KACE Systems Management Appliance 13.2 Common Documents

Caractère	Description	Exemple d'expression	Fichiers cibles	Fichiers mis en correspondance
(toute chaîne)	L'utilisation de caractères non spéciaux permet uniquement de retrouver les noms de fichier contenant la chaîne en question.	abc	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	abcFile.xls Myabc.txt MyFile.abc
.	Le point remplace tout caractère unique. Saisi seul, il correspond à tous les fichiers.	.	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc
\	La barre oblique inverse permet d'utiliser une forme de remplacement pour un caractère spécial et de créer une référence à ce qui précède. Pour plus d'informations, rendez-vous sur http://rexegg.com/regex-capture.html.	.*\.txt$	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	Myabc.txt
^	L'accent circonflexe représente les caractères spécifiés au début du nom de fichier.	^k	install.exe kinstaller.exe runkbot.bat	kinstaller.exe
\|	La barre verticale sépare une liste d'options à faire correspondre.	run\|install	install.exe kinstaller.exe runkbot.bat	install.exe kinstaller.exe runkbot.bat
$	Le signe dollar représente les caractères spécifiés à la fin du nom de fichier.	bat$	install.exe kinstaller.exe runkbot.bat	runkbot.bat
?	Le point d'interrogation rend le caractère qui précède optionnel dans les résultats.	\.log10?$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 mylog.log10
*	L'astérisque représente le caractère qui précède zéro ou plusieurs fois.	\.log1*$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 app.log appconf.log11
+	Le signe plus représente le caractère qui précède une ou plusieurs fois.	ap+.*\.log	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log appconf.log11
[ ]	Les crochets délimitent une classe de caractères et représentent tout caractère dans les crochets. Les règles sur les caractères spéciaux (classe de caractères) diffèrent des expressions régulières.	[123]	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 afile.txt3 appconf.log11 mylog.log10
()	Les parenthèses délimitant des caractères créent une référence avec ce qui précède et représentent les caractères qui précèdent et/ou les caractères délimités. Pour plus d'informations, rendez-vous sur http://rexegg.com/regex-capture.html.	(p)\1	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log appconf.log11
{n}	Les accolades répètent le caractère qui précède n fois, où n est un entier supérieur ou égal à 1.	{p}\.log$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log

Référence concernant les règles avec expressions régulières

La syntaxe des règles avec expressions régulières varie légèrement des autres règles s'appliquant aux fichiers. Par exemple, l'argument fullpath est une chaîne qui correspond au chemin complet vers l'emplacement d'un fichier, mais il n'inclut pas le nom du fichier. Le nom du fichier est indiqué sous forme d'argument distinct à l'aide d'une expression régulière.

Le tableau suivant fournit une liste des règles vous permettant d'utiliser les expressions régulières.

Définition des arguments dans une règle

Vous pouvez définir des arguments dans les règles d'inventaire personnalisé pour rechercher des chemins d'accès, des fichiers, des clés de registre, des entrées de registre, des informations de version, des variables d'environnement et d'autres attributs.

Pour connaître la syntaxe des règles, reportez-vous aux tableaux dans Vérification des conditions (règles conditionnelles), Obtention de valeurs depuis un périphérique (Champ d'inventaire personnalisé) et Mise en correspondance de noms de fichier avec des expressions standard.

Recherche d'un chemin ou d'un fichier

path et fullpath sont des chaînes qui spécifient le chemin complet d'un répertoire ou d'un fichier sur le périphérique. Exemple :

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

L'agent KACE détecte le répertoire ou le fichier, puis procède au test spécifique.

Recherche d'une entrée ou d'une clé de registre

registryPath permet d'obtenir le chemin complet vers une clé de registre dans le registre. Exemple :

HKEY_LOCAL_MACHINE/application/kace

Définition d'une version

version correspond à un nombre entier (type TEXTE) que l’agent KACE compare à la version de l’élément testé sur le périphérique.

Par exemple, le test FileVersionGreaterThan retourne True si la valeur indiquée est supérieure au numéro de version du fichier ou du dossier. Sinon, il retourne False.

Pour tester une plage, combinez une règle LessThan à une règle GreaterThan comme suit :

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

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

Acrobat\Acrobat.exe, 8.00)

Définitions des variables utilisateur ou d'environnement

var est une chaîne qui correspond au nom réel de la variable d'environnement dans le périphérique.

Par exemple, pour tester si la variable du répertoire Program Files est correctement définie :

EnvironmentVariableEquals(ProgramFiles, TEXT,

C:\Program Files)

Définition d'un attribut de fichier

attribute correspond à une propriété du système, à une propriété de fichier ou de dossier, ou encore à une propriété attribuée par un agent KACE sur le périphérique. L'appliance propose des types d'arguments dépendants du système d'exploitation.

Utilisation d'attributs pour fichiers Windows

Vous pouvez utiliser les fonctions FileInfoGreaterThan, FileInfoLessThan et FileInfoEquals pour tester la propriété d'un fichier sur Windows à l'aide de la syntaxe suivante :

FunctionName (fullpath, attribute, type, value)

Le tableau suivant présente les attributs pris en charge par Windows.

Attribut	Type	Description
AccessedDate	DATE	Date et heure du dernier accès au fichier.
Comments	TEXTE	Informations supplémentaires fournies aux fins de diagnostic.
CompanyName	TEXTE	Nom de l'entreprise ayant créé le fichier.
CreatedDate	DATE	Heure de création du fichier.
FileBuildPart	NOMBRE	Troisième position dans une version de fichier. Exemple : dans 1.2.3, 3=Build.
FileDescription	TEXTE	Description du fichier pour la page Détails des propriétés du fichier de Windows.
FileMajorPart	NOMBRE	Première position dans une version de fichier. Exemple : dans 1.2.3, 1=Major.
FileMinorPart	NOMBRE	Deuxième position dans une version de fichier. Exemple : dans 1.2.3, 2=Minor.
FileName	TEXTE	Nom actuel du fichier. Voir également FileExists.
FilePrivatePart	NOMBRE	Quatrième position dans une version de fichier. Exemple : dans 1.2.3.4, 4=Private.
FileVersion	TEXTE	Version complète du fichier dans la page Détails des propriétés du fichier. Voir également FileVersionEquals, FileVersionGreaterThan et FileVersionLessThan.
InternalName	TEXTE	Nom interne du fichier (le cas échéant), tel que le nom du composant. Si le fichier ne comporte pas de nom interne, celui-ci correspond au nom de fichier d'origine, sans extension.
Langue	TEXTE	Code de langue, affiche le nom correspondant dans la page Détails des propriétés du fichier.
LegalCopyright	TEXTE	Note de copyright s'appliquant au fichier.
LegalTrademarks	TEXTE	Marques commerciales et marques déposées s'appliquant au fichier.
ModifiedDate	DATE	Date et heure de la dernière modification du fichier.
OriginalFilename	TEXTE	Nom complet du fichier tel qu'initialement attribué ou installé sur le périphérique.
PrivateBuild	TEXTE	Informations sur la version du fichier.
ProductBuildPart	NOMBRE	Troisième position dans une version de produit. Exemple : dans 1.2.3, 3=Build.
ProductMajorPart	NOMBRE	Première position dans une version de produit. Exemple : dans 1.2.3, 1=Major.
ProductMinorPart	NOMBRE	Deuxième position dans une version de produit. Exemple : dans 1.2.3, 2=Minor.
ProductName	TEXTE	Chaîne correspondant au nom du produit dans les propriétés Windows.
ProductPrivatePart	NOMBRE	Quatrième position dans une version de produit. Exemple : dans 1.2.3.4, 4=Private.
ProductVersion	TEXTE	Version complète du produit. Voir également ProductVersionEquals, ProductVersionGreaterThan et ProductVersionLessThan.
SpecialBuild	TEXTE	Informations supplémentaires sur le build.

Test des attributs de fichier Linux et Mac

Sur les périphériques Linux et Mac, vous pouvez utiliser les arguments suivants pour tester les attributs de fichier :

Définition du type de données

type identifie le type de données que vous testez ou retournez.

L’agent KACE prend en charge les types suivants :

•

TEXTE est une chaîne. Valide uniquement pour les règles conditionnelles correspondant parfaitement, telles que Equals. Pour les règles avec retour de valeur, cela définit le type de Champ d'inventaire personnalisé sur une chaîne et limite donc les critères de recherche et les filtres aux opérateurs correspondants.

•

NOMBRE est un nombre entier. Valide quelles que soient les règles conditionnelles, cela permet d'indiquer un nombre entier à des fins de comparaison.

•

DATE, qui doit être au format MM/jj/aaaa HH:mm:ss. Par exemple : 09/28/2006 05:03:51. L'heure est requise. Par exemple, lors d'une comparaison de type GreaterThan, vous devez au minimum définir l'heure sur 00:00:00.

Définition des valeurs à tester

En général, value fait suite au type, sauf dans le cas d'une règle où le type de donnée est connu telle que dans une règle de version. La valeur définie doit correspondre au type. Voir Définition du type de données.

Définition du nom d'une entrée de registre (Windows uniquement)

valueName est une chaîne qui correspond au nom de l'entrée de registre à tester. À utiliser uniquement dans les tests de registre pour les périphériques Windows.

Définition d'une clé PLIST (Mac uniquement)

entry est un NOMBRE, du TEXTE ou une DATE qui correspond à une clé dans un fichier PLIST sur un périphérique Mac OS X. Si la clé recherchée est contenue dans un tableau/dictionnaire du fichier PLIST, elle peut être référencée en spécifiant le nom/nombre entier du tableau/dictionnaire, avec un point-virgule de délimitation, puis le nom/nombre entier de la clé (dictionary:key) dans l'argument entry.

Exemples d'arguments :

•

La clé Item 0, dans le tableau PackageGroups, est référencée en utilisant l'argument PackageGroups:0.

•

La clé contentType, dans le dictionnaire Item 102, est référencée en utilisant l'argument 102:contentType.

Utilisation d'une expression régulière

regex désigne une expression régulière permettant de retrouver un nom de fichier selon une règle conditionnelle ou avec retour de valeur. Pour plus d'informations, voir Mise en correspondance de noms de fichier avec des expressions standard.

Définition des commandes

Les fonctions ShellCommand permettent de définir la commande à exécuter sur le périphérique. Les instructions de rédaction des arguments dans une règle ne s'appliquent pas aux commandes. Toutefois, si une commande comporte un espace après une parenthèse ouvrante ou immédiatement avant une parenthèse fermante, il est supprimé.

Test des règles d'inventaire personnalisé

Pour tester les règles d’inventaire personnalisé, vous pouvez exécuter une commande d’inventaire sur un périphérique géré par l’agent KACE. Cela vous permet de déboguer les règles d'inventaire personnalisé sans exécuter le processus d'inventaire dans son intégralité.

Ouvrez une invite de commande sur un périphérique sur lequel l’agent KACE est installé.

Entrez la commande suivante : kdeploy -custominventory

L’agent contacte l’appliance et effectue l’inventaire personnalisé. Les requêtes et les valeurs renvoyées s'affichent.

Syntaxe	Windows	RHEL	OS X	Description
FilenamesMatchingRegexExist (fullpath,regex)	X	X	X	True si le nom de l'un des fichiers du répertoire indiqué correspond à l'expression régulière que vous avez saisie.
FilenamesMatchingRegexGreaterThan (fullpath,regex,value)	X	X	X	True si le nombre de fichiers correspondant est supérieur à la valeur indiquée.
FilenamesMatchingRegexLessThan (fullpath,regex,value)	X	X	X	True si le nombre de fichiers correspondant est inférieur à la valeur indiquée.
FilenamesMatchingRegexEqual (fullpath,regex,value)	X	X	X	True si le nombre de fichiers correspondant est identique à la valeur indiquée.
FilenamesMatchingRegexReturn (fullpath,regex,type)	X	X	X	Définit le champ d'inventaire personnalisé sur les noms de fichier qui correspondent (chemin compris).

Attribut	Type	Description
access_time	DATE	Date et heure du dernier accès au fichier par l'utilisateur ou le système
block_size	NOMBRE	Longueur de bloc du fichier
blocks	NOMBRE	Nombre de blocs utilisés par le fichier
creation_time	DATE	Date et heure de création du fichier
device_number	NOMBRE	Numéro d'identification du périphérique (disque) contenant le fichier
group	TEXTE	Nom de groupe du propriétaire du fichier
inode	NOMBRE	Numéro de l'inode du fichier
modification_time	DATE	Date et heure de la dernière modification et de son enregistrement
number_links	NOMBRE	Nombre de liens physiques vers le fichier
owner	TEXTE	Nom d'utilisateur de la personne propriétaire du fichier
size	NOMBRE	Taille du fichier

製品を選択してください:

サービス向上のために、「Purpose of your Chat（チャットの目的）」を記入してください。

お客様の不具合に推奨されるソリューション

KACE Systems Management Appliance 13.2 Common Documents - Guide d'administration (13.0)

Compréhension des expressions régulières

Référence concernant les règles avec expressions régulières

Définition des arguments dans une règle

Test des règles d'inventaire personnalisé