KACE Systems Management Appliance 7.1 - Guia de administração

Criação de regras para Inventário personalizado

Aplicação das regras para inventário personalizado

Sintaxe das regras para Inventário personalizado

É possível criar aplicativos personalizados e Regras de inventário personalizadas para estes aplicativos para que as informações sobre os aplicativos sejam coletadas de dispositivos gerenciados.

Acesse a página Detalhes do software:

Faça login no Console do administrador do K1000, http://K1000_hostname/admin. Ou, se a opção Mostrar menu da organização no cabeçalho administrativo estiver ativada nas Configurações gerais da solução, selecione uma organização na lista suspensa no canto superior direito da página, ao lado das informações de login.

Na barra de navegação esquerda, clique em Inventário e em Software.

Selecione Escolher ação > Novo.

Fornecer informações gerais: Nome, Versão, Editor.

Para a devida divulgação de informações., insira essas informações de forma consistente em todo inventário de software.

Insira as seguintes informações:

Opção	Descrição
Atribuir a rótulo	(Opcional) O rótulo associado ao item.
Notas	Qualquer informação que você queira acrescentar.
Sistemas operacionais compatíveis	Os sistemas operacionais nos quais o aplicativo é executado. Os aplicativos são implantados apenas nos dispositivos com os sistemas operacionais selecionados.
Regra de inventário personalizada	(Opcional) As regras de inventário personalizado aplicam-se ao aplicativo. As regras de inventário personalizado permitem que você detecte aplicativos e outros itens em um dispositivo e capture detalhes para o fornecimento de informações. Por exemplo, a solução verifica primeiro se o aplicativo está presente em um dispositivo, antes de implantá-lo. Porém, em alguns casos, programas instalados não são registrados em Adicionar/remover programas ou em áreas padrão do registro. Nesses casos, o equipamento pode não ser capaz de detectar a presença do aplicativo sem informações adicionais do administrador. Por isso, a solução poderá repetir a instalação sempre que o dispositivo se conectar. As regras de inventário personalizado podem evitar essa repetição. As regras a seguir verificam se a versão do Network Associates VirusScan instalada em um dispositivo é mais nova que uma determinada versão antes de implantá-la: RegistryValueGreaterThan(HKEY_LOCAL_MACHINE\ Software\Network Associates\TVD\ Network Associates\TVD\Shared Components\ VirusScanEngine\4.0.xx,szDatVersion,4.0.44)

Ao lado de Carregar e associar arquivo, clique em Escolher arquivo para localizar um arquivo e, em seguida, clique em Abrir ou Escolher.

Para distribuir aplicativos usando Instalações gerenciadas ou Sincronizações de arquivo, é necessário associar os arquivos de aplicativo reais ao aplicativo.

Para evitar que um arquivo seja copiado para os Compartilhamentos de replicação, selecione Não replicar arquivos associados. Essa configuração é útil quando há arquivos grandes, como suítes de software, que não devem ser instalados a partir dos Compartilhamentos de replicação pelos usuários.

Opcional: Selecione uma Categoria e Nível de ameaça para o software.

Clique em Salvar.

Aplicação das regras para inventário personalizado

O Agente do K1000 recebe novas regras de inventário personalizado durante o primeiro inventário de dispositivo depois de elas terem sido criadas. Durante esse primeiro inventário, o Agente executa as novas regras e relata os resultados para a solução.

O agente executa todas as regras e qualquer outro processo agendado para a sessão. Portanto, uma vez feito o inventário do dispositivo, a execução de todas as regras e de outros processos pode levar alguns minutos antes que o Agente informe os resultados.

Depois que Agente informa os resultados, a página de detalhes do dispositivo mostra os resultados em Software, em Programas instalados e nos Campos de inventário personalizados.

NOTA: Os aplicativos com as regras de retorno de valor que definem um Campo de inventário personalizado também aparecem como programas instalados.

Se os resultados não forem os esperados, verifique se o dispositivo passou pelo inventário corretamente. A hora de inventário é exibida no campo Último inventário na página de detalhes do dispositivo.

Sintaxe das regras para Inventário personalizado

Use a sintaxe correta para nomes de função e argumentos nas regras de Inventário personalizado.

As regras Valor de retorno e Condicional usam a seguinte sintaxe:

functionName(argument,argument,...)

Para obter informações específicas sobre as funções e seus argumentos, consulte:

•

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

Sintaxe de função

Digite o functionName seguido por um parêntese de abertura, coloque os argumentos com um parêntese de encerramento. Não são permitidos espaços entre o nome da função e o parêntese de abertura.

Sintaxe de argumento

Digite a sintaxe de argumento para todas as regras, exceto command e regex (expressão regular), a saber:

•

Argumentos separados por vírgula.

•

Vírgulas não são permitidas em nenhum outro lugar na string, exceto como descrito em Vírgulas e parênteses como valores em uma regra.

•

Não inclua aspas simples ou duplas.

•

O espaço em branco é cortado da frente e de trás de cada argumento.

Por exemplo, as seguintes sintaxes são as mesmas:

RegistryValueEquals(HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\
Version Vector, IE, 10.000)
RegistryValueEquals(HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\
Version Vector,IE,10.000)

Vírgulas e parênteses como valores em uma regra

Para usar uma vírgula, parêntese de abertura ou parêntese de fechamento como valores em uma regra, é preciso escapá-los como {{comma}}. {{op}}, and {{cp}}, respectivamente.

•

Em argumentos em que as vírgulas fazem parte do valor do parâmetro, é necessário escapá-las como {{comma}}, exceto no último argumento na função.

Por exemplo, se o usuário quiser testar o valor de registro cujo nome é “test,value”, será necessário escapar a vírgula nesse caso, pois o nome do valor de registro não é o último argumento na função de Inventário personalizado (CI).

RegistryValueEquals(HKEY_LOCAL_MACHINE\SOFTWARE\TestSoft, test{{comma}}value, HelloWorld)

Se o usuário quiser testar um valor de registro que contém uma vírgula, não será necessário escapar, pois o valor é o último argumento na função de Inventário personalizado. O inventário personalizado a seguir testa o valor de registro HKLM\SOFTWARE\TestSoft\test1 e verifica se o valor é igual a 2,4.

RegistryValueEquals(HKEY_LOCAL_MACHINE\SOFTWARE\TestSoft,test1,2,4)

Se a função de Inventário personalizado contém apenas um parâmetro, ela cobre tudo que está entre parênteses como valor do argumento. Nesse caso não é necessário escapar vírgulas, que farão parte do argumento na função de Inventário personalizado.

ShellCommandTextReturn(wmic MEMORYCHIP get BankLabel,Capacity,description,manufacturer)

•

É necessário escapar um parêntese aberto literal sem correspondente como {{op}}. Quando o parser está transformando os argumentos em tokens para a função, ele conta o número de parênteses abertos e fechados para determinar o final da função e argumento. Portanto, um parêntese aberto literal sem um correspondente atrapalha a conta e faz com que o valor de argumento seja analisado incorretamente. Se um parêntese aberto literal for necessário como parte do valor do argumento, deverá ser representado com {{op}}.

Por exemplo, se o usuário quiser exibir a cadeia “Hello ( World”, o inventário personalizado deverá ser o seguinte:

ShellCommandTextReturn(echo Hello {{op}} World)

•

É necessário escapar um parêntese fechado literal sem correspondente como {{cp}}.

Quando o parser está transformando os argumentos em tokens para a função, ele conta o número de parênteses abertos e fechados para determinar o final da função quando encontra o último parêntese fechado com correspondente. No entanto, se o próprio valor do argumento contém um parêntese fechado sem correspondente, isso leva o parser a achar que se trata do final da função e a truncar o valor do argumento prematuramente.

Se um parêntese fechado literal for necessário como parte do valor do argumento, deverá ser representado com {{cp}}.

Por exemplo, se o usuário quiser exibir a cadeia “Hello ) World”, o inventário personalizado deve ser o seguinte:

ShellCommandTextReturn(echo Hello {{cp}} World)

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.

DICA: É possível exibir uma lista de dispositivos que possuem o item instalado em Inventário > Software > 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 do K1000 usa o relógio em 24 horas (0 - 24 horas).

•

O carimbo de data/hora listado no banco de dados do K1000 reflete a hora UTC (Coordinated Universal Time, Tempo universal coordenado), para que ela seja normalizada em todos os dispositivos, independente 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 attribute 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 K1000 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: Teste da versão do Internet Explorer

Para verificar se a versão do Internet Explorer é 10.0.9200.17148:

FileVersionEquals(C:\Program Files\Internet Explorer\iexplore.exe, 10.0.9200.17148)

Especificar a versão como 10.0.9 retornaria falso. O argumento da versão em uma função Equals deve ser preciso. Um número parcial falhará quando a versão completa for maior.

Exemplo: Detecção do Windows XP Service Pack 2

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

Ao usar a solução para implantar o Windows XP Service Pack 2, 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 a solução tente implantar o SP2 em dispositivos que já estão nesse nível (ou seja, os dispositivos com SP1 que tenham sido atualizados e os dispositivos originalmente idealizados com SP2).

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 23.

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 a 10

Para verificar se a versão do produto é superior a 10:

ProductVersionGreaterThan(C:\Program Files\Internet Explorer\iexplorer.exe, 10)

Para verificar se a versão do produto é 10 (que é igual a 10) ou superior, digite:

ProductVersionEquals(C:\Program Files\Internet Explorer\iexplorer.exe, 10)

OR ProductVersionGreaterThan(C:\Program Files\Internet Explorer\iexplorer.exe,

10)

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\Internet Explorer\iexplorer.exe, 9)
AND ProductVersionLessThan(C:\Program Files\Internet Explorer\iexplorer.exe, 10)

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 OR 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.

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 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)

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

Please select your product:

To serve you better, please complete the Purpose of your Chat:

Recommended Solutions for Your Problem

KACE Systems Management Appliance 7.1 - Guia de administração

Criação de regras para Inventário personalizado

Aplicação das regras para inventário personalizado

Sintaxe das regras para Inventário personalizado

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