Gestion des utilisateurs invités dans PowerShell avec l'API Microsoft Graph

Dans les environnements de travail collaboratif d'aujourd'hui, inviter des utilisateurs invités à accéder aux ressources organisationnelles est devenu une pratique courante. PowerShell, combiné avec Microsoft Graph API (mggraph), offre un moyen puissant de gérer ces utilisateurs invités. Cet article de blog explore comment utiliser PowerShell et mggraph pour gérer les utilisateurs invités, avec des exemples pratiques pour illustrer les concepts clés. Plongeons-y.

Introduction aux utilisateurs invités et à l'API Microsoft Graph

Les utilisateurs invités sont des utilisateurs externes qui se voient accorder l'accès aux ressources de votre organisation. Microsoft Graph API, un point de terminaison unifié pour accéder aux données à travers les services Microsoft, permet aux administrateurs d'automatiser la gestion de ces utilisateurs invités par le biais de scripts PowerShell.

Installer l'API Graph et se connecter au Cloud

Avant de plonger dans les exemples, nous avons encore du travail à faire, à savoir que nous devons nous connecter au cloud.

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

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

Inviter | Récupérer | Supprimer des utilisateurs invités

Voici quelques exemples de la façon d'inviter des utilisateurs invités, de récupérer (d'afficher) des utilisateurs invités et enfin de supprimer des utilisateurs invités.

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

Déconnecter

Enfin et surtout, nous nous déconnectons de l'API ms graph.

Disconnect-MgGraph

J'espère que cela a été utile.