Partilhar via


Adicionar membros do grupo em massa no Microsoft Entra ID

Você pode adicionar vários membros a um grupo usando um arquivo CSV (valores separados por vírgula) para importar em massa membros do grupo no portal para ID do Microsoft Entra.

Compreender o modelo CSV

Transfira e preencha o modelo CSV de carregamento em massa para adicionar com êxito membros do grupo Microsoft Entra em massa. Seu modelo CSV pode se parecer com este exemplo:

Captura de tela que mostra a planilha para upload e textos explicativos explicando a finalidade e os valores de cada linha e coluna.

Estrutura do modelo CSV

As linhas em um modelo CSV baixado são:

  • 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.> Um exemplo é Member object ID or user principal name [memberObjectIdOrUpn] Required. Algumas versões mais antigas do modelo podem ter pequenas variações. Para alterações de associação de grupo, você pode escolher o ID do objeto membro ou o nome principal do usuário.
  • Linha de exemplos: o modelo inclui uma linha de exemplos de valores aceitáveis para cada coluna. Você deve remover a linha de exemplos e substituí-la por suas próprias entradas.

Mais orientações

  • 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 outras colunas 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.
  • Adicione pelo menos dois UPNs ou IDs de objeto de dois usuários para carregar o arquivo com êxito.

Membros do grupo de importação 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 Grupos.

  2. Selecione Microsoft Entra ID.

    Nota

    Os proprietários de grupos também podem importar em massa membros de grupos de sua propriedade.

  3. Selecione Grupos>Todos os grupos.

  4. Abra o grupo ao qual está a adicionar membros e, em seguida, selecione Membros.

  5. Na página Membros, selecione operações em massa e, em seguida, escolha Importar membros.

  6. Na página Importar membros do grupo em massa, selecione Download para obter o modelo de arquivo CSV com as propriedades de membro do grupo necessárias.

    Captura de tela que mostra que o comando Importar Membros está na página de perfil do grupo.

  7. Abra o arquivo CSV e adicione uma linha para cada membro do grupo que você deseja importar para o grupo. Os valores necessários são ID do objeto Membro ou Nome principal do usuário. Em seguida, guarde o ficheiro.

    Captura de tela que mostra que o arquivo CSV contém nomes e IDs dos membros a serem importados.

  8. Na página Membros do grupo de importação em massa, em Carregar seu arquivo csv, navegue até o arquivo. Quando você seleciona o arquivo, a validação do arquivo CSV é iniciada.

  9. Quando o conteúdo do arquivo é validado, a página de importação em massa exibe Arquivo carregado com êxito. Se houver erros, tem de os corrigir antes de poder submeter o trabalho.

  10. Quando o arquivo passar na validação, selecione Enviar para iniciar a operação em massa que importa os membros do grupo para o grupo.

  11. Quando a operação de importação é concluída, uma notificação indica que a operação em massa foi bem-sucedida.

Se você tiver erros, poderá baixar e exibir o arquivo de resultados na página Resultados da operação em massa. O ficheiro contém o motivo de cada erro. O envio do arquivo deve corresponder ao modelo fornecido e incluir os nomes exatos das colunas. Para obter mais informações sobre limitações de operações em massa, consulte Limites de serviço de importação em massa.

Verificar o status da importação

Você pode ver o status de todas as suas solicitações em massa pendentes na página Resultados da operação em massa.

Captura de tela que mostra a opção Verificar status na página Resultados da operação em massa.

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 são listadas.

Limites do serviço de importação em massa

Nota

Ao executar operações em massa, como importar ou criar, você pode encontrar um problema se a operação em massa não for concluída dentro de uma hora. Para contornar esse problema, recomendamos dividir o número de registros processados por lote. Por exemplo, antes de iniciar uma exportação, você pode limitar o conjunto de resultados filtrando um tipo de grupo ou nome de usuário para reduzir o tamanho dos resultados. Ao refinar seus filtros, essencialmente você está limitando os dados retornados pela operação em massa. Para obter mais informações, consulte Limitações do serviço de operações em massa.

Próximos passos