Freigeben über


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

PowerShell-Beispiel

Sie können externe Benutzer per Massenvorgang zu einer Organisation einladen. Dabei werden E-Mail-Adressen verwendet, die Sie in einer CSV-Datei gespeichert haben.

  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 Invitee b2binvitee@gmail.com
    Outlook B2B invitee b2binvitee@outlook.com
  2. Abrufen der aktuellen Microsoft Graph PowerShell

    Um die Cmdlets verwenden zu können, 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