Tutorial: usar o PowerShell para convidar em massa os usuários de colaboração B2B do Microsoft Entra massa

Aplica-se a: Locatários da força de trabalho (saiba mais)

Se você usar a colaboração do Microsoft Entra B2B para trabalhar com parceiros externos, poderá convidar vários usuários convidados para sua organização ao mesmo tempo por meio do portal ou do PowerShell. Neste tutorial, você aprenderá a usar o PowerShell para enviar convites em massa para usuários externos. Especificamente, faça o seguinte:

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Pré-requisitos

Instale o módulo mais recente de PowerShell do Microsoft Graph

Instale a versão mais recente do módulo do Microsoft Graph PowerShell.

Primeiro, verifique quais módulos estão instalados. Abra o PowerShell como um usuário com privilégios elevados (execute como administrador) e execute o seguinte comando:

Get-InstalledModule Microsoft.Graph

Para instalar o módulo v1 do SDK no PowerShell Core ou no Windows PowerShell, execute este comando:

Install-Module Microsoft.Graph -Scope CurrentUser

Opcionalmente, altere o escopo da instalação usando o -Scope parâmetro. Isso requer permissões de administrador.

Install-Module Microsoft.Graph -Scope AllUsers

Para instalar o módulo beta, execute este comando.

Install-Module Microsoft.Graph.Beta

Você pode receber um prompt informando que está instalando o módulo de um repositório não confiável. Isso ocorrerá se você não tiver definido o repositório PSGallery como confiável anteriormente. Pressione Y para instalar o módulo.

Obter contas de email de teste

Você precisa de duas ou mais contas de email de teste para as quais enviar os convites. As contas precisam estar fora da organização. É possível usar qualquer tipo de conta, incluindo contas sociais, como endereços gmail.com ou outlook.com.

Preparar o arquivo CSV

No Microsoft Excel, crie um arquivo CSV com a lista de nomes de usuário convidados e endereços de email. Não se esqueça de incluir os títulos de coluna Name e InvitedUserEmailAddress.

Por exemplo, crie uma planilha no seguinte formato:

Salve o arquivo como C:\BulkInvite\Invitations.csv.

Se você não tiver o Excel, crie um arquivo CSV em qualquer editor de texto, como o Bloco de Notas. Separe cada valor com uma vírgula e cada linha com uma nova linha.

Entrar no locatário

Execute o seguinte comando para se conectar ao locatário:

Connect-MgGraph -TenantId "<YOUR_TENANT_ID>"

Por exemplo, Connect-MgGraph -TenantId "aaaabbbb-0000-cccc-1111-dddd2222eeee". Você também pode usar o domínio do locatário, mas o parâmetro permanece -TenantId. Por exemplo, Connect-MgGraph -TenantId "contoso.onmicrosoft.com".

Insira suas credenciais quando solicitado.

Enviar convites em massa

Para enviar os convites, execute o seguinte script do PowerShell (em que * * c:\bulkinvite\invitations.csv é o caminho do arquivo CSV):

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

O script envia um convite para os endereços de email no arquivo invitations.csv . Você vê uma saída semelhante à seguinte para cada usuário:

Verificar se os usuários existem no diretório

Para verificar se os usuários convidados foram adicionados ao Microsoft Entra ID, execute o seguinte comando:

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

Os usuários convidados precisam aparecer na lista com um nome UPN no formato endereçodeemail#EXT#@domínio. Por exemplo, msullivan_fabrikam.com#EXT#@contoso.onmicrosoft.com, em que contoso.onmicrosoft.com é a organização da qual você enviou os convites.

Limpar os recursos

Será possível excluir as contas de usuário de teste no diretório quando elas não forem mais necessárias. Execute o comando a seguir para excluir uma conta de usuário:

 Remove-MgUser -UserId "<String>"

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

Conteúdo relacionado

Neste tutorial, você enviou convites em massa para usuários convidados fora da sua organização. Em seguida, saiba como convidar usuários convidados em massa para o portal e como aplicar a MFA para eles.

• Convidar usuários convidados em massa por meio do portal