Herramienta DXmodify: Adición de información nueva o modificada a un directorio
Utilice la herramienta DXmodify para realizar cualquiera de las siguientes acciones:
cad140es
Utilice la herramienta DXmodify para realizar cualquiera de las siguientes acciones:
- Rellenar un directorio vacío
- Agregar entradas completas nuevas a un directorio existente
- Agregar atributos nuevos a las entradas existentes
- Modificar, renombrar o suprimir atributos de una entrada
- Cargar un archivo binario
Cuando se ejecuta la herramienta DXmodify, se puede introducir la información nueva o modificada desde la entrada estándar o desde un archivo LDIF.
Este comando presenta el siguiente formato:
dxmodify [action] [options]
- acciónEspecifica la acción que la herramienta realizará. La herramienta DXmodify sigue las directivas changetype en el archivo LDIF. Si el archivo LDIF contiene entradas y ninguna directiva changetype, se podrá indicar a DXmodify si se deben agregar estas entradas o si se deben sustituir las entradas existentes. DXmodify sustituye las entradas si alguna de las siguientes condiciones es verdadera:
- La entrada del archivo LDIF es una operación de modificación y el tipo de modificación se especifica para un atributo en el archivo LDIF.
- Se especifica -r.
- -aAgrega las entradas del archivo LDIF al directorio.
- -rSustituye las entradas o atributos del directorio con aquellos que aparecen en el archivo LDIF.
- opcionesSeleccione una o más de las siguientes opciones:
- -cSe ejecuta en modo continuo. Se notifican errores, pero no se detiene el proceso.
- -dnivel[-dnivel...]Establece los niveles de depuración de LDAP.
- nivelDefine el nivel de depuración tal y como se muestra a continuación:-1 Activar toda la depuración0 Sin depuración1 Función de seguimiento2 Gestión de paquetes de depuración4 Depuración elevada del seguimiento8 Gestión de la conexión16 Impresión de paquetes enviados y recibidos32 Procesamiento del filtro de búsqueda64 Procesamiento del archivo de configuración128 Procesamiento de la lista de control de acceso256 Conexiones/operaciones/resultados del registro de estadísticas512 Entradas del registro de estadísticas enviadas1024 Imprimir comunicación con back-end de shell2048 Imprimir la depuración del análisis de entradasSe pueden agregar los números de forma conjunta para especificar varios niveles de depuración al mismo tiempo. Por ejemplo, el nivel de depuración 6 especifica tanto el nivel de depuración 2 como el 4.
- -DDNenlaceEspecifica el nombre distintivo del usuario que realiza el enlace.
- -Eextensión-búsquedaEspecifica una extensión de la búsqueda como resultados paginados. Por ejemplo, para devolver los resultados en páginas de 10, utilice este comando:dxsearch -h host -E pr=10 "(cn=*)"
- -FFuerza a que se utilicen todos los registros de cambios.
- -fnombre de archivoEspecifica un archivo LDIF de origen. Si no se especifica esta opción o no se especifica un nombre de archivo, DXmodify esperará a la entrada de la entrada estándar.
- -HURIEspecifica el URI de LDAP del host del directorio. Si no se especifica esta opción, la herramienta utiliza elhost localen su lugar.Se puede utilizar una dirección IPv6, como en el ejemplo siguiente:-H ldap://[2001:db8:0:1:99a4:6159:198f:b309]
- -hhost-dapNotaEsta opción está en desuso. Utilice la opción -H en su lugar. La opción -h todavía funciona en la versión actual de CA Directory.Especifica la dirección o el nombre de host del host del directorio. Si no se especifica esta opción, la herramienta utiliza elhost localen su lugar.Se puede incluir el protocolo de direcciones OSI para SAP de transporte, sesión y presentación expandiendo completamentehost-dap:hostname:port/tsel/ssel/pselSe pueden incluir caracteres ASCII y binarios en los selectorestsel,sselypselutilizando el signo % seguido de los dos dígitos hexadecimales que representan el código ASCII del carácter como, por ejemplo, lo siguiente:
- / se expresa como %2F
- % se expresa como %25
- -llímitetiempoEspecifica el límite de tiempo (en segundos) para cada operación de DAP.
- -MActiva el control de TIDSA de gestión.
- -MMActiva el control de TIDSA de gestióny lo hace crítico. Para obtener más información, consulte el capítulo sobre controles de LDAP en laGuía de administración.
- -nMuestra lo que se realizará, pero no lo hace realmente. Esto puede resultar útil con fines de depuración, aunque por lo general se utiliza la opción -v.
- -P 2|3Especifica el protocolo de LDAP. De forma predeterminada, se establece en 3.
- -ppuerto-dapEspecifica el puerto en el equipo host del directorio. Si no se especifica, la herramienta utiliza el puerto 102, el puerto OSI, de forma predeterminadaSe pueden combinar los argumentos -p y -h en un solo argumento y se pueden expresar como un nombre de host o dirección IP separada por puntos. Por ejemplo, se pueden sustituir las opciones de la primera línea por las de la segunda:-h 192.168.19.202 -p 19389 -h 192.168.19.202:19389
- -qSe ejecuta en modo silencioso, en el que no se informa de las operaciones correctas.
- -SarchivoEscribe cualquier modificación omitida en el archivo especificado.
- -stiempoEspecifica el tiempo (en milisegundos) de la suspensión después de cada operación.
- -vSe ejecuta en modo detallado.
- -WSolicita al usuario la contraseña de enlace.
- -wcontraseñaEspecifica la contraseña de enlace.
- -ynombrearchivoEspecifica un archivo que contiene la contraseña de enlace.
- -Z [nombrearchivo_config_ssld]Especifica que la herramienta debe iniciar una solicitud TLS, utilizando el archivo de configuración especificado. Si se omite el nombre de archivo, la herramienta utiliza DXHOME/config/ssld/dxldap.conf.Utilice -ZZ para solicitar una respuesta del agente de sistema de directorio cuando una solicitud sea correcta.Nota: Para obtener más información, consulte Archivo de configuración SSLD.
Ejemplo: Realizar varios cambios en una entrada
Este ejemplo utiliza el directorio de muestra Democorp proporcionado con CA Directory. Se puede repetir este ejemplo como un ejercicio de aprendizaje.
Se pueden realizar varios cambios, como cambiar el título y la dirección postal, agregar un segundo número de teléfono y suprimir la descripción de una entrada.
Este ejemplo muestra que se pueden sustituir los valores de varios atributos utilizando una instrucción replace siempre y cuando la instrucción replace especifique el primer nombre de atributo de la serie.
- Cree un archivo LDIF llamadoh-modify.ldifque contiene los siguientes elementos:dn: cn=Murray HORSFALL, ou=Repair,ou=Operations,o=Democorp,c=AU changetype: modify replace: title title: Chief Information Officer - add: telephone telephone: 797 8888 - delete: description - replace: postalAddress postalAddress: 173 Toorak Rd $ South Yarra postalCode: 3066
- Utilice DXmodify para aplicar el archivo editado de la siguiente manera:dxmodify -h localhost:19389 -f h-modify.ldif
Ejemplo: Adicción de un archivo binario
Este ejemplo muestra cómo agregar un archivo JPEG con un registro de personal de staff.ldif.
Para los archivos JPEG, la clase de objeto es
cosinePilotObject
, el nombre del atributo X.500 es cosineJpegPhoto
y el nombre del atributo LDAP es JpegPhoto
.Este ejemplo utiliza el directorio de muestra Democorp proporcionado con CA Directory. Se puede repetir este ejemplo como un ejercicio de aprendizaje.
Para agregar un archivo binario, siga estas instrucciones:
- Decida qué clase de objeto del esquema del directorio y qué atributo se desean utiliza para almacenar los datos binarios.En este ejemplo, utilice el atributocosineJpegPhotodentro de la clase de objetocosinePilotObject.
- Cree entradas en un archivo LDIF con la sintaxis siguiente:attributeName:< FILE://pathEn este ejemplo, cree staff.ldif con el formato siguiente:dn: cn=Peter Bell,ou=Infrastructure,ou=Support,o=Democorp,c=AU oc: organizationalPerson oc: newPilotPerson oc: cosinePilotObject cn: Peter Bell sn: BELL cosineJpegPhoto:< FILE://d:\temp\PHOTO\BELPE01.jpg title: Design Supervisor telephone: 881 9256 description: Computing mail: [email protected] postalAddress: 7-11 Fine Street$Penville CA postalCode: 32750
- Ejecute el siguiente comando:dxmodify -a -c -h hostname:19389 -f staff.ldif