KACE Systems Management Appliance 13.1 Common Documents

Syntaxe des règles d'inventaire personnalisé

Utilisez la syntaxe correcte pour les noms de fonction et les arguments dans les règles d'inventaire personnalisé.

Les règles conditionnelles et avec retour de valeur utilisent la syntaxe suivante :

functionName(argument,argument,...)

Pour plus d'informations sur les fonctions et leurs arguments, reportez-vous aux références suivantes :

•

Vérification des conditions (règles conditionnelles)

•

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

•

Mise en correspondance de noms de fichier avec des expressions standard

Syntaxe des fonctions

Entrez functionName suivi d'une parenthèse ouvrante, insérez les arguments, puis refermez la parenthèse. N'insérez aucun espace entre le nom de la fonction et la parenthèse ouvrante.

Syntaxe de l'argument

Entrez la syntaxe de l'argument pour toutes les règles (excepté command et regex (expression régulière)) comme suit :

•

Séparez chaque argument par une virgule.

•

N'insérez aucune autre virgule dans la chaîne que celles indiquées dans la section Virgules et parenthèses comme valeurs dans une règle.

•

N'insérez aucun guillemet simple ou double.

•

Les espaces avant ou après chaque argument sont ignorés.

Par exemple, les syntaxes suivantes sont identiques :

RegistryValueEquals(HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\Mozilla Firefox, CurrentVersion, 78.0.2)
RegistryValueEquals(HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\Mozilla Firefox,CurrentVersion,78.0.2)

Virgules et parenthèses comme valeurs dans une règle

Si vous devez utiliser une virgule, une parenthèse ouvrante ou une parenthèse fermante dans une règle, indiquez-les sous la forme {{comma}}, {{op}} et {{cp}}, respectivement.

•

Dans les arguments où les virgules font partie de la valeur du paramètre, vous devez représenter ces dernières par la forme {{comma}}, sauf pour le dernier argument de la fonction.

Par exemple, si l'utilisateur veut tester une valeur de registre dont le nom de valeur est « test,value », il doit utiliser la forme de remplacement pour la virgule, car le nom de la valeur de registre n'est pas le dernier argument de la fonction Custom Inventory (CI).

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

Si l'utilisateur veut tester une valeur de registre où la valeur elle-même contient une virgule, il est inutile d'utiliser la forme de remplacement, car la valeur est le dernier argument de la fonction Custom Inventory. La fonction Custom Inventory suivante teste la valeur de registre HKLM\SOFTWARE\TestSoft\test1 et recherche si la valeur est égale à 2,4.

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

Si la fonction Custom Inventory contient uniquement un paramètre, elle prend tout ce qui est entre parenthèses comme valeur de l'argument. Dans ce cas, il est inutile de remplacer les virgules, car elles font partie de l'argument de la fonction Custom Inventory.

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

•

Une parenthèse ouvrante littérale sans correspondance doit être représentée par la forme {{op}}. Lorsque l'analyseur crée des jetons pour les arguments de la fonction, il compte le nombre de parenthèses ouvrantes et fermantes pour déterminer la fin de la fonction et de l'argument. Ainsi, des parenthèses ouvrantes littérales sans correspondance perturbent le comptage et provoquent une analyse incorrecte de la valeur de l'argument. Si une parenthèse ouvrante littérale est nécessaire dans la valeur de l'argument, elle doit être représentée par {{op}}.

Par exemple, si l'utilisateur veut faire représenter la chaîne « Hello ( World », la fonction CI doit être écrite comme suit :

ShellCommandTextReturn(echo Hello {{op}} World)

•

Les parenthèses fermantes littérales sans correspondance doivent être remplacées par la forme {{cp}}.

Lorsque l'analyseur crée des jetons pour les arguments de la fonction, il compte le nombre de parenthèses ouvrantes et fermantes pour déterminer la fin de la fonction lorsqu'il rencontre les dernières parenthèses fermantes avec correspondance. Cependant, si la valeur de l'argument contient elle-même une parenthèse fermante sans correspondance, l'analyseur considérera à tort qu'il s'agit de la fin de la fonction et la valeur de l'argument sera tronquée prématurément.

Si une parenthèse fermante littérale est nécessaire dans la valeur de l'argument, elle doit être représentée par {{cp}}.

Par exemple, si l'utilisateur veut représenter la chaîne « Hello ) World », la fonction CI doit être écrite comme suit :

ShellCommandTextReturn(echo Hello {{cp}} World)

Vérification des conditions (règles conditionnelles)

Vous pouvez rédiger des règles d'inventaire personnalisé déterminant si une application est installée ou non (true/false).

Si vous utilisez une règle conditionnelle et qu'elle renvoie True, le nom d'affichage (Titre) de l'application personnalisée s'affiche dans la section Logiciels : Programmes installés de la page Détails sur le périphérique, dans la section Inventaire.

Les sections suivantes décrivent les règles testant les conditions :

•

Référence concernant les règles conditionnelles

•

Vérification de la présence d'une condition (règles de type Exists)

•

Évaluation des paramètres du périphérique (règles de type Equals)

•

Comparaison des valeurs des périphériques (règles GreaterThan et LessThan)

•

Vérification de conditions multiples

Si la règle retourne False, l'application ne s'affiche pas dans la section Programmes installés des détails de l'inventaire du périphérique.

CONSEIL: les périphériques où l'élément est installé sont répertoriés à la page Inventaire > Logiciels > Custom_item : Détails.

Référence concernant les règles conditionnelles

Le tableau suivant présente les types de données pouvant être utilisés pour faire des comparaisons.

Types de données pris en charge pour les fonctions de comparaison
Règle conditionnelle	Types de données pris en charge pour les fonctions de comparaison Equals, GreaterThan, LessThan
EnvironmentVariable	DATE, NOMBRE, TEXTE
FileInfo	DATE, NOMBRE, TEXTE
FilenamesMatchingRegex	NOMBRE
FileVersion	TEXTE
PlistValue	NOMBRE, TEXTE
ProductVersion	TEXTE
RegistryValue	TEXTE

Le tableau suivant indique comment les comparaisons sont faites.

Réalisation des comparaisons

Type de données

Considérations

DATE

•

Avant l'évaluation, les valeurs cibles sont analysées en tant que dates à l'aide des mêmes règles que celles de la classe PHP DateTime, puis elles sont normalisées selon le format suivant :

MM/JJ/AAAA HH:MM:SS

•

La fonction d’horodatage de la base de données de l’appliance utilise le format 0 – 24 heures.

•

La fonction d’horodatage de la base de données de l’appliance indique l’heure UTC (temps universel coordonné), de manière à ce que l’heure soit normalisée sur tous les périphériques, indépendamment de leurs fuseaux horaires respectifs.

•

Si la valeur cible contient uniquement une date, une heure correspondant à minuit UTC est ajoutée.

NOMBRE

•

Seuls les nombres entiers sont évalués.

•

Si une valeur cible contient tout autre caractère (lettres, signes de ponctuation, etc.), seuls les nombres qui précèdent la première valeur non numérique sont évalués.

Par exemple, si la valeur cible est 52a1, seul 52 est évalué.

•

Seuls les nombres ne dépassant pas la valeur du plus grand nombre entier représentable sur 32 bits (2 147 483 647) sont pris en charge.

TEXTE

•

Les valeurs sont évaluées mot pour mot, sans modification de formatage (comme cela peut être le cas avec les types de données DATE et NOMBRE).

•

Les chaînes de texte sont évaluées par ordre lexicographique.

•

Il est possible d'utiliser des virgules dans les chaînes évaluées ; il n'est donc pas nécessaire de recourir à des caractères de remplacement.

Le tableau suivant dresse la liste des règles conditionnelles pouvant être utilisées, avec des liens expliquant comment définir les arguments :

Référence concernant les règles conditionnelles
Syntaxe	Windows	RHEL	OS X	Description
DirectoryExists (path)	X	X	X	Recherche un répertoire dans le chemin spécifié sur le périphérique.
FileExists (path)	X	X	X	Recherche un fichier dans le chemin spécifié sur le périphérique (nom du fichier et extension inclus dans le chemin).
FileVersionEquals (path, version)	X			Vérifie que la propriété Version > Version du fichier du fichier spécifié dans le chemin correspond à la valeur TEXTE que vous avez saisie.
FileVersionLessThan (path, version)	X			Vérifie que la propriété Version > Version du fichier du fichier spécifié en tant que chemin est inférieure à la valeur TEXTE que vous avez saisie.
FileVersionGreaterThan (path, version)	X			Vérifie que la propriété Version > Version du fichier du fichier spécifié est supérieure à la valeur TEXTE que vous avez saisie.
ProductVersionEquals (path, version)	X			Vérifie que la propriété Version > Version du produit de l'exécutable ou du fichier d'installation spécifié correspond à la valeur TEXTE que vous avez saisie.
ProductVersionLessThan (path, version)	X			Vérifie que la propriété Version > Version du produit de l'exécutable ou du fichier d'installation spécifié est inférieure à la valeur TEXTE que vous avez saisie.
ProductVersionGreaterThan (path, version)	X			Vérifie que la propriété Version > Version du produit de l'exécutable ou du fichier d'installation spécifié est supérieure à la valeur TEXTE que vous avez saisie.
FileInfoGreaterThan (fullpath, attribute, type, value)	X	X	X	Vérifie que la propriété Informations sur le fichier de l'exécutable ou du fichier d'installation spécifié est supérieure à la valeur que vous avez saisie.
FileInfoLessThan (fullpath, attribute, type, value)	X	X	X	Vérifie que la propriété Informations sur le fichier de l'exécutable ou du fichier d'installation spécifié est inférieure à la valeur que vous avez saisie.
FileInfoEquals (fullpath, attribute, type, value)	X	X	X	Vérifie que l'attribut de l'exécutable ou du fichier d'installation spécifié correspond à la valeur que vous avez saisie.
RegistryKeyExists (registryPath)	X			Vérifie qu'une clé de registre existe.
RegistryValueEquals (registryPath, valueName, value)	X			Vérifie qu'une entrée de registre correspond exactement à la valeur que vous avez spécifiée. La valeur est comparée en tant que TEXTE.
RegistryValueLessThan (registryPath, valueName, value)	X			Vérifie que l'entrée de registre est inférieure à la valeur que vous avez spécifiée. La valeur correspond à un TEXTE.
RegistryValueGreaterThan (registryPath, valueName, value)	X			Vérifie que l'entrée de registre est supérieure à la valeur que vous avez spécifiée. La valeur correspond à un TEXTE.
EnvironmentalVariableExists (var)	X	X	X	Vérifie qu'une variable d'environnement avec le nom spécifié existe.
EnvironmentalVariableGreaterThan (var, type, value)	X	X	X	Vérifie que la définition de variable d'environnement est supérieure à la valeur spécifiée. Les trois types sont valides : TEXTE, DATE (au format complet dd/mm/yyyy hh:mm:ss) et NOMBRE.
EnvironmentalVariableLessThan (var, type, value)	X	X	X	Vérifie que la définition de variable d'environnement est inférieure à la valeur spécifiée. Les trois types sont valides : TEXTE, DATE (au format complet dd/mm/yyyy hh:mm:ss) et NOMBRE.
EnvironmentalVariableEquals (var, type, value)	X	X	X	Vérifie que la définition de variable d'environnement correspond exactement à la valeur spécifiée. Les trois types sont valides : TEXTE, DATE (au format complet dd/mm/yyyy hh:mm:ss) et NOMBRE.
PlistValueExists (fullpath, entry)			X	Vérifie que la valeur désignée existe dans un fichier PLIST.
PlistValueGreaterThan (fullpath, entry, type, value)			X	Vérifie que la valeur désignée est un NOMBRE ou un TEXTE supérieur à la valeur que vous avez saisie.
PlistValueLessThan (fullpath, entry, type, value)			X	Vérifie que la valeur désignée est un NOMBRE ou un TEXTE inférieur à la valeur que vous avez saisie.
PlistValueEquals (fullpath, entry, type, value)			X	Vérifie que la valeur désignée est un NOMBRE ou un TEXTE correspondant exactement à la valeur que vous avez saisie.

Pour plus d'informations sur les fonctions Equals, GreaterThan et LessThan pour FilenamesMatchingRegex, voir Référence concernant les règles avec expressions régulières.

Vérification de la présence d'une condition (règles de type Exists)

Les règles dont le nom se termine par Exists vérifient la présence d'un fichier, d'un répertoire, d'une clé de registre ou d'un autre élément. Si l’agent KACE identifie un élément sur le périphérique, la règle retourne True et l’élément s’affiche en tant que programme installé dans les détails de l’inventaire du périphérique.

Utilisez l'une des règles Exists suivantes :

•

DirectoryExists (path)

•

FileExists (path)

•

RegistryKeyExists (registryPath)

•

EnvironmentalVariableExists (var)

•

PlistValueExists (fullpath, entry)

•

FilenameMatchingRegexExist (fullpath, regex)

Exemple : recherche d'un répertoire (dossier)

L'exemple suivant permet de tester l'existence du répertoire Windows sur le périphérique :

DirectoryExists(C:\WINDOWS\)

Exemple : recherche d'un fichier

REMARQUE: l'exemple suivant permet de vérifier l'existence de l'exécutable du Bloc-notes sur le périphérique :

FileExists(C:\WINDOWS\notepad.exe)

Évaluation des paramètres du périphérique (règles de type Equals)

Les règles dont le nom se termine par Equals comparent la valeur définie sur le périphérique à celle que vous avez spécifiée dans la règle. Les règlent retournent True si les valeurs correspondent exactement.

Les règles utilisant des arguments avec des types de données fixes peuvent uniquement comparer des valeurs du même type.

Utilisez l'une des règles Equals suivantes :

•

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)

Exemple : test du paramètre JAVA_HOME

Pour vérifier que le paramètre JAVA_HOME est C:\Program Files\Java\jdk1.6.0_02 :

EnvironmentVariableEquals(JAVA_HOME, TEXT, C:\Program Files\Java\jdk1.6.0_02)

Exemple : test du paramètre McAfee® Registry Entry

Pour vérifier que le paramètre utilise le même format que la date dans l'entrée :

RegistryValueEquals(HKEY_LOCAL_MACHINE\Software\McAfee\AVEngine, AVDatDate, 2014/03/01)

Exemple : détection de Windows 7 Service Pack 1

Windows 7 Service Pack 1 s'affiche dans Ajout/Suppression de programmes, uniquement sur les périphériques initialement équipés de Windows 7, puis mis à niveau vers SP1. Pour cet élément, l'inventaire des applications par défaut n'indique pas les périphériques déjà équipés du SP1, car ils sont affiliés d'origine au niveau SP1.

Si vous utilisez l’appliance pour déployer Windows 7 Service Pack 1, créez la règle d’inventaire personnalisé suivante pour une application personnalisée :

RegistryValueEquals(HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\

CurrentVersion,CSDVersion,Service Pack 2)

Vous pouvez ensuite exclure les appareils sur lesquels cet élément est installé afin d'éviter que l'appliance ne tente de déployer SP2 vers des appareils déjà à niveau (appareils Windows 7 déjà mis à niveau et appareils SP1 d'origine).

Comparaison des valeurs des périphériques (règles GreaterThan et LessThan)

Les fonctions dont le nom se termine par GreaterThan et LessThan comparent les valeurs indiquées dans le Table 24.

Utilisez l'une des règles GreaterThan et LessThan suivantes :

•

FileVersionGreaterThan (path, version) et FileVersionLessThan (path, version)

•

ProductVersionGreaterThan (path, version) et ProductVersionLessThan (path, version)

•

FileInfoGreaterThan (fullpath, attribute, type, value) et FileInfoLessThan (fullpath, attribute, type, value)

•

RegistryValueGreaterThan (registryPath, valueName, value) et RegistryValueLessThan (registryPath, valueName, value)

•

EnvironmentalVariableGreaterThan (var, type, value) et EnvironmentalVariableLessThan (var, type, value)

•

PlistValueGreaterThan (fullpath, entry, type, value) et PlistValueLessThan (fullpath, entry, type, value)

•

FilenameMatchingRegexGreaterThan (fullpath, regex, value) et FilenameMatchingRegexLessThan (fullpath, regex, value)

Exemple : vérification consistant à s’assurer que la version du produit est supérieure

Pour vérifier que la version du produit est supérieure à une version spécifique :

ProductVersionGreaterThan(C:\Program Files\Mozilla Firefox\firefox.exe, 78)

Pour vérifier que la version du produit est supérieure ou égale à un nombre donné, saisissez la règle suivante :

ProductVersionEquals(C:\Program Files\Mozilla Firefox\firefox.exe, 78)

OR ProductVersionGreaterThan(C:\Program Files\Mozilla Firefox\firefox.exe,

78)

Exemple : vérification de la plage de la version du produit

Pour vérifier que la version du produit se trouve dans une plage donnée, combinez les règles LessThan et GreaterThan :

ProductVersionGreaterThan(C:\Program Files\Mozilla Firefox\firefox.exe, 77)
AND ProductVersionLessThan(C:\Program Files\Mozilla Firefox\firefox.exe, 79)

IMPORTANT: n'entrez pas les règles sur des lignes distinctes. Séparez les règles uniquement par un espace. Si des règles sont entrées sur des lignes distinctes, la règle composée n'est pas valide.

Vérification de conditions multiples

Vous pouvez combiner des règles à l'aide des opérateurs ET et OU pour tester plusieurs conditions.

REMARQUE: l'utilisation des opérateurs ET et OU dans une même règle d'inventaire personnalisé n'est pas prise en charge. Définissez des applications distinctes.

L'association de règles conditionnelles produit les résultats suivants :

•

Opérateur ET : toutes les règles doivent retourner True pour que les résultats retournent également True et enregistrent l'application en tant que programme installé.

•

Opérateur OU : une seule règle doit retourner True pour que l'application soit enregistrée en tant que programme installé.

Vérification de conditions multiples True (ET)

Utilisez l'opérateur ET pour associer des règles conditionnelles dans le champ Inventaire personnalisé lorsque vous souhaitez enregistrer l'élément en tant que programme installé uniquement si toutes les règles retournent la mention True.

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.

Exemple : vérification d'une clé de registre et comparaison de valeurs

Pour vérifier une clé de registre et une valeur d'entrée de registre sur un périphérique Windows, utilisez l'opérateur ET pour combiner les règles comme suit :

RegistryKeyExists(registryPath
) ET RegistryValueEquals(registryPath, valueName, value)

Vérification d'une condition True (OU)

Lorsque vous combinez des règles à l'aide de l'opérateur OU, si l'une des règles du Champ Inventaire personnalisé est True, l'application apparaît dans la liste Programmes installés du périphérique.

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

Function
(arguments
) OU Function
(arguments
) OU ...

Séparez chaque fonction de l'opérateur par des espaces.

Exemple : vérification d'une valeur de registre

Pour vérifier qu'une entrée de registre correspond à une valeur ou à une autre :

RegistryValueEquals(registryPath, valueName, value) OU
RegistryValueEquals(registryPath, valueName, value)

CONSEIL: pour définir une plage, combinez les règles RegistryValueGreaterThan et RegistryValueLessThan avec l'opérateur ET.

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

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 KACE 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 Mozilla Firefox

L’exemple suivant définit le Champ d’inventaire personnalisé pour la version du produit Mozilla Firefox sous la forme d’un NOMBRE :

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

FileInfoReturn(C:\Program Files\Mozilla Firefox\firefox.exe,CurrentVersion,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é CurrentVersion Mozilla Firefox

Pour définir la clé de registre CurrentVersion en tant que Champ d’inventaire personnalisé :

RegistryValueReturn (HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\Mozilla Firefox\CurrentVersion, 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 gérées en fonction de la langue du système, entrez la règle suivante pour obtenir le paramètre régional 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 KACE 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.