Herramienta DXmodify: Adición de información nueva o modificada a un directorio

Utilice la herramienta DXmodify para realizar cualquiera de las siguientes acciones:
cad126es
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ón
    Especifica 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.
    • -a
      Agrega las entradas del archivo LDIF al directorio.
    • -r
      Sustituye las entradas o atributos del directorio con aquellos que aparecen en el archivo LDIF.
  • opciones
    Seleccione una o más de las siguientes opciones:
  • -c
    Se ejecuta en modo continuo. Se notifican errores, pero no se detiene el proceso.
  • -d
    nivel 
    [
    -
    d
    nivel
    ...]
    Establece los niveles de depuración de LDAP.
    • nivel
      Define el nivel de depuración tal y como se muestra a continuación:
      -1 Activar toda la depuración
      0 Sin depuración
      1 Función de seguimiento
      2 Gestión de paquetes de depuración
      4 Depuración elevada del seguimiento
      8 Gestión de la conexión
      16 Impresión de paquetes enviados y recibidos
      32 Procesamiento del filtro de búsqueda
      64 Procesamiento del archivo de configuración
      128 Procesamiento de la lista de control de acceso
      256 Conexiones/operaciones/resultados del registro de estadísticas
      512 Entradas del registro de estadísticas enviadas
      1024 Imprimir comunicación con back-end de shell
      2048 Imprimir la depuración del análisis de entradas
      Se 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.
  • -D
    DNenlace
    Especifica el nombre distintivo del usuario que realiza el enlace.
  • -E
    extensión-búsqueda
    Especifica 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=*)"
  • -F
    Fuerza a que se utilicen todos los registros de cambios.
  • -f
    nombre de archivo
    Especifica 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.
  • -H
    URI
    Especifica el URI de LDAP del host del directorio. Si no se especifica esta opción, la herramienta utiliza el
    host local
    en su lugar.
    Se puede utilizar una dirección IPv6, como en el ejemplo siguiente:
    -H ldap://[2001:db8:0:1:99a4:6159:198f:b309]
  • -h
    host-dap
    Nota
    Esta 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 el
    host local
    en su lugar.
    Se puede incluir el protocolo de direcciones OSI para SAP de transporte, sesión y presentación expandiendo completamente
    host-dap
    :
    hostname:port/tsel/ssel/psel
    Se pueden incluir caracteres ASCII y binarios en los selectores
    tsel
    ,
    ssel
    y
    psel
    utilizando 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
  • -l
    límitetiempo
    Especifica el límite de tiempo (en segundos) para cada operación de DAP.
  • -M
    Activa el control de TI
    DSA de gestión
    .
  • -MM
    Activa el control de TI
    DSA de gestión
    y lo hace crítico. Para obtener más información, consulte el capítulo sobre controles de LDAP en la
    Guía de administración
    .
  • -n
    Muestra 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|3
    Especifica el protocolo de LDAP. De forma predeterminada, se establece en 3.
  • -p
    puerto-dap
    Especifica el puerto en el equipo host del directorio. Si no se especifica, la herramienta utiliza el puerto 102, el puerto OSI, de forma predeterminada
    Se 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
  • -q
    Se ejecuta en modo silencioso, en el que no se informa de las operaciones correctas.
  • -S
    archivo
    Escribe cualquier modificación omitida en el archivo especificado.
  • -s
    tiempo
    Especifica el tiempo (en milisegundos) de la suspensión después de cada operación.
  • -v
    Se ejecuta en modo detallado.
  • -W
    Solicita al usuario la contraseña de enlace.
  • -w
    contraseña
    Especifica la contraseña de enlace.
  • -y
    nombrearchivo
    Especifica 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.
  1. Cree un archivo LDIF llamado
    h-modify.ldif
    que 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
  2. 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:
  1. 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 atributo
    cosineJpegPhoto
    dentro de la clase de objeto
    cosinePilotObject
    .
  2. Cree entradas en un archivo LDIF con la sintaxis siguiente:
    attributeName:< FILE://path
    En 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
  3. Ejecute el siguiente comando:
    dxmodify -a -c -h hostname:19389 -f staff.ldif