KACE Systems Management Appliance 13.2 Common Documents

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

Referência da regra de expressão regular

A sintaxe de uma regra de expressão regular varia um pouco das outras regras de arquivo. O argumento fullpath é uma cadeia que corresponde ao caminho absoluto para o local do arquivo, mas não inclui o nome do arquivo. O nome do arquivo é especificado como um argumento separado que usa uma expressão regular.

A tabela a seguir fornece uma lista de regras que permite o uso de expressões regulares.

Definição da regra de argumentos

É possível definir argumentos em regras de inventário personalizado para localizar caminhos, arquivos, chaves de registro, informações de versão, variáveis de ambiente e outros atributos.

Para obter detalhes sobre a sintaxe de regra e seus usos, consulte as tabelas em Verificação de condições (regras condicionais), Obtenção de valores de um dispositivo (Campo de inventário personalizado) e Correspondência de nomes de arquivos com expressões regulares.

Localização de um caminho ou arquivo

path e fullpath são strings que especificam o caminho absoluto para um diretório ou arquivo no dispositivo. Por exemplo:

C:\Program Files\Mozilla Firefox\firefox.exe

O Agente do KACE localiza o diretório ou o arquivo e executa o teste específico.

Localização de uma chave de Registro e entrada

registryPath é uma cadeia que especifica o caminho absoluto no registro ou para uma chave de registro. Por exemplo:

HKEY_LOCAL_MACHINE/application/kace

Especificação de uma versão

version é um inteiro (tipo TEXT) que o Agente do KACE compara com a versão do item sendo testado no dispositivo.

Por exemplo, o teste FileVersionGreaterThan retorna 'true' se o valor especificado for superior ao número de versão do arquivo ou pasta e normalmente retorna 'false'.

Para testar um intervalo, associe a regra Less Than e Greater Than, conforme abaixo:

FileVersionGreaterThan(C:\Program Files\Adobe\Acrobat\7.0\Acrobat\Acrobat.exe, 6.99)

AND FileVersionLessThan(C:\Program Files\Adobe\Acrobat\7.0\

Acrobat\Acrobat.exe, 8.00)

Especificação das variáveis de ambiente ou de usuário

var é uma string que corresponde ao nome real da variável de ambiente no dispositivo.

Por exemplo, para testar se a variável de diretório Program Files está definida corretamente:

EnvironmentVariableEquals(ProgramFiles, TEXT,

C:\Program Files)

Especificação de um atributo de arquivo

attribute é uma propriedade do sistema, uma propriedade de arquivo ou pasta, ou uma propriedade do Agente do KACE atribuído no dispositivo. A solução fornece tipos de argumento que dependem dos sistemas operacionais.

Uso de atributos de arquivo Windows

Você pode usar as funções FileInfoGreaterThan, FileInfoLessThan e FileInfoEquals para testar uma propriedade de arquivo do Windows na seguinte sintaxe:

FunctionName (fullpath, attribute, type, value)

A tabela a seguir mostra os atributos com suporte do Windows:

Atributo	Tipo	Descrição
AccessedDate	DATE	Última data e hora que o arquivo foi acessado.
Comentários	TEXT	Informações adicionais fornecidas para fins de diagnóstico.
CompanyName	TEXT	Nome da empresa que produziu o arquivo.
CreatedDate	DATE	Quando o arquivo foi criado.
FileBuildPart	NUMBER	Terceira posição da versão do arquivo. Por exemplo: Na versão 1.2.3, 3=Build.
FileDescription	TEXT	Descrição do arquivo da página Detalhes de propriedades de arquivo do Windows.
FileMajorPart	NUMBER	Primeira posição da versão do arquivo. Por exemplo: Na versão 1.2.3, 1=Major.
FileMinorPart	NUMBER	Segunda posição da versão do arquivo. Por exemplo: Na versão 1.2.3, 2=Minor.
FileName	TEXT	Nome atual do arquivo. Consulte também FileExists.
FilePrivatePart	NUMBER	Quarta posição da versão do arquivo. Por exemplo: Na versão 1.2.3.4, 4=Private.
FileVersion	TEXT	Versão completa do arquivo mostrada na página Detalhes das propriedades do arquivo. Consulte também FileVersionEquals, FileVersionGreaterThan e FileVersionLessThan.
InternalName	TEXT	Nome interno do arquivo, caso exista, como o nome do componente. Se o arquivo não tiver um nome interno, ele será igual ao nome do arquivo original sem a extensão.
Idioma	TEXT	O código do idioma exibe o nome correspondente na página Detalhes das propriedades do arquivo.
LegalCopyright	TEXT	Avisos de copyright que se aplicam ao arquivo.
LegalTrademarks	TEXT	Marcas comerciais e marcas registradas que se aplicam ao arquivo.
ModifiedDate	DATE	Último dia e hora que o arquivo foi modificado.
OriginalFilename	TEXT	Fornece o nome completo do arquivo quando ele for colocado ou instalado no dispositivo.
PrivateBuild	TEXT	Informações sobre a versão do arquivo.
ProductBuildPart	NUMBER	Terceira posição da versão do produto. Por exemplo: Na versão 1.2.3, 3=Build.
ProductMajorPart	NUMBER	Primeira posição da versão do produto. Por exemplo: Na versão 1.2.3, 1=Major.
ProductMinorPart	NUMBER	Segunda posição da versão do produto. Por exemplo: Na versão 1.2.3, 2=Minor.
Nome do produto	TEXT	Cadeia que corresponde ao nome do produto da propriedade Windows.
ProductPrivatePart	NUMBER	Quarta posição da versão do produto. Por exemplo: Na versão 1.2.3.4, 4=Private.
ProductVersion	TEXT	A versão completa do produto. Consulte também ProductVersionEquals, ProductVersionGreaterThan e ProductVersionLessThan.
SpecialBuild	TEXT	Informações adicionais sobre a criação.

Teste para atributos de arquivos Linux e Mac

Em dispositivos Linux e Mac, você pode usar os seguintes argumentos para testar os atributos de arquivo:

Especificação de tipos de dados

type identifica o tipo de dados que você está testando ou retornando.

O Agente do KACE é compatível com os seguintes tipos:

•

TEXT é uma cadeia. Válido apenas para correspondências exatas de regras condicionais, como Equals. Em regras ValueReturn, define o tipo do Campo de inventário personalizado como string e limita os critérios de pesquisa e filtragem para corresponder aos operadores.

•

NUMBER é um número inteiro. Válido em todas as regras condicionais, permite que você especifique um número inteiro para comparação.

•

DATE deve ser no formato DD/mm/aaaa HH:mm:ss. Por exemplo:28/09/2006 05:03:51. A hora é obrigatória. Por exemplo, em uma comparação, como maior que, onde você deve pelo menos especificar dessa forma: 00:00:00.

Especificação de valores para teste

value normalmente segue o type, exceto em uma regra onde o tipo de dados é conhecido, como em uma regra de versão. O valor especificado deve corresponder ao tipo. Consulte Especificação de tipos de dados.

Especificação do nome de uma entrada de registro (somente Windows)

valueName é uma cadeia que corresponde ao nome da entrada do Registro que você deseja testar. Usada apenas em testes de registro para dispositivos Windows.

Especificação de uma chave PLIST (somente Mac)

entry é NUMBER, TEXT ou DATE e corresponde a uma chave em um arquivo PLIST em um dispositivo Mac OS X. Para fazer referência a uma chave que está em uma matriz ou dicionário no arquivo PLIST, especifique o nome ou inteiro da matriz ou dicionário, use um ponto e vírgula para limitar e o nome ou inteiro da chave (dicionário:chave) no argumento de entrada.

Exemplos de argumento:

•

Uma chave Item 0, em uma matriz PackageGroups, é referenciada usando PackageGroups:0 como argumento

•

Uma chave contentType, no dicionário Item 102, é referenciada usando 102:contentType como argumento.

Uso da expressão regular

regex é uma expressão regular que corresponde a um nome de arquivo em uma regra Condicional ou de Retorno de valor. Para obter mais detalhes, consulte Correspondência de nomes de arquivos com expressões regulares.

Definição de comandos

As funções de comando shell permitem especificar o command (comando) que você deseja executar no dispositivo. As diretrizes para escrever argumentos de regras não se aplicam ao comando. Entretanto, o espaço em branco após o parêntese de abertura e imediatamente antes do fechamento é removido do comando.

Teste de regras para o inventário personalizado

Para testar as regras do inventário personalizado, é possível executar um comando de inventário personalizado em um dispositivo gerenciado por Agente do KACE. Isso permite depurar as regras do inventário personalizado sem que seja necessário executar todo o processo de inventário.

Abra um prompt de comando em um dispositivo com o Agente do KACE instalado.

Digite o seguinte comando: kdeploy -custominventory

O Agente entra em contato com a solução e executa o inventário personalizado. Consultas e valores de retorno são exibidos.

Sintaxe	Win	RHEL	OS X	Descrição
FilenamesMatchingRegexExist (fullpath,regex)	X	X	X	Retorna true se todos os arquivos no diretório especificado corresponderem ao nome do arquivo que você digitou usando uma expressão regular.
FilenamesMatchingRegexGreaterThan (fullpath,regex,value)	X	X	X	True, se o número de arquivos que corresponde for maior que o valor.
FilenamesMatchingRegexLessThan (fullpath,regex,value)	X	X	X	True, se o número de arquivos que corresponde for menor que o valor.
FilenamesMatchingRegexEqual (fullpath,regex,value)	X	X	X	True, se o número de arquivos que corresponde for igual ao valor.
FilenamesMatchingRegexReturn (fullpath,regex,type)	X	X	X	Define o Campo de inventário personalizado com os nomes de arquivo correspondentes (inclui o caminho).

Atributo	Tipo	Descrição
access_time	DATE	Última vez que o usuário ou sistema acessou o arquivo
block_size	NUMBER	Tamanho de bloco do arquivo
bloqueios	NUMBER	O número de blocos usados pelo arquivo
creation_time	DATE	Hora em que o arquivo foi criado
device_number	NUMBER	O número de identificação do dispositivo (disco) com o arquivo
grupo	TEXT	Nome do grupo do proprietário do arquivo
inode	NUMBER	O número inode do arquivo
modification_time	DATE	Última vez que uma alteração foi feita e salva
number_links	NUMBER	Número de links diretos para o arquivo
proprietário	TEXT	O nome de usuário da pessoa que possui o arquivo
tamanho	NUMBER	Tamanho do arquivo.

请选择您的产品：

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

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

KACE Systems Management Appliance 13.2 Common Documents - Guia de administração (13.0)

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

Referência da regra de expressão regular

Definição da regra de argumentos

Teste de regras para o inventário personalizado