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).