> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/general/invite-external-guest-users.md).
# 外部ゲスト ユーザーを招待
### 説明
このランブックは、Microsoft Entra ID で外部ユーザーをゲスト ユーザーとして招待します。名、姓、会社名、利用場所、マネージャー、スポンサーなどの任意のプロフィール プロパティは、招待が承諾された後に設定できます。招待されたユーザーは、必要に応じて指定したグループに追加できます。
### 場所
Organization → General → 外部ゲスト ユーザーを招待
**Runbook の完全名**
rjgit-org\_general\_Invite-external-guest-users
### 詳細
| プロパティ | 値 |
| -------- | --------------------------------------------------------------------------------------- |
| バージョン | 2.0.3 |
| 必要なモジュール | RealmJoin.RunbookHelper (>= 0.8.9)
Microsoft.Graph.Authentication (>= 2.39.0)
|
| スケジュール可能 | いいえ |
### 注意
一般的な使用例:
* 基本的なゲスト招待: メール アドレスと表示名のみを指定します。すべてのプロフィール パラメーターとグループ パラメーターは空欄のままでかまいません
* 完全なオンボーディング: すべての任意フィールドを指定してプロフィール プロパティを設定し、マネージャー/スポンサーを割り当て、1 回の実行でグループに追加します
パラメーターの相互作用:
* プロフィール プロパティ (givenName、surname、companyName、usageLocation) は、空でない場合にのみ適用されます。これらを省略すると、PATCH 呼び出し自体がスキップされます
* マネージャーとスポンサーの割り当て、およびグループ メンバーシップは、それぞれ対応するパラメーターが必要です。指定されない場合はすべて黙ってスキップされます
### アクセス許可
#### アプリケーションのアクセス許可
* **種類**：Microsoft Graph
* User.ReadWrite.All
* *招待を作成し、ゲストのプロフィール プロパティを更新し、マネージャーとスポンサーを設定します*
* Group.ReadWrite.All
* *対象のグループを確認し、/groups/{id}/members/$ref を介してゲストを追加します*
* Organization.Read.All
* *テナント ID を読み取り、既定の招待リダイレクト URL を構築します*
### パラメーター
#### InvitedUserEmail
招待するゲスト ユーザーのメール アドレス。
| プロパティ | 値 |
| ----- | --- |
| 必須 | はい |
| 既定値 | |
| 種類 | 文字列 |
#### InvitedUserDisplayName
ゲスト ユーザーの表示名。
| プロパティ | 値 |
| ----- | --- |
| 必須 | いいえ |
| 既定値 | |
| 種類 | 文字列 |
#### GroupId
ゲスト ユーザーを追加するグループのオブジェクト ID。指定しない場合、ユーザーはどのグループにも追加されません。
| プロパティ | 値 |
| ----- | --- |
| 必須 | いいえ |
| 既定値 | |
| 種類 | 文字列 |
#### 名
ゲスト ユーザーの名 (ファースト ネーム)。
| プロパティ | 値 |
| ----- | --- |
| 必須 | いいえ |
| 既定値 | |
| 種類 | 文字列 |
#### 姓
ゲスト ユーザーの姓 (ラスト ネーム)。
| プロパティ | 値 |
| ----- | --- |
| 必須 | いいえ |
| 既定値 | |
| 種類 | 文字列 |
#### 会社名
ゲスト ユーザーの会社名。
| プロパティ | 値 |
| ----- | --- |
| 必須 | いいえ |
| 既定値 | |
| 種類 | 文字列 |
#### ManagerName
ゲスト ユーザーに割り当てるマネージャー。ディレクトリからユーザーを選択します。
| プロパティ | 値 |
| ----- | --- |
| 必須 | いいえ |
| 既定値 | |
| 種類 | 文字列 |
#### SponsorName
ゲスト ユーザーに割り当てるスポンサー。ディレクトリからユーザーを選択します。
| プロパティ | 値 |
| ----- | --- |
| 必須 | いいえ |
| 既定値 | |
| 種類 | 文字列 |
#### CustomizeInvitation
招待メッセージとリダイレクト URL をカスタマイズできるようにします。
| プロパティ | 値 |
| ----- | ----- |
| 必須 | いいえ |
| 既定値 | False |
| 種類 | ブール値 |
#### InvitationMessage
招待メールに含めるカスタム メッセージ本文。CustomizeInvitation が有効な場合にのみ使用されます。
| プロパティ | 値 |
| ----- | --- |
| 必須 | いいえ |
| 既定値 | |
| 種類 | 文字列 |
#### InviteRedirectUrl
招待を承諾した後にユーザーがリダイレクトされるカスタム URL。CustomizeInvitation が有効な場合にのみ使用されます。
| プロパティ | 値 |
| ----- | --- |
| 必須 | いいえ |
| 既定値 | |
| 種類 | 文字列 |
#### 利用場所
ゲスト ユーザーの利用場所に使用する ISO 3166-1 alpha-2 の国コード (例: "US"、"DE")。
| プロパティ | 値 |
| ----- | --- |
| 必須 | いいえ |
| 既定値 | |
| 種類 | 文字列 |
[Runbook Reference の概要に戻る](/ja/zi-dong-hua/runbooks/runbook-references.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/general/invite-external-guest-users.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.