Utilizando Variables

Use variables para almacenar valores a los que se puede hacer referencia en múltiples pasos del procedimiento. Las variables se transfieren automáticamente a procedimientos anidados.

• Tres métodos para crear variables:
  • Variables de procedimiento: use el comando getVariable() en un procedimiento para crear un nuevo nombre de variable sin caracteres especiales. Ejemplo: VariableName. En los pasos subsiguientes, incluidos los pasos de los procedimientos anidados, haga referencia a la variable encerrando su nombre con el carácter #. Ejemplo: #VariableName#.

  Nota: No se puede hacer referencia a las variables de procedimiento fuera del procedimiento o de los procedimientos anidados que las usan, excepto por las variables GLOBALES. Una variable de procedimiento sólo es visible para la sección del procedimiento en el que se creó y cualquier procedimiento secundario. Una vez que un procedimiento abandona la cláusula THEN o ELSE en la que se creó la variable, esta queda fuera de ámbito y ya no es válida. Use la opción Variables GLOBALES, que se describe a continuación, para mantener la visibilidad de una variable después de abandonar la cláusula THEN o ELSE en la que se creó la variable.

  • Variables administradas : use Administrador de variable para definir las variables que pueden usarse repetidamente en procedimientos diferentes. Puede mantener varios valores de cada variable gestionada, con cada valor aplicado a uno o mas IDs de grupos. A las variables administradas no se le pueden reasignar valores nuevos dentro de un procedimiento. En un procedimiento, haga referencia a una variable administrada mediante el nombre de la variable entre los caracteres < y >. Ejemplo: <VariableName>.
  • Variables GLOBALES: las variables no GLOBALES no pueden devolver un valor modificado de una variable de procedimiento definida por el procedimiento primario. Las variables no GLOBALES inicializadas en el procedimiento secundario tampoco se pueden regresar al primario. Las variables cuyo nombre contiene el prefijo GLOBAL: (sin distinguir mayúsculas y seguido por dos puntos) pueden pasar valores modificados del secundario al principal, sin importar que la variable se inicialice en el procedimiento primario o secundario. Los procedimientos secundarios subsiguientes pueden usar cualquier variable GLOBAL inicializada en cualquier paso anterior, independientemen de si la variable global se inicializó en un procedimiento primario o en otro procedimiento secundario.
• Nombres de variable: los nombres de variable no pueden incluir los siguientes caracteres: , % ' " / \ : * ? < > | y el carácter de espacio.
• Dónde se usan : una vez creadas las variables puede incluirlas, en su formato encerrada entre caracteres, en cualquier campo de entrada de texto desplegado por un cuadro de diálogo IF-ELSE-STEP.
• Distinguen entre mayúsculas y minúsculas : los nombres de las variables distinguen entre mayúsculas y minúsculas.
• Caracteres reservados: dado que los caracteres <, > y # se usan para identificar nombres de variable, estos caracteres se deben introducir dos veces como texto regular en una línea de comandos. Por ejemplo, el siguiente comando, c:\dir >> filelist.txt, se interpreta en el tiempo de ejecución del procedimiento como c:\dir > filelist.txt.
• Tipos de valores de variable posibles: los siguientes son los tipos de valores de variable que se obtienen normalmente mediante el uso del parámetro getVariable().
  • Valor de registro y Valor de registro de 64 bits: consulte Comandos de 64 bits, datos del valor de registro especificado en la máquina administrada. La última barra invertida simple de una cadena se usa para delimitar la clave de registro del valor de registro. Para incluir barras invertidas como parte de la cadena de valores, especifique barras dobles para cada carácter de barra. Por ejemplo, la cadena HKEY_LOCAL_MACHINE\SOFTWARE\SomeKey\Value\\Name se interpreta como la clave HKEY_LOCAL_MACHINE\SOFTWARE\SomeKey con un valor de Value\Name.
  • Contenido del archivo : datos de un archivo especificado en la máquina administrada. Consulte Comandos de 64 bits.
  • Valor constante : constante especificada según se clasifica en el editor de procedimiento.
  • Ruta de directorio de instalación agente : directorio en el cual se instala el agente en la máquina administrada.
  • Unidad de instalación de agente: unidad en la que se instala el agente en la máquina administrada, como c:\.
  • Ruta de acceso del directorio de trabajo de agente : directorio de trabajo en la máquina administrada según se especifica mediante el uso de Agente > Directorio de trabajo.

    Advertencia: No elimine los archivos y las carpetas del directorio de trabajo. El agente usa los datos almacenados en el directorio de trabajo para llevar a cabo varias tareas.

  • Ruta de directorio temporal del usuario : el directorio temporal para el usuario actualmente conectado en la máquina administrada. Esta ruta es la expansión de la variable de entorno %TEMP% para el usuario actualmente conectado. Si no hay usuario conectado. es el directorio temporal predeterminado de Windows.
  • Machine.Group ID : ID de la máquina del agente que ejecuta el procedimiento.
  • Número de versión del archivo : la versión de software del archivo especificado en la máquina administrada. Por ejemplo, un archivo exe o dll a menudo contiene el número de versión de su lanzamiento.
  • Tamaño del archivo : tamaño en bytes del archivo especificado en la máquina administrada.
  • Fecha de última modificación del archivo: la última fecha y hora de modificación en horario universal, coordinadas (UTC) del archivo especificado en la máquina administrada en formato yyyy/mm/dd hh:mm:ss.
  • Variables de datos de vistas SQL automáticas: los parámetros de vistas SQL están disponibles como variables de procedimiento automáticamente declaradas. Las variables automáticas le permiten omitir mediante el uso del comando GetVariable antes de usar la variable en un paso. Use el formato #SqlViewName.ColumnName# en un procedimiento para devolver el valor de dbo.SqlView.Column para el agente que ejecuta el procedimiento. Vea Sistema > Vistas a la Base de Datos para ver la lista de vistas de SQL y las columnas que están disponibles.

    Nota: Datos de vistas SQL: este antiguo método para devolver un valor de vista de base de datos sólo es necesario si intenta devolver un valor de una máquina distinta de la que ejecuta el procedimiento de agente.
    
    Use el comando GetVariable con la opción Datos de vista SQL para crear una nueva variable de procedimiento y establecerla en el valor dbo.SqlView.Column. Use el formato SqlViewName/ColumnName/mach.groupID o SqlViewName/ColumnName. Si se omite la ID de máquina opcional, entonces se recupera el valor para el agente que ejecuta el procedimiento. Si ColumnName contiene un espacio, enciérrelo entre corchetes. Ejemplo: vSystemInfo/[Product Name]  Consulte Sistema > Vistas de base de datos para ver la lista de vistas SQL y las columnas que están disponibles.

  • Variables de administrador automáticas: tres variables de administrador que se declaran de forma automática. Estas variables de administrador automáticas permiten que los procedimientos de agente accedan a los valores que no están presentes en una vista SQL.
    • #adminDefaults.adminEmail# : dirección de correo electrónico del usuario del VSA que programó el procedimiento de agente.
    • #adminDefaults.adminName#: nombre del usuario del VSA que programó el procedimiento de agente.
    • #scriptIdTab.scriptName#: nombre del procedimiento de agente.
  • Propiedad WMI : nombres de espacio, clase y propiedad de WMI. El formato de la propiedad WMI especificada es NameSpace:Class.Property. Por ejemplo, root\cimv2:Win32_OperatingSystem.FreePhysicalMemory. Especifique una instancia utilizando la siguiente sintaxis: NameSpace:Class[N].Property donde [N] es el número de instancia. Por ejemplo, root\cimv2:Win32_OnboardDevice[3].Description. La primera instancia puede indicarse especificando o no el número de instancia [1].
  • Valor de expresión: especifique una expresión que conste de variables de procedimiento y seis operadores matemáticos +, -, *, /, ( y ) que se evalúan y se asignan a una nueva variable de procedimiento. Por ejemplo, ((#variable1# + #variable2#) + 17.4) / (#variable3# * 4). Las variables de procedimiento deben contener valores numéricos.
  • Solicitado cuando se programa el procedimiento : muestra un mensaje para ingresar un valor cuando se ejecuta el procedimiento de agente. El valor se almacena en el nombre de la variable especificado. Especifique el texto y nombre de la variable solicitados. Por ejemplo, cada vez que se ejecuta este procedimiento, un usuario del VSA puede ingresar a un directorio de máquina distinto.
• Variables de alerta: se puede asignar un procedimiento de agente para que se ejecute cuando se activa una alerta. En la mayoría de los casos, la alerta pasa variables predefinidas al procedimiento de agente. Estas variables de alerta se registran por tema de alerta. Consulte Alertas - Nuevo agente instalado para ver un ejemplo.
• Variables de entorno de Windows: puede hacer referencia a variables de entorno de Windows sólo dentro de executeFile(), Ejecutar archivo en la ruta y executeShellCommand(). Encierre todo el comando entre comillas, ya que la variable de entorno puede contener espacios que pueden afectar la ejecución. Para ver otros comandos de procedimiento de agente, use getVariable() a fin de obtener la clave de registro que contiene las variables de entorno, ubicada en HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment.