Einführung
Führen Sie ein Skript inline als Teil einer Automatisierung aus – kein gespeichertes Skript erforderlich. Shell ist die richtige Wahl für einmalige Befehle oder einfache Logik, die nicht in Ihrer Skriptbibliothek gespeichert werden muss.
Für Skripte, die Sie in mehreren Automatisierungen wiederverwenden möchten, siehe Skript ausführen Aktion stattdessen.
Die Shell-Aktion konfigurieren
Klicken Sie im Automatisierungs-Pipeline im Bearbeitungsmodus auf + und wählen Sie Shell aus der Kategorie „System".
Das Aktionsfenster öffnet sich mit den Skriptkonfigurationsfeldern.
Sprache
Wählen Sie die Skriptsprache für dieses Skript aus.
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. Der Standardwert beträgt 100 Sekunden.
Ausführen als
Der Kontokontext, unter dem das Skript ausgeführt wird.
Option | Verhalten |
Lokales System | Wird als SYSTEM-Konto ausgeführt – mit erhöhten Rechten, ohne Benutzerkontext |
Aktueller Benutzer | Wird als der aktuell angemeldete Benutzer ausgeführt – nützlich für benutzerkontextbezogene Vorgänge wie das Anwenden von Anzeigeeinstellungen oder das Konfigurieren von Benutzereinstellungen |
Skript-Editor
Schreiben Sie Ihr Skript im Code-Editor. Klicken Sie auf (x) in der unteren rechten Ecke des Editors, um eine Variable, eine Systemvariable oder einen benutzerdefinierten Feldreferenzwert an der Cursorposition einzufügen.
Durch Auswahl eines Elements wird es als {{variable_name}} an der Cursorposition. Level löst den Wert zur Laufzeit auf, bevor das Skript ausgeführt wird.
💡 TIPP: Systemvariablen wie Gerätehostname und Gerätespitzname erfordern keine Einrichtung – sie sind immer verfügbar. Automatisierungsvariablen (aufgeführt unter Variablen) sind auf die aktuelle Automatisierung beschränkt und müssen zuerst erstellt werden, entweder über das Variablen Menü oder durch eine vorherige Aktion. Benutzerdefinierte Felder, die Sie in Ihrer Organisation definiert haben, werden ebenfalls in der Auswahl angezeigt und lösen zur Laufzeit den Feldwert des jeweiligen Geräts auf.
Exit-Codes
Level verwendet den Exit-Code des Skripts, um zu bestimmen, ob die Aktion erfolgreich war oder fehlgeschlagen ist.
Exit-Code | 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 nachdem ein nicht behandelter Fehler aufgetreten ist, wird Level die Aktion als erfolgreich behandeln.
Bedingungen
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 für 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 Aktionen – Übersicht für 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 Shell und „Skript ausführen"? Shell schreibt das Skript direkt im Aktionsfenster – es wird nicht in Ihrer Skriptbibliothek gespeichert. „Skript ausführen" führt ein gespeichertes Skript aus, das in mehreren Automatisierungen wiederverwendet werden kann. Verwenden Sie Shell für schnelle einmalige Befehle; verwenden Sie „Skript ausführen", wenn dieselbe Logik gepflegt oder geteilt werden soll.
Was passiert, wenn das Skript das Zeitlimit überschreitet? Die Aktion wird als fehlgeschlagen markiert. Die Bei Aktionsfehler Einstellung in den zusätzlichen Optionen steuert, ob die Pipeline stoppt oder weiterläuft.
Kann ein Shell-Skript eine Automatisierungsvariable setzen? Ja – auf zwei Arten. Verwenden Sie die Inline-
{{variable_name=value}}Syntax an einer beliebigen Stelle in der Skriptausgabe, um eine Skriptvariable zu setzen; diese Skriptvariable muss dann im Aktionsfenster einer Automatisierungsvariable zugeordnet werden, um für nachfolgende Aktionen verfügbar zu sein. Oder verwenden Sie Aktionsausgabe einer Variable zuweisen in den zusätzlichen Optionen, um die vollständige Standardausgabe des Skripts direkt in eine Automatisierungsvariable zu erfassen, ohne zusätzliche Zuordnung. Siehe Variablen direkt aus Skripten setzen für die Details zur Inline-Syntax.Wer kann Shell-Aktionen hinzufügen oder ändern? Techniker mit der Berechtigung, Automatisierungen in der jeweiligen Gruppe zu bearbeiten. Siehe Arbeitsbereich → Berechtigungen für die Konfiguration der Zugriffskontrolle.