KACE Systems Management Appliance 14.0 Common Documents

Règles conditionnelles : ces règles vérifient s'il existe des conditions sur les périphériques. Lorsqu’une règle retourne True, l’agent KACE consigne l’élément en tant que programme installé. Lorsque la règle retourne False, l'élément n'apparaît pas comme Programme installé.

•

Règles avec retour de valeur : ces règles obtiennent des données provenant de périphériques. Si la valeur existe, l’agent KACE consigne l’élément en tant que programme installé et définit le Champ d’inventaire personnalisé correspondant.

Créer des règles d'inventaire personnalisé

Implémentation des règles d'inventaire personnalisé

Syntaxe des règles d'inventaire personnalisé

Vous pouvez créer des applications personnalisées, ainsi que des règles d'inventaire personnalisé pour ces applications, afin de collecter des informations relatives aux applications auprès de périphériques infogérés.

Accédez à la page Détails sur le logiciel :

Connectez-vous à la Console d’administration de l’appliance à l’adresse https://nom_hôte_appliance/admin. Ou bien, si l'option Afficher le menu de l'organisation dans l'en-tête d'administrateur est activée dans les Paramètres généraux de l'appliance, sélectionnez une organisation dans la liste déroulante située en haut à droite de la page, à côté des informations de connexion.

Dans la barre de navigation de gauche, cliquez sur Inventaire, puis cliquez sur Inventaire personnalisé.

Sélectionnez Choisir une action > Nouvelle.

Donnez les informations générales : Nom, Version, Éditeur.

Pour permettre la création des rapports adéquats en aval, saisissez ces informations de façon cohérente dans l'ensemble de l'inventaire des logiciels.

Indiquez les informations suivantes :

Option	Description
Restreindre aux étiquettes	(Facultatif) Étiquette associée à l'élément.
Remarques	Toute information supplémentaire que vous souhaitez fournir.
Systèmes d'exploitation pris en charge	Systèmes d'exploitation sur lesquels l'application s'exécute. Les applications ne sont déployées que sur les périphériques dont le système d'exploitation est sélectionné.
Règle d'inventaire personnalisé	(Facultatif) Règles d'inventaire personnalisé à appliquer à l'application. Les règles d'inventaire personnalisé permettent de détecter les applications et les autres éléments présents sur un périphérique et de capturer des informations en vue de la création de rapports. Ainsi, l'appliance vérifie d'abord si une application est présente sur un périphérique avant de déployer cette application. Dans certains cas, toutefois, les programmes installés ne sont pas enregistrés dans Ajout/Suppression de programmes ou dans les zones habituelles du Registre. Si tel est le cas, l'appliance ne sera peut-être pas en mesure de détecter la présence de l'application sans informations supplémentaires de la part de l'administrateur. Par conséquent, il se peut que l'appliance répète l'installation chaque fois que le périphérique se connecte. Les règles d'inventaire personnalisé permettent d'éviter cela. La règle suivante vérifie que la version de Network Associates VirusScan installée sur un périphérique est plus récente qu'une version donnée avant de la déployer : RegistryValueGreaterThan(HKEY_LOCAL_MACHINE\ Software\Network Associates\TVD\ Network Associates\TVD\Shared Components\ VirusScanEngine\4.0.xx,szDatVersion,4.0.44)

En regard de Télécharger et associer le fichier, cliquez sur Sélectionner un fichier afin de rechercher un fichier, puis cliquez sur Ouvrir ou sur Choisir.

Pour distribuer des applications au moyen d'installations infogérées ou de synchronisations de fichiers, vous devez associer les fichiers d'application à l'application.

Pour empêcher la copie du fichier sur des partages de réplication, sélectionnez Ne pas répliquer le fichier associé. Cette option est utile pour les fichiers volumineux, tels que les suites logicielles, que vous ne souhaitez pas voir installés par les utilisateurs depuis des partages de réplication.

Facultatif : sélectionnez une Catégorie et un Niveau de menace pour le logiciel.

Cliquez sur Enregistrer.

Implémentation des règles d'inventaire personnalisé

L’agent KACE reçoit de nouvelles règles d’inventaire personnalisé lors du premier inventaire des périphériques après la création des règles. Lors de ce premier inventaire, l'agent exécute les nouvelles règles et transmet les résultats à l'appliance.

L'agent exécute toutes les règles et tous les autres processus programmés pour cette session. Ainsi, une fois le périphérique inventorié, l'exécution de toutes les règles et autres processus peut prendre plusieurs minutes avant que l'agent ne consigne les résultats.

Après transmission des résultats par l'agent, la page des détails du périphérique affiche les résultats sous Logiciel dans Programmes installés et Champs d'inventaire personnalisés.

REMARQUE: les applications qui présentent des règles avec retour de valeur définissant un Champ d'inventaire personnalisé apparaissent également en tant que Programmes installés.

Si vous n'obtenez pas les résultats escomptés, vérifiez que le périphérique a été inventorié récemment. L'heure de l'inventaire apparaît dans le champ Dernier inventaire de la page des détails sur le périphérique.

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)