Einführung
Führen Sie 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 – z. B. einen benutzerdefinierten Feldwert oder eine Automatisierungsvariable – können Sie diese zuordnen, ohne die Skriptlogik zu ändern.
⚙️ Voraussetzungen
Ein gespeichertes Skript muss in Ihrer Skriptbibliothek vorhanden sein, oder Sie können eines direkt inline erstellen. Siehe Skripte für Informationen zum Erstellen und Organisieren von Skripten.
Eine Automatisierung muss vorhanden sein, bevor Aktionen hinzugefügt werden können. Siehe Erste Schritte mit Automatisierungen , falls Sie noch keines eingerichtet haben.
Skript ausführen – Aktion
Wenn der Canvas noch keine Aktionen enthält, wählen Sie Aktion hinzufügen. Um diesen Schritt zu einem Canvas hinzuzufügen, der bereits Aktionen enthält, klicken Sie auf das inline + an der gewünschten Stelle aus und wählen Sie Weitere Aktion hinzufügen. Wählen Sie dann Skript ausführen aus System.
Das Aktionsfenster öffnet sich und zeigt das Skript Feld und zwei Schaltflächen: ein externes Link-Symbol zum Durchsuchen Ihrer gespeicherten Skripte und Skript erstellen , um inline ein neues Skript zu schreiben.
Ein Skript auswählen
Klicken Sie auf das externe Link-Symbol 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.
Ein Skript inline erstellen
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.
Zeitüberschreitung (in Sekunden) Wie lange Level wartet, bis das Skript abgeschlossen ist, bevor es als fehlgeschlagen markiert wird. Standard ist 100 Sekunden.
Ausführen als Der Kontokontext, unter dem das Skript ausgeführt wird.
Option | Verhalten |
Lokales System | Wird als SYSTEM-Konto ausgeführt – erhöhte Rechte, kein Benutzerkontext |
Aktueller Benutzer | Wird als der aktuell angemeldete Benutzer ausgeführt – nützlich für benutzerkontextbezogene Vorgänge wie das Festlegen von Hintergrundbildern, das Konfigurieren von Benutzereinstellungen usw. |
Schreiben Sie Ihr Skript im Code-Editor. Klicken Sie auf {x} , um Variablen und benutzerdefinierte Felder inline im Skript zu referenzieren. Wenn Sie fertig sind, klicken Sie auf Skript erstellen , um es zu speichern und der Aktion zuzuweisen.
Skriptvariablen
Skriptvariablen sind benannte Werte, die auf der Variablen Registerkarte. Im Skript ausführen Aktion ermöglicht das Zuordnen einer Skriptvariablen zu einer Automatisierungsvariablen, damit das gespeicherte Skript Eingaben empfangen und einen aktualisierten Wert an spätere Automatisierungsschritte zurücksenden kann.
Vor der Ausführung überträgt Level den aktuellen Wert der Automatisierungsvariablen in die zugeordnete Skriptvariable.
Während der Ausführung kann das Skript der Skriptvariablen einen neuen Wert zuweisen. Level schreibt den neuen Wert zurück in die zugeordnete Automatisierungsvariable.
ℹ️ HINWEIS: Sie können auch Gerätesystemvariablen oder benutzerdefinierte Felder direkt über den {x} Auswahlbereich im Skripteditor. Verwenden Sie eine zugeordnete Skriptvariable, wenn der Wert aus einer Automatisierungsvariablen stammt oder wenn das gespeicherte Skript seinen eigenen wiederverwendbaren Variablennamen verwenden soll.
Wenn ein Skript mit definierten Variablen ausgewählt wird, erscheint ein Skriptvariablen Abschnitt erscheint im Aktionsfenster.
So ordnen Sie eine Skriptvariable einer Automatisierungsvariablen zu:
Im Skriptvariablen Abschnitt die Skriptvariable, die Sie zuordnen möchten.
Öffnen Sie das Automatisierungsvariablen Dropdown-Menü in derselben Zeile.
Wählen Sie eine vorhandene Automatisierungsvariable aus oder klicken Sie auf Neue Variable erstellen.
So ordnen Sie Variablen automatisch zu: Klicken Sie auf Nach Name abgleichen im Skriptvariablen Abschnitt. Level füllt nur leere Zuordnungen aus und lässt bestehende Auswahlen unverändert.
Eine exakte Namensübereinstimmung wird bevorzugt, einschließlich Groß-/Kleinschreibung.
Wenn keine exakte Übereinstimmung vorhanden ist, verwendet Level eine Übereinstimmung ohne Berücksichtigung der Groß-/Kleinschreibung nur dann, wenn genau eine Automatisierungsvariable übereinstimmt.
Wenn keine Variable übereinstimmt oder mehrere Variablen nur bei Ignorierung der Groß-/Kleinschreibung übereinstimmen, bleibt die Zuordnung leer. Wählen Sie für diese Zeile manuell eine Automatisierungsvariable aus.
Überprüfen Sie die ausgewählten Automatisierungsvariablen und verwenden Sie die Dropdown-Menüs, um verbleibende leere Zuordnungen auszufüllen.
Wenn das Skript startet, empfängt die zugeordnete Skriptvariable den aktuellen Wert der Automatisierungsvariablen. Referenzieren Sie sie im gespeicherten Skript mit {{script_variable_name}}. Um einen neuen Wert an die Automatisierung zurückzusenden, weisen Sie der Skriptvariablen mit {{script_variable_name=value_expression}}.
Siehe Automatisierungsvariablen die vollständige Referenz zum Erstellen und Verwenden von Automatisierungsvariablen.
ℹ️ HINWEIS: Der Abschnitt „Skriptvariablen" erscheint nur, wenn das ausgewählte Skript mindestens eine Variable in der Registerkarte „Variablen" definiert hat. Skripte ohne Variablen zeigen diesen Abschnitt nicht an.
Skriptvariablen verwalten
Skriptvariablen werden im Skript selbst definiert, nicht im Aktionsfenster. Öffnen Sie den Skripteditor und navigieren Sie zur Variablen Registerkarte, um sie hinzuzufügen, zu bearbeiten oder zu entfernen.
Skriptausgabe erfassen
Es gibt zwei Möglichkeiten, einen Wert aus einem Skript zu erfassen und ihn für nachfolgende Aktionen in der Pipeline verfügbar zu machen.
Eine zugeordnete Skriptvariable zuweisen
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 Automatisierungsvariablen 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. Sie wird nicht aus der Standardausgabe des Skripts geparst. Die Skriptvariable muss in der Variablen Registerkarte vorhanden sein 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.
Vollständige Ausgabe einer Variable zuweisen
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 – erfasst jedoch alles, was das Skript ausgibt, nicht nur den benötigten Wert.
💡 TIPP: Verwenden Sie die Zuweisung einer zugeordneten Skriptvariablen, wenn das Skript andere Ausgaben erzeugt, die nicht in der Variable erscheinen sollen. Verwenden Sie Aktionsausgabe einer Variable zuweisen , wenn die einzige Ausgabe des Skripts der Wert ist, den Sie erfassen möchten.
Exitcodes
Level verwendet den Exitcode des Skripts, um zu bestimmen, ob die Aktion erfolgreich war oder fehlgeschlagen ist.
Exitcode | Ergebnis |
| Aktion als erfolgreich markiert |
Ungleich null (z. B. | Aktion als fehlgeschlagen markiert |
Ihre Bei Aktionsfehler Einstellung in den zusätzlichen Optionen steuert, was als Nächstes passiert – ob die Pipeline stoppt oder weiterläuft.
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.
Bedingungen
Der Bedingungen Abschnitt ermöglicht es Ihnen, die Ausführung dieser Aktion auf Basis von Geräteattributen oder dem Ergebnis einer vorherigen Aktion einzuschränken.
Siehe Aktionsbedingungen die vollständige Referenz zu Bedingungstypen, Operatoren und Werten.
Zusätzliche Optionen
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.
Häufig gestellte Fragen
Was ist der Unterschied zwischen „Skript ausführen" und „Shell"? „Skript ausführen" führt ein gespeichertes Skript aus Ihrer Bibliothek aus – das Skript ist versioniert und kann in verschiedenen Automatisierungen wiederverwendet werden. „Shell" führt ein direkt im Aktionsfenster geschriebenes Ad-hoc-Skript aus. Verwenden Sie „Skript ausführen", wenn dieselbe Logik geteilt oder gepflegt werden soll; verwenden Sie „Shell" für einmalige Inline-Befehle.
Kann eine Automatisierungsvariable einem gespeicherten Skript als Eingabe dienen? Ja. Definieren Sie eine Skriptvariable in der Variablen Registerkarte zugeordnet werden in der Skript ausführen Aktion und referenzieren Sie die Skriptvariable im gespeicherten Skript. Level überträgt den aktuellen Wert der Automatisierungsvariablen vor der Ausführung.
Kann das Skript Ausgaben schreiben, die andere Aktionen lesen können? Ja. Weisen Sie einer zugeordneten Skriptvariablen mit
{{script_variable_name=value_expression}}, um einen bestimmten Wert in die zugeordnete Automatisierungsvariable zurückzuschreiben. Oder verwenden Sie Aktionsausgabe einer Variable zuweisen in den zusätzlichen Optionen, um die gesamte Standardausgabe des Skripts zu erfassen.Was passiert, wenn das Skript eine Zeitüberschreitung hat? Die Aktion wird als fehlgeschlagen markiert. Die Bei Aktionsfehler Einstellung in den zusätzlichen Optionen steuert, ob die Pipeline stoppt oder weiterläuft.
Wer kann Aktionen vom Typ „Skript ausführen" hinzufügen oder ändern? Techniker mit der Berechtigung, Automatisierungen in der betreffenden Gruppe zu bearbeiten. Siehe Arbeitsbereich → Berechtigungen für die Konfiguration der Zugriffskontrolle.






