Agent Exécuter
Fonction | Exécuter un programme sur le système cible (Windows uniquement) |
|---|---|
Alarme | Code de sortie, temps d'exécution |
Détails d'exécution de l'agent
Paramètres d'exécution de l'agent
Paramètre | Description |
|---|---|
Chemin d'accès au programme | Programme exécutable, y compris son chemin d'accès absolu. Ce chemin d'accès ou cet exécutable spécifique doit être autorisé dans la section Exécuter les programmes de la configuration WinAgent à distance. |
Argument de ligne de commande | Arguments de ligne de commande pour l'exécutable. |
Délai | L'exécutable sera arrêté après le délai d'expiration, s'il est toujours en cours d'exécution. S'il est défini, ce délai d'expiration remplace le délai d'expiration par défaut dans la configuration WinAgent à distance (Délai d'expiration du processus par défaut). |
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, WinAgent masque les fenêtres de l'application exécutée. |
Supprimer le temps d'exécution | Si cette case est cochée, le temps d'exécution de chaque vérification n'est pas enregistré 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 de limite d'alarme. |
La liste déroulante Balises permet de saisir des variables prédéfinies dans les champs ci-dessus, par exemple $NAME$ pour le nom de la tâche.
Valeurs d'exécution de l'agent et limites d'alarme
Valeur / Limite d'alarme | Description |
|---|---|
Code de sortie | Code de sortie renvoyé par l'exécutable. En général, un code de sortie de 0 signifie qu'aucune erreur n'est survenue pendant l'exécution, mais le code de sortie dépend de l'exécutable. |
Durée d'exécution | Durée d'exécution du programme distant (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 de la tâche (voir la section Codes d'erreur des tâches) |
Exemples d'exécution d'agent
Exemple 1 - Lancer un redémarrage à distance
Cet exemple utilise la commande système shutdown.exe avec l'argument /r pour redémarrer la machine distante.
Pour cela, la commande ou son répertoire parent doit être autorisé dans la configuration WinAgent à distance, sous l'onglet Exécuter les 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
Cela exécute la commande suivante et vérifie si le service w32time est en cours d'exécution sur la machine distante :
Chemin d'accès au programme | C:\Windows\system32\cmd.exe |
|---|---|
Argument de ligne de commande | /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 WinAgent distante, dans l'onglet Exécuter les programmes (voir ci-dessus).
Cela permet de vérifier l'état d'un service sur des machines distantes fonctionnant par exemple sous Windows 2000, qui n'est pas pris en charge par le plugin Agent Service job.
Sortie 2
Si le service est en cours d'exécution, le code de sortie est = 0, s'il est arrêté ou indisponible, le code de sortie est = 1.
Exemple 3 - Ping d'un server à partir de l'hôte Windows à l'aide de PowerShell
Cette tâche envoie une requête ping au server1 à partir du 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 |
|---|---|
Argument de ligne de commande. | if (test-connection server1 -Count 2 -Quiet) {exit 0} else {exit 1} |
Le fichier PowerShell.exe doit également être autorisé dans la configuration WinAgent à distance, dans l'onglet Exécuter les programmes (voir ci-dessus).






