Démarrage rapide : Ajouter un utilisateur invité avec PowerShell

S’applique à : Locataires de main-d’œuvre (en savoir plus)

Il existe de nombreuses façons d’inviter des partenaires externes à vos applications et services avec Microsoft Entra collaboration B2B. Dans le guide de démarrage rapide précédent, vous avez vu comment ajouter des utilisateurs invités directement dans le Microsoft Entra admin center. Vous pouvez également utiliser PowerShell pour ajouter des utilisateurs invités, un par un, ou en bloc. Dans ce guide de démarrage rapide, vous utilisez la commande New-MgInvitation pour ajouter un utilisateur invité à votre locataire Microsoft Entra.

Cet article explique comment inviter des utilisateurs invités avec Microsoft Graph PowerShell. Vous pouvez également gérer les utilisateurs invités avec Microsoft Entra PowerShell.

Prérequis

Pour suivre le scénario décrit dans ce démarrage rapide, vous avez besoin de ce qui suit :

• Un abonnement Azure. Si vous n'avez pas d'abonnement Azure, créez un compte free avant de commencer.
• Un rôle qui vous permet de créer des utilisateurs dans votre répertoire de locataires, dont au moins un rôle Inviteur d’invités ou un rôle Administrateur d’utilisateurs.
• Installez le module Microsoft Graph Identity Sign-ins (Microsoft. Graph.Identity.SignIns) et le module Microsoft Graph Users (Microsoft). Graph.Users). Vous pouvez utiliser l’instruction #Requires pour empêcher l’exécution d’un script, sauf si les modules PowerShell requis sont satisfaits.

#Requires -Modules Microsoft.Graph.Identity.SignIns, Microsoft.Graph.Users

• Obtenez un compte e-mail de test. Vous avez besoin d’un compte e-mail de test auquel vous pouvez envoyer l’invitation. Le compte doit être externe à votre organisation. Vous pouvez utiliser n’importe quel type de compte, y compris un compte social tel qu’un Gmail.com ou une adresse Outlook.com.

Connectez-vous à votre locataire

Exécutez la commande suivante pour vous connecter à votre locataire :

Connect-MgGraph -Scopes 'User.Invite.All','User.Read.All'

Lorsque vous y êtes invité, entrez vos informations d’identification.

Envoyer une invitation

1. Pour envoyer une invitation à votre compte e-mail de test, exécutez la commande PowerShell suivante (remplacez « Henry Ross » et henry@contoso.com par le nom de votre compte e-mail de test et par votre adresse e-mail) :

   New-MgInvitation -InvitedUserDisplayName "Henry Ross" -InvitedUserEmailAddress henry@contoso.com -InviteRedirectUrl "https://myapplications.microsoft.com" -SendInvitationMessage:$true
   

2. La commande envoie une invitation à l’adresse e-mail spécifiée. Regardez la sortie, qui doit être semblable à l’exemple qui suit :

   Id                                   InviteRedeemUrl                                                                                                   
   --                                   ---------------                                                                                                   
   00aa00aa-bb11-cc22-dd33-44ee44ee44ee https://login.microsoftonline.com/redeem?...
   

Vérifier que l’utilisateur se trouve dans l’annuaire

1. Pour vérifier que l’utilisateur invité a été ajouté à Microsoft Entra ID, exécutez la commande suivante (remplacez henry@contoso.com par votre e-mail invité) :

   Get-MgUser -Filter "Mail eq 'henry@contoso.com'"
   

2. Examinez la sortie pour voir si l’utilisateur que vous avez invité y figure, avec un nom d’utilisateur principal (UPN) au format suivant : adresse_e-mail#EXT#@domaine. Par exemple, john_contoso.com#EXT#@fabrikam.onmicrosoft.com, où fabrikam.onmicrosoft.com est l’organisation depuis laquelle vous avez envoyé les invitations.

   Id                                   DisplayName              Mail                           UserPrincipalName        
   --                                   -----------              ----                           -----------------               
   00aa00aa-bb11-cc22-dd33-44ee44ee44ee Henry Ross               henry@contoso.com              henry_contoso.com#EXT#@fabrikam.onmicrosoft.com
   

Nettoyer les ressources

Quand vous n’en avez plus besoin, vous pouvez supprimer le compte d’utilisateur de test de l’annuaire. Exécutez la commande suivante pour supprimer un compte d’utilisateur :

Remove-MgUser -UserId '<String>'

Par exemple :

Remove-MgUser -UserId 'henry_contoso.com#EXT#@fabrikam.onmicrosoft.com'

ou

Remove-MgUser -UserId '00aa00aa-bb11-cc22-dd33-44ee44ee44ee'

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez invité et ajouté un seul utilisateur invité à votre annuaire à l’aide de PowerShell. Vous pouvez également inviter un utilisateur invité à l’aide du Microsoft Entra admin center. En outre, vous pouvez inviter des utilisateurs invités en bloc à l’aide de PowerShell.