Управление пользователями гостей в PowerShell с помощью Microsoft Graph API

В современных условиях совместной работы приглашение гостей для доступа к организационным ресурсам стало обычной практикой. PowerShell в сочетании с Microsoft Graph API (mggraph) предоставляет мощный способ управления этими гостевыми пользователями. В этом блоге рассматривается, как использовать PowerShell и mggraph для управления гостевыми пользователями, с практическими примерами для иллюстрации ключевых концепций. Давайте углубимся в это.

Введение в гостей и Microsoft Graph API

Пользователи-гости — это внешние пользователи, которым предоставлен доступ к ресурсам вашей организации. Microsoft Graph API, единая точка доступа для доступа к данным через службы Microsoft, позволяет администраторам автоматизировать управление этими пользователями-гостями с помощью скриптов PowerShell.

Установка Graph 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

Отключить

Напоследок, мы отключаемся от API ms graph.

Disconnect-MgGraph

Надеюсь, это было полезно.