KACE Systems Management Appliance 13.0 Common Documents - Guía de administración

Sintaxis de las reglas de inventario personalizado

Sintaxis de las reglas de inventario personalizado

Utilice la sintaxis correcta para los nombres de función y argumentos en las reglas de Inventario personalizado.

Las reglas de generación de valores y condicionales utilizan la siguiente sintaxis:

Para obtener información específica sobre las funciones y sus argumentos, consulte:

Sintaxis de función

Escriba el NombreDeFunción seguido de un paréntesis inicial, encierre los argumentos con un paréntesis de cierre. No se permiten espacios entre el nombre de la función y el paréntesis inicial.

Sintaxis del argumento

Escriba la sintaxis del argumento para todas las reglas, excepto comando y regex (expresión regular) de la siguiente manera:

Por ejemplo, las sintaxis siguientes son iguales:

Comas y paréntesis como valores en una regla

Si se utiliza una coma, paréntesis inicial o paréntesis de cierre como valores en una regla, se los debe omitir como {{coma}}. {{op}} y {{cp}} respectivamente.

Por ejemplo, si el usuario desea probar según el valor de registro en el cual el nombre de valor es "test,value", el usuario necesitaría omitir la coma en este caso porque el nombre de valor de registro no es el último argumento en la función Inventario personalizado (CI).

Si el usuario desea probar según el valor de registro en el cual el valor mismo contiene una coma, entonces no hay necesidad de omisión debido a que el valor es el último argumento en la función Inventario personalizado. El siguiente Inventario personalizado prueba el valor de registro HKLM\SOFTWARE\TestSoft\test1 y consulta para ver que el valor sea igual a 2,4.

Si el Inventario personalizado contiene un solo parámetro, toma todo lo que esté entre paréntesis como el valor para el argumento. Las comas en este caso no deben omitirse y serán parte del argumento para la función Inventario personalizado.

Por ejemplo, si el usuario desea repetir la cadena "Hello ( World", entonces el CI debe parecerse a lo siguiente:

Cuando el analizador tokeniza los argumentos para la función, contabiliza la cantidad de paréntesis iniciales y de cierre para determinar el final de la función cuando encuentra el último paréntesis de cierre con coincidencia. Sin embargo, si el valor del argumento mismo contiene un paréntesis de cierre sin coincidencias, el paréntesis hace creer al analizador que es el final de la función y el valor del argumento se truncará antes de tiempo.

Si un paréntesis inicial literal se necesita como parte del valor del argumento, se debe representar con {{cp}}.

Por ejemplo, si el usuario desea repetir la cadena "Hello ) World", entonces el CI debe parecerse a lo siguiente:

Búsqueda de condiciones (reglas condicionales)

Búsqueda de condiciones (reglas condicionales)

Puede escribir las reglas de inventario personalizado que identifican si una aplicación está instalada o no (verdadero/falso).

Cuando se utiliza una regla condicional, si la regla resulta verdadera, aparece el nombre para mostrar (título) de la aplicación personalizada en la sección Software: Programas instalados de la página Detalles del dispositivo en la sección Inventario.

Las siguientes secciones describen las reglas que buscan condiciones:

Cuando la regla resulta falsa, la aplicación no aparece en la sección Programas instalados en los detalles del inventario del dispositivo.

SUGERENCIA: Puede ver una lista de dispositivos que tienen instalado el elemento en Inventario > Software > Elemento_personalizado:: Página Detalles.

Referencia de regla condicional

La siguiente tabla describe qué tipos de datos pueden utilizarse para la comparación.

La siguiente tabla describe cómo se hacen las comparaciones.

La siguiente tabla enumera las reglas condicionales disponibles con vínculos a detalles específicos sobre cómo especificar los argumentos.

Para obtener más información sobre Equals, GreaterThan y LessThan para FilenamesMatchingRegex, consulte Referencia de regla de expresión regular.

Verificación de la existencia de una condición (Reglas Exists)

Las reglas que terminan en Exists buscan la presencia de un archivo, un directorio, una clave de registro u otro elemento. Si el agente de KACE encuentra el elemento en el dispositivo, la regla resultará verdadera y el elemento aparecerá como programa instalado en los detalles del inventario del dispositivo.

Utilice cualquiera de las siguientes reglas Exists:

Ejemplo: Busque un directorio (carpeta)

El ejemplo a continuación realiza una prueba para verificar si el directorio de Windows existe en el dispositivo:

Ejemplo: Busque un archivo

NOTA: El ejemplo a continuación verifica que el archivo ejecutable del bloc exista en el dispositivo:

Evaluación de los ajustes del dispositivo (reglas Equals)

Las reglas que terminan en Equals comparan el valor establecido en el dispositivo con el valor que especificó en la regla. La regla resulta verdadera si la coincidencia de los valores es exacta.

Las reglas que usan argumentos con los tipos de datos establecidos pueden comparar solo valores del mismo tipo.

Utilice cualquiera de las siguientes reglas Equals:

Ejemplo: Prueba del ajuste JAVA_HOME

Para verificar que la configuración JAVA_HOME sea C:\Program Files\Java\jdk1.6.0_02:

Ejemplo: Prueba del ajuste de las entradas del registro de McAfee®

Para comprobar el ajuste, utilice el mismo formato que la fecha en la entrada:

Ejemplo: Detección del Service Pack 1 de Windows 7

El Service Pack 1 de Windows 7 aparece en Agregar o quitar programas solo para los dispositivos que originalmente tenían Windows 7 y luego se actualizaron al SP1. El inventario de aplicaciones predeterminado para este elemento no refleja los dispositivos que ya tienen SP1 porque la imagen original se creó con nivel SP1.

Cuando el dispositivo se utiliza para implementar el Service Pack 1 de Windows 7, cree la siguiente regla de inventario personalizado para una aplicación personalizada:

Puede excluir los dispositivos con este elemento instalado para evitar que el dispositivo intente implementar el SP2 en los dispositivos que ya tienen ese nivel (es decir, los dispositivos con Windows 7 que se actualizaron y los dispositivos cuya imagen original es con SP1).

Comparación de valores de dispositivo (reglas Mayor que y Menor que)

Las funciones que terminan en GreaterThan y LessThan comparan solo valores como se enumeran en Table 24.

Utilice cualquiera de las siguientes reglas Greater Than y Less Than:

Ejemplo: Comprobar si la versión del producto es superior

Para verificar que la versión del producto sea superior a un número determinado:

Para verificar que la versión del producto sea un número determinado o superior, escriba lo siguiente:

Ejemplo: Prueba de rango de la versión de producto

Para probar si la versión de un producto está dentro de un rango, combine las reglas menor que y mayor que:

IMPORTANTE: No escriba reglas en líneas separadas. Separe las reglas solo por espacio. Tener reglas en líneas separadas invalida la regla compuesta.

Prueba de condiciones múltiples

Puede incorporar reglas con los operadores AND (Y) o los operadores OR (O) para probar las condiciones múltiples.

NOTA: No se admite el uso de los operadores AND y OR juntos en la misma regla de inventario personalizado. Configure aplicaciones por separado.

Al incorporar reglas condicionales se producen los resultados siguientes:

IMPORTANTE: No escriba reglas en líneas separadas. Separe las reglas solo por espacio. Tener reglas en líneas separadas invalida la regla compuesta.

Búsqueda de condiciones múltiples (AND)

Utilice el operador AND para incorporar reglas condicionales en el campo Inventario personalizado si desea que el elemento sea informado solo como programa instalado si todas las reglas son verdaderas.

En el campo Inventario personalizado, una las reglas con la siguiente sintaxis:

Separe los enunciados condicionales del operador con espacios.

Ejemplo: Búsqueda de una clave de registro y comparación de valores

Para buscar un valor de clave de registro y de entrada de registro en un dispositivo Windows, use AND para combinar las reglas de la siguiente manera:

Búsqueda de una condición verdadera (OR)

Cuando une reglas con el operador OR, si cualquiera de las reglas en el campo Inventario personalizado es verdadera, la aplicación aparece en la lista Programas instalados del dispositivo.

En el Campo Inventario personalizado, una las reglas con la siguiente sintaxis:

Separe los enunciados de función y el operador con un espacio.

Ejemplo: Búsqueda de cualquier valor de registro

Para verificar que una entrada de registro sea un valor u otro:

SUGERENCIA: Para especificar un rango, utilice las reglas RegistryValueGreaterThan y RegistryValueLessThan unidas por el operador AND.

Obtención de valores de un dispositivo (campo Inventario personalizado)

Obtención de valores de un dispositivo (campo Inventario personalizado)

Las reglas que finalizan en ValueReturn le permiten recopilar información a partir del dispositivo. Puede utilizar estas reglas para recopilar información que el agente de KACE no recopila normalmente.

Los valores devueltos se configuran con el nombre para mostrar de la aplicación personalizada (título). Esto aparece en la página Detalles del dispositivo en Software en Programas instalados y Campos del inventario personalizado.

Utilice los valores del Campo Inventario personalizado para administrar las instalaciones y distribuir el software, así como también los informes, los filtro Ver por, los criterios de búsqueda de Etiqueta inteligente o cualquier otro proceso que se pueda realizar con un ajuste de detección automática.

Esta sección abarca los temas siguientes:

Referencia de la regla de generación de valor

La siguiente tabla muestra todas las reglas de generación de valores disponibles que puede utilizar para ajustar un Campo Inventario personalizado :

Obtención de los valores de información del archivo

Puede establecer el Campo Inventario personalizado con cualquiera de los atributos de información del archivo de Windows con la regla FileInfoReturn.

Ejemplo: Obtención de la versión de Mozilla Firefox

El ejemplo a continuación establece el campo Inventario personalizado para la versión de producto de Mozilla Firefox como un NÚMERO:

En el Campo Inventario personalizado, escriba lo siguiente:

Obtención de los valores de la clave de registro

Puede establecer el Campo Inventario personalizado para una clave de registro con la regla RegistryValueReturn. Donde registryPath (a la izquierda) es la ruta de acceso a la entrada y valueName (a la derecha) es la clave que desea mostrar.

Ejemplo: Obtención de la clave de versión actual de Mozilla Firefox

Para establecer la clave de registro de versión actual como campo Inventario personalizado:

Obtención del resultado del comando

Las reglas de comando le permiten establecer el resultado de un comando en un Campo Inventario personalizado. El comando depende del interpretador de comando y de la ruta de acceso ejecutable en el dispositivo.

Por ejemplo, en los dispositivos Windows puede escribir comandos MS-DOS, pero no puede escribir comandos UNIX del estilo Cygwin a menos que Cygwin esté instalado y disponible en la ruta de acceso predeterminada para todos los usuarios.

Utilice cualquiera de las reglas a continuación para establecer la salida del comando en un campo Inventario personalizado:

Ejemplo: Obtención de tiempo de actividad en Mac OS X

Para establecer el tiempo activo como un campo Inventario personalizado:

Obtención de valores de PLIST

Las reglas PlistValueReturn le permiten establecer una clave de lista de propiedades (PList) como un Campo Inventario personalizado.

Ejemplo: Obtención de la configuración regional del sistema

Para distribuir aplicaciones con instalaciones administradas según el idioma proporcionado por el sistema, escriba la siguiente regla para obtener la configuración regional del dispositivo y, luego, cree la etiqueta inteligente correspondiente que se aplicará al dispositivo en función del código de idioma que informe el agente de KACE en el campo Inventario personalizado:

Obtención de valores múltiples

Una reglas ValueReturn con los operadores AND u OR. La regla muestra la aplicación como programa instalado, si alguno de los valores no está vacío.

Los valores unidos están establecidos en el mismo campo Inventario personalizado separados por el operador y por lo tanto se consideran técnicamente como TEXTO a los fines de los criterios de búsqueda, filtros, informes y otros procesos del dispositivo.

Reglas ValueReturn unidas por:

En el campo Inventario personalizado, una las reglas con la sintaxis siguiente:

Separe los enunciados condicionales del operador con espacios. No una operadores AND y OR en la misma regla.

Coincidencia de nombres de archivo con expresiones regulares

Coincidencia de nombres de archivo con expresiones regulares

Las expresiones regulares buscan coincidencias de un carácter o una cadena especificados con los nombres de archivo en el directorio especificado.

Esta sección describe las expresiones regulares que coinciden con nombres de archivo en reglas condicionales y de generación de valores mediante una expresión regular.

NOTA: El agente de KACE solo proporciona funciones que comparan nombres de archivo con expresiones regulares.