Partager via


Exemples de code et PowerShell pour Microsoft Entra B2B Collaboration

Exemple PowerShell

Vous pouvez inviter en bloc des utilisateurs externes à une organisation à partir d’adresses e-mail que vous stockez dans un fichier .csv.

  1. Préparer le fichier .csv

    Créez un fichier .csv et nommez-le invitations.csv. Dans cet exemple, le fichier est enregistré dans C:\data et contient les informations suivantes :

    Nom InvitedUserEmailAddress
    Invité B2B Gmail b2binvitee@gmail.com
    Invité B2B Outlook b2binvitee@outlook.com
  2. Obtenir la dernière version de Microsoft Graph PowerShell

    Pour utiliser les nouvelles applets de commande, vous devez installer le module Microsoft Graph PowerShell mis à jour. Pour plus d’informations, consultez Installer le SDK Microsoft Graph PowerShell

  3. Connectez-vous à votre architecture cliente

    Connect-MgGraph -Scopes "User.Invite.All"
    
  4. Exécutez l’applet de commande PowerShell

    $invitations = import-csv C:\data\invitations.csv
    $messageInfo = New-Object Microsoft.Open.MSGraph.Model.InvitedUserMessageInfo
    $messageInfo.customizedMessageBody = "Hey there! Check this out. I created an invitation through PowerShell"
    foreach ($email in $invitations) {
       New-MgInvitation -InviteRedirectUrl "https://wingtiptoysonline-dev-ed.my.woodgrove.com" `
          -InvitedUserDisplayName $email.Name -InvitedUserEmailAddress $email.InvitedUserEmailAddress `
          -InvitedUserMessageInfo $messageInfo -SendInvitationMessage:$true
    }
    

Cette applet de commande envoie une invitation aux adresses e-mail stockées dans le fichier invitations.csv. Fonctionnalités supplémentaires de cette cmdlet :

  • Texte personnalisé dans le message électronique
  • Y compris un nom d’affichage pour l’utilisateur invité
  • Envoi de messages aux personnes en copie ou suppression complète des messages électroniques

Exemple de code

L’exemple de code illustre l’appel de l’API d’invitation et l’obtention de l’URL d’échange. Utilisez l’URL d’échange pour envoyer un e-mail d’invitation personnalisé. Vous pouvez composer l’e-mail avec un client HTTP, ce qui vous permet de personnaliser son apparence et de l’envoyer via l’API Graph Microsoft.

POST https://graph.microsoft.com/v1.0/invitations
Content-type: application/json
{
  "invitedUserEmailAddress": "david@fabrikam.com",
  "invitedUserDisplayName": "David",
  "inviteRedirectUrl": "https://myapp.contoso.com",
  "sendInvitationMessage": true
}

Étapes suivantes