Como utilizar o Csvde para importar contactos e objectos do utilizador para o Active Directory

Este artigo passo a passo descreve como usar o utilitário Csvde.exe para criar contactos e contas de utilizador no Active Directory. Poderá necessitar de utilizar este método em alguns cenários, por exemplo, quando os administradores pretendam exportar destinatários personalizados do Microsoft Exchange Server 5.5 e importá-los para o Active Directory como contactos do Microsoft Windows.

O Csvde.exe é um utilitário da linha de comandos do Microsoft Windows 2000 localizado na pasta SystemRoot\System32 depois de instalar o Windows 2000. O Csvde.exe é semelhante ao Ldifde.exe, mas extrai informações num formato de valores separados por vírgulas (CSV, comma-separated value). Pode utilizar o Csvde para importar e exportar dados do Active Directory que utilizem o formato de valores separados por vírgulas. Utilize um programa de folhas de cálculo, como o Microsoft Excel, para abrir este ficheiro .csv e visualizar as informações de cabeçalhos e valores. Consulte a ajuda do Microsoft Excel para obter informações sobre funções, como Concatenar, que podem simplificar o processo de criação de um ficheiro .csv.

Nota: embora o Csvde seja semelhante ao Ldifde, o Csvde tem uma limitação significativa: só consegue importar e exportar dados do Active Directory utilizando um formato de valores separados por vírgulas (.csv). A Microsoft recomenda que use o utilitário Ldifde para operações de modificação ou eliminação. Além disso, o nome distinto (também conhecido como DN) do item que está a tentar importar deverá ser apresentado na primeira coluna do ficheiro .csv ou a importação não funcionará.

O ficheiro .csv de origem pode resultar de uma exportação de directório do Exchange Server. No entanto, devido à diferença de mapeamentos de atributos entre o directório do Exchange Server e o Active Directory, deverá efectuar algumas modificações no ficheiro .csv. Por exemplo, uma exportação de directório do Exchange Server tem uma coluna com o nome "obj-class" que o utilizador deverá alterar para "objectClass". Deverá também alterar o nome "Display Name" para "displayName".

Para obter mais informações sobre mapeamentos de atributos, clique no número de artigo que se segue para visualizar o artigo na base de dados de conhecimento da Microsoft (KB, Microsoft Knowledge Base): Utilize a seguinte sintaxe para executar a ferramenta a partir de uma linha de comandos: Neste artigo estão listados os atributos mínimos necessários para cada tipo de objecto que poderá pretender criar e são fornecidos cabeçalhos de ficheiros .csv de exemplo. Note que os atributos mínimos necessários para uma organização poderão não satisfazer os requisitos de utilização de outra organização. Utilize o ADSI Edit ou o Ldp.exe para visualizar os atributos de utilizadores existentes e para verificar os atributos que poderá necessitar ou pretender para o seu cenário.

Aviso: se utilizar o snap-in ADSI Edit, o utilitário LDP ou qualquer outro cliente LDAP versão 3 e modificar de forma incorrecta os atributos de objectos do Active Directory, poderá provocar problemas graves. Estes problemas poderão forçar a reinstalação do Microsoft Windows 2000 Server, Microsoft Windows Server 2003, Microsoft Exchange 2000 Server, Microsoft Exchange Server 2003 ou de ambos (Windows e Exchange). A Microsoft não garante que os problemas resultantes da modificação incorrecta dos atributos de objectos do Active Directory possam ser resolvidos. Todo e qualquer risco decorrente da modificação destes atributos é da responsabilidade do utilizador.

Contacto do Windows 2000 sem endereço de correio electrónico

A lista existente nesta secção descreve os atributos mínimos necessários para um contacto do Windows 2000 sem endereço de correio electrónico. Pode requerer mais atributos para satisfazer as suas necessidades. Por exemplo, pode adicionar facilmente o atributo telephoneNumber ao ficheiro .csv.

• objectClass. Este atributo especifica o tipo de objecto criado.
• DN (nome distinto). Este atributo especifica o nome distinto do novo objecto do utilizador.
• displayName. O atributo displayName contém o nome do objecto tal como aparece na lista global de endereços e em outras listas de endereços das quais o objecto é membro.

Estes atributos necessários deverão ser cabeçalhos de colunas no ficheiro .csv como apresentado no seguinte exemplo.



Note que nome distinto do objecto do utilizador nesta tabela inclui o nome do objecto que está a ser criado, juntamente com o nome distinto da unidade organizacional (OU) na qual este objecto deverá ser criado.

Por exemplo, para criar um contacto com o nome MailDisabledContact numa unidade organizacional, o valor seria semelhante ao valor que se segue:

cn=MailDisabledContact,OU=OU nome,DC=Nome_domínio,DC=com

Isto também se aplica a todas as outras importações descritas abaixo neste artigo.

Utilizador do Windows 2000, sem caixa de correio ou endereço de correio electrónico

A lista existente nesta secção descreve os atributos mínimos necessários para um utilizador do Windows 2000 sem caixa de correio ou endereço de correio electrónico.

• objectClass. O atributo objectClass especifica o tipo de objecto criado.
• DN (nome distinto). Este atributo especifica o nome distinto do novo objecto do utilizador.
• displayName. O atributo displayName contém o nome do objecto tal como aparece na lista global de endereços e em outras listas de endereços das quais o objecto é membro.
• sAMAccountName. Este atributo é mapeado para Nome de início de sessão (anterior ao Windows 2000) na interface de utilizador e é normalmente o mesmo que o Nome de início de sessão do utilizador.
• userAccountControl. Defina o valor deste atributo como 512.

Estes atributos necessários deverão ser cabeçalhos de colunas no ficheiro .csv como apresentado no seguinte exemplo.

Resolução de problemas

De um modo geral, o utilitário Csvde fornece indicações claras do que não é aceitável no ficheiro .csv. Por exemplo, não pode utilizar o Csvde para duplicar determinados atributos se os mesmos já existirem no Active Directory. Se tentar efectuar este procedimento, receberá a seguinte mensagem: Se um atributo necessário estiver em falta no ficheiro .csv, receberá a seguinte mensagem: O Csvde não regista eventos no registo de eventos de aplicações. Para resolver problemas relacionados com o Csvde deverá visualizar o resultado da linha de comandos e utilizar o LDP ou o ADSI Edit para comparar o ficheiro com os atributos de objectos do utilizador existentes. Não modifique objectos no Active Directory sem primeiro testar o processo de forma exaustiva num ambiente de teste.

Para obter mais informações, clique nos números de artigo que se seguem para visualizar os artigos na base de dados de conhecimento da Microsoft (KB, Microsoft Knowledge Base):