Commandes IF-THEN-ELSE

Il s'agit d'un récapitulatif des paramètres IF-THEN-ELSE utilisés dans les scripts VSA.

Paramètres IF

L'application est en cours d'exécution

Cette option permet de vérifier si une application spécifiée est en cours d'exécution sur l'ordinateur géré. Si l'application est lancée, l'instruction THEN est exécutée. Dans le cas contraire, c'est l'instruction ELSE,qui est exécutée. Si vous sélectionnez cette option dans la liste déroulante, le champ Saisir le nom de l'application s'affiche.

Vérifier la Valeur de registre

Après la saisie du chemin d'accès au registre, la valeur contenue dans la clé est renvoyée. Vous pouvez en tester l'existence, l'absence, l'égalité ou les différences de taille. Par exemple, HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\AppPaths\AgentMon.exe\path contient le chemin d'accès au répertoire pour savoir où est installé l'agent sur l'ordinateur cible. Le test détermine si la valeur stockée pour cette clé existe. En d'autres termes, vous vérifiez si l'agent est installé.

Une barre oblique \ à la fin de la clé renvoie la valeur par défaut correspondante. HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\WORDPAD.EXE\ renvoie une valeur par défaut, telle que %ProgramFiles%\Windows NT\Accessories\WORDPAD.EXE

Les tests disponibles sont les suivants :

• Existe : vrai si la clé de registre existe dans la ruche.
• Absent : vrai si la clé de registre n'existe pas dans la ruche.
• = : vrai si la valeur de la clé de registre est égale à la valeur de test.
• Not = : vrai si la valeur de la clé de registre n'est pas égale à la valeur de test.
• > : vrai si la valeur de la clé de registre est supérieure à la valeur de test (la valeur doit être numérique).
• >= : vrai si la valeur de la clé de registre est supérieure ou égale à la valeur de test (la valeur doit être numérique).
• < : vrai si la valeur de la clé de registre est inférieure à la valeur de test (la valeur doit être numérique).
• <= : vrai si la valeur de la clé de registre est inférieure ou égale à la valeur de test (la valeur doit être numérique).
• Contient : vrai si la valeur de test est une sous-chaîne de la valeur de la clé de registre (la valeur doit être une chaîne).
• Ne contient pas : vrai si la valeur de test n'est pas une sous-chaîne de la valeur de la clé de registre (la valeur doit être une chaîne).

Vérifier la variable

Saisissez un nom de variable au format #var_name# dans l'espace disponible. L'option Vérifier la variable évalue les valeurs actuelles affectées à #var_name# et les compare à la valeur fournie. La valeur fournie peut également être un autre nom de variable au format #var_name2#.  Si la vérification est vraie, les étapes THEN seront exécutées. En revanche, si la vérification est fausse, les étapes ELSE seront exécutées. Les tests disponibles sont les suivants :

• Existe : vrai si la variable existe.
• Absent : vrai si la variable n'existe pas.
• = : vrai si la valeur de la variable est égale à la valeur de test.
• Not = : vrai si la valeur de la variable n'est pas égale à la valeur de test.
• > : vrai si la valeur de la variable est supérieure à la valeur de test.
• >= : vrai si la valeur de la variable est supérieure ou égale à la valeur de test.
• < : vrai si la valeur de la variable est inférieure à la valeur de test.
• <= : vrai si la valeur de la variable est inférieure ou égale à la valeur de test.
• Contient : vrai si la valeur de test est une sous-chaîne de la variable (la valeur doit être une chaîne).
• Ne contient pas : vrai si la valeur de test n'est pas une sous-chaîne de la variable (la valeur doit être une chaîne).

Dans le cadre des tests =, Not =, >, >=, < et <=, les variables comparées peuvent être une chaîne, un numéro, une date au format aaaa/mm/jj ou aaaa/mm/jj hh:mm ou aaaa/mm/jj hh:mm:ss ou un numéro de version avec des points ou des virgules comme 1.2.3 ou 4,5,6,7. Si vous spécifiez un format de date, vous pouvez le décaler avec + jj:hh:mm:ss ou - jj:hh:mm:ss. Seuls les jours jj sont obligatoires ; vous pouvez omettre les heures  hh, les minutes mm et les secondes ss et supposer qu'elles sont nulles en cas d'absence. Vous pouvez spécifier CURRENT_TIMESTAMP pour indiquer que l'heure actuelle est remplacée pendant la comparaison au moment de l'exécution du script. Par exemple, vous devez interpréter CURRENT_TIMESTAMP - 7:12:00:00 comme 7 jours et 12 heures soustraits de l'heure à laquelle le script est exécuté.

Évaluer l'expression

Saisissez une expression contenant au moins un nom de variable au format #var_name# dans l'espace disponible. L'option Évaluer l'expression utilise la valeur actuelle affectée à chaque #var_name#, évalue l'expression mathématique et la compare à la valeur fournie. La valeur fournie peut également être une autre expression. L'expression mathématique peut contenir des +, -, *, /, ( et ).  Par exemple  (3.7 + (200 * #countA#)) / (#countB# - #countC#). Si la vérification est vraie, les étapes THEN seront exécutées. Si la vérification est fausse, les étapes ELSE seront exécutées. Les tests disponibles sont les suivants :

• = : vrai si la valeur de la variable est égale à la valeur de test.
• Not = : vrai si la valeur de la variable n'est pas égale à la valeur de test.
• > : vrai si la valeur de la variable est supérieure à la valeur de test.
• >= : vrai si la valeur de la variable est supérieure ou égale à la valeur de test.
• < : vrai si la valeur de la variable est inférieure à la valeur de test.
• <= : vrai si la valeur de la variable est inférieure ou égale à la valeur de test.

  Remarque: utilisation impossible avec les opérateurs Existe, Absent, Contient, ou Ne contient pas.

Le service est en cours d'exécution

Cette option permet de déterminer si un service est exécuté sur l'ordinateur géré.

• Vrai si le service est en cours d'exécution.
• Faux si le service est arrêté ou n'existe pas.

Vérifier l'existence du fichier

Cette option permet de déterminer si un fichier existe sur un ordinateur géré. Saisissez le chemin d'accès complet et le nom du fichier. Par exemple, si vous saisissez c:\windows\notepad.exe, la valeur True est renvoyée si le fichier Notepad.exe existe, et la valeur False s'il n'existe pas.

Remarque: des variables d'environnement, comme %windir%\notepad.exe, sont acceptables.

Vérifier la présence du fichier dans le chemin du répertoire

Saisissez le nom d'un fichier pour vérifier s'il existe sur l'ordinateur géré. Dans la mesure où vous devez exécuter une étape THEN ou ELSE avant ce test IF, Vérifier la présence du fichier dans le chemin du répertoire ne sert qu'aux scripts appelés par l'étape THEN ou ELSE d'un script parent.

Vérifier la clé de registre

Cette option permet de vérifier l'existence d'une clé de registre. L'option Vérifier la clé de registre est différente de l'option Vérifier la valeur de registre étant donné qu'elle peut vérifier une entrée de registre au niveau du répertoire, qui contient uniquement d'autres clés de registre (et aucune valeur). Vérifier la clé de registre détecte si toute une branche de registre existe.

True

Si vous sélectionnez True, les étapes THEN seront exécutées. Sélectionnez True pour exécuter directement une série d'étapes qui ne nécessite aucune décision, par exemple si un fichier existe en utilisant la fonction Vérifier l'existence du fichier.

L'utilisateur est connecté

Permet d'effectuer un test pour vérifier la connexion d'un utilisateur donné ou de n'importe quel utilisateur sur l'ordinateur géré. Saisissez le nom de connexion de l'utilisateur ou ne remplissez pas le champ pour vérifier la connexion d'un utilisateur. Les étapes THEN seront exécutées si un utilisateur est connecté. Les étapes ELSE seront exécutées dans le cas contraire.

La réponse de l'utilisateur est Oui

Permet d'afficher une boîte de dialogue sur l'ordinateur géré en cliquant sur les boutons Oui et Non. Permet également d'effectuer l'instruction ELSE si une durée définie par l'administrateur a expiré. Si l'utilisateur sélectionne Oui, l'instruction THEN sera exécutée. Si le délai de sélection expire ou si l'utilisateur sélectionne Non, l'instruction ELSE sera exécutée. Cette fonction exige une autorisation de l'utilisateur pour poursuivre le traitement du script. Cette requête est utile pour les scripts exigeant un redémarrage de l'ordinateur géré avant la fin de leur traitement.

Vous pouvez utiliser des variables de script, par exemple #varName# dans les champs La réponse de l'utilisateur est Oui pour générer les messages de manière dynamique en fonction des données de scripts.

Paramètres THEN-ELSE

Détection du système d'exploitation

Lorsque vous écrivez une instruction THEN-ELSE,  vous pouvez sélectionner le système d'exploitation sur lequel exécuter le script. Ce paramètre est particulièrement pratique si vous souhaitez écrire un script à exécuter sur plusieurs systèmes d'exploitation. En effet, les chemins d'accès aux répertoires nécessitent une syntaxe différente sur Windows et Macintosh pour fonctionner correctement. Si vous créez deux étapes au sein du même script pour tous les systèmes d'exploitation Windows et pour un système d'exploitation Mac OS X, vous ne serez pas obligé de créer un script supplémentaire pour un système d'exploitation distinct.

Fermer l'application

Si l'application spécifiée est exécutée sur l'ordinateur géré, elle est fermée.

Supprimer le fichier

Cette option permet de supprimer un fichier sur un ordinateur géré. Saisissez le chemin d'accès complet et le nom du fichier.

Remarque: des variables d'environnement sont acceptables si vous les définissez sur l'ordinateur d'un utilisateur.  Ainsi, l'utilisation d'un chemin d'accès %windir%\notepad.exe ressemblerait à celle de C:\windows\notepad.exe.

Supprimer le fichier dans le chemin du répertoire

Cette option permet de supprimer le fichier situé sur le chemin renvoyé lorsque vous utilisez paramètre Récupérer le chemin de répertoire dans le registre.

Supprimer la clé de registre

Cette option permet de supprimer la clé de registre spécifiée, ainsi que toutes ses sous-clés.

Supprimer la valeur de registre

Cette option permet de supprimer la valeur stockée dans la clé de registre spécifiée.

Exécuter le fichier

Cette option permet d'exécuter le fichier spécifié sur l'ordinateur géré. Cette fonction réplique le lancement d'une application à l'aide de la commande Exécuter… située dans le menu Démarrer Microsoft Windows. Cette fonction prend les trois paramètres suivants :

• Nom du chemin d'accès complet au fichier .exe.
• Liste des arguments à transmettre au fichier .exe.
• Indicateur précisant si le script doit patienter jusqu'à la finalisation du fichier .exe. (1 pour patienter, 0 pour poursuivre le traitement du script sans patienter).

  Remarque: des variables d'environnement sont acceptables si vous les définissez sur l'ordinateur d'un utilisateur.  Ainsi, l'utilisation d'un chemin d'accès %windir%\notepad.exe ressemblerait à celle de C:\windows\notepad.exe.

Exécuter le fichier dans le chemin du répertoire

Identique à Exécuter le fichier sauf que le chemin d'accès au fichier .exe est renvoyé par un paramètre Récupérer le chemin de répertoire dans le registre.

Remarque: des variables d'environnement sont acceptables si vous les définissez sur l'ordinateur d'un utilisateur.  Ainsi, l'utilisation d'un chemin d'accès %windir%\notepad.exe ressemblerait à celle de C:\windows\notepad.exe.

Exécuter le script

Cette option permet l'exécution d'un autre script nommé. Utilisez cette méthodologie pour traiter plusieurs clauses IF-THEN-ELSE par chaîne. Si le script n'existe plus sur le serveur KServer, un message d'erreur s'affiche en regard de sa liste déroulante.

Exécuter la commande du shell

Cette option permet au script de passer des commandes à l'interpréteur sur l'ordinateur géré. Une fois que vous avez sélectionné cette commande, le champ Saisir la commande à exécuter dans une invite de commande s'affiche. Saisissez une commande dans ce champ. La syntaxe de la commande doit être correcte. Son exécution doit être possible avec la version du système d'exploitation sur l'ordinateur géré. Les commandes et les paramètres avec des espaces doivent être placés entre guillemets. Dans la mesure où l'exécution des commandes dépend du répertoire de l'agent, vous devez utiliser les chemins d'accès absolus lors de la saisie de ces commandes.

Remarque: la fonction Exécuter la commande du shell affiche une fenêtre d'invite de commandes sur l'ordinateur géré avant d'y être exécutée. Si vous ne souhaitez pas l'affichage de cette fenêtre sur l'ordinateur géré au risque de créer une confusion, placez toutes les commandes dans un fichier de commandes. Envoyez ce fichier vers l'ordinateur géré à l'aide de la commande Écrire le fichier. Exécutez-le avec la commande Exécuter le fichier. La fonction Exécuter le fichier n'ouvre pas de fenêtre sur l'ordinateur géré.

Récupérer le chemin de répertoire dans le registre

Cette option permet de renvoyer un chemin d'accès au fichier stocké dans la clé de registre spécifiée. Utilisez cette commande pour récupérer l'emplacement du fichier. Par exemple, cette commande vous permet de rechercher le répertoire où l'application a été installée.

Récupérer le fichier

Téléchargez le fichier en utilisant le chemin spécifié sur l'ordinateur géré. Veillez à saisir un chemin d'accès complet pour y charger le fichier souhaité. Le fichier est stocké sur le serveur KServer dans un répertoire privé pour chaque ordinateur géré. Accédez au fichier chargé dans Scripts > Récupérer le fichier.

• Vous pouvez éventuellement renommer les copies existantes des fichiers chargés en utilisant une extension .bak. Faites-le avant le prochain téléchargement. Vous avez ainsi accès à la dernière version du fichier et à l'ancienne version.
• Vous pouvez éventuellement envoyer un email d'alerte si le fichier téléchargé n'est pas celui que vous avez déjà téléchargé.
• Vous pouvez éventuellement envoyer un email d'alerte si le fichier téléchargé est le même que vous avez déjà téléchargé.

Récupérer le fichier dans le chemin du répertoire

Cette commande ressemble à la commande Récupérer le fichier si ce n'est que celle-ci ajoute le chemin d'accès renvoyé par la commande Récupérer le chemin de répertoire dans le registre au début du chemin d'accès distant. Accédez au fichier chargé dans Scripts > Récupérer le fichier.

Récupérer l'URL

Cette option permet de renvoyer le lien URL d'une page Web et le stocke dans un fichier.

Récupérer la variable

Cette option permet de définir une nouvelle variable d'agent. Lorsque l'étape du script est exécutée, le système définit une nouvelle variable et lui affecte une valeur en fonction des données extraites de l'agent sur l'ordinateur géré. Vous pouvez faire référence à cette valeur dans une ligne de script ultérieure ou un script imbriqué en délimitant le nom de la variable avec le caractère #. Par exemple : #var_name#.

Remarque: Seules les variables créées à l'aide de la commande Récupérer la variable dans un script apparaissent dans les étapes suivantes avec le nom de la variable entouré du caractère #. Les variables créées à l'aide du Gestionnaire de variables apparaissent dans les scripts avec le nom de la variable entouré des caractères < et >.

• Valeur de registre : données issues de la valeur de registre spécifiée sur l'ordinateur géré.
• Contenus des fichiers : données issues d'un fichier spécifié sur l'ordinateur géré.
• Valeur constante : constante spécifiée, telle qu'elle est saisie dans l'Éditeur de script.
• Valeur de l'expression : permet de spécifier une expression constituée de variables de scripts et de six opérateurs mathématiques +, -, *, /, ( et ), qui sont évalués et affectés à une nouvelle variable de script. Par exemple, ((#variable1# + #variable2#) + 17.4) / (#variable3# * 4). Les variables de script doivent contenir des valeurs numériques.
• Chemin d'accès au répertoire d'installation de l'agent : répertoire où l'agent est installé sur l'ordinateur géré.
• Lecteur d'installation de l'agent : lecteur sur lequel l'agent est installé sur l'ordinateur géré, par exemple c:\.
• Chemin du répertoire temp de l'agent : répertoire temporaire sur l'ordinateur géré, comme défini dans la fonction Répertoire temporaire sur l'onglet de l'agent.
• Chemin du répertoire Temp utilisateur : répertoire temporaire pour l'utilisateur connecté actuellement sur l'ordinateur géré. Ce chemin est une expansion de la variable d'environnement %TEMP% pour l'utilisateur connecté. SI aucun utilisateur n'est connecté, le répertoire temporaire Windows est défini par défaut.
• ID d'ordinateur.groupe : ID d'ordinateur pour l'agent chargé d'exécuter le script.
• Numéro de version du fichier : numéro de version issue de la propriété du fichier spécifié sur l'ordinateur géré.
• Taille de fichier : taille en octets du fichier spécifié sur l'ordinateur géré.
• Date de dernière modification du fichier : date du fichier spécifié sur l'ordinateur géré au format aaaa/mm/jj hh:mm:ss.
• Données de la vue SQL : valeur de dbo.SqlView.Column. Utilisez le format SqlViewName/ColumnName/mach.groupID ou SqlViewName/ColumnName. Si l'ID d'ordinateur facultatif est ignoré, la valeur de l'agent, qui exécute ce script, est extraite. Si ColumnName comprend un espace, le met entre parenthèses. Par exemple : vSystemInfo/[Product Name]. Consultez Système > Vues de la base de données pour accéder à une liste disponible des vues et des colonnes SQL.
• Propriété WMI : espace de noms, classe et propriété WMI. Le format de la propriété WMI spécifiée est NameSpace:Class.Property. Par exemple, root\cimv2:Win32_OperatingSystem.FreePhysicalMemory.

Faites-vous passer pour l'utilisateur

Saisissez un nom d'utilisateur, un mot de passe et un domaine pour que l'agent puisse se connecter, lorsque vous spécifiez la commande Exécuter en tant qu'utilisateur... dans Exécuter le fichier, Exécuter le fichier situé dans le chemin de répertoire ou Exécuter la commande du shell. Laissez le domaine vide pour une connexion à un compte sur l'ordinateur local.

Suspendre le script

Suspendre ce script pendant N secondes. Cette commande permet de donner du temps à Windows pour l'exécution d'une tâche asynchrone, telles que le démarrage ou l'arrêt d'un service.

Redémarrer

Cette option permet de redémarrer l'ordinateur géré sans conditions. Pour avertir l'utilisateur, précédez cette commande d'un message La réponse de l'utilisateur est Oui. Un message La réponse de l'utilisateur est Oui avertit l'utilisateur avant le redémarrage de son ordinateur.

Renommer le fichier verrouillé

Cette option permet de renommer un fichier en cours d'utilisation. Le fichier est renommé au prochain redémarrage du système. Le nom du fichier spécifié est un chemin d'accès complet. La fonction Renommer le fichier verrouillé permet également de supprimer un fichier utilisé si sa destination est vide. Le fichier est supprimé au redémarrage du système.

Renommer le fichier verrouillé dans le chemin d'accès au répertoire

Cette option permet de renommer un fichier en cours d'utilisation. Le fichier est renommé au prochain redémarrage du système. Le nom du fichier spécifié est ajouté au chemin d'accès au répertoire. La fonction Renommer le fichier verrouillé dans le chemin d'accès au répertoire permet également de supprimer un fichier utilisé si sa destination est vide. Le fichier est supprimé au redémarrage du système.

Planifier le script

Cette option permet de planifier l'exécution d'un script. Cette option vous permet éventuellement de préciser le délai d'attente après l'exécution de cette tâche, avant l'exécution du script et de l'ID d'ordinateur concerné, pour y exécuter le script.

Envoyer un email

Cette option permet d'envoyer un email à au moins un destinataire. Cette option permet de spécifier l'objet et le texte de l'email.

Envoyer un message

Cette option permet d'envoyer le message saisi vers un ordinateur géré. Si vous sélectionnez l'option Immédiatement, un message s'affiche immédiatement. Si vous sélectionnez l'option Après que l'utilisateur clique sur l'icône clignotante de la barre du statut système, l'icône Agent dans la barre d'état système clignote à la réception d'un message. Lorsque l'utilisateur clique sur l'icône, le message s'affiche.

Envoyer l'URL

Cette option permet d'envoyer le lien URL saisi vers un ordinateur géré. Si vous sélectionnez l'option Immédiatement, le navigateur Web est lancé par défaut et le lien URL spécifié s'affiche. Si vous sélectionnez l'option Après que l'utilisateur clique sur l'icône clignotante de la barre du statut système, l'icône Agent dans la barre d'état système clignote à la réception d'un message. Le lien URL s'affiche dans le navigateur Web par défaut lorsque l'utilisateur clique sur l'icône.

Définir la valeur de registre

Cette option permet d'écrire des données sur la clé de registre spécifiée. Cette fonction prend les trois paramètres suivants :

• Chemin d'accès à la clé de registre.
• Données pour écrire sur la clé de registre.
• Type de données pour la clé de registre.
  • REG_SZ : valeur de chaîne.
  • REG_BINARY : données binaires au format hexadécimal.
  • DWORD : données binaires limitées à 32 bits. Saisie au format hexadécimal ou décimal.
  • REG_EXPAND_SZ : valeur de chaîne « extensible » avec une variable. Par exemple : %SystemRoot%.
  • REG_MULTI_SZ : tableau de chaînes multiples. Utilisé pour saisir plusieurs valeurs, chacune étant séparée par une chaîne \0. Utilisez \\0 pour insérer \0 dans une valeur de tableau de chaînes.

Utiliser l'identification

Utilisez l'identification de l'ID d'ordinateur dans la page Définir les informations d'identification pour exécuter un fichier ou une commande du shell lorsque vous spécifiez la commande Exécuter en tant qu'utilisateur... dans Exécuter le fichier, Exécuter le fichier situé dans le chemin de répertoire ou Exécuter la commande du shell. La commande de script Utiliser l'identification fonctionne de la même façon que la commande Faites-vous passer pour l'utilisateur. La seule différence est que vous pouvez utiliser une identification unique plutôt qu'une identification fixe dans un script pour accéder à chaque ordinateur.

Remarque: une erreur d'exécution du script est enregistrée si une commande de script Définir les informations d'identification tombe sur un nom d'utilisateur vide.

Écrire le répertoire

Cette option permet d'écrire un répertoire sélectionné, dont les sous-répertoires et les fichiers, en le copiant depuis la fenêtre Gérer les fichiers stockés sur le serveur vers le nom de son chemin d'accès complet spécifié sur l'ordinateur géré.

Écrire le fichier

Cette option permet d'écrire un fichier sélectionné dans une liste déroulante en le copiant depuis la fenêtre Gérer les fichiers stockés sur le serveur vers le nom de son chemin d'accès complet spécifié sur l'ordinateur géré. Saisissez un nouveau nom de fichier si vous souhaitez le renommer.

Chaque fois qu'un script exécute la commande Écrire le fichier, l'agent vérifie si le fichier est déjà présent ou non en le hachant pour en vérifier l'intégrité. Si non, le fichier est écrit. Si le fichier existe, le script passe à l'étape suivante. Vous pouvez exécuter un script plusieurs fois avec la fonction Écrire le fichier, qui envoie un fichier volumineux à un ordinateur géré sachant que le serveur VSA ne le téléchargera qu'une seule fois.

Remarque: des variables d'environnement sont acceptables si vous les définissez sur l'ordinateur d'un utilisateur. Ainsi, l'utilisation d'un chemin d'accès %windir%\notepad.exe ressemblerait à celle de C:\windows\notepad.exe.

Écrire un fichier dans le chemin du répertoire

Cette option permet d'écrire le nom de fichier spécifié en le copiant vers le chemin d'accès renvoyé par une commande Récupérer le chemin du répertoire du registre.

Écrire l'entrée de journal des scripts

Cette option permet d'écrire la chaîne fournie en la copiant vers le journal des scripts pour l'agent chargé d'exécuter ce script.

Rubrique 674: Envoyer vos commentaires. Télécharger une version PDF de ce guide en ligne depuis la première rubrique de la table des matières.