DEV Community

Eduardo Silva
Eduardo Silva

Posted on

ManageEngine ADManager Plus: criando centenas de usuários no AD em minutos (sem PowerShell)

ManageEngine ADManager Plus: criando centenas de usuários no Active Directory em minutos (sem PowerShell)

Se você já passou uma tarde inteira criando usuário por usuário no Active Directory Users and Computers durante um processo de admissão em massa, sabe o quanto isso consome tempo e abre espaço para erro humano. O ManageEngine ADManager Plus resolve esse problema com um recurso simples e poderoso: criação de usuários em lote a partir de um arquivo CSV, com templates reutilizáveis e sem precisar escrever uma linha de script.[1]

Neste artigo, vou mostrar o passo a passo prático para configurar e executar esse processo, incluindo os cuidados que fazem a diferença entre um import bem-sucedido e uma lista de erros no fim da importação.

Por que usar o import via CSV em vez de PowerShell ou criação manual

A criação manual não escala: é lenta e sujeita a inconsistência (um analista preenche o campo "Departamento" diferente do outro, esquece de adicionar o usuário ao grupo de distribuição correto, etc.). Scripts PowerShell resolvem a escala, mas exigem manutenção de código, tratamento de erros e, geralmente, ficam nas mãos de quem escreveu o script.

O ADManager Plus ataca os dois problemas ao mesmo tempo: a importação em massa via CSV elimina a necessidade de scripting, e os templates de criação de usuário padronizam atributos, senha inicial, pertencimento a grupos e horários de logon para todos os usuários criados a partir daquele template.[1][2]

Pré-requisitos

Antes de importar, garanta que:

  • Você está logado no ADManager Plus como administrador ou como técnico de helpdesk com permissão delegada para criar contas de usuário.[1]
  • Existe (ou foi criado antecipadamente) um template de criação de usuário com os atributos padrão desejados — senha, grupos, unidade organizacional padrão, etc.
  • O arquivo CSV está formatado corretamente: a primeira linha contém os nomes LDAP dos atributos, e cada linha seguinte representa um usuário com os valores correspondentes.[1]
  • Os atributos obrigatórios (como givenName e sn) estão presentes em todas as linhas.[1]

Um ponto de segurança importante: evite colocar senhas em texto claro diretamente no CSV. A prática recomendada é configurar a senha no template de criação e referenciar esse template pela coluna templateName no CSV — assim, a senha nunca circula em um arquivo de planilha que pode acabar sendo compartilhado por e-mail ou salvo em um local sem controle de acesso.[1]

Passo a passo

1. Prepare o CSV

Monte a planilha com, no mínimo, as colunas obrigatórias. Um exemplo simples:

sAMAccountName,givenName,sn,userPrincipalName,OUName,templateName
jsilva,Joao,Silva,jsilva@suaempresa.com.br,"OU=TI,DC=suaempresa,DC=com,DC=br",TemplateOnboardingTI
mferreira,Maria,Ferreira,mferreira@suaempresa.com.br,"OU=Financeiro,DC=suaempresa,DC=com,DC=br",TemplateOnboardingFin
Enter fullscreen mode Exit fullscreen mode

Note que o nome da OU de destino pode ser definido linha a linha através da coluna OUName, o que é útil quando o lote de usuários é de departamentos diferentes.[1][3]

2. Acesse o módulo de criação em massa

No console do ADManager Plus, vá em:

Management > User Management > User Creation > Create Bulk Users
Enter fullscreen mode Exit fullscreen mode

(ou, dependendo da versão, Management > User Management > CSV Import > Create Users).[1]

3. Selecione domínio e template

  • Escolha o domínio correto em Select Domain.
  • Escolha o template padrão em Select Template. Esse template populará automaticamente atributos como senha, grupos e horário de logon — mas se o CSV tiver uma coluna templateName preenchida para uma linha específica, ela sobrescreve o template selecionado na tela para aquele usuário.[1]

4. Importe o CSV

Clique em Import, selecione o arquivo e confirme. O sistema carrega as linhas e exibe uma pré-visualização dos registros que serão criados — use esse momento para revisar e, se precisar, clicar no ícone Modify para corrigir algum registro individual antes de seguir.[1]

5. Defina a OU de destino e finalize

Clique em Next, selecione a OU de destino (ou crie uma nova OU diretamente na tela, se necessário) e finalize clicando em Create Users. Se o CSV já trouxer a coluna OUName preenchida, ela tem prioridade para definir onde cada usuário será criado.[1]

Boas práticas que evitam dor de cabeça

  • Valide o CSV antes de importar. Um atributo obrigatório faltando em uma única linha pode derrubar a criação daquele usuário específico — melhor detectar isso antes do import em produção.[1]
  • Teste com um lote pequeno primeiro. Antes de importar 300 linhas de uma vez, rode o processo com 2 ou 3 usuários de teste para validar template, atributos e destino da OU.[1]
  • Padronize com templates, não confie só no CSV. Senha, pertencimento a grupos e horário de logon devem vir do template de criação, não de colunas espalhadas no CSV — isso reduz inconsistência entre lotes diferentes feitos por pessoas diferentes.[1][2]
  • Automatize o processo recorrente. Se a sua empresa recebe novos colaboradores com frequência via integração de RH, o ADManager Plus permite agendar a automação do provisionamento: você define o horário de execução, o caminho onde o CSV é disponibilizado e o template a aplicar, e o sistema dispara a criação sempre que encontra um CSV novo ou atualizado naquele caminho — com ou sem fluxo de aprovação (workflow) no meio do caminho.[2]

Conclusão

A criação de usuários em massa no Active Directory não precisa depender de script PowerShell mantido por uma única pessoa, nem de horas de digitação manual. Com o ADManager Plus, o fluxo CSV + template resolve os dois problemas: padroniza atributos sensíveis (senha, grupos, OU) através do template e acelera o provisionamento através da importação em lote — com a possibilidade de ir além e automatizar completamente o processo para rodadas recorrentes de onboarding.[1][2][3]

Se você já usa ADManager Plus só para tarefas pontuais de helpdesk, vale a pena revisitar esse recurso específico na próxima leva grande de admissões — a diferença de tempo economizado costuma ser enorme.

Sources

[1] https://www.manageengine.com/products/ad-manager/admanager-kb/create-bulk-ad-users-csv.html — Create AD Users from a CSV File - ADManager Plus KB
[2] https://www.manageengine.com/products/ad-manager/active-directory-management-automation/automated-active-directory-user-creation-provisioning.html — Automate User Creation in Active Directory - ADManager Plus
[3] https://www.manageengine.com/products/ad-manager/help/csv-import-management/active-directory-user-creation-csv.html — Bulk User Creation in Active Directory by CSV Import

Top comments (0)