Tutorial: convidar usuários de colaboração B2B do Microsoft Entra em massa
Se você usar a colaboração B2B do Microsoft Entra para trabalhar com parceiros externos, poderá convidar vários usuários convidados para a sua organização ao mesmo tempo. Neste tutorial, você aprenderá a usar o centro de administração do Microsoft Entra para enviar convites em massa para usuários externos. Especificamente, você seguirá estas etapas:
- Use Convidar usuários em massa para preparar um arquivo de valores separados por vírgula (.csv) com as informações do usuário e as preferências do convite
- Carregar o arquivo .csv no Microsoft Entra ID
- Verifique se os usuários foram adicionados ao diretório
Pré-requisitos
- Caso não tenha uma assinatura do Microsoft Entra ID, crie uma conta gratuita antes de começar.
- É necessário ter duas ou mais contas de email de teste para enviar o convite. 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.
Convidar usuários convidados em massa
Dica
As etapas neste artigo podem variar ligeiramente com base no portal do qual você começa.
Entre no centro de administração do Microsoft Entra como, no mínimo, Administrador de Usuários.
Navegue até Identidade>Usuários>Todos os usuários.
Selecione Operações em massa>Convite em massa.
Na página Convidar usuários em massa, selecione Baixar para obter um modelo .csv válido com as propriedades do convite.
Abra o modelo .csv e adicione uma linha para cada usuário convidado. Os valores obrigatórios são:
Endereço de email a ser convidado – o usuário que receberá um convite
URL de redirecionamento – a URL para a qual o usuário convidado é encaminhado depois de aceitar o convite. Caso queira encaminhar o usuário à página Meus Aplicativos, será necessário alterar esse valor para https://myapps.microsoft.com ou https://myapplications.microsoft.com.
Observação
Não use vírgulas na Mensagem de convite personalizada, porque elas impedirão que a mensagem seja analisada com êxito.
Salve o arquivo.
Na página Convidar usuários em massa, em Carregar o arquivo CSV, procure o arquivo. Quando você selecionar o arquivo, a validação do arquivo .csv será iniciada.
Quando o conteúdo do arquivo for validado, você verá a mensagem Arquivo carregado com êxito. Se houver erros, você precisará corrigi-los antes de enviar o trabalho.
Quando o arquivo passar na validação, selecione Enviar para iniciar a operação em massa do Azure que adiciona os convites.
Para exibir o status do trabalho, selecione Clique aqui para exibir o status de cada operação. Se preferir, selecione Resultados da operação em massa na seção Atividade. Para obter detalhes de cada item de linha na operação em massa, escolha os valores nas colunas Nº de Êxitos, Nº de Falhas ou Total de Solicitações. Se ocorrerem falhas, os motivos da falha serão listados.
Quando o trabalho for concluído, você verá uma notificação indicando que a operação em massa foi bem-sucedida.
Entender o modelo CSV
Baixe e preencha o modelo CSV de upload em massa para ajudar você a convidar usuários convidados do Microsoft Entra em massa com êxito. O modelo CSV que você baixa pode ser semelhante a este exemplo:
Estrutura do modelo CSV
As linhas em um modelo CSV baixado são as seguintes:
- Número de versão: A primeira linha que contém o número de versão deve ser incluída no CSV de carregamento.
- Cabeçalhos de coluna: O formato dos cabeçalhos de coluna é <Nome do item> [PropertyName]<Obrigatório ou em branco>. Por exemplo,
Email address to invite [inviteeEmail] Required. Algumas versões mais antigas do modelo podem ter pequenas variações. - Linha de exemplos: incluímos uma linha de exemplos de valores para cada coluna no modelo. Você deve remover a linha de exemplos e substituí-la por suas entradas.
Diretriz adicional
- As duas primeiras linhas do modelo de carregamento não devem ser removidas nem modificadas ou o carregamento não poderá ser processado.
- As colunas necessárias são listadas primeiro.
- Não recomendamos adicionar novas colunas ao modelo. Todas as colunas extras adicionadas são ignoradas e não são processadas.
- Recomendamos que você baixe a versão mais recente do modelo CSV sempre que possível.
Verificar os usuários convidados no diretório
Verifique se os usuários convidados que você adicionou existem no diretório no centro de administração do Microsoft Entra ou usando o PowerShell.
Exibir usuários convidados no centro de administração do Microsoft Entra
- Entre no centro de administração do Microsoft Entra como, no mínimo, Administrador de Usuários.
- Navegue até Identidade>Usuários>Todos os usuários.
- Em Mostrar, selecione Somente usuários convidados e verifique se os usuários adicionados estão listados.
Exibir os usuários convidados com o PowerShell
Para exibir usuários convidados no PowerShell, você precisa do Microsoft.Graph.Usersmódulo do PowerShell. Em seguida, entre usando o comando Connect-MgGraph com uma conta de administrador para consentir os escopos necessários:
Connect-MgGraph -Scopes "User.Read.All"
Execute o comando a seguir:
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, lstokes_fabrikam.com#EXT#@contoso.onmicrosoft.com, em que contoso.onmicrosoft.com é a organização da qual você enviou os convites.
Limpar os recursos
Quando as contas de usuário de teste não forem mais necessárias, você poderá excluí-las do diretório no portal do Azure na página Usuários marcando a caixa de seleção ao lado do usuário convidado e, em seguida, selecionando Excluir.
Se preferir, execute o seguinte comando do PowerShell para excluir uma conta de usuário:
Remove-MgUser -UserId "<UPN>"
Por exemplo: Remove-MgUser -UserId "lstokes_fabrikam.com#EXT#@contoso.onmicrosoft.com"