Führt ein gespeichertes Skript auf einem Gerät als Teil einer Automatisierung aus. Unterstützt PowerShell, Bash, Python und andere Sprachen. Wenn Ihr Skript Daten von außerhalb benötigt – wie einen benutzerdefinierten Feldwert oder eine Automatisierungsvariable – können Sie diese zuordnen, ohne die Skriptlogik zu ändern.

Klicken Sie in der Automatisierungspipeline im Bearbeitungsmodus auf + und wählen Sie Skript ausführen aus der Kategorie „System".

Das Aktionsfenster öffnet sich und zeigt das Skript Feld und zwei Schaltflächen: ein Symbol für einen externen Link zum Durchsuchen Ihrer gespeicherten Skripte und Skript erstellen um ein neues Skript inline zu schreiben.

Klicken Sie auf das Symbol für den externen Link neben dem Skript Feld, um die Auswahl gespeicherter Skripte zu öffnen. Skripte sind in Ordnern organisiert – erweitern Sie einen Ordner, um dessen Inhalt zu durchsuchen, oder verwenden Sie das Suchfeld, um ein Skript nach Name zu finden.

Klicken Sie auf Skript erstellen um ein neues Skript zu schreiben, ohne den Automatisierungseditor zu verlassen. Der Skripteditor öffnet sich als Seitenbereich.

Konfigurieren Sie Folgendes:

Skriptname Ein beschreibender Name für das Skript. Es wird in Ihrer Skriptbibliothek gespeichert und steht für die Verwendung in anderen Automatisierungen zur Verfügung.

Sprache Die Skriptsprache für dieses Skript.

Unterstützte Sprachen: Ansible, Bash, Go, osquery, PowerShell, Python, Zsh.

Zeitlimit (in Sekunden) Wie lange Level wartet, bis das Skript abgeschlossen ist, bevor es als fehlgeschlagen markiert wird. Standardwert ist 100 Sekunden.

Ausführen als Der Kontokontext, unter dem das Skript ausgeführt wird.

Schreiben Sie Ihr Skript im Code-Editor. Klicken Sie auf {x} um Variablen und benutzerdefinierte Felder direkt im Skript zu referenzieren. Klicken Sie abschließend auf Skript erstellen um es zu speichern und der Aktion zuzuordnen.

Skriptvariablen sind benannte Werte, die im Variablen Registerkarte. Im Skript ausführen Aktion ermöglicht es, durch die Zuordnung einer Skriptvariable zu einer Automatisierungsvariable, dass das gespeicherte Skript Eingaben empfängt und einen aktualisierten Wert an spätere Automatisierungsschritte zurücksendet.

Wenn ein Skript mit definierten Variablen ausgewählt wird, erscheint ein Skriptvariablen Abschnitt erscheint im Aktionsfenster.

So ordnen Sie eine Skriptvariable einer Automatisierungsvariable zu:

Wenn das Skript startet, erhält die zugeordnete Skriptvariable den aktuellen Wert der Automatisierungsvariable. Referenzieren Sie sie im gespeicherten Skript mit {{script_variable_name}}. Um einen neuen Wert an die Automatisierung zurückzusenden, weisen Sie der Skriptvariable mit {{script_variable_name=value_expression}}.

Siehe Automatisierungsvariablen die vollständige Referenz zum Erstellen und Verwenden von Automatisierungsvariablen.

Skriptvariablen werden im Skript selbst definiert, nicht im Aktionsfenster. Öffnen Sie den Skripteditor und navigieren Sie zur Variablen Registerkarte hinzufügen, bearbeiten oder entfernen.

Es gibt zwei Möglichkeiten, einen Wert aus einem Skript zu erfassen und für nachfolgende Aktionen in der Pipeline verfügbar zu machen.

Verwenden Sie {{script_variable_name=value_expression}} im gespeicherten Skript, um eine zugeordnete Automatisierungsvariable zu aktualisieren. Wenn beispielsweise eine PowerShell-Skriptvariable mit dem Namen local_ip einer Automatisierungsvariable zugeordnet ist, verwenden Sie {{local_ip=$ip}} nach der Berechnung von $ip.

Vor der Ausführung ersetzt Level die Zuweisung durch den korrekten Variablen-Setzbefehl für die Shell des Skripts. Die Ausgabe wird nicht aus der Standardausgabe des Skripts geparst. Die Skriptvariable muss im Variablen Registerkarte vorhanden und in der Skript ausführen Aktion.

Verwenden Sie diese Option, wenn das Skript Protokolle oder andere Ausgaben erzeugt und Sie nur einen bestimmten Wert weitergeben möchten.

In Zusätzliche Optionen, verwenden Sie Aktionsausgabe einer Variable zuweisen um die gesamte Standardausgabe des Skripts in eine Automatisierungsvariable zu erfassen. Dies funktioniert für jedes Skript, ohne Änderungen am Skript selbst vorzunehmen – erfasst jedoch alles, was das Skript ausgibt, und nicht nur den benötigten Wert.

Level verwendet den Exit-Code des Skripts, um festzustellen, ob die Aktion erfolgreich war oder fehlgeschlagen ist.

Ihre Bei Aktionsfehler Einstellung in den zusätzlichen Optionen steuert, was als Nächstes passiert – ob die Pipeline stoppt oder fortfährt.

Stellen Sie sicher, dass Ihre Skripte explizit mit dem entsprechenden Code beendet werden. Wenn ein Skript mit 0 nach einem nicht behandelten Fehler beendet, behandelt Level die Aktion als erfolgreich.

Der Bedingungen Abschnitt ermöglicht es Ihnen, einzuschränken, wann diese Aktion ausgeführt wird, basierend auf Geräteattributen oder dem Ergebnis einer vorherigen Aktion.

Siehe Aktionsbedingungen die vollständige Referenz zu Bedingungstypen, Operatoren und Werten.

Erweitern Sie Zusätzliche Optionen für Aktionsname, Fehlerverhalten, Ausgabevariablenzuweisung, Wiederholungsversuche und den Aktivierungsschalter.

Siehe Aktionsübersicht die vollständige Referenz zu den zusätzlichen Optionen, die für jede Aktion verfügbar sind.