SKOOR Documentation

Agent ausführen

Funktion	Ausführen eines Programms auf dem Zielsystem (nur Windows)
Alarmierend	Exitcode, Laufzeit

Agent

Agent -Ausführungsparameter

Parameter	Beschreibung
Programmpfad	Ausführbares Programm einschließlich seines absoluten Pfads. Dieser Pfad oder die spezifische ausführbare Datei muss im Abschnitt „ Programme ausführen“ der Remote-WinAgent-Konfiguration zugelassen werden.
Befehlszeilen-Arg.	Befehlszeilenargumente für die ausführbare Datei.
Auszeit	Die ausführbare Datei wird nach Ablauf der Zeitüberschreitung beendet, falls sie noch ausgeführt wird. Wenn diese Zeitüberschreitung festgelegt ist, überschreibt diese Zeitüberschreitung die Standardzeitüberschreitung in der Remote-WinAgent-Konfiguration ( Standardprozesszeitüberschreitung ).
Führen Sie nur eine Instanz aus	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 ausgeführten Programme des Zielsystems, wird sie nicht erneut gestartet.
Fenster während der Ausführung ausblenden	Wenn dieses Kontrollkästchen gesetzt ist, blendet der WinAgent die Fenster der ausgeführten Anwendung aus.
Laufzeit 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. Sein Wert steht auch nicht mehr zur Verwendung in Alarm Limit zur Verfügung.

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

Agent Execute-Werte und Alarmgrenzen

Wert / Alarm Limit	Beschreibung
Exit-Code	Der von der ausführbaren Datei zurückgegebene Beendigungscode. 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.
Laufzeit	Die Dauer der Remote-Programmausführung (in s). Dieser Wert und die 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 die Ausführung von Agent

Beispiel 1 – Führen Sie einen Remote-Neustart durch

In diesem Beispiel wird der Systembefehl shutdown.exe mit dem Argument /r verwendet, um einen Neustart des Remotecomputers zu veranlassen.

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

Ausgang 1

Beispiel 2 – Überprüfen Sie, ob der Dienst w32time ausgeführt wird, indem Sie den Befehl wmic auf dem Remote-Computer verwenden

Dadurch wird der folgende Befehl ausgeführt und überprüft, ob der w32time -Dienst auf dem Remotecomputer ausgeführt wird:

Programmpfad	C:\Windows\system32\cmd.exe
Befehlszeilen-Arg.	/C FOR /F %G IN ('wmic service w32time get state /value ^\| findstr "State=Running"') Verlassen Sie /B 0

Die ausführbare Datei cmd.exe muss auch in der Remote-WinAgent-Konfiguration auf der Registerkarte Programme ausführen zugelassen werden (siehe oben).

Dies ermöglicht es, einen Dienststatus auf entfernten Rechnern zu prüfen, auf denen zB Windows 2000 ausgeführt wird, was für das Job-Plug-in Agent Service nicht unterstützt wird.

Ausgang 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 – Pingen Sie einen Server vom Windows-Host mit PowerShell

Dieser Job pingt Server server1 vom Windows-System aus und gibt den Exit-Code 0 im Erfolgsfall oder 1 zurück, wenn er fehlschlägt.

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

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