KACE Systems Management Appliance 14.0 Common Documents

Verificação de condições (regras condicionais)

Você pode elaborar regras para Inventário personalizado que identificam se um aplicativo está ou não (true/false) instalado.

Ao usar uma regra condicional, se a regra retornar verdadeiro, o nome de exibição (Título) do aplicativo personalizado é exibido em Software: Seção Programas instalados da página Detalhe do dispositivo na seção Inventário.

As seções a seguir descrevem as regras que testam as condições:

•

Referência de regra Condicional

•

Verificação de existência de condição (Regras Exists)

•

Avaliação das configurações do dispositivo (Regras Equals)

•

Comparação de valores de dispositivo (Regras Greater e Less Than)

•

Teste de condições variadas

Quando a regra retornar falso, o aplicativo não aparece na seção Programas instalados nos detalhes do inventário do dispositivo.

Tip:	DICA: É possível exibir uma lista de dispositivos que possuem o item instalado em Inventário > Inventário personalizado > Custom_item: Página Detalhe.

Referência de regra Condicional

A tabela a seguir descreve os tipos de dados que podem ser usados para comparação.

Tipos de dados com suporte para funções de comparação
Regra condicional	Tipos de dados com suporte para funções de comparação Equals, GreaterThan, LessThan
EnvironmentVariable	DATE, NUMBER, TEXT
FileInfo	DATE, NUMBER, TEXT
FilenamesMatchingRegex	NUMBER
FileVersion	TEXT
PlistValue	NUMBER, TEXT
ProductVersion	TEXT
RegistryValue	TEXT

A tabela a seguir descreve como as comparações são feitas.

Como as comparações são feitas

Tipo de dados

Considerações

DATE

•

Antes da avaliação, os valores de destino são analisados como uma data usando as mesmas regras da classe DateTime PHP e normalizados para usar o seguinte formato:

MM/DD/AAAA HH:MM:SS

•

O carimbo de data/hora listado no banco de dados da solução usa o relógio em 24 horas (0 - 24 horas).

•

O carimbo de data/hora listado no banco de dados da solução reflete a hora UTC (Coordinated Universal Time, Tempo universal coordenado), para que ela seja normalizada em todos os dispositivos, independentemente dos seus respectivos fusos horários.

•

Se o valor de destino contiver somente uma data, um carimbo de data/hora será adicionado com base na meia-noite para UTC.

NUMBER

•

Somente números inteiros são avaliados.

•

Se um valor de destino contiver outros caracteres (letras, sinais de pontuação e assim por diante), somente os números até o primeiro não número são avaliados.

Por exemplo, se o valor de destino for 52a1, somente 52 será avaliado.

•

Somente números até o valor positivo máximo inteiro de 32 bits (2.147.483.647) têm suporte.

TEXT

•

Os valores são avaliados sem alteração, sem nenhuma alteração de formatação potencial (como pode ocorrer com tipos de dados DATE e NUMBER).

•

Sequências de texto são avaliadas em ordem lexicográfica.

•

As sequências sendo avaliadas podem conter vírgulas; não é necessário ignorá-las.

A tabela a seguir fornece uma lista das regras condicionais disponíveis com links para informações específicas sobre como especificar os argumentos.

Referência de regra Condicional
Sintaxe	Win	RHEL	OS X	Descrição
DirectoryExists (path)	X	X	X	Verifica se há um diretório no caminho especificado no dispositivo.
FileExists (path)	X	X	X	Verifica se há um arquivo no caminho especificado no dispositivo. Incluir o nome do arquivo e a extensão no caminho.
FileVersionEquals (path, version)	X			Verifica se a propriedade Versão > Versão do arquivo do arquivo especificado no caminho corresponde ao valor de TEXTO que você inseriu.
FileVersionLessThan (path, version)	X			Verifica se a propriedade Versão > Versão do arquivo do arquivo especificado no caminho é inferior ao valor de TEXTO que você inseriu.
FileVersionGreaterThan (path, version)	X			Verifica se a propriedade Versão > Versão do arquivo do arquivo especificado é superior ao valor de TEXTO que você inseriu.
ProductVersionEquals (path, version)	X			Verifica se a propriedade Versão > Versão do produto do arquivo executável ou de instalação especificado corresponde ao valor de TEXTO que você inseriu.
ProductVersionLessThan (path, version)	X			Verifica se a propriedade Versão > Versão do produto do arquivo executável ou de instalação especificado é inferior ao valor de TEXTO que você inseriu.
ProductVersionGreaterThan (path, version)	X			Verifica se a propriedade Versão > Versão do produto do arquivo executável ou de instalação especificado é superior ao valor de TEXTO que você inseriu.
FileInfoGreaterThan (fullpath, attribute, type, value)	X	X	X	Verifica se a propriedade Informações do arquivo do arquivo executável ou de instalação especificado é superior ao valor que você digitou.
FileInfoLessThan (fullpath, attribute, type, value)	X	X	X	Verifica se a propriedade Informações do arquivo do arquivo executável ou de instalação especificado é inferior ao valor que você digitou.
FileInfoEquals (fullpath, attribute, type, value)	X	X	X	Verifica se o atributo do arquivo executável ou de instalação especificado coincide com o valor que você digitou.
RegistryKeyExists (registryPath)	X			Verifica se existe uma chave de Registro.
RegistryValueEquals (registryPath, valueName, value)	X			Verifica se uma entrada de registro corresponde exatamente ao valor especificado. O valor é comparado como TEXTO.
RegistryValueLessThan (registryPath, valueName, value)	X			Verifica se a entrada de registro é inferior ao valor especificado. O valor é um TEXT.
RegistryValueGreaterThan (registryPath, valueName, value)	X			Verifica se a entrada de registro é superior ao valor especificado. O valor é um TEXT.
EnvironmentalVariableExists (var)	X	X	X	Verifica se existe uma variável de ambiente com o nome especificado.
EnvironmentalVariableGreaterThan (var, type, value)	X	X	X	Verifica se a definição da variável de ambiente é superior ao valor especificado. Todos os três tipos são válidos, TEXT, DATE (no formato completo dd/mm/aaaa hh:mm:ss) e NUMBER.
EnvironmentalVariableLessThan (var, type, value)	X	X	X	Verifica se a definição da variável de ambiente é inferior ao valor especificado. Todos os três tipos são válidos, TEXT, DATE (no formato completo dd/mm/aaaa hh:mm:ss) e NUMBER.
EnvironmentalVariableEquals (var, type, value)	X	X	X	Verifica se a definição da variável de ambiente coincide exatamente com o valor especificado. Todos os três tipos são válidos, TEXT, DATE (no formato completo dd/mm/aaaa hh:mm:ss) e NUMBER.
PlistValueExists (fullpath, entry)			X	Verifica se existe um valor nomeado em um arquivo PLIST.
PlistValueGreaterThan (fullpath, entry, type, value)			X	Verifica se o valor nomeado é um TEXT ou NUMBER superior ao valor especificado.
PlistValueLessThan (fullpath, entry, type, value)			X	Verifica se o valor nomeado é um TEXT ou NUMBER inferior ao valor especificado.
PlistValueEquals (fullpath, entry, type, value)			X	Verifica se o valor nomeado é um TEXT ou NUMBER que coincide exatamente com o valor especificado.

Para obter informações sobre Equals, GreaterThan e LessThan para FilenamesMatchingRegex, consulte Referência da regra de expressão regular.

Verificação de existência de condição (Regras Exists)

Regras cujo nome termina com Exists verificam a presença de um arquivo, diretório, chave de Registro ou outro item. Se o Agente do KACE localizar o item no dispositivo, a regra retornará "true", e o item aparecerá como um programa instalado nos detalhes de inventário do dispositivo.

Use qualquer uma das regras Exists a seguir:

•

DirectoryExists (path)

•

FileExists (path)

•

RegistryKeyExists (registryPath)

•

EnvironmentalVariableExists (var)

•

PlistValueExists (fullpath, entry)

•

FilenameMatchingRegexExist (fullpath, regex)

Exemplo: Verificar um diretório (pasta)

O exemplo a seguir verifica se existe diretório do Windows no dispositivo:

DirectoryExists(C:\WINDOWS\)

Exemplo: Verificar um arquivo

NOTA: O exemplo a seguir verifica se o arquivo executável do Bloco de Notas existe no dispositivo:

FileExists(C:\WINDOWS\notepad.exe)

Avaliação das configurações do dispositivo (Regras Equals)

Regras cujo nome termina com Equals compara o valor definido no dispositivo com o valor especificado na regra. A regra retorna true, se os valores coincidirem exatamente.

Regras que usam argumentos com tipos de dados definidos só podem comparar valores do mesmo tipo.

Use qualquer uma das regras Exists a seguir:

•

FileVersionEquals (path, version)

•

ProductVersionEquals (path, version)

•

FileInfoEquals (fullpath, attribute, type, value)

•

RegistryValueEquals (registryPath, valueName, value)

•

EnvironmentalVariableEquals (var, type, value)

•

PlistValueEquals (fullpath, entry, type, value)

•

FilenameMatchingRegexEqual (fullpath, regex, value)

Exemplo: Teste das configurações JAVA_HOME

Verificar se a configuração JAVA_HOME está em C:\Program Files\Java\jdk1.6.0_02:

EnvironmentVariableEquals(JAVA_HOME, TEXT, C:\Program Files\Java\jdk1.6.0_02)

Exemplo: Teste da configuração de entrada de registro do McAfee®

Para verificar a configuração, use o mesmo formato da data da entrada:

RegistryValueEquals(HKEY_LOCAL_MACHINE\Software\McAfee\AVEngine, AVDatDate, 2014/03/01)

Exemplo: Detecção do Windows 7 Service Pack 1

O Windows 7 Service Pack 1 aparece em Adicionar/Remover programas de dispositivos que originalmente tinham o Windows 7 e só depois atualizaram para o SP1. O inventário de aplicativo padrão para esse item não reflete os dispositivos que já estão no SP1 porque suas imagens foram criadas originalmente no nível SP1.

Ao usar o equipamento para implantar o Windows 7 Service Pack 1, crie a seguinte regra de inventário personalizada para um aplicativo personalizado:

RegistryValueEquals(HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\

CurrentVersion,CSDVersion,Service Pack 2)

Em seguida, é possível excluir dispositivos com esse item instalado para evitar que o equipamento tente implantar o SP2 em dispositivos que já estão nesse nível (ou seja, os dispositivos com Windows 7 que tenham sido atualizados e os dispositivos originalmente idealizados com SP1).

Comparação de valores de dispositivo (Regras Greater e Less Than)

Funções cujos nomes terminam com GreaterThan e LessThan comparam valores conforme listados em Table 24.

Use qualquer uma das regras Greater Than e Less Than a seguir:

•

FileVersionGreaterThan (path, version) e FileVersionLessThan (path, version)

•

ProductVersionGreaterThan (path, version) e ProductVersionLessThan (path, version)

•

FileInfoGreaterThan (fullpath, attribute, type, value) e FileInfoLessThan (fullpath, attribute, type, value)

•

RegistryValueGreaterThan (registryPath, valueName, value) e RegistryValueLessThan (registryPath, valueName, value)

•

EnvironmentalVariableGreaterThan (var, type, value) e EnvironmentalVariableLessThan (var, type, value)

•

PlistValueGreaterThan (fullpath, entry, type, value) e PlistValueLessThan (fullpath, entry, type, value)

•

FilenameMatchingRegexGreaterThan (fullpath, regex, value) e FilenameMatchingRegexLessThan (fullpath, regex, value)

Exemplo: Testar se a versão do produto é superior

Para verificar se a versão do produto é superior a um determinado número:

ProductVersionGreaterThan (C:\Program Files\Mozilla Firefox\firefox.exe, 78)

Para verificar se a versão do produto é um determinado número ou superior, digite:

ProductVersionEquals (C:\Program Files\Mozilla Firefox\firefox.exe, 78)

OR ProductVersionGreaterThan (C:\Program Files\Mozilla Firefox\firefox.exe,

78)

Exemplo: Testar um intervalo de versão do produto

Para testar se a versão do produto está dentro de um intervalo, combine as regras Less Than e Greater Than:

ProductVersionGreaterThan (C:\Program Files\Mozilla Firefox\firefox.exe, 77)
e ProductVersionLessThan (C:\Program Files\Mozilla Firefox\firefox.exe, 79)

Important:

IMPORTANTE: Não insira regras em linhas separadas. Separe as regras apenas com espaço. Se houver regras em linhas separadas, a regra de composto será invalidada.

Teste de condições variadas

Você pode associar regras usando operadores E e OU para testar várias condições.

NOTA: O uso de operadores E e OU na mesma regra para inventário personalizado não é suportado. Configure aplicativos separados.

Associar regras condicionais gera os seguintes resultados:

•

Operador E: Todas as regras devem retornar true para que os resultados retornem true e informem o aplicativo como um programa instalado.

•

Operador OR: Apenas uma regra deve retornar true para o aplicativo a ser informado como um programa instalado.

Important:

IMPORTANTE: Não insira regras em linhas separadas. Separe as regras apenas com espaço. Se houver regras em linhas separadas, a regra de composto será invalidada.

Verificação de várias condições true (E)

Só use o operador E para associar regras condicionais no campo de inventário personalizado se todas as regras forem "true" e quando desejar que um item seja relatado como um programa instalado.

No Campo de inventário personalizado, associe regras usando a seguinte sintaxe:

Function
(arguments...
) AND Function
(arguments
) AND ...

Separe as instruções condicionais do operador com espaços.

Exemplo: Verificação de chave de registro e comparação de valores

Para verificar uma chave de Registro e um valor de entrada do Registro em um dispositivo Windows use ABD para combinar as regras conforme mostrado abaixo:

RegistryKeyExists(registryPath
) AND RegistryValueEquals(registryPath, valueName, value)

Verificação de uma condição true (OR)

Ao associar regras usando o operador OR, se qualquer uma das regras no Campo de inventário personalizado for "true", o aplicativo aparecerá na lista do dispositivo Programa instalado.

No Campo de inventário personalizado, associe as regras usando a seguinte sintaxe:

Function
(arguments
) OR Function
(arguments
) OR ...

Separe as instruções de função do operador usando um espaço.

Exemplo: Verificação de valor do registro

Para verificar se uma entrada de Registro é um valor ou outro:

RegistryValueEquals(registryPath, valueName, value) OR
RegistryValueEquals(registryPath, valueName, value)

Tip:	DICA: Para especificar um intervalo, use as regras RegistryValueGreaterThan e RegistryValueLessThan associadas ao operador E.

Obtenção de valores de um dispositivo (Campo de inventário personalizado)

As regras que terminam com ValueReturn permitem coletar informações do dispositivo. Use essas regras para obter as informações que o Agente do KACE normalmente não tem.

Os valores retornados são definidos com o nome de exibição do aplicativo personalizado (título). Eles são exibidos na página Detalhes do dispositivo em Software em Programas instalados e Campos de inventário personalizados.

Use os valores do Campo de inventário personalizado para gerenciar as instalações e distribuir o software, os relatórios, a filtragem Visualizar por, os critérios de pesquisa de Rótulo inteligente ou qualquer outro processo que possa ser realizado com uma configuração detectada automaticamente.

Esta seção aborda os seguintes tópicos:

•

Referência regra de Valor de retorno

•

Obtenção de valores da chave de registro

•

Obtenção da saída de comando

•

Obtenção de valores PLIST

•

Obtenção de vários valores

Referência regra de Valor de retorno

A tabela a seguir mostra todas as regras de retorno de valor disponíveis que você pode usar para definir um campo de inventário personalizado:

Sintaxe	Win	RHEL	OS X	Descrição
RegistryValueReturn (registryPath, valueName, type)	X			Retorna o valor de uma entrada de Registro e define o tipo de dados para o que você especificou.
EnvironmentalVariableReturn (var, type)Especificação das variáveis de ambiente ou de usuário	X	X	X	Retorna o valor de uma variável de ambiente e define o tipo de dado para aquele definido por você.
FileInfoReturn (path, attribute, type)	X	X	X	Retorna o valor de um atributo de arquivo, consulte os tipos válidos em Definição da regra de argumentos.
ShellCommandTextReturn (command)	X	X	X	Retorna a saída do comando e define o tipo de dados para TEXT.
ShellCommandDateReturn (command)	X	X	X	Retorna a saída do comando e define o tipo de dados para DATE.
ShellCommandNumberReturn (command)	X	X	X	Retorna a saída do comando e define o tipo de dados para NUMBER.
PlistValueReturn (fullpath, entry, type)			X	Retorna o valor da chave PLIST e define o tipo de dados para TEXT, NUMBER ou DATE.

Obtenção dos valores das informações de arquivo

É possível definir o Campo de inventário personalizado em qualquer um dos atributos das informações de arquivo do Windows usando a regra FileInfoReturn.

Exemplo: Como obter a versão do Mozilla Firefox

O exemplo a seguir define o Campo de inventário personalizado para a versão de produto do Mozilla Firefox como NUMBER:

No Campo de inventário personalizado, digite:

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

Obtenção de valores da chave de registro

Você pode definir Campo de inventário personalizado como uma chave de registro usando a regra RegistryValueReturn. Em que registryPath (à esquerda) é o caminho para a entrada e valueName (à direita) é a chave que você deseja retornar. A ilustração mostra o Editor de registro, com um painel de árvore de diretório à esquerda, e nome, tipo e dados à direita.

Exemplo: Como obter a chave CurrentVersion do Mozilla Firefox

Para definir a chave de registro CurrentVersion como um Campo de inventário personalizado:

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

Obtenção da saída de comando

Regras Command permitem que você defina a saída de um comando como um Campo de inventário personalizado. O comando depende do interpretador de comandos e do caminho do executável no dispositivo.

Por exemplo, em dispositivos Windows, é possível escrever comandos do MS-DOS, mas não comandos UNIX estilo Cygwin, a menos que o Cygwin esteja instalado e disponível no caminho padrão para todos os usuários.

Use qualquer uma das regras a seguir para definir a saída do comando para um Campo de inventário personalizado:

•

ShellCommandTextReturn (command)

•

ShellCommandDateReturn (command)

•

ShellCommandNumberReturn (command)

Exemplo: Obtenção do tempo de ativação em um Mac OS X

Para definir o tempo de ativação como um Campo de inventário personalizado:

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

Obtenção de valores PLIST

As regras PlistValueReturn permitem definir uma chave Property List (PList) como um Campo de inventário personalizado.

Exemplo: Obtenção da localidade do sistema

Para distribuir os aplicativos usando as instalações gerenciadas com base no idioma fornecido pelo sistema, digite a seguinte regra para obter a localidade do dispositivo e crie um rótulo inteligente correspondente que seja aplicado ao dispositivo com base no código do idioma informado pelo Agente do KACE no Campo de inventário personalizado:

PlistValueReturn(~/Library/Preferences/GlobalPreferences.plist, AppleLocale, TEXT)

Obtenção de vários valores

Associe regras ValueReturn usando o operador E ou OR. A regra mostra o aplicativo como um programa instalado, se algum valor não estiver vazio.

Os valores associados estão todos definidos no mesmo Campo de inventário personalizado, separados pelo operador e, portanto, são tecnicamente considerados para fins de critérios de pesquisa, filtros, relatórios e outros processos do equipamento como TEXT.

As regras ValueReturn associadas pelo:

•

Operador E: Todos os valores são informados no Campo de inventário personalizado.

•

Operador OR: Todos os valores são informados no Campo de inventário personalizado.

No Campo de inventário personalizado, associe regras usando a seguinte sintaxe:

Function(arguments...) AND Function(arguments) AND ...

Separe as instruções condicionais do operador com espaços. Não associe os operadores E e OR na mesma regra.

Correspondência de nomes de arquivos com expressões regulares

Noções básicas das expressões regulares

Referência da regra de expressão regular

As expressões regulares comparam um caractere ou sequência de caracteres específicos aos nomes de arquivos no diretório especificado.

Esta seção descreve as expressões regulares que correspondem a nomes de arquivos nas regras Condicionais e de Retorno de valor que usam uma expressão regular.

NOTA: O Agente do KACE fornece somente funções que comparam os nomes de arquivos que usam expressões regulares.

Noções básicas das expressões regulares

É possível usar a sintaxe de expressões regulares para corresponder aos nomes de arquivos.

Tip:	DICA: Para obter mais informações sobre como escrever expressões regulares, acesse http://msdn.microsoft.com/en-us/library/az24scfc.aspx.

A tabela a seguir fornece uma visão geral da sintaxe de expressões regulares usada para correspondência com os nomes de arquivos:

Caractere	Descrição	Expressão de exemplo	Arquivos de destino	Arquivos correspondidos
(qualquer cadeia)	Os caracteres não especiais correspondem a qualquer nome de arquivo que contenha a sequência.	abc	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	abcFile.xls Myabc.txt MyFile.abc
.	Ponto corresponde a qualquer caractere único. Quando inserido sozinho ele corresponde a todos os arquivos.	.	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc
\	A barra invertida é usada para substituir um caractere especial e para criar uma referência invertida. Para obter mais informações, vá para http://rexegg.com/regex-capture.html.	.*\.txt$	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	Myabc.txt
^	O acento circunflexo corresponde aos caracteres especificados para o início do nome do arquivo.	^k	install.exe kinstaller.exe runkbot.bat	kinstaller.exe
\|	A barra vertical separa uma lista de opções para corresponder.	run\|install	install.exe kinstaller.exe runkbot.bat	install.exe kinstaller.exe runkbot.bat
$	O cifrão corresponde aos caracteres especificados para o fim do nome do arquivo.	bat$	install.exe kinstaller.exe runkbot.bat	runkbot.bat
?	O ponto de interrogação faz com que o caractere anterior seja opcional nas correspondências.	\.log10?$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 mylog.log10
*	O asterisco corresponde ao caractere anterior zero ou mais vezes.	\.log1*$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 app.log appconf.log11
+	O sinal de mais corresponde ao caractere anterior um ou mais vezes.	ap+.*\.log	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log appconf.log11
[ ]	Os colchetes circunscrevem uma classe de caracteres e correspondem qualquer caractere dentro deles. As regras de caracteres especiais da classe de caractere diferem das expressões regulares normais.	[123]	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 afile.txt3 appconf.log11 mylog.log10
()	Caracteres entre parênteses criam uma referência anterior e correspondem aos caracteres anteriores e/ou aos caracteres circunscritos. Para obter mais informações, vá para http://rexegg.com/regex-capture.html.	(p)\1	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log appconf.log11
{n}	As chaves repetem o caractere que precede o número de vezes especificado, onde n é maior ou igual a 1.	{p}\.log$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log

请选择您的产品：

为向您提供更好的服务，请填写'Purpose of your Chat'（联系目的）：

针对您的问题建议的解决方案

KACE Systems Management Appliance 14.0 Common Documents - Guia de administração

Verificação de condições (regras condicionais)

Obtenção de valores de um dispositivo (Campo de inventário personalizado)

Correspondência de nomes de arquivos com expressões regulares

Noções básicas das expressões regulares