DokumentationAgent Ausführen
Funktion | Ausführen eines Programms auf dem Zielsystem (nur Windows) |
|---|---|
Alarmierung | Exit-Code, Laufzeit |
Agent Ausführungsdetails
Agent-Ausführungsparameter
Parameter | Beschreibung |
|---|---|
Programm-Pfad | Ausführbares Programm einschließlich seines absoluten Pfads. Dieser Pfad oder diese bestimmte ausführbare Datei muss im Abschnitt „Programme ausführen“ der Remote-WinAgent-Konfiguration zugelassen sein. |
Befehlszeilenargumente | Befehlszeilenargumente für die ausführbare Datei. |
Zeitlimit | Die ausführbare Datei wird nach Ablauf der Zeitüberschreitung beendet, wenn sie noch ausgeführt wird. Wenn diese Option aktiviert ist, überschreibt diese Zeitüberschreitung die Standardzeitüberschreitung in der Remote-WinAgent-Konfiguration (Standard-Prozesszeitüberschreitung). |
Nur eine Instanz ausführen | Wenn diese Option aktiviert ist, ist nur eine Instanz der ausführbaren Datei zulässig. Befindet sich die ausführbare Datei bereits in der Liste der laufenden Programme des Zielsystems, wird sie nicht erneut gestartet. |
Fenster während der Ausführung ausblenden | Wenn dieses Kontrollkästchen aktiviert ist, blendet WinAgent die Fenster der ausgeführten Anwendung aus. |
Laufzeit unterdrücken | Wenn dieses Kontrollkästchen aktiviert ist, wird die Laufzeit jeder Überprüfung nicht in der Datenbank gespeichert und ihr Wert ist im Wertebereich nicht mehr sichtbar. Der Wert steht auch nicht mehr für die Verwendung in Alarm Limit-Angaben zur Verfügung. |
Über die Dropdown-Liste „Tags“ können vordefinierte Variablen in die Felder oben eingegeben werden, z. B. $NAME$ für den Namen des Auftrags.
Agent-Ausführungswerte und Alarm Limits
Wert / Alarm Limit | Beschreibung |
|---|---|
Exit-Code | Der vom ausführbaren Programm zurückgegebene Exit-Code. Normalerweise bedeutet ein Exit-Code von 0, dass während der Ausführung keine Fehler aufgetreten sind. Der Exit-Code hängt jedoch vom ausführbaren Programm ab. |
Laufzeit | Die Dauer der Ausführung des Remote-Programms (in Sekunden). Dieser Wert und das Alarm Limit sind nur verfügbar, wenn der Parameter „Laufzeit unterdrücken” nicht aktiviert ist. |
Fehlercode | Generischer Job-Fehlercode (siehe Abschnitt „Job-Fehlercodes“) |
Beispiele für die Ausführung von Agenten
Beispiel 1 – Remote-Neustart ausführen
In diesem Beispiel wird der Systembefehl „shutdown.exe“ mit dem Argument „/r“ verwendet, um einen Neustart des Remote-Computers auszuführen.
Dazu muss der Befehl oder sein übergeordnetes Verzeichnis in der Remote-WinAgent-Konfiguration auf der Registerkarte „Programme ausführen“ zugelassen sein:
Ausgabe 1
Beispiel 2 – Überprüfen, ob der Dienst „w32time“ auf dem Remote-Computer mit dem Befehl „wmic“ ausgeführt wird
Hiermit wird der folgende Befehl ausgeführt und überprüft, ob der Dienst „w32time“ auf dem Remote-Computer ausgeführt wird:
Programm-Pfad | C:\Windows\system32\cmd.exe |
|---|---|
Befehlszeilenargument | /C FOR /F %G IN ('wmic service w32time get state /value ^| findstr "State=Running"') Do exit /B 0 |
Die ausführbare Datei cmd.exe muss auch in der Remote-WinAgent-Konfiguration auf der Registerkarte „Programme ausführen” (siehe oben) zugelassen sein.
Dadurch kann der Status eines Dienstes auf Remote-Rechnern überprüft werden, auf denen z. B. Windows 2000 läuft, was für das Agent Service Job-Plugin nicht unterstützt wird.
Ausgabe 2
Wenn der Dienst ausgeführt wird, ist der Exit-Code = 0, wenn er angehalten wurde oder nicht verfügbar ist, ist der Exit-Code = 1.
Beispiel 3 – Ping eines Servers vom Windows-Host mit PowerShell
Dieser Job pingt den Server server1 vom Windows-System aus an und gibt bei Erfolg den Exit-Code 0 und bei einem Fehler den Exit-Code 1 zurück.
Programm-Pfad | %SystemRoot%\system32\WindowsPowerShell\v1.0\powershell.exe |
|---|---|
Befehlszeilenargument | if (test-connection server1 -Count 2 -Quiet) {exit 0} else {exit 1} |
Die Datei „PowerShell.exe“ muss außerdem in der Remote-WinAgent-Konfiguration auf der Registerkarte „Programme ausführen“ zugelassen sein (siehe oben).