DocumentationAgent Exécuter
Fonction | Exécuter un programme sur le système cible (Windows uniquement) |
|---|---|
Alarme | Code de sortie, Durée d'exécution |
Détails de l'exécution par l'agent
Paramètres d'exécution de l'agent
Paramètre | Description du paramètre |
|---|---|
Chemin d'accès au programme | Programme exécutable avec son chemin d'accès absolu. Ce chemin ou l'exécutable spécifique doit être autorisé dans la section Exécuter des programmes de la configuration de WinAgent à distance. |
Ligne de commande arg. | Arguments de la ligne de commande pour l'exécutable. |
Timeout | L'exécutable sera interrompu après le délai d'attente, s'il est toujours en cours d'exécution. S'il est défini, ce délai remplace le délai par défaut dans la configuration WinAgent distante(Délai d'attente par défaut du processus). |
Exécuter une seule instance | Une seule instance de l'exécutable est autorisée si cette option est cochée. Si l'exécutable figure déjà dans la liste des programmes en cours d'exécution du système cible, il ne sera pas relancé. |
Masquer la fenêtre pendant l'exécution | Si cette case est cochée, le WinAgent masque les fenêtres de l'application exécutée. |
Supprimer la durée d'exécution | Si cette case est cochée, la durée d'exécution de chaque contrôle n'est pas enregistrée dans la base de données et sa valeur n'est plus visible dans la section des valeurs. Sa valeur n'est également plus disponible pour être utilisée dans les spécifications des limites d'alarme. |
La liste déroulante Tags permet de saisir des variables prédéfinies dans les champs ci-dessus, par exemple $NAME$ pour le nom du travail.
Valeurs d'exécution de l'agent et limites d'alarme
Valeur / Limite d'alarme | Description de la valeur |
|---|---|
Code de sortie | Code de sortie renvoyé par l'exécutable. En général, un code de sortie de 0 signifie qu'il n'y a pas eu d'erreur pendant l'exécution, mais le code de sortie dépend de l'exécutable. |
Durée d'exécution | Durée de l'exécution du programme à distance (en secondes). Cette valeur et cette limite d'alarme ne sont disponibles que si le paramètre Supprimer le temps d'exécution n'est pas activé. |
Code d'erreur | Code d'erreur générique du travail (voir la section Codes d'erreur des travaux). |
Exemples d'exécution par l'agent
Exemple 1 - Effectuer un redémarrage à distance
Cet exemple utilise la commande système shutdown.exe avec l'argument /r pour redémarrer la machine distante.
Pour ce faire, la commande ou son répertoire parent doit être autorisé dans la configuration de WinAgent à distance, dans l'onglet Exécuter des programmes:
Sortie 1
Exemple 2 - Vérifier si le service w32time est en cours d'exécution à l'aide de la commande wmic sur la machine distante
La commande suivante est exécutée et vérifie si le service w32time est en cours d'exécution sur la machine distante :
Chemin d'accès au programme | C:\NWindows\NSystem32\Ncmd.exe |
|---|---|
Ligne de commande arg. | /C FOR /F %G IN ('wmic service w32time get state /value ^| findstr "State=Running"') Do exit /B 0 |
L'exécutable cmd.exe doit également être autorisé dans la configuration du WinAgent distant dans l'onglet Exécuter des programmes (voir ci-dessus).
Cela permet de vérifier l'état d'un service sur des machines distantes fonctionnant par exemple sous Windows 2000, ce qui n'est pas pris en charge par le plugin de tâches du service de l'agent.
Sortie 2
Si le service est en cours d'exécution, le code de sortie est = 0, s'il est arrêté ou non disponible, le code de sortie est = 1.
Exemple 3 - Envoi d'une requête ping à un serveur à partir de l'hôte Windows à l'aide de PowerShell
Ce job ping le serveur server1 depuis le système Windows et renvoie le code de sortie 0 en cas de succès ou 1 en cas d'échec.
Chemin d'accès au programme | %SystemRoot%\system32\WindowsPowerShell\v1.0\powershell.exe |
|---|---|
Ligne de commande arg. | if (test-connection server1 -Count 2 -Quiet) {exit 0} else {exit 1} |
PowerShell.exe doit également être autorisé dans la configuration du WinAgent distant dans l'onglet Exécuter des programmes (voir ci-dessus).