Microsoft Graph PowerShell を使ってゲストユーザーを招待してみた際のメモ書きです。
PowerShell 7 をつかう
何かと便利なので、PowerShell 7 を利用します。
インストール方法はこちら。
New-MgInvitation コマンド
New-MgInvitation コマンドを使ってゲストユーザーの招待ができます。
接続
最小特権で User.Invite.All が必要なため、スコープを指定してコマンドを実行します。
サインインを求められたら、サインインをしてください。
Connect-MgGraph -Scopes 'User.Invite.All'
パラメーター
invitedUserEmailAddress にゲストのアドレスを入力し実行します。
CustomizedMessageBody は招待メールの本文をカスタマイズできます。
$params = @{ InvitedUserDisplayName = "ろぼ" invitedUserEmailAddress = "roboboy@contoso.com" InviteRedirectUrl = "https://myapplications.microsoft.com" SendInvitationMessage = $true invitedUserMessageInfo = @{ CustomizedMessageBody = "Welcome to ROBOBOY tenant!" } }
招待の実行
New-MgInvitation -BodyParameter $params
切断
接続したらちゃんと切断しましょう。
Disconnect-MgGraph
さいごに
Microsoft Graph PowerShell でゲストユーザー招待してみました。
Microsoft Graph API を使っているとなんとなくわかりすい気がします。