Ayuda en línea de DMM Studio › DMM Studio › Estructura del lenguaje › Comandos Apply

Comandos Apply

A continuación se indican los comandos Apply utilizados en los script de CA DMM:

ApplyDirectory

Aplica el contenido de un directorio del equipo de origen en el equipo de destino. Este comando incluye dos o tres parámetros. El primer parámetro corresponde a la ruta del directorio, un valor de cadena. El segundo parámetro corresponde a una de las siguientes constantes de sobrescritura o a una nueva ruta de directorio. Hay tres constantes para el método de sobrescritura: ALWAYS, NEWER o NEVER. Si la constante de sobrescritura se omite, se aplica el método predeterminado NEWER o el seleccionado por el usuario. Si el segundo parámetro es una ruta de directorio nueva, el contenido del directorio <nombre directorio> se aplica a <nombre directorio nuevo>. Es posible utilizar otro método de sobrescritura. Sólo se pueden aplicar directorios ya almacenados. A la hora de desplazar contenido, si la ruta de almacenamiento contiene una cadena con comodín, no incluya el comodín en la ruta de desplazamiento.

Primer parámetro:

Nombre del directorio (cadena)

Segundo parámetro:

Nombre del nuevo directorio (cadena)

Tercer parámetro:

Método de sobrescritura (cadena)

Uso:

ApplyDirectory(<nombre directorio>, [método sobrescritura]); o

ApplyDirectory(<nombre directorio>, <nombre directorio nuevo>, [método sobrescritura]);

Ejemplo:

ApplyDirectory("c:\\My Documents");
ApplyDirectory("c:\\My Documents", NEWER);
ApplyDirectory("c:\\My Documents", "c:\\Word Documents");
ApplyDirectory("c:\\My Documents", "c:\\Word Documents", ALWAYS);
/*Wildcard example*/
ApplyDirectory("c:\\My Documents\\*.fol", "c:\\New Path\\Word Documents", ALWAYS);

ApplyFile

Aplica un archivo del equipo de origen en el equipo de destino. Este comando incluye dos o tres parámetros. El primer parámetro corresponde al nombre del archivo, un valor de cadena. El segundo parámetro corresponde a una de las siguientes constantes de sobrescritura o a una nueva ruta de archivo. Hay tres constantes para el método de sobrescritura: ALWAYS, NEWER o NEVER. Si la constante de sobrescritura se omite, se aplica el método predeterminado NEWER o el seleccionado por el usuario. Si el segundo parámetro corresponde a una ruta de archivo nueva, el archivo <nombre archivo> se aplica a <nuevo nombre archivo>. También es posible indicar otro método de sobrescritura. Este comando reconoce el asterisco (*) como comodín. Sólo se pueden aplicar archivos ya almacenados. A la hora de desplazar contenido, si la ruta de almacenamiento contiene una cadena con comodín, no incluya el comodín en la ruta de desplazamiento.

Primer parámetro:

Nombre del archivo (cadena)

Segundo parámetro:

Nuevo nombre del archivo (cadena)

Tercer parámetro:

Método de sobrescritura (cadena)

Uso:

ApplyFile(<nombre archivo>, [método sobrescritura]); o

ApplyFile(<nombre archivo>, <nuevo nombre archivo>, [método sobrescritura]);

Ejemplo:

ApplyFile("c:\\temp\\file.txt");
/*Wildcard example*/
ApplyFile("c:\\My Documents\\*.txt", "c:\\New Path\\Word Documents", ALWAYS);

ApplyKey

Sirve para aplicar una clave de registro con todos sus valores o una sección de archivo .ini con todos sus valores desde el equipo de origen al de destino. Este comando admite dos parámetros. Sólo se pueden aplicar claves ya almacenadas.

Primer parámetro:

Ruta de la clave (cadena)

Segundo parámetro:

Ruta de la clave nueva (cadena)

Uso:

ApplyKey(<ruta de clave>, [ruta de clave nueva]);

Ejemplo

ApplyKey("HKLM\\Software\\Microsoft\\Office\\8.0\\Word\\Data\\Toolbar");

ApplyMappedFile

Aplica un archivo del equipo de origen en el equipo de destino. Si en los datos del archivo se especifica una ruta de directorio, se asigna a la ruta oportuna.

Primer parámetro:

Ruta del archivo (cadena)

Segundo parámetro:

Nuevo nombre del archivo (cadena)

Tercer parámetro:

Método de sobrescritura (cadena)

Uso:

ApplyMappedFile(<nombre archivo>, [método sobrescritura]); o

ApplyMappedFile(<nombre archivo>, <nuevo nombre archivo>, [método sobrescritura]);

Ejemplos:

ApplyMappedFile("c:\\temp\\file.txt");

ApplyMappedFile("c:\\My Documents\\file.txt", "c:\\New Path\\Word Documents\\file.txt", ALWAYS);

ApplyMappedKey

Aplica una clave de registro con todos sus valores o una sección de archivo ini con todos sus valores desde el equipo de origen al de destino. Si cualquiera de los nombres o los datos de los valores es una ruta de directorio, se asigna a la ruta apropiada. Este comando admite dos parámetros. Sólo se pueden aplicar claves ya almacenadas.

Primer parámetro:

Ruta de la clave (cadena)

Segundo parámetro:

Ruta de la clave nueva (cadena)

Uso:

ApplyMappedKey(<ruta de clave>, [ruta de clave nueva]);

Ejemplo:

ApplyMappedKey("HKLM\\Software\\Microsoft\\Office\\8.0\\Word\\Data\\Toolbar");

ApplyMappedSubKeys

Aplica una clave de registro junto con todos sus valores y todas sus subclaves, o una sección de archivo ini junto con todos sus valores desde el equipo de origen al de destino. Si cualquiera de los nombres o los datos de los valores es una ruta de directorio, se asigna a la ruta apropiada. Este comando admite dos parámetros. Sólo se pueden aplicar claves ya almacenadas.

Primer parámetro:

Ruta de la clave (cadena)

Segundo parámetro:

Ruta de la clave nueva (cadena)

Uso:

ApplyMappedSubKeys(<ruta de clave>, [ruta de clave nueva]);

Ejemplo:

ApplyMappedSubKeys("HKLM\\Software\\Microsoft\\Office\\8.0\\Word\\Data\\Toolbar");

ApplyMappedValue

Permite aplicar un valor de clave de registro o un valor de archivo .ini desde el equipo de origen al de destino. Si el nombre del valor o el valor es una ruta de directorio, se asigna a la ruta apropiada. Este comando admite seis parámetros. Sólo se pueden aplicar como asignados valores que se guardaran como asignados.

Primer parámetro:

Ruta de la clave (cadena)

Segundo parámetro:

Nombre del valor (cadena)

Nota: Si el valor corresponde al predeterminado, el segundo parámetro debe ser NULO ("")

Tercer parámetro:

Ruta de la clave nueva (cadena)

Nota: Si no se va a mover el valor a otra ubicación, el tercer parámetro debe ser NULO ("").

Cuarto parámetro:

Delimitador (cadena)

Quinto parámetro:

Indicador de rutas cortas (valor booleano)

Sexto parámetro:

Nombre del valor nuevo en caso de desplazamiento (cadena)

Uso:

ApplyMappedValue(<ruta de clave>, <nombre valor>, [ruta de clave nueva], [delimitador], [rutas cortas], [nombre valor nuevo]);

Ejemplos:

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips","HKLM\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips", "HKLM\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", ";");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips", "", ";");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\", "Tooltips", "", ";", true);

ApplySubKeys

Aplica una clave de registro junto con todos sus valores y todas sus subclaves desde el equipo de origen al de destino. Este comando admite dos parámetros. Sólo se pueden aplicar claves ya almacenadas.

Primer parámetro:

Ruta de la clave (cadena)

Segundo parámetro:

Ruta de la clave nueva (cadena)

Uso:

ApplySubKeys(<ruta de clave>, [ruta de clave nueva]);

Ejemplo:

ApplySubKeys("HKCU\\Software\\Microsoft\\Office\\8.0\\Word");

ApplyValue

Aplica un valor de clave de registro desde el equipo de origen al de destino. Este comando acepta cuatro parámetros. Sólo se pueden aplicar valores ya almacenados.

Primer parámetro:

Ruta de la clave (cadena)

Segundo parámetro:

Nombre del valor (cadena)

Tercer parámetro:

Ruta de la clave nueva (cadena)

Cuarto parámetro:

Nombre del valor nuevo (cadena)

Uso:

ApplyValue(<ruta de clave>, <nombre de valor>, [ruta de clave nueva], [nombre de valor nuevo]);

Ejemplo:

ApplyValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips");

DeleteKey

Se usa para borrar una clave junto con todos sus valores y todas sus subclaves del registro o de los archivos .ini. En caso de darse problemas al borrar la clave, se devuelve Falso. Si la clave no existe, se devuelve Verdadero. Si la ruta conduce a un archivo .ini, se borran todas las secciones del archivo .ini.

Primer parámetro:

Ruta de la clave (cadena)

Ejemplo:

DeleteKey( "HKCU\\Software\\MyApp");
DeleteKey( "c:\\windows\\test.ini\\Keyname");
/* all keys deleted */
DeleteKey( "c:\\windows\\test.ini");

DeleteValue

Permite borrar un valor del registro o de los archivos .ini. En caso de darse problemas al borrar el valor, se devuelve Falso. Si el valor no existe, se devuelve Verdadero.

Primer parámetro:

Ruta de la clave (cadena)

Segundo parámetro:

Nombre del valor (cadena)

Ejemplo:

DeleteValue( "HKCU\\Software\\MyApp", "SomeValue");

DeleteValue( "c:\\windows\\win.ini\", "SomeValue");

SetKey

Sirve para crear o establecer una clave.

Primer parámetro:

Ruta de la clave (cadena)

Ejemplo:

SetKey("HKLM\\New Key");

SetValue

El comando SetValue crea o configura un valor clave. Si la clave no existe, este comando la creará.

Este comando tiene el formato siguiente:

SetValue(<ruta de archivo>, <nombre de valor>, <datos>, <tipo>)

Ruta de archivo

(para el registro) Representa la ruta clave (valor de cadena).

(para XML) Representa la ruta del archivo completo.

Nombre de valor

(para el registro) Representa el nombre del valor (valor de cadena).

(para XML) Representa la consulta válida de XPath.

Datos

Representa el valor.

Tipo

Representa el tipo de valor.

A continuación se muestran los valores de registro aceptados:

Ejemplos: Configurar un valor clave

• Este ejemplo configura un valor clave en el caso del registro:

  SetValue("HKLM\\Destination", "String Value", "This is a string value", STRING);
  

• Este ejemplo configura un valor clave en el caso de XML:

  SetValue("C:\\abc.xml", "/docnode/node1/node2", "It is a node", "");