Tutorial: Masseneinladen von Benutzern für die Microsoft Entra B2B-Zusammenarbeit mithilfe von PowerShell

Gilt für: Mitarbeiter(-)Mandanten (weitere Informationen)

Wenn Sie die Zusammenarbeit mit Microsoft Entra B2B für die Zusammenarbeit mit externen Partnern verwenden, können Sie mehrere Gastbenutzer gleichzeitig über das Portal oder PowerShell zu Ihrer Organisation einladen. In diesem Tutorial erfahren Sie, wie Sie mit PowerShell Masseneinladungen an externe Benutzer senden. Das Tutorial umfasst vor allem die folgenden Aufgaben:

• Vorbereiten einer durch Trennzeichen getrennten CSV-Datei mit den Benutzerinformationen
• Ausführen eines PowerShell-Skripts zum Senden von Einladungen
• Überprüfen, ob die Benutzer dem Verzeichnis hinzugefügt werden

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Voraussetzungen

Installieren des aktuellen Microsoft Graph PowerShell-Moduls

Stellen Sie sicher, dass Sie die neueste Version des Microsoft Graph PowerShell-Moduls installieren.

Überprüfen Sie zunächst, welche Module Sie installiert haben. Öffnen Sie PowerShell als Benutzer mit erhöhten Rechten (als Administrator ausführen), und führen Sie den folgenden Befehl aus:

Get-InstalledModule Microsoft.Graph

Führen Sie den folgenden Befehl aus, um das v1-Modul des SDK in PowerShell Core oder Windows PowerShell zu installieren:

Install-Module Microsoft.Graph -Scope CurrentUser

Ändern Sie optional den Bereich der Installation mithilfe -Scope des Parameters. Dies erfordert Administratorberechtigungen.

Install-Module Microsoft.Graph -Scope AllUsers

Führen Sie diesen Befehl aus, um das Betamodul zu installieren.

Install-Module Microsoft.Graph.Beta

Möglicherweise erhalten Sie eine Eingabeaufforderung, dass Sie das Modul aus einem nicht vertrauenswürdigen Repository installieren. Das passiert, wenn Sie das PSGallery-Repository nicht zuvor als vertrauenswürdiges Repository festgelegt haben. Drücken Sie Y, um das Modul zu installieren.

Einrichten von Test-E-Mail-Konten

Sie benötigen zwei oder mehr Test-E-Mail-Konten, um die Einladungen zu senden. Die Konten müssen sich außerhalb Ihrer Organisation befinden. Sie können jede Art von Konto verwenden, einschließlich Konten bei sozialen Netzwerken wie gmail.com- oder outlook.com-Adressen.

Vorbereiten der CSV-Datei

Erstellen Sie in Microsoft Excel eine CSV-Datei mit der Liste der eingeladenen Benutzernamen und E-Mail-Adressen. Achten Sie darauf, dass Sie die Spaltenüberschriften Name und InvitedUserEmailAddress angeben.

Erstellen Sie beispielsweise ein Arbeitsblatt im folgenden Format:

Speichern Sie die Datei unter C:\BulkInvite\Invitations.csv.

Wenn Sie nicht über Excel verfügen, erstellen Sie eine CSV-Datei in einem Texteditor, z. B. Notepad. Trennen Sie Werte durch Kommas und Zeilen durch eine neue Zeile.

Anmelden im Mandanten

Führen Sie den folgenden Befehl aus, um die Verbindung mit dem Mandanten herzustellen:

Connect-MgGraph -TenantId "<YOUR_TENANT_ID>"

Beispiel: Connect-MgGraph -TenantId "aaaabbbb-0000-cccc-1111-dddd2222eeee". Sie können auch die Mandantendomäne verwenden, aber der Parameter bleibt die -TenantId. Beispiel: Connect-MgGraph -TenantId "contoso.onmicrosoft.com".

Geben Sie bei Aufforderung Ihre Anmeldeinformationen ein.

Senden von Masseneinladungen

Führen Sie zum Senden der Einladungen das folgende PowerShell-Skript aus (wobei * * c:\bulkinvite\invitations.csv der Pfad der CSV-Datei ist):

$invitations = import-csv c:\bulkinvite\invitations.csv

$messageInfo = New-Object Microsoft.Graph.PowerShell.Models.MicrosoftGraphInvitedUserMessageInfo

$messageInfo.customizedMessageBody = "Hello. You are invited to the Contoso organization."

foreach ($email in $invitations) {
	New-MgInvitation ` 
      -InvitedUserEmailAddress $email.InvitedUserEmailAddress `
		-InvitedUserDisplayName $email.Name `
		-InviteRedirectUrl https://myapplications.microsoft.com/?tenantid=aaaabbbb-0000-cccc-1111-dddd2222eeee `
		-InvitedUserMessageInfo $messageInfo `
		-SendInvitationMessage
}

Das Skript sendet eine Einladung an die E-Mail-Adressen in der dateiinvitations.csv . Für jeden Benutzer wird die Ausgabe ähnlich wie folgt angezeigt:

Überprüfen, ob Benutzer im Verzeichnis vorhanden sind

Um zu überprüfen, ob die eingeladenen Benutzer Microsoft Entra ID hinzugefügt wurden, führen Sie den folgenden Befehl aus:

 Get-MgUser -Filter "UserType eq 'Guest'"

Die von Ihnen eingeladenen Benutzer sollten mit einem Benutzerprinzipalnamen (UPN) im Format E-Mail-Adresse#EXT#@Domäne angezeigt werden. Beispiel: msullivan_fabrikam.com#EXT#@contoso.onmicrosoft.com, wobei contoso.onmicrosoft.com die Organisation ist, für die Sie die Einladungen gesendet haben.

Bereinigen von Ressourcen

Wenn Sie die Testbenutzerkonten nicht mehr benötigen, können Sie sie aus dem Verzeichnis löschen. Führen Sie den folgenden Befehl aus, um ein Benutzerkonto zu löschen:

 Remove-MgUser -UserId "<String>"

Zum Beispiel: Remove-MgUser -UserId "00aa00aa-bb11-cc22-dd33-44ee44ee44ee"

Zugehöriger Inhalt

In diesem Tutorial haben Sie Masseneinladungen an Gastbenutzer außerhalb Ihrer Organisation gesendet. Als Nächstes erfahren Sie, wie Sie Gastbenutzer in großen Mengen über das Portal einladen und MFA für sie erzwingen.

• Masseneinladung von Gastbenutzern über das Portal