KACE Systems Management Appliance 14.0 Common Documents

Regras condicionais: Estas regras realizam testes para saber se há ou não uma condição nos dispositivos. Quando uma regra retorna true, o Agente do KACE relata o item como um programa instalado. Quando uma regra retorna falso, o item não aparece como um Programa instalado.

•

Regras de retorno de valor: Estas regras obtêm dados dos dispositivos. Se o valor existir, o Agente do KACE relata o item como um programa instalado e define um Campo de inventário personalizado correspondente.

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 da solução: https://appliance_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 Inventário personalizado.

Selecione Escolher ação > Novo.

Forneça 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.

Forneça as seguintes informações:

Opção	Descrição
Restringir ao 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 KACE 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\Mozilla\Mozilla Firefox, CurrentVersion, 78.0.2)
RegistryValueEquals(HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\Mozilla Firefox,CurrentVersion,78.0.2)

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)