SKOOR Dokumentation

Agent Ausführen

Funktion	Ausführen eines Programms auf dem Zielsystem (nur Windows)
Alarmierung	Exit-Code, Laufzeit

Agent Ausführen Detail

Agent Ausführen Parameter

Parameter	Beschreibung
Programm-Pfad	Ausführbares Programm einschließlich seines absoluten Pfads. Dieser Pfad oder eine bestimmte ausführbare Datei muss in der WinAgent-Remote-Konfiguration im Abschnitt Run Programs zugelassen sein.
Befehlszeilen-Arg.	Befehlszeilenargumente für die ausführbare Datei.
Zeitüberschreitung	Die ausführbare Datei wird nach einer bestimmten Zeitspanne beendet, falls sie noch läuft. Wenn diese Zeitüberschreitung festgelegt ist, überschreibt sie die Standardzeitüberschreitung in der WinAgent-Remote-Konfiguration(Standardzeitüberschreitung für Prozesse).
Nur eine Instanz ausführen	Wenn dieses Kontrollkästchen aktiviert ist, ist nur eine Instanz der ausführbaren Datei zulässig. Wenn sich die ausführbare Datei bereits in der Liste der laufenden Programme des Zielsystems befindet, wird sie nicht erneut gestartet.
Fenster während der Ausführung ausblenden	Wenn dieses Kontrollkästchen aktiviert ist, blendet der WinAgent die Fenster der ausgeführten Anwendung aus.
Laufende Zeit unterdrücken	Wenn dieses Kontrollkästchen aktiviert ist, wird die Laufzeit jeder Prüfung nicht in der Datenbank gespeichert und ihr Wert ist nicht mehr im Wertebereich sichtbar. Ihr Wert steht auch nicht mehr für die Angabe von Alarm Limits zur Verfügung.

Die Dropdown-Liste Tags ermöglicht die Eingabe von vordefinierten Variablen in die obigen Felder, z.B. $NAME$ für den Namen des Jobs.

Agent Execute Werte und Alarm Limits

Wert / Alarm Limit	Beschreibung
Exit-Code	Der von der ausführbaren Datei 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 von der ausführbaren Datei ab.
Laufende Zeit	Die Dauer der Ausführung des entfernten Programms (in s). Dieser Wert und das Alarm Limit sind nur verfügbar, wenn der Parameter Laufzeit unterdrücken nicht aktiviert ist.
Fehlercode	Allgemeiner Job-Fehlercode (siehe Abschnitt Job-Fehlercodes)

Beispiele für Agent Execute

Beispiel 1 - Neustart aus der Ferne durchführen

In diesem Beispiel wird der Systembefehl shutdown.exe mit dem Argument /r verwendet, um einen Neustart des entfernten Computers durchzuführen.

Dazu muss der Befehl oder sein übergeordnetes Verzeichnis in der WinAgent-Remotekonfiguration auf der Registerkarte Programme ausführen zugelassen sein:

Ausgabe 1

Beispiel 2 - Prüfen, ob der Dienst w32time mit dem Befehl wmic auf dem entfernten Computer ausgeführt wird

Der folgende Befehl wird ausgeführt und überprüft, ob der Dienst w32time auf dem entfernten Computer ausgeführt wird:

Programmpfad	C:\Windows\system32\cmd.exe
Befehlszeile arg.	/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 WinAgent-Remotekonfiguration auf der Registerkarte Programme ausführen (siehe oben) zugelassen werden.

Dies ermöglicht es, den Status eines Dienstes auf entfernten Rechnern zu überprüfen, 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 läuft, ist der Exit-Code = 0, wenn er gestoppt oder nicht verfügbar ist, ist der Exit-Code = 1.

Beispiel 3 - Anpingen eines Servers vom Windows-Host mit PowerShell

Dieser Auftrag pingt den Server server1 vom Windows-System aus an und gibt im Erfolgsfall den Exit-Code 0 und im Fehlerfall 1 zurück.

Programmpfad	%SystemRoot%\system32\WindowsPowerShell\v1.0\powershell.exe
Befehlszeilenarg.	if (test-connection server1 -Count 2 -Quiet) {exit 0} else {exit 1}

Die PowerShell.exe muss auch in der WinAgent-Remotekonfiguration auf der Registerkarte Programme ausführen zugelassen werden (siehe oben).