外部ゲスト ユーザーを招待

外部の人物をゲスト ユーザーとして招待

説明

外部のメール アドレスに Microsoft Entra ID のゲスト招待を送信します。オプションで、ゲストをグループに追加し、名前、会社、使用場所、マネージャー、スポンサーなどのプロファイル詳細をゲスト アカウントにすぐ設定できます。招待メールとランディング ページはカスタマイズできます。

一般的な使用例

• 基本的なゲスト招待: メール アドレスと表示名のみを指定します。すべてのプロファイル パラメーターとグループ パラメーターは空欄のままで構いません。
• 完全なオンボーディング: すべての任意フィールドを指定してプロファイル プロパティを設定し、マネージャーとスポンサーを割り当て、1回の実行でゲストをグループに追加します。

パラメーターの相互作用

• プロファイル プロパティ（givenName, surname, companyName, usageLocation）は空でない場合にのみ適用されます。省略すると更新呼び出しは完全にスキップされます。
• マネージャーの割り当て、スポンサーの割り当て、グループ メンバーシップはいずれも、それぞれ対応するパラメーターが必要です。指定されていない場合はすべて静かにスキップされます。

場所

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

Runbook の完全名

rjgit-org_general_Invite-external-guest-users

詳細

プロパティ	値
バージョン	2.0.3
必要なモジュール	RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0)
スケジュール可能	いいえ

権限

アプリケーションの権限

• 種類: Microsoft Graph

  • User.ReadWrite.All

    • 招待を作成し、ゲストのプロファイル プロパティを更新し、マネージャーとスポンサーを設定します
  • Group.ReadWrite.All

    • 対象グループを確認し、/groups/{id}/members/$ref 経由でゲストを追加します
  • Organization.Read.All

    • 既定の招待リダイレクト URL を作成するためにテナント ID を読み取ります

パラメーター

InvitedUserEmail

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

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

InvitedUserDisplayName

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

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

GroupId

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

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

GivenName

ゲストの名。

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

Surname

ゲストの姓。

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

CompanyName

ゲストが勤務する会社。

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

ManagerName

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

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

SponsorName

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

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

CustomizeInvitation

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

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

InvitationMessage

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

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

InviteRedirectUrl

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

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

UsageLocation

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

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

Runbook リファレンスの概要に戻る