KACE Systems Management Appliance 14.0 Common Documents

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

•

Obtención de los valores de la clave de registro

•

Obtención del resultado del comando

•

Obtención de valores de PLIST

•

Obtención de valores múltiples

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 :

Sintaxis	Win	RHEL	OS X	Descripción
RegistryValueReturn (rutaDeAccesoDelRegistro, nombreDelValor, tipo)	X			Muestra el valor de una entrada del registro y ajusta el tipo de datos al especificado.
EnvironmentalVariableReturn (var, tipo)Especificación de variables de entorno o usuario	X	X	X	Muestra el valor de una variable de entorno y ajusta el tipo de datos al especificado.
FileInfoReturn (rutaDeAcceso, atributo, tipo)	X	X	X	Muestra el valor de un atributo de archivo, consulte los tipos válidos en Definición de los argumentos de la regla.
ShellCommandTextReturn (comando)	X	X	X	Muestra la salida de un comando y establece el tipo de datos en TEXTO.
ShellCommandDateReturn (comando)	X	X	X	Muestra la salida del comando y establece el tipo de datos en FECHA.
ShellCommandNumberReturn (comando)	X	X	X	Muestra la salida del comando y establece el tipo de datos en NÚMERO.
PlistValueReturn (rutaDeAccesoCompleta, entrada, tipo)			X	Muestra el valor de la clave PLIST y establece el tipo de datos en TEXTO, NÚMERO o FECHA.

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:

FileInfoReturn(C:\Program Files\Mozilla Firefox\firefox.exe,CurrentVersion,TEXT)

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. La ilustración muestra un Editor de registro, con un panel de árbol del directorio en la izquierda, además de nombre, tipo y datos en la derecha.

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:

RegistryValueReturn (HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\Mozilla Firefox\CurrentVersion, TEXT

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:

•

ShellCommandTextReturn (comando)

•

ShellCommandDateReturn (comando)

•

ShellCommandNumberReturn (comando)

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

Para establecer el tiempo activo como un campo Inventario personalizado:

ShellCommandTextReturn(/usr/bin/uptime | sed -e 's/.*load averages://' | awk '{print $1}')

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:

PlistValueReturn(~/Library/Preferences/GlobalPreferences.plist, configuraciónRegionalApple, TEXTO)

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:

•

Operador AND: todos los valores se informan en el campo Inventario personalizado.

•

Operador OR: todos los valores se informan en el campo Inventario personalizado.

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

Función (argumentos...) AND Función (argumentos) AND ...

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

Comprensión de las expresiones regulares

Referencia de regla de expresión regular

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.

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

Comprensión de las expresiones regulares

Puede utilizar la sintaxis de expresiones regulares para buscar la coincidencia de los nombres de archivo.

TIP: Para obtener más información acerca de cómo escribir expresiones regulares, vaya a http://msdn.microsoft.com/en-us/library/az24scfc.aspx.

La siguiente tabla brinda información general sobre la sintaxis de las expresiones regulares utilizadas para buscar la coincidencia de los nombres de archivo:

Carácter	Descripción	Expresión de ejemplo	Archivos de destino	Archivos coincidentes
(cualquier cadena)	Los caracteres no especiales coinciden con cualquier nombre de archivoque contenga la cadena.	abc	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	abcFile.xls Myabc.txt MyFile.abc
.	El punto coincide con cualquier carácter único. Cuando se ingresa solo, coincide con todos los archivos.	.	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc
\	La barra diagonal inversa se utiliza para omitir un carácter especial y para crear una referencia inversa. Para obtener más información, visite http://rexegg.com/regex-capture.html.	.*\.txt$	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	Myabc.txt
^	El circunflejo busca coincidencias con los caracteres que especificó al inicio del nombre de archivo.	^k	install.exe kinstaller.exe runkbot.bat	kinstaller.exe
\|	La barra vertical separa una lista de opciones para buscar coincidencias.	run\|install	install.exe kinstaller.exe runkbot.bat	install.exe kinstaller.exe runkbot.bat
$	El símbolo de dólar busca coincidencias con los caracteres que especificó al final del nombre de archivo.	bat$	install.exe kinstaller.exe runkbot.bat	runkbot.bat
?	Los signos de pregunta hacen que el carácter anterior sea opcional en la búsqueda de coincidencias.	\.log10?$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 mylog.log10
*	El asterisco busca coincidencias del carácter anterior cero o más veces.	\.log1*$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 app.log appconf.log11
+	El símbolo más busca coincidencias del carácter anterior una o más veces.	ap+.*\.log	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log appconf.log11
[ ]	Los corchetes encierran una clase de carácter y equiparan cualquier carácter dentro de los corchetes. Las reglas de carácter especial de clase de carácter son diferentes a las expresiones regulares normales.	[123]	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 afile.txt3 appconf.log11 mylog.log10
()	Los paréntesis que encierran caracteres crean una referencia inversa y equiparan los caracteres precedentes y/o los caracteres encerrados. Para obtener más información, visite http://rexegg.com/regex-capture.html.	(p)\1	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log appconf.log11
{n}	Las llaves repiten el carácter anterior la cantidad de veces especificada, si n es mayor o igual a 1.	{p}\.log$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log

Referencia de regla de expresión regular

La sintaxis de una regla de expresión regular varía ligeramente de las otras reglas de archivo. El argumento rutaDeAccesoCompleta es una cadena que une la ruta de acceso absoluta a la ubicación del archivo, pero no incluye el nombre del archivo. El nombre del archivo se especifica como un argumento separado con una expresión regular.

La tabla a continuación proporciona una lista de reglas que le permiten usar expresiones regulares.

Sintaxis	Win	RHEL	OS X	Descripción
FilenamesMatchingRegexExist (rutaDeAccesoCompleta,regex)	X	X	X	Resulta verdadero si cualquiera de los archivos en el directorio especificado coincide con el nombre de archivo que escribió mediante la expresión regular.
FilenamesMatchingRegexGreaterThan (rutaDeAccesoCompleta,regex,valor)	X	X	X	Verdadero si la cantidad de archivos que coinciden es mayor que el valor.
FilenamesMatchingRegexLessThan (rutaDeAccesoCompleta,regex,valor)	X	X	X	Verdadero si la cantidad de archivos que coinciden es menor que el valor.
FilenamesMatchingRegexEqual (rutaDeAccesoCompleta,regex,valor)	X	X	X	Verdadero si la cantidad de archivos que coinciden es igual al valor.
FilenamesMatchingRegexReturn (rutaDeAccesoCompleta,regex,tipo)	X	X	X	Establece el campo Inventario personalizado según los nombres de archivo que coinciden (incluye la ruta de acceso).

Documentos relacionados

The document was helpful.

Seleccionar calificación

I easily found the information I needed.

Seleccionar calificación

Seleccione su producto:

Con el fin de ofrecerle un mejor servicio, complete el campo Motivo del chat:

Soluciones recomendadas para su problema

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

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

Coincidencia de nombres de archivo con expresiones regulares

Comprensión de las expresiones regulares

Referencia de regla de expresión regular