DocsAgent Exécuter
Une fonction | Exécuter un programme sur le système cible (Windows uniquement) |
|---|---|
Alarmant | Code de sortie, durée d'exécution |
Détail de l'exécution de l' Agent
Paramètres d'exécution de l' Agent
Paramètre | Description |
|---|---|
Chemin du programme | Programme exécutable incluant son chemin absolu. Ce chemin ou exécutable spécifique doit être autorisé dans la section Exécuter les programmes de la configuration WinAgent distant. |
Argument de ligne de commande. | Arguments de ligne de commande pour l'exécutable. |
Temps libre | L'exécutable sera terminé 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'attente remplace le délai d'attente par défaut dans la configuration WinAgent distant ( Délai d'attente du processus par défaut ). |
Exécuter une seule instance | Une seule instance de l'exécutable est autorisée si elle 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 redémarré. |
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 le temps d'exécution | Si cette case est cochée, la durée d'exécution de chaque vérification 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 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 du travail.
Agent Exécuter les valeurs et les limites d'alarme
Valeur / Limite d'alarme | Description |
|---|---|
Code de sortie | Code de sortie renvoyé par l'exécutable. Habituellement, un code de sortie de 0 signifie qu'il n'y a pas eu d'erreurs lors de l'exécution, cependant, le code de sortie dépend de l'exécutable. |
Durée de fonctionnement | La durée d'exécution du programme à distance (en s). Cette valeur et cette limite d'alarme ne sont disponibles que si le paramètre Supprimer le temps de fonctionnement n'est pas activé. |
Code d'erreur | Code d'erreur de tâche générique (voir section Codes d'erreur de tâche ) |
Exemples d'exécution d' Agent
Exemple 1 - Effectuer un redémarrage à distance
Cet exemple utilise la commande système shutdown.exe avec l'argument /r pour émettre un redémarrage de la machine distante.
Cela nécessite que la commande ou son répertoire parent soit autorisé dans la configuration distante de WinAgent dans l'onglet Exécuter les programmes :
Sortie 1
Exemple 2 - Vérifiez 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 du 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 distante de WinAgent dans l'onglet Exécuter les programmes (voir ci-dessus).
Cela permet de vérifier l'état d'un service sur des machines distantes exécutant par exemple Windows 2000, qui n'est pas pris en charge pour le plug-in de travail Agent Service .
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 - Envoyer un ping à un server à partir de l'hôte Windows à l'aide de PowerShell
Cette tâche envoie un ping au server 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 du 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 PowerShell.exe doit également être autorisé dans la configuration à distance de WinAgent dans l'onglet Exécuter les programmes (voir ci-dessus).