Guía detallada de importación y exportación masiva en Active Directory

Esta guía presenta la administración por lotes del servicio Active Directory^® mediante la utilidad Formato de intercambio de datos LDAP (Protocolo ligero de acceso a directorios) (LDIF) y varios programas de ejemplo que puede escribir con el sistema de desarrollo de Microsoft Visual Basic^® Scripting Edition (VBScript).

En esta página

	Introducción
	Introducción
	Usar VBScript y ADSI
	Apéndice: Usar LDIFDE
	Recursos adicionales

Introducción

Guías detalladas

Las guías detalladas de desarrollo de Windows Server 2003 proporcionan experiencia práctica para muchas configuraciones de sistemas operativos. Las guías comienzan estableciendo una infraestructura de red común a través de la instalación de Windows Server 2003, la configuración de Active Directory, la instalación de una estación de trabajo Windows XP Professional y, por último, la incorporación de esta estación de trabajo a un dominio. Las guías detalladas posteriores asumen que posee esta infraestructura de red común. Si no desea seguir esta infraestructura de red común, tendrá que efectuar las modificaciones pertinentes mientras utiliza estas guías.

La infraestructura de red común requiere que se sigan las instrucciones de las guías siguientes.

Una vez configurada la infraestructura de red común, pueden utilizarse todas las guías detalladas adicionales. Tenga en cuenta que algunas guías detalladas pueden tener requisitos previos adicionales además de los requisitos de infraestructura de red común. Todos los requisitos adicionales se indicarán en la guía detallada específica.

Microsoft Virtual PC

Las guías detalladas de desarrollo de Windows Server 2003 se pueden implementar en un entorno de laboratorio físico o mediante tecnologías de creación de entornos virtuales como Microsoft Virtual PC 2004 o Microsoft Virtual Server 2005. La tecnología de máquina virtual permite a los usuarios ejecutar varios sistemas operativos simultáneamente en un único servidor físico. Virtual PC 2004 y Virtual Server 2005 están diseñados para aumentar la eficacia operativa de las pruebas y desarrollo de software, la migración de aplicaciones heredadas y los escenarios de consolidación de servidores.

En las guías detalladas de desarrollo de Windows Server 2003 se asume que todas las configuraciones se realizarán en un entorno de laboratorio físico, aunque la mayoría de ellas se pueden aplicar a un entorno virtual sin necesidad de modificarlas.

La aplicación de los conceptos proporcionados en estas guías detalladas a un entorno virtual se escapa al alcance de este documento.

Notas importantes

Las compañías, organizaciones, productos, nombres de dominio, direcciones de correo electrónico, logotipos, personas, lugares y datos mencionados aquí son ficticios. No se pretende indicar, ni debe deducirse ninguna asociación con compañías, organizaciones, nombres de dominio, direcciones de correo electrónico, logotipos, personas, lugares o datos reales.

Esta infraestructura común está concebida para su uso en una red privada. El nombre ficticio de la compañía y el nombre DNS (Sistema de nombres de dominio) utilizados en la infraestructura común no están registrados para su uso en Internet. No debe utilizar estos nombres en una red pública ni en Internet.

El objetivo de la estructura del servicio Active Directory para esta infraestructura común es mostrar cómo funciona la administración de cambios y configuración de Windows Server 2003 con Active Directory. No se ha diseñado como un modelo para configurar Active Directory en una organización.

Principio de la página

Introducción

Esta guía presenta la administración por lotes del servicio Active Directory mediante la utilidad Formato de intercambio de datos LDAP (LDIF) y un programa simple que puede escribir con el sistema de desarrollo de Visual Basic Scripting Edition (VBScript). Con estas herramientas, puede exportar, importar y modificar objetos como usuarios, contactos, grupos, servidores, impresoras y carpetas compartidas.

En esta guía se realizarán las siguientes tareas.

Requisitos previos

Usar la utilidad Ldifde.exe

La utilidad LDIF es un borrador estándar de Internet para un formato de archivo que se puede utilizar para realizar operaciones por lotes en directorios que cumplen los estándares LDAP. LDIF se puede utilizar para exportar e importar datos y permite realizar operaciones por lotes como Agregar, Modificar y Eliminar en Active Directory. En el sistema operativo Windows Server 2003 se incluye una utilidad llamada Ldifde.exe que proporciona compatibilidad con las operaciones por lotes basadas en el estándar LDIF.

También puede usar la utilidad Ldifde.exe para ampliar el esquema, exportar información de usuarios y grupos de Active Directory a otras aplicaciones o servicios y rellenar Active Directory con datos de otros servicios de directorio.

Nota:  la utilidad Ldifde.exe es el método recomendado para insertar extensiones de esquemas probadas en un entorno de producción.

Exportar objetos

Puede usar la utilidad Ldifde.exe para exportar todos los objetos de la unidad organizativa Mercadotecnia, creada en "Guía detallada de infraestructura común (Parte 1)". En este ejemplo se busca la unidad organizativa de algunos objetos y se crea un archivo con los nombres de esos objetos.

Para exportar objetos mediante LDIF

1.	Inicie sesión como administrador de dominio.
2.	Haga clic en el botón Inicio, seleccione Todos los programas y Accesorios y, a continuación, haga clic en Símbolo del sistema.
3.	En el símbolo del sistema, escriba: ldifde -f marketing.ldf -s hq-con-dc-01 -d "ou=mercadotecnia,ou=cuentas,dc=contoso,dc=com" -p subtree -r  "(objectCategory=CN=Persona,CN=Esquema,CN=Configuración,DC=contoso,DC=com)"
4.	Presione ENTRAR. Los resultados deben ser similares a los que se muestran en la Figura 1. Figura 1.  Exportación de datos de directorio Ver la imagen a tamaño completo El comando anterior crea un archivo LDIF llamado Marketing.ldf mediante la conexión al servidor llamado HQ-CON-DC-01 y la ejecución de una búsqueda en los subárboles de la unidad organizativa Mercadotecnia de todos los objetos de la categoría Persona. El archivo de salida se almacenará en la raíz del directorio Documents and Settings del usuario actual. Nota:  objectCategory es un atributo indizado diseñado para aumentar la velocidad de búsqueda. Puede utilizar este archivo LDIF para realizar una importación por lotes de todos los objetos de la unidad organizativa Mercadotecnia a cualquier otro directorio compatible con LDAP. Puede que algunos atributos no se apliquen a otras implementaciones de LDAP. En concreto, si utiliza este mecanismo para importar los objetos a otro Active Directory, algunos atributos deben omitirse porque se generan automáticamente durante la creación de objetos. (Si no se omiten específicamente, la operación puede producir un error.) Por ejemplo, el comando LDIFDE que se utiliza para omitir estos atributos es idéntico al comando anterior, con la única diferencia de que incorpora el parámetro –m. ldifde -f marketing.ldf -s hq-con-dc-01 -d "ou=mercadotecnia,ou=cuentas,dc=contoso,dc=com" -p subtree -r  "(objectCategory=CN=Persona,CN=Esquema,CN=Configuración,DC=contoso,DC=com)" –m

Modificar objetos

En el siguiente ejemplo, toda la organización Mercadotecnia se ha movido a una nueva dirección de oficina. Se utiliza LDIF para realizar una modificación por lotes de todos los objetos de usuario de la organización Mercadotecnia mediante la modificación de los atributos de provincia, calle, localidad y código postal.

Para modificar objetos mediante LDIF y el Bloc de notas

1.	Haga clic en el botón Inicio, seleccione Todos los programas y Accesorios y, a continuación, haga clic en Símbolo del sistema.
2.	En el símbolo del sistema, escriba los siguiente comandos para extraer las entradas necesarias. ldifde -f marketing.ldf -s hq-con-dc-01 -d "ou=mercadotecnia,ou=cuentas,dc=contoso,dc=com" -p subtree –r "(objectCategory=CN=Persona,CN=Esquema,CN=Configuración,DC=contoso,DC=com)" -l "1,st,streetaddress,postalcode" Nota:  las entradas de City, State, Address y PostalCode no se han definido en las guías de infraestructura de red común para los objetos de usuario incluidos en la unidad organizativa Mercadotecnia. Es aconsejable que rellene estos campos para cada objeto de usuario de la unidad organizativa Mercadotecnia antes de realizar la exportación.
3.	Presione ENTRAR.
4.	Abra el archivo marketing.ldf con el Bloc de notas. Nota:  si ha especificado datos para cada objeto de usuario, los resultados serán similares a los que se muestran en la Figura 2. Figura 2.  Revisión de un archivo LDF
5.	En el Bloc de notas, modifique cada entrada de objeto de usuario en Marketing.ldf de forma que tenga un aspecto similar al que se muestra en la Figura 3. Nota:  debe guardar el archivo como un archivo .ldf. Figura 3.  Modificación de un archivo de importación LDF
6.	Cierre el Bloc de notas. En la ventana del símbolo del sistema, escriba: ldifde –i -f marketing.ldf -s hq-con-dc-01
7.	Presione ENTRAR. Los resultados deben ser similares a los que se muestran en la Figura 4. Figura 4.  Importación correcta de un archivo LDF
8.	Para confirmar que los atributos de objetos de usuario se han modificado correctamente, utilice el complemento Usuarios y equipos de Active Directory. (Para obtener ayuda con el uso de este complemento, consulte la Guía detallada de administración de Active Directory.)

Nota:  otra utilidad llamada Csvde.exe realiza las mismas funciones de exportación que la utilidad Ldifde.exe, pero emplea un formato de archivo separado por comas. Las operaciones de importación con esta utilidad son sólo “agregar”; no ofrece la capacidad de modificar ni eliminar objetos. El formato de archivo de valores separados por comas (CSV) es compatible con aplicaciones como Microsoft Excel.

Crear y eliminar objetos

En los ejemplos siguientes, se utiliza LDIF para agregar y eliminar usuarios de Active Directory.

Para crear un nuevo usuario mediante LDIF

1.	Haga clic en el botón Inicio y en Ejecutar, escriba Bloc de notas Newuser.ldf y, a continuación, haga clic en Aceptar. Cuando se le indique, haga clic en Sí para crear un nuevo archivo.
2.	Agregue el siguiente texto al archivo. dn: CN=Pilar Ackerman,OU=Mercadotecnia,OU=Cuentas,DC=contoso,DC=com changetype: add cn: Pilar Ackerman objectClass: user samAccountName: Pilar givenName: Pilar sn: Ackerman
3.	Guarde y después cierre el archivo newuser.ldf . Antes de seguir con la creación de objetos de usuario, compruebe el archivo guardado en el directorio Documents and Settings.
4.	Escriba lo siguiente en la ventana del símbolo del sistema. ldifde –i -f newuser.ldf -s hq-con-dc-01
5.	Presione ENTRAR. Cuando termine, la ventana del símbolo del sistema confirmará las modificaciones, como se muestra en la Figura 5. Figura 5 Agregar un nuevo usuario

Para eliminar un usuario mediante LDIF

Principio de la página

Usar VBScript y ADSI

ADSI permite desarrollar fácilmente aplicaciones habilitadas para directorios. Junto con Windows Script Host, las operaciones por lotes de directorios se pueden ejecutar con secuencias de comandos mediante el software de desarrollo VBScript o Microsoft JScript^®. En esta guía, los procedimientos descritos en la sección anterior (en los que se utilizaba LDIF) se han realizado mediante aplicaciones simples escritas en VBScript.

Tenga en cuenta que estas secuencias de comandos no incluyen comprobación de errores ni se han concebido para proporcionar una referencia a VBScript y ADSI a los programadores. En todos los ejemplos que se incluyen en este documento se asume que ha iniciado sesión con las credenciales correctas en un equipo que es miembro del dominio de destino. En ADSI es posible especificar de forma explícita credenciales y un dominio de destino. Después de cada procedimiento, confirme que se han modificado las entradas mediante el complemento Usuarios y equipos de Active Directory.

Exportar objetos

En este ejemplo, se utiliza un editor de texto, como el Bloc de notas, para crear un programa VBScript. La secuencia de comandos busca la unidad organizativa Mercadotecnia y crea un archivo de texto con todos los objetos de usuarios y un subconjunto de sus atributos.

Para crear y ejecutar una secuencia de comandos de exportación

'Global variables
    Dim oContainer
    Dim OutPutFile
    Dim FileSystem
'Initialize global variables
    Set FileSystem = WScript.CreateObject("Scripting.FileSystemObject")
    Set OutPutFile = FileSystem.CreateTextFile("marketing.txt", True) 
    Set oContainer=GetObject("LDAP://OU=Marketing,OU=Accounts,DC=contoso,DC=com")
'Enumerate Container
    EnumerateUsers oContainer
'Clean up
    OutPutFile.Close
    Set FileSystem = Nothing
    Set oContainer = Nothing
    WScript.Echo "Finished"
    WScript.Quit(0)
Sub EnumerateUsers(oCont)
    Dim oUser
    For Each oUser In oCont
        Select Case LCase(oUser.Class)
               Case "user"
                    If Not IsEmpty(oUser.distinguishedName) Then
                       OutPutFile.WriteLine "dn: " & oUser.distinguishedName
                    End If
                    If Not IsEmpty(oUser.name) Then
                       OutPutFile.WriteLine "name: " & oUser.Get ("name")
                    End If
                    If Not IsEmpty(oUser.streetAddress) Then
                       OutPutFile.WriteLine "streetAddress: " & oUser.streetAddress
                    End If
                    If Not IsEmpty(oUser.l) Then
                       OutPutFile.WriteLine "l: " & oUser.l
                    End If
                    If Not IsEmpty(oUser.st) Then
                       OutPutFile.WriteLine "st: " & oUser.st
                    End If
                    If Not IsEmpty(oUser.postalcode) Then
                       OutPutFile.WriteLine "postalcode: " & oUser.postalcode
                    End If
               Case "organizationalunit", "container"
                    EnumerateUsers oUser
        End Select
        OutPutFile.WriteLine
    Next
End Sub

Nota:  al ejecutar export.vbs se crea el archivo Marketing.txt, que contiene una lista de usuarios y un subconjunto de sus atributos.

Con las modificaciones apropiadas, esta secuencia de comandos se puede utilizar con cualquier aplicación que sea compatible con las tecnologías Modelo de objetos componentes (COM) y Visual Basic de Microsoft. Estas aplicaciones son Visual Basic, Excel y Microsoft Access. También se admiten secuencias de comandos en Internet Explorer y Servicios de Internet Information Server.

Modificar objetos

En este ejemplo, se modificarán todos los atributos de dirección de los usuarios incluidos en la unidad organizativa Mercadotecnia. Se utiliza un programa VBScript simple para realizar una modificación por lotes de todos los objetos de usuario de la organización Mercadotecnia. La secuencia de comandos modifica los atributos de provincia, calle, localidad y código postal.

Para crear y ejecutar una secuencia de comandos de modificación de objetos

Dim oContainer
    Set oContainer=GetObject("LDAP://OU=Marketing,OU=Accounts,DC=contoso,DC=com")
ModifyUsers oContainer
'cleanup
    Set oContainer = Nothing
    WScript.Echo "Finished"
    WScript.Quit
Sub ModifyUsers(oObject)
    Dim oUser
    oObject.Filter = Array("user")
    For Each oUser in oObject
        oUser.Put "st","Washington"
        oUser.Put "streetAddress","One Microsoft Way"
        oUser.Put "postalCode","98052"
        oUser.Put "l","Redmond"
        oUser.SetInfo
    Next
End Sub

Crear y eliminar objetos

En este ejemplo, se utiliza VBScript para agregar un nuevo usuario a la organización Mercadotecnia. Este ejemplo ilustra lo fácil que resulta utilizar ADSI y VBScript para tener acceso al directorio mediante programación. Tenga en cuenta que en este ejemplo sólo se configura un conjunto limitado de atributos durante la creación del usuario.

Para crear y ejecutar una secuencia de comandos de creación de objetos

Dim oContainer
Dim oUser
Set oContainer=GetObject("LDAP://OU=Marketing,OU=Accounts,DC=contoso,DC=com")
'Create user
        Set oUser = oContainer.Create("User","CN=Pilar Ackerman") 
'Assign values to user attributes
        oUser.Put "samAccountName","Pilar"
        oUser.Put "givenName","Pilar"
        oUser.Put "sn","Ackerman"
        oUser.Put "userPrincipalName","pilar@contoso.com"
        oUser.SetInfo
'Clean up
Set oUser = Nothing
Set oContainer = Nothing
WScript.Echo "Finished"
WScript.Quit

Para crear y ejecutar una secuencia de comandos de eliminación de objetos

Dim oContainer
    Set oContainer=GetObject("LDAP://OU=Marketing,OU=Accounts,DC=contoso,DC=com")
'Delete user
    oContainer.Delete "user","CN=Pilar Ackerman"
'Clean up
Set oContainer = Nothing
WScript.Echo "Finished"
WScript.Quit

Principio de la página

Apéndice: Usar LDIFDE

Sintaxis

ldifde [-i] [-f NombreArchivo] [-s NombreServidor] [-c Cadena1 Cadena2] [-v] [-j Ruta] [-t NúmeroPuerto] [-d NCBase] [-r FiltroLDAP] [-p Alcance] [-l ListaAtributosLDAP] [-o ListaAtributosLDAP] [-g] [-m] [-n] [-k] [-a NombreCompletoUsuario Contraseña] [-b NombreUsuario Dominio Contraseña] [-?]

Parámetros

-i

-f NombreArchivo

-s NombreServidor

-c Cadena1 Cadena2

-v

-j Ruta

-t NúmeroPuerto

-d NCBase

-r FiltroLDAP

-p Alcance

-l ListaAtributosLDAP

-o ListaAtributosLDAP

-g

-m

-n

-k

-a NombreCompletoUsuario Contraseña

-b NombreUsuario Dominio Contraseña

-?

Comentarios

Cuando cree el archivo de importación para utilizarlo con el comando Ldifde, use un valor de changeType para definir el tipo de cambios que contendrá el archivo de importación. Están disponibles los siguientes valores de changeType:

A continuación se incluye un ejemplo de un formato de archivo de importación LDIF que utiliza el valor add.

DN: CN=UsuarioEjemplo,DC=NombreDominio

changetype: add

CN: UsuarioEjemplo

description: DescripciónDeArchivo

objectClass: User

sAMAccountName: UsuarioEjemplo

Ejemplos

Para recuperar sólo el nombre completo, el nombre común, el nombre, el apellido y el número de teléfono de los objetos devueltos, escriba:

-l DistinguishedName, CN, GivenName, SN, Telephone

Para omitir el objeto GUID, escriba:

-o whenCreated, whenChanged, objectGUID

Leyenda de formato

Principio de la página

Recursos adicionales

Para obtener más información, consulte los siguientes recursos:

Principio de la página