Microsoft Graph APIを使用したPowerShellでのゲストユーザーの管理

今日の協働作業環境において、ゲストユーザーを組織のリソースに招待することは一般的な慣行となっています。PowerShellとMicrosoft Graph API（mggraph）を組み合わせることで、これらのゲストユーザーを管理するための強力な方法が提供されています。このブログ投稿では、PowerShellとmggraphを使用してゲストユーザーを管理する方法を探求し、重要な概念を示す実用的な例を紹介します。それでは、始めましょう。

ゲストユーザーとMicrosoft Graph APIの紹介

ゲストユーザーは、あなたの組織のリソースにアクセスを許可された外部ユーザーです。Microsoft Graph APIは、Microsoftサービス全体のデータにアクセスするための統一されたエンドポイントであり、管理者がPowerShellスクリプトを通じてこれらのゲストユーザーの管理を自動化できるようにします。

グラフAPIのインストールとクラウドへの接続

例に入る前に、まだいくつかの作業が残っています。具体的には、クラウドに接続する必要があります。

Micrsoft Graph Module
Install-Module Microsoft.Graph -AllowClobber -Force

Connect to Cloud
Connect-MgGraph -Scopes 'User.ReadWrite.All'  
Get-MgContext | Select-Object -ExpandProperty Scopes

招待 | 取得 | ゲストユーザーの削除

ここでは、ゲストユーザーを招待する方法、ゲストユーザーを取得（表示）する方法、そして最後にゲストユーザーを削除する方法のいくつかの例を示します。

Invite Guest User
New-MgInvitation -InvitedUserDisplayName "Hans Womanizer" -InvitedUserEmailAddress pewa2303@gmail.com `
-InviteRedirectUrl "https://myapplications.microsoft.com" -SendInvitationMessage:$true

Retrieve Guest Users
Get-MgUser -Filter "userType eq 'Guest'" -All 
Get-MgUser -Filter "userType eq 'Guest' and externalUserState eq 'PendingAcceptance'" -All 

Remove Guest User
Remove-MgUser -UserId pewa2303_gmail.com#EXT#@sid500.onmicrosoft.com

切断する

最後に、ms graph APIから切断します。

Disconnect-MgGraph

役に立てば幸いです。