Självstudie: Använda PowerShell för att massinbjuda Microsoft Entra B2B-samarbetsanvändare

Gäller för: Personalklientorganisationer Externa klienter (läs mer)

Om du använder Microsoft Entra B2B-samarbete för att arbeta med externa partner kan du bjuda in flera gästanvändare till din organisation samtidigt via portalen eller via PowerShell. I den här självstudien får du lära dig hur du använder PowerShell för att skicka massinbjudningar till externa användare. Mer specifikt gör du följande:

Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.

Förutsättningar

Installera den senaste Microsoft Graph PowerShell-modulen

Kontrollera att du installerar den senaste versionen av Microsoft Graph PowerShell-modulen.

Kontrollera först vilka moduler du har installerat. Öppna PowerShell som en upphöjd användare (Kör som administratör) och kör följande kommando:

Get-InstalledModule Microsoft.Graph

Kör följande kommando för att installera v1-modulen i SDK:t i PowerShell Core eller Windows PowerShell:

Install-Module Microsoft.Graph -Scope CurrentUser

Du kan också ändra omfånget för installationen med hjälp av parametern -Scope . Detta kräver administratörsbehörigheter.

Install-Module Microsoft.Graph -Scope AllUsers

Kör följande kommando för att installera betamodulen.

Install-Module Microsoft.Graph.Beta

Du kan få ett meddelande om att du installerar modulen från en obetrodd lagringsplats. Detta inträffar om du inte tidigare har angett PSGallery-lagringsplatsen som en betrodd lagringsplats. Tryck Y för att installera modulen.

Hämta test-e-postkonton

Du behöver två eller flera test-e-postkonton som du kan skicka inbjudningarna till. Kontona måste vara utanför organisationen. Du kan använda alla typer av konton, inklusive sociala konton som gmail.com eller outlook.com adresser.

Förbereda CSV-filen

I Microsoft Excel skapar du en CSV-fil med listan över inbjudna användarnamn och e-postadresser. Se till att inkludera kolumnrubrikerna Namn och InvitedUserEmailAddress .

Skapa till exempel ett kalkylblad i följande format:

Spara filen som C:\BulkInvite\Invitations.csv.

Om du inte har Excel kan du skapa en CSV-fil i valfri textredigerare, till exempel Anteckningar. Avgränsa varje värde med kommatecken och varje rad med en ny rad.

Logga in på din klientorganisation

Kör följande kommando för att ansluta till klientorganisationen:

Connect-MgGraph -TenantId "<YOUR_TENANT_ID>"

Till exempel Connect-MgGraph -TenantId "aaaabbbb-0000-cccc-1111-dddd2222eeee". Du kan också använda klientdomänen, men parametern förblir -TenantId. Till exempel Connect-MgGraph -TenantId "contoso.onmicrosoft.com".

När du uppmanas till det anger du dina autentiseringsuppgifter.

Skicka massinbjudningar

Om du vill skicka inbjudningarna kör du följande PowerShell-skript (där c:\bulkinvite\invitations.csv är sökvägen till CSV-filen):

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

Skriptet skickar en inbjudan till e-postadresserna i filen Invitations.csv. Du bör se utdata som liknar följande för varje användare:

Kontrollera att användarna finns i katalogen

Kontrollera att de inbjudna användarna har lagts till i Microsoft Entra-ID genom att köra följande kommando:

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

Du bör se de användare som du har bjudit in med ett upn-namn (user principal name) i formatet emailaddress#EXT#@domain. Till exempel msullivan_fabrikam.com#EXT#@contoso.onmicrosoft.com, var contoso.onmicrosoft.com är den organisation som du skickade inbjudningarna från.

Rensa resurser

När de inte längre behövs kan du ta bort testanvändarkontona i katalogen. Kör följande kommando för att ta bort ett användarkonto:

 Remove-MgUser -UserId "<String>"

Till exempel: Remove-MgUser -UserId "00aa00aa-bb11-cc22-dd33-44ee44ee44ee"

Relaterat innehåll

I den här självstudien skickade du massinbjudningar till gästanvändare utanför organisationen. Lär dig sedan hur du massinbjuder gästanvändare på portalen och hur du framtvingar MFA för dem.

• Massinbjuda gästanvändare via portalen