Zelfstudie: PowerShell gebruiken om gebruikers van Microsoft Entra B2B-samenwerking bulksgewijs uit te nodigen

Van toepassing op:Externe tenantsvan werknemers (meer informatie)

Als u Microsoft Entra B2B-samenwerking gebruikt om samen te werken met externe partners, kunt u meerdere gastgebruikers tegelijk uitnodigen voor uw organisatie via de portal of PowerShell. In deze zelfstudie leert u hoe u PowerShell gebruikt voor het verzenden van bulk-uitnodigingen naar externe gebruikers. Ga als volgt te werk:

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Vereisten

De nieuwste Microsoft Graph PowerShell-module installeren

Zorg ervoor dat u de nieuwste versie van de Microsoft Graph PowerShell-module installeert.

Controleer eerst welke modules u hebt geïnstalleerd. Open PowerShell als een gebruiker met verhoogde bevoegdheid (als administrator uitvoeren) en voer de volgende opdracht uit:

Get-InstalledModule Microsoft.Graph

Als u de v1-module van de SDK wilt installeren in PowerShell Core of Windows PowerShell, voert u deze opdracht uit:

Install-Module Microsoft.Graph -Scope CurrentUser

Wijzig desgewenst het bereik van de installatie met behulp van de parameter -Scope. Hiervoor zijn beheerdersmachtigingen vereist.

Install-Module Microsoft.Graph -Scope AllUsers

Voer deze opdracht uit om de bètamodule te installeren.

Install-Module Microsoft.Graph.Beta

Mogelijk ontvangt u een prompt dat u de module installeert vanuit een niet-vertrouwde opslagplaats. Dit gebeurt als u de opslagplaats PSGallery eerder niet hebt ingesteld als een vertrouwde opslagplaats. Druk Y om de module te installeren.

Test-e-mailaccounts ophalen

U hebt twee of meer test-e-mailaccounts nodig om de uitnodigingen naar te verzenden. De accounts moeten van buiten uw organisatie zijn. U kunt elk type account gebruiken, inclusief sociale accounts, zoals gmail.com of outlook.com adressen.

Het CSV-bestand voorbereiden

Maak in Microsoft Excel een CSV-bestand met de lijst met genodigde gebruikersnamen en e-mailadressen. Vergeet niet de kolomkoppen Naam en InvitedUserEmailAddress op te nemen.

Maak bijvoorbeeld een werkblad in de volgende indeling:

Sla het bestand op als C:\BulkInvite\Invitations.csv.

Wanneer u geen Excel hebt, kunt u een CSV-bestand maken in een teksteditor, zoals Kladblok. Scheid de waarden met een komma, en plaats elke rij op een nieuwe regel.

Aanmelden bij uw tenant

Voer de volgende opdracht uit om verbinding te maken met de tenant:

Connect-MgGraph -TenantId "<YOUR_TENANT_ID>"

Bijvoorbeeld: Connect-MgGraph -TenantId "aaaabbbb-0000-cccc-1111-dddd2222eeee". U kunt ook het tenantdomein gebruiken, maar de parameter blijft de -TenantId. Bijvoorbeeld: Connect-MgGraph -TenantId "contoso.onmicrosoft.com".

Voer uw inloggegevens in wanneer dit gevraagd wordt.

Bulk-uitnodigingen verzenden

Als u de uitnodigingen wilt verzenden, voert u het volgende PowerShell-script uit (waarbij * * c:\bulkinvite\invitations.csv het pad van het CSV-bestand is):

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

Het script verzendt een uitnodiging naar de e-mailadressen in het bestand invitations.csv. De uitvoer ziet er ongeveer als volgt uit voor elke gebruiker:

Controleer of de gebruikers bestaan in de map

Voer de volgende opdracht uit om te controleren of de uitgenodigde gebruikers zijn toegevoegd aan Microsoft Entra ID:

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

U moet nu de uitgenodigde gebruikers zien met een user principal name (UPN) in de indeling e-mailadres#EXT #@domein. Bijvoorbeeld msullivan_fabrikam.com#EXT#@contoso.onmicrosoft.com, waar contoso.onmicrosoft.com is de organisatie van waaruit u de uitnodigingen hebt verzonden.

Hulpbronnen opruimen

Wanneer u de test-gebruikersaccounts niet meer nodig hebt, kunt u deze uit de map verwijderen. Voer de volgende opdracht uit om een gebruikersaccount te verwijderen:

 Remove-MgUser -UserId "<String>"

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

Gerelateerde inhoud

In deze zelfstudie hebt u bulk-uitnodigingen naar gastgebruikers buiten uw organisatie verzonden. Leer vervolgens hoe u gastgebruikers bulksgewijs kunt uitnodigen in de portal en hoe u MFA voor hen afdwingt.

• Gastgebruikers in bulk uitnodigen via het portaal