Freigeben über


Microsoft Entra B2B-Zusammenarbeit: Code- und PowerShell-Beispiele

PowerShell-Beispiel

Sie können externe Benutzer in großer Zahl aus E-Mail-Adressen, die Sie in einer .csv Datei speichern, in eine Organisation einladen.

  1. Vorbereiten der .csv Datei

    Erstellen Sie eine neue .csv Datei, und nennen Sie sie invitations.csv. In diesem Beispiel wird die Datei unter „C:\data“ gespeichert, und sie enthält die folgenden Informationen:

    Name InvitedUserEmailAddress
    Gmail B2B Einladungsempfänger b2binvitee@gmail.com
    Outlook B2B invitee b2binvitee@outlook.com
  2. Holen Sie sich die neueste Microsoft Graph PowerShell

    Um die neuen Cmdlets zu verwenden, müssen Sie das aktualisierte Microsoft Graph PowerShell-Modul installieren. Weitere Informationen finden Sie unter Installieren des Microsoft Graph PowerShell SDK

  3. Melden Sie sich bei Ihrem Mandanten an.

    Connect-MgGraph -Scopes "User.Invite.All"
    
  4. Führen Sie das PowerShell-Cmdlet aus.

    $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
    }
    

Mit diesem Cmdlet wird eine Einladung an die E-Mail-Adressen in „invitations.csv“ gesendet. Weitere Funktionen dieses Cmdlets sind:

  • Benutzerdefinierter Text in der E-Mail-Nachricht
  • Einfügen eines Anzeigenamens für den eingeladenen Benutzer
  • Senden von Nachrichten an Benutzer in Kopie oder Unterdrücken sämtlicher E-Mail-Nachrichten

Codebeispiel

Das Codebeispiel veranschaulicht, wie sie die Einladungs-API aufrufen und die Einlösungs-URL abrufen. Verwenden Sie die Einlösungs-URL, um eine benutzerdefinierte Einladungs-E-Mail zu senden. Sie können die E-Mail kann über einen HTTP-Client zusammenstellen, sodass Sie das ihr Aussehen anpassen und sie über die Microsoft Graph-API senden können.

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
}

Nächste Schritte