Adicionar membros do grupo em massa no Microsoft Entra ID

Descrição geral

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 ao grupo Microsoft Entra. Usa o modelo que descarregas para a operação de importação de membros do grupo. O modelo atual de membros do grupo começa com o cabeçalho de coluna, e não com uma linha version:v1.0.

Estrutura do modelo CSV

As linhas em um modelo CSV baixado são:

• Cabeçalhos das colunas: Mantenha o cabeçalho completo da coluna transferida exatamente como está. O nome da propriedade entre parênteses é apenas uma parte do cabeçalho, por isso não substitua o cabeçalho completo por apenas memberObjectIdOrUpn. O cabeçalho atual de importação do membro do grupo é Member object ID or user principal name [memberObjectIdOrUpn] Required. Para alterações na pertença ao grupo, pode usar o ID do objeto membro ou o nome principal do utilizador (UPN) nas linhas sob este cabeçalho.
• Linha de exemplos: Se o template incluir uma linha de valores de exemplo, como Example: 9832aad8-e4fe-496b-a604-95c6eF01ae75, remove a linha de exemplos e substitui-a pelas tuas próprias entradas.

Mais orientações

• Mantenha qualquer linha de versão e linha de cabeçalho de coluna no modelo de carregamento exatamente como foi descarregado, caso contrário, 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 adicionais adicionadas são ignoradas e nã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 utilizadores para carregar o ficheiro com sucesso.
• Introduza um membro por linha. Não uses pontos e vírgulas ou outros delimitadores para separar vários elementos numa única linha.

Exemplo de arquivo CSV

Aqui está um exemplo de um ficheiro CSV concluído pronto para upload, que corresponde ao formato atual de modelo de importação de membro do grupo. Este exemplo utiliza nomes principais de utilizador (UPNs):

Member object ID or user principal name [memberObjectIdOrUpn] Required
alain@contoso.com
isabella@contoso.com
joseph@contoso.com
chaya@contoso.com

Alternativamente, pode usar IDs de objetos em vez de UPNs:

Member object ID or user principal name [memberObjectIdOrUpn] Required
00aa00aa-bb11-cc22-dd33-44ee44ee44ee
11bb11bb-cc22-dd33-ee44-55ff55ff55ff
22cc22cc-dd33-ee44-ff55-66aa66aa66aa

Membros do grupo de importação em massa

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

2. Navegue até Identidade.

   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 lote e depois escolha Importar membros.

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

   

7. Abra o arquivo CSV e adicione uma linha para cada membro do grupo que você deseja importar para o grupo. Para cada membro, introduza o seu nome principal de utilizador (UPN, como user@contoso.com) ou o seu ID de Objeto (um GUID como aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb). Introduza um membro por linha. Em seguida, guarde o ficheiro.

8. Na página Importação em massa de membros do grupo, em Carregue o seu arquivo CSV, navegue até ao ficheiro. 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 encontrar erros, pode transferir e visualizar o ficheiro de resultados na página de 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

Pode ver o estado de todos os seus pedidos em massa pendentes na página de resultados da operação em massa .

1. Navegue para Identidade>Utilizadores>Resultados de operações em massa.

2. Encontre a sua operação a granel na lista. A coluna Estado mostra se a operação está em Progresso, Bem-sucedida ou Falhada.

   

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.

Descarregue o ficheiro de resultados

Para descarregar resultados detalhados:

1. Na página de resultados de operações em bloco , selecione a operação que pretende rever.
2. Selecione Download para obter um ficheiro CSV com o estado de cada linha do seu upload original.
3. Abra o ficheiro CSV para ver quais membros foram adicionados com sucesso e quais falharam, juntamente com mensagens de erro específicas.

Os erros comuns incluem:

• Membro não encontrado: O UPN ou ID do objeto não existe no seu diretório.
• O membro já existe: O utilizador já é membro do grupo.
• Formato inválido: O formato UPN ou ID do objeto está incorreto.

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

Próximos passos

• Remover membros do grupo em massa
• Baixar membros de um grupo
• Descarregue uma lista de todos os grupos