【 New-MgInvitation 】コマンドレット――Azure Active Directoryにゲストユーザーを招待する：Windows PowerShell基本Tips（62）
本連載は、PowerShellコマンドレットについて、基本書式からオプション、具体的な実行例までを紹介していきます。今回は「New-MgInvitation」コマンドレットを解説します。
この記事は会員限定です。会員登録（無料）すると全てご覧いただけます。
本連載では、Windows PowerShellの基本的なコマンドレットについて、基本的な書式からオプション、具体的な実行例までを分かりやすく紹介していきます。今回は、「Azure Active Directory」（Azure AD）にゲストユーザーを追加する「New-MgInvitation」コマンドレットです。
New-MgInvitationコマンドレットとは？
「New-MgInvitation」は、PowerShellを利用してAzure ADにゲストユーザーを追加するためのコマンドレットです。ゲストユーザーはブラウザから新規作成することもできますが、複数のゲストユーザーを一括作成したい、メンバーとしてゲストユーザーを作成したいといった操作に有効です。
なお、New-MgInvitationコマンドレットは、本連載第45回で解説した「Connect-MgGraph」コマンドレットで「Connect-MgGraph -Scopes "User.ReadWrite.All"」と実行して、Azure ADへの接続とアクセス許可を与えておくことが前提条件になります。
New-MgInvitationコマンドレットの主なオプション
| オプション | 意味 |
|---|---|
| -InvitedUserEmailAddress | 招待するユーザーのメールアドレスを指定する |
| -InviteRedirectUrl | 招待を受けるユーザーがアクセスするアプリを指定する。 |
| -InvitedUserDisplayName | 招待するユーザーの表示名を指定する。省略可能 |
| -SendInvitationMessage | 招待するユーザーに招待を通知するメールを送信する。省略可能 |
| -InvitedUserType | ユーザーをゲストまたはメンバーとして招待する。省略可能 |
ゲストユーザーを招待する
New-MgInvitationコマンドレットでは「-InvitedUserEmailAddress」オプションを指定して、自身のテナントにゲストとして招待するユーザーのメールアドレスを指定します。その後、続けて「-InviteRedirectUrl」オプションを指定して、招待したユーザーがアクセスするアプリを指定します。
Copyright © ITmedia, Inc. All Rights Reserved.
ITmediaはアイティメディア株式会社の登録商標です。