KACE Systems Management Appliance 7.1 - Guide d'administration

Les règles se terminant par ValueReturn vous permettent de collecter des informations sur le périphérique. Vous pouvez utiliser ces règles pour collecter des informations que l'agent K1000 ne collecte normalement pas.

Les valeurs obtenues sont définies avec le nom d'affichage (Titre) de l'application personnalisée. Cela apparaît sur la page Détails sur le périphérique, sous Logiciel, dans Programmes installés et Champs d'inventaire personnalisés.

Utilisez les valeurs du Champ d'inventaire personnalisé pour gérer les installations et distribuer les logiciels ainsi que les rapports, le filtre Afficher par, les critères de recherche de type étiquette dynamique ou tout autre processus pouvant être effectué avec un paramètre de détection automatique.

Sections traitées dans ce chapitre :

•

Référence des règles avec retour de valeur

•

Obtention des valeurs de la clé de registre

•

Obtention du résultat d'une commande

•

Obtention des valeurs PLIST

•

Obtention de valeurs multiples

Référence des règles avec retour de valeur

Le tableau suivant répertorie toutes les règles avec retour de valeur disponibles pour définir un champ d'inventaire personnalisé :

Syntaxe	Windows	RHEL	OS X	Description
RegistryValueReturn (registryPath, valueName, type)	X			Retourne la valeur d'une entrée de registre et définit le type de données sur celui que vous avez spécifié.
EnvironmentalVariableReturn (var, type) Définitions des variables utilisateur ou d'environnement	X	X	X	Retourne la valeur d'une variable d'environnement et définit le type de données sur celui que vous avez spécifié.
FileInfoReturn (path, attribute, type)	X	X	X	Retourne la valeur d'un attribut de fichier. Reportez-vous aux types valides dans Définition des arguments dans une règle.
ShellCommandTextReturn (command)	X	X	X	Retourne le résultat de la commande et définit le type de données sur TEXTE.
ShellCommandDateReturn (command)	X	X	X	Retourne le résultat de la commande et définit le type de données sur DATE.
ShellCommandNumberReturn (command)	X	X	X	Retourne le résultat de la commande et définit le type de données sur NOMBRE.
PlistValueReturn (fullpath, entry, type)			X	Retourne la valeur de la clé PLIST et définit le type de données sur TEXTE, NOMBRE ou DATE.

Obtention des valeurs concernant les informations sur le fichier

Vous pouvez définir le champ d'inventaire personnalisé sur l'un des attributs Informations sur le fichier Windows à l'aide de la règle FileInfoReturn.

Exemple : obtention de la version de produit de Windows Internet Explorer

L'exemple suivant définit le Champ d'inventaire personnalisé pour la version du produit Internet Explorer sous la forme d'un NOMBRE :

Dans le Champ d'inventaire personnalisé, utilisez la syntaxe suivante :

FileInfoReturn(C:\Program Files\Internet Explorer\iexplore.exe,ProductVersion,TEXT)

Obtention des valeurs de la clé de registre

Vous pouvez définir le Champ d'inventaire personnalisé sur une clé de registre en utilisant la règle RegistryValueReturn. Où registryPath (sur la gauche) correspond au chemin de l'entrée, tandis que valueName (sur la droite) correspond à la clé que vous souhaitez retourner. L'illustration présente l'éditeur du Registre, avec un panneau d'arborescence de répertoires sur la gauche, et le nom, le type et les données sur la droite.

Exemple : obtention de la clé Internet Explorer ProductID

Pour définir la clé de registre ProductID en tant que Champ d'inventaire personnalisé :

RegistryValueReturn (HKEY_LOCAL_MACHINE\application\Microsoft\Internet Explorer\

Registration, ProductId, TEXT

Obtention du résultat d'une commande

Les règles de commande permettent de définir le résultat d'une commande dans un Champ d'inventaire personnalisé. La commande est fonction de l'interpréteur de ligne de commande et du chemin de l'exécutable sur le périphérique.

Par exemple, sur les périphériques Windows, il est possible de saisir des commandes MS-DOS, mais pas des commandes UNIX de type Cygwin (sauf si Cygwin est installé et disponible dans le chemin par défaut pour tous les utilisateurs).

Utilisez l'une des règles suivantes pour définir le résultat de la commande dans un Champ d'inventaire personnalisé :

•

ShellCommandTextReturn (command)

•

ShellCommandDateReturn (command)

•

ShellCommandNumberReturn (command)

Exemple : obtention de la durée d'activité sur Mac OS X

Pour définir la durée d'activité en tant que Champ d'inventaire personnalisé :

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

Obtention des valeurs PLIST

La règle PlistValueReturn permet de définir une liste de propriétés (ou PList) en tant que Champ d'inventaire personnalisé.

Exemple : obtention des paramètres régionaux du système

Pour distribuer les applications à l'aide des installations infogérées en fonction de la langue native, entrez la règle suivante pour obtenir les paramètres régionaux du périphérique, puis créez l'étiquette dynamique correspondante qui s'applique au périphérique, selon le code de langue indiqué par l'agent K1000 dans le Champ d'inventaire personnalisé :

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

Obtention de valeurs multiples

Combinez les règles ValueReturn à l'aide de l'opérateur ET ou OU. La règle affiche l'application en tant que programme installé si l'une des valeurs n'est pas vide.

Les valeurs associées sont toutes définies dans le même Champ d'inventaire personnalisé, séparées par l'opérateur. Elles sont donc considérées techniquement comme du TEXTE aux fins de critères de recherches, filtres, rapports et autres processus de l'appliance.

Règles ValueReturn combinées par :

•

Opérateur ET : toutes les valeurs sont consignées dans le Champ d'inventaire personnalisé.

•

Opérateur OU : les valeurs correctes sont consignées dans le Champ d'inventaire personnalisé.

Dans le champ Inventaire personnalisé, associez les règles à l'aide de la syntaxe suivante :

Function(arguments...) ET Function(arguments) ET ...

Séparez chaque condition de l'opérateur par des espaces. Ne combinez pas les opérateurs ET et OU dans une même règle.

Mise en correspondance de noms de fichier avec des expressions standard

Compréhension des expressions standard

Référence concernant les règles avec expressions standard

Les expressions standard permettent d'établir des correspondances entre un caractère ou une chaîne spécifiée et les noms de fichiers d'un répertoire donné.

Cette section décrit les expressions standard qui permettent de retrouver des noms de fichier selon des règles conditionnelles et avec retour de valeur.

REMARQUE: l'agent K1000 propose uniquement des fonctions qui comparent les noms de fichier à l'aide d'expressions standard.

Compréhension des expressions standard

Vous pouvez utiliser la syntaxe des expressions standard pour retrouver des noms de fichier.

CONSEIL: pour plus d'informations sur la rédaction d'expressions standard, consultez le site https://msdn.microsoft.com/fr-fr/library/az24scfc.aspx.

Le tableau ci-dessous présente la syntaxe des expressions standard utilisées pour la recherche de noms de fichier :

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 standard.	[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 standard

La syntaxe des règles avec expressions standard 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 standard.

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

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

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 - Guide d'administration

Obtention de valeurs depuis un périphérique (Champ d'inventaire personnalisé)

Mise en correspondance de noms de fichier avec des expressions standard

Compréhension des expressions standard

Référence concernant les règles avec expressions standard