Partilhar via

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

  • Artigo

Aplica-se a:Círculo verde com um símbolo de marca de verificação branco. Locatários da força deCírculo branco com um símbolo X cinzento. trabalho Locatários externos (saiba mais)

Se você usar a colaboração B2B do Microsoft Entra 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, você faz o seguinte:

  • Preparar um arquivo de valores separados por vírgulas (.csv) com as informações do usuário
  • Executar um script do PowerShell para enviar convites
  • Verifique se os usuários foram adicionados ao diretório

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

Pré-requisitos

Instalar o módulo mais recente do Microsoft Graph PowerShell

Certifique-se de instalar a versão mais recente do módulo PowerShell do Microsoft Graph.

Primeiro, verifique quais módulos você instalou. Abra o PowerShell como um usuário elevado (Executar 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 o seguinte comando:

Install-Module Microsoft.Graph -Scope CurrentUser

Opcionalmente, você pode alterar 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 o seguinte 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 ocorre se você não tiver definido anteriormente o repositório PSGallery como um repositório confiável. Pressione Y para instalar o módulo.

Obter contas de e-mail de teste

Você precisa de duas ou mais contas de e-mail de teste para as quais possa enviar os convites. As contas devem ser de fora da sua organização. Você pode usar qualquer tipo de conta, incluindo contas sociais, como gmail.com ou outlook.com endereços.

Preparar o arquivo CSV

No Microsoft Excel, crie um arquivo CSV com a lista de nomes de usuário e endereços de email convidados. Certifique-se de incluir os cabeçalhos das colunas Name e InvitedUserEmailAddress .

Por exemplo, crie uma planilha no seguinte formato:

Captura de tela que mostra as colunas do arquivo csv de Name e InvitedUserEmailAddress.

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

Se você não tiver o Excel, poderá criar 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.

Iniciar sessão no seu inquilino

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 continua sendo o -TenantId. Por exemplo, Connect-MgGraph -TenantId "contoso.onmicrosoft.com".

Quando solicitado, insira suas credenciais.

Enviar convites em massa

Para enviar os convites, execute o seguinte script do PowerShell (onde 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 e-mail no arquivo Invitations.csv. Você deve ver uma saída semelhante à seguinte para cada usuário:

Captura de tela que mostra a saída do PowerShell que inclui aceitação pendente do 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'"

Você deve ver os usuários que você convidou listados, com um nome principal de usuário (UPN) no formato emailaddress#EXT#@domain. Por exemplo, msullivan_fabrikam.com#EXT#@contoso.onmicrosoft.com, onde contoso.onmicrosoft.com é a organização da qual você enviou os convites.

Limpar recursos

Quando não for mais necessário, você poderá excluir as contas de usuário de teste no diretório. Execute o seguinte comando 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 no portal e como aplicar a MFA para eles.