Tutorial: Convidar em massa usuários de colaboração B2B do Microsoft Entra

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. 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:

  • Usar o convite em massa para preparar um arquivo de valores separados por vírgulas (.csv) com as informações do usuário e as preferências de convite
  • Carregue o arquivo .csv para o Microsoft Entra ID
  • Verificar se os utilizadores foram adicionados ao diretório

Pré-requisitos

  • Se você não tiver o Microsoft Entra ID, crie uma conta gratuita antes de começar.
  • Precisa de duas ou mais contas de e-mail de teste para as quais possa enviar os convites. As contas têm de ser externas à sua organização. Pode utilizar qualquer tipo de conta, incluindo contas sociais como os endereços do gmail.com ou outlook.com.

Convide usuários convidados em massa

Gorjeta

As etapas neste artigo podem variar ligeiramente com base no portal a partir do qual você começou.

  1. Entre no centro de administração do Microsoft Entra como pelo menos um Administrador de Usuário.

  2. Navegue até Identidade>de todos os usuários.>

  3. Selecione Operações>em massa Convite em massa.

    Screenshot of the bulk invite button.

  4. Na página Convidar usuários em massa, selecione Download para obter um modelo de .csv válido com propriedades de convite.

    Screenshot of the download the csv file button.

  5. Abra o modelo .csv e adicione uma linha para cada usuário convidado. Os valores exigidos são:

    • Endereço de e-mail para convidar - 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. Se quiser encaminhar o usuário para a página Meus Aplicativos, altere esse valor para https://myapps.microsoft.com ou https://myapplications.microsoft.com.

    Screenshot of the example csv file with guest users entered.

    Nota

    Não use vírgulas na mensagem de convite personalizada porque elas impedirão que a mensagem seja analisada com êxito.

  6. Guarde o ficheiro.

  7. Na página Convidar usuários em massa, em Carregar seu arquivo csv, navegue até o arquivo. Quando você seleciona o arquivo, a validação do arquivo .csv é iniciada.

  8. Quando o conteúdo do arquivo for validado, você verá Arquivo carregado com êxito. Se houver erros, tem de os corrigir antes de poder submeter o trabalho.

  9. Quando o arquivo passar na validação, selecione Enviar para iniciar a operação em massa do Azure que adiciona os convites.

  10. Para visualizar o status do trabalho, selecione Clique aqui para visualizar o status de cada operação. Ou, você pode selecionar Resultados da operação em massa na seção Atividade . Para obter detalhes sobre cada item de linha dentro da operação em massa, selecione os valores nas colunas # Sucesso, # Falha ou Total de Solicitações . Se ocorrerem falhas, as razões para a falha serão listadas.

    Screenshot of the bulk operation results.

  11. Quando o trabalho for concluído, você verá uma notificação de que a operação em massa foi bem-sucedida.

Compreender o modelo CSV

Baixe e preencha o modelo CSV de upload em massa para ajudá-lo a convidar usuários convidados do Microsoft Entra em massa. O modelo CSV baixado pode ser semelhante a este exemplo:

Spreadsheet for upload and call-outs explaining the purpose and values for each row and column

Estrutura do modelo CSV

As linhas em um modelo CSV baixado são as seguintes:

  • Número da versão: A primeira linha que contém o número da 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 no modelo uma linha de exemplos de valores para cada coluna. Você deve remover a linha de exemplos e substituí-la por suas próprias entradas.

Orientações adicionais

  • As duas primeiras linhas do modelo de carregamento não devem ser removidas ou modificadas, ou o carregamento não pode ser processado.
  • As colunas necessárias são listadas primeiro.
  • Não recomendamos adicionar novas colunas ao modelo. Todas as colunas adicionadas são ignoradas e não processadas.
  • Recomendamos que você baixe a versão mais recente do modelo CSV sempre que possível.

Verificar usuários convidados no diretório

Verifique se os usuários convidados adicionados 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

  1. Entre no centro de administração do Microsoft Entra como pelo menos um Administrador de Usuário.
  2. Navegue até Identidade>de usuários Todos os usuários.>
  3. Em Mostrar, selecione Somente usuários convidados e verifique se os usuários adicionados estão listados.

Exibir usuários convidados com o PowerShell

Para exibir usuários convidados com o PowerShell, você precisará do Microsoft.Graph.Users módulo PowerShell. Em seguida, entre usando o Connect-MgGraph comando com uma conta de administrador para consentir com os escopos necessários:

Connect-MgGraph -Scopes "User.Read.All"

Execute o seguinte comando:

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

Deverá ver os utilizadores que convidou listados, com um nome principal de utilizador (UPN) no formato endereçoe-mail#EXT#@dominio. Por exemplo, lstokes_fabrikam.com#EXT#@contoso.onmicrosoft.com, onde contoso.onmicrosoft.com é a organização da qual você enviou os convites.

Clean up resources (Limpar recursos)

Quando não for mais necessário, você poderá excluir as contas de usuário de teste no diretório no portal do Azure na página Usuários marcando a caixa de seleção ao lado do usuário convidado e selecionando Excluir.

Ou você pode executar 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"

Próximos passos