> 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 のゲスト招待を外部のメール アドレスに送信します。必要に応じて、ゲストをグループに追加し、名前、会社、使用場所、マネージャー、スポンサーなどのプロファイル詳細をゲスト アカウントにすぐに設定します。招待メールとランディング ページはカスタマイズできます。

### 一般的な使用例

* 基本的なゲスト招待: メール アドレスと表示名だけを指定し、プロファイルとグループのパラメーターはすべて空欄のままにできます。
* フル オンボーディング: すべての省略可能なフィールドを指定してプロファイル プロパティを設定し、マネージャーとスポンサーを割り当て、1 回の実行でゲストをグループに追加します。

### パラメーターの相互作用

* プロファイル プロパティ (`givenName`, `surname`, `companyName`, `usageLocation`) は空でない場合にのみ適用されます。指定しない場合、更新呼び出しは完全にスキップされます。
* マネージャーの割り当て、スポンサーの割り当て、およびグループ メンバーシップには、それぞれのパラメーターが必要です。指定されていない場合は、いずれも黙ってスキップされます。

### 場所

組織 → 全般 → 外部ゲスト ユーザーを招待

**完全な Runbook 名**

rjgit-org\_general\_Invite-external-guest-users

### 詳細

| プロパティ    | 値                                                                                        |
| -------- | ---------------------------------------------------------------------------------------- |
| バージョン    | 2.0.3                                                                                    |
| 必須モジュール  | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| スケジュール可能 | いいえ                                                                                      |

### 権限

#### アプリケーションのアクセス許可

* **種類**: Microsoft Graph
  * User.ReadWrite.All
    * *招待を作成し、ゲストのプロファイル プロパティを更新し、マネージャーとスポンサーを設定します*
  * Group.ReadWrite.All
    * *対象グループを確認し、/groups/{id}/members/$ref を使用してゲストを追加します*
  * Organization.Read.All
    * *既定の招待リダイレクト URL を作成するためにテナント ID を読み取ります*

### パラメーター

#### InvitedUserEmail

招待する相手のメール アドレス。

| プロパティ | 値    |
| ----- | ---- |
| 必須    | true |
| 既定値   |      |
| 種類    | 文字列  |

#### InvitedUserDisplayName

ディレクトリでゲストに表示される名前。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### GroupId

ゲストが追加されるグループ。ランブックのカスタマイズで事前設定されます。空の場合はなしを意味します。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### 名

ゲストの名。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### 姓

ゲストの姓。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### 会社名

ゲストが勤務する会社。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### ManagerName

ゲストのマネージャーになるユーザー。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### SponsorName

ゲストのスポンサーとして記録されるユーザー。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### CustomizeInvitation

独自の招待メッセージとリダイレクト URL のフィールドを表示します。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   | False |
| 種類    | ブール値  |

#### InvitationMessage

招待メールに含まれるテキスト。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### InviteRedirectUrl

承諾後にゲストが移動するページ。たとえば SharePoint サイトなどです。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### 利用場所

ライセンスを割り当てる前に必要な 2 文字の国コード。たとえば US または DE です。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

[Runbook リファレンスの概要に戻る](/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/general/invite-external-guest-users.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.