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, lesen Sie Skript ausführen Aktion stattdessen.
Die Shell-Aktion konfigurieren
Klicken Sie in der Automatisierungspipeline im Bearbeitungsmodus auf + und wählen Sie Shell aus der Kategorie „System".
Das Aktionsfenster öffnet sich mit den Skript-Konfigurationsfeldern.
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 – erhöhte Rechte, kein Benutzerkontext |
Aktueller Benutzer | Wird als aktuell angemeldeter 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, Systemvariable oder einen benutzerdefinierten Feldreferenz 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, erscheinen ebenfalls in der Auswahl und werden zur Laufzeit auf den Feldwert des jeweiligen Geräts aufgelöst.
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 fortfährt.
Stellen Sie sicher, dass Ihre Skripte explizit mit dem entsprechenden Code beendet werden. Wenn ein Skript mit 0 nach dem Auftreten eines nicht behandelten Fehlers, wird Level die Aktion als erfolgreich werten.
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 Aktionsü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 muss.
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 fortfährt.
Kann ein Shell-Skript eine Automatisierungsvariable setzen? Ja – auf zwei Arten. Verwenden Sie die Inline-
{{variable_name=value}}Syntax an einer beliebigen Stelle in Ihrer Skriptausgabe, um eine Skriptvariable zu setzen; diese Skriptvariable muss dann im Aktionsfenster einer Automatisierungsvariable zugeordnet werden, damit sie für nachfolgende Aktionen verfügbar ist. 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 Inline-Syntaxdetails.Wer kann Shell-Aktionen hinzufügen oder ändern? Techniker mit der Berechtigung, Automatisierungen in der entsprechenden Gruppe zu bearbeiten. Siehe Arbeitsbereich → Berechtigungen für die Konfiguration der Zugriffskontrolle.