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

Comandos existentes

Los script de CA DMM utilizan los siguientes comandos existentes:

DirectoryExists

Permite verificar la existencia de un directorio. Este comando acepta dos parámetros. El primer parámetro corresponde a la ruta del directorio, un valor de cadena. El segundo parámetro indica si se debe buscar en el equipo de origen o en el de destino. El segundo parámetro es opcional y constituye un valor booleano. Si el segundo parámetro es Verdadero, el intérprete busca el archivo especificado en el equipo de origen. Si el parámetro es Falso o no está presente, el intérprete realiza la búsqueda en el equipo de destino.

Nota: El parámetro booleano sólo se puede usar durante las funciones General y Apply. Si se usa en otras funciones, se produce un error de sintaxis o de tiempo de ejecución.

Primer parámetro:

Ruta del directorio (cadena)

Segundo parámetro:

Indicador del equipo (valor booleano)

Uso:

DirectoryExists( <ruta directorio>, [valor booleano] );

Ejemplo:

if (DirectoryExists( "c:\\My Documents"))
 StoreDirectory( "c:\\My Documents");

if (DirectoryExists( "c:\\My Documents", SOURCE))
 ApplyDirectory( "c:\\My Documents");

FileExists

Permite verificar que un archivo existe bien en el equipo de origen, bien en el de destino. El primer parámetro corresponde a la ruta del archivo, una cadena. El segundo parámetro indica si se debe buscar en el equipo de origen o en el de destino. El segundo parámetro es opcional y constituye un valor booleano. Si el segundo parámetro es Verdadero, el intérprete busca el archivo especificado en el equipo de origen. Si el parámetro es Falso o no está presente, el intérprete realiza la búsqueda en el equipo de destino.

Nota: El parámetro booleano sólo se puede usar durante las funciones General y Apply. Si se usa en otras funciones, se produce un error de sintaxis o de tiempo de ejecución.

Primer parámetro:

Ruta del archivo (cadena)

Segundo parámetro:

Indicador del equipo (valor booleano)

Uso:

FileExists( <ruta archivo> );

Ejemplos:

if (FileExists( "c:\\My Documents\\myfile.txt"))
    StoreFile( "c:\\My Documents\\myfile.txt");

if (FileExists( "c:\\My Documents\\myfile.txt", SOURCE))

KeyExists

Permite verificar que una clave de registro existe bien en el equipo de origen, bien en el de destino. Acepta dos parámetros. El primer parámetro corresponde a la ruta de la clave de registro, una cadena. El segundo parámetro indica si se debe buscar en el equipo de origen o en el de destino. El segundo parámetro es opcional y constituye un valor booleano. Si el segundo parámetro es Verdadero, el intérprete busca la clave especificada en el equipo de origen. Si el parámetro es Falso o no está presente, el intérprete realiza la búsqueda en el equipo de destino.

Nota: El parámetro booleano sólo se puede usar durante las funciones General y Apply. Si se usa en otras funciones, se produce un error de sintaxis o de tiempo de ejecución.

Primer parámetro:

Ruta de la clave (cadena)

Segundo parámetro:

Indicador del equipo (valor booleano)

Uso:

KeyExists( <ruta de clave> );

Ejemplo:

if (KeyExists( "HKLM\\Software\\Microsoft\\Plus!", SOURCE))

ApplyKey( "HKLM\\Software\\Microsoft\\Plus!");

ValueExists

Se emplea para verificar que un valor de clave de registro existe en el registro o en el archivo INI. Este comando admite dos o tres parámetros. El primer parámetro es la ruta de la clave de registro y el segundo es el nombre del valor. Los dos primeros parámetros son obligatorios y constituyen valores de cadena. El tercer parámetro indica si se debe buscar en el equipo de origen o en el de destino. El tercer parámetro es opcional y constituye un valor booleano. Si el tercer parámetro es Verdadero, el intérprete busca la clave especificada en el equipo de origen. Si el parámetro es Falso o no está presente, el intérprete realiza la búsqueda en el equipo de destino.

Nota: El tercer parámetro booleano sólo se puede usar durante las funciones General y Apply. El tercer parámetro booleano ocasiona un error de sintaxis o de tiempo de ejecución si se usa en otros casos.

Primer parámetro:

Ruta de la clave (cadena)

Segundo parámetro:

Nombre del valor (cadena)

Tercer parámetro:

Equipo (valor booleano)

Uso:

ValueExists( <ruta clave>, <nombre valor>, [valor booleano] );

Ejemplo:

if (ValueExists( "HKCU\\Control Panel\\Desktop", "Smooth Scrolling", SOURCE))

ApplyValue( "HKCU\\Control Panel\\Desktop", "Smooth Scrolling");