Die Script-Bibliothek ist der Ort, an dem Sie Scripts erstellen, organisieren und verwalten, die in Automatisierungen, Script-Monitoren und Ad-hoc-Läufen aus der Geräteliste oder den Gerätedetails verwendet werden können. Scripts werden einmal gespeichert und sind in Ihrer gesamten Umgebung wiederverwendbar — ändern Sie ein Script in der Bibliothek und das Update wird überall dort reflektiert, wo es referenziert ist.
Scripts
Gehen Sie zu Scripts in der Seitenleiste.
Die linke Seitenleiste hat oben drei feste Elemente:
Alle Scripts — zeigt alle Scripts in Ihrer Bibliothek, übergreifend auf alle Gruppen
Neues Script — öffnet das Dialog „Script erstellen"
Nicht gruppierte Scripts — Scripts, die noch nicht einer Gruppe zugewiesen sind
Darunter listet der Abschnitt Script-Gruppen alle benutzerdefinierten Gruppen auf, die Sie erstellt haben. Wählen Sie eine Gruppe aus, um die Tabelle zu filtern und nur Scripts aus dieser Gruppe anzuzeigen.
Die Haupttabelle zeigt alle Scripts, die der aktuellen Auswahl entsprechen. Spalten umfassen Name, Gruppe, Beschreibung, Typ (Sprache) und Erstellt. Klicken Sie auf einen beliebigen Script-Namen, um ihn im Editor zu öffnen.
Ein Script Erstellen
Klicken Sie auf + Script erstellen oben rechts oder auf Neues Script in der Seitenleiste. Ein Dialog erscheint und fordert einen Namen an.
Geben Sie einen Namen ein und klicken Sie auf Erstellen. Der Script-Editor wird sofort geöffnet.
💡 TIPP: Benennen Sie Scripts spezifisch — „Gastkonto deaktivieren - Windows" ist leichter zu finden und wiederzuverwenden als „Gastkonto-Script". Sie können sie jederzeit später umbenennen.
Script-Editor
Jedes Script hat vier Registerkarten im linken Panel: Script, Variablen, Verknüpfte Automatisierungen und Verknüpfte Monitore.
Die konfigurierbaren Felder:
Script-Name — der Name, der in der Bibliothek und in der Auswahl der Aktion „Script ausführen" angezeigt wird.
Beschreibung — optional. In der Script-Auflistung angezeigt. Lohnt sich für gemeinsame Bibliotheken auszufüllen.
Sprache — die Scripting-Sprache. Unterstützte Optionen:
Ansible
Bash
Go
osquery
PowerShell
Python
Zsh
Zeitüberschreitung (in Sekunden) — wie lange Level wartet, bis das Script abgeschlossen ist, bevor die Ausführung als fehlgeschlagen gekennzeichnet wird. Standard ist 100 Sekunden.
Ausführen als — der Kontokontext, unter dem das Script ausgeführt wird:
Option | Verhalten |
Lokales System | Wird als SYSTEM-Konto ausgeführt — erhöht, kein Benutzerkontext |
Aktueller Benutzer | Wird als angemeldeter Benutzer ausgeführt — verwenden Sie dies für Benutzerkontext-Operationen wie das Anwenden von Hintergrundbildern oder das Konfigurieren von benutzerspezifischen Einstellungen |
Der Code-Editor nimmt die rechte Seite des Bildschirms ein. Schreiben oder fügen Sie Ihr Script direkt ein. Klicken Sie auf {x} in der unteren rechten Ecke des Editors, um eine Variable, Systemvariable oder benutzerdefinierten Feldverweis inline einzufügen.
Klicken Sie auf Script speichern zum Speichern. Änderungen werden erst nach dem Speichern wirksam.
⚠️ WARNUNG: Nicht gespeicherte Änderungen gehen verloren, wenn Sie die Website verlassen. Speichern Sie, bevor Sie den Editor verlassen.
Variablen
Die Registerkarte Variablen zeigt alle für dieses Script deklarierten Script-Variablen. Script-Variablen sind benannte Ausgabeslots — das Script schreibt während der Ausführung einen Wert hinein, und Sie können diesen Wert einer Automatisierungsvariable im Aktionspanel Script ausführen zuordnen, um ihn durch die Pipeline zu leiten.
Klicken Sie auf + Neue Variable hinzufügen, um eine neue Variable zu definieren. Nach der Definition werden Variablen im Abschnitt Script-Variablen jeder Aktion Script ausführen angezeigt, die auf dieses Script verweist.
ℹ️ HINWEIS: Script-Variablen erfassen Ausgaben aus einem Script. Um Daten in ein Script zu übergeben — Gerätekontext, benutzerdefinierte Feldwerte, Systeminformationen — verwenden Sie die Auswahl {x} im Code-Editor, um inline auf Variablen oder benutzerdefinierte Felder zu verweisen.
Für die vollständige Referenz zum Zuordnen von Script-Variablen zu Automatisierungsvariablen und ihrer Verwendung in nachfolgenden Aktionen, siehe Aktion Script Ausführen, Automatisierungsvariablen, und Systemvariablen.
Verknüpfte Automatisierungen
Die Registerkarte Verknüpfte Automatisierungen listet jede Automatisierung auf, die auf dieses Script über eine Aktion Script ausführen verweist. Klicken Sie auf einen beliebigen Automatisierungsnamen, um ihn zu öffnen.
ℹ️ HINWEIS: Ein Script kann nicht gelöscht werden, während es verknüpfte Automatisierungen hat. Sie müssen das Script zuerst aus jeder referenzierenden Automatisierung entfernen oder diese Automatisierungen löschen. Die Registerkarte macht es einfach zu sehen, was genau betroffen wäre.
Verknüpfte Monitore
Die Registerkarte Verknüpfte Monitore listet alle Script-Monitore auf, die dieses Script verwenden. Die gleiche Löschregel gilt: Heben Sie die Verknüpfung mit allen Monitoren auf, bevor ein Script gelöscht werden kann.
Organisation mit Script-Gruppen
Script-Gruppen ermöglichen es Ihnen, Scripts nach Plattform, Funktion, Team oder wie es für Ihre Umgebung sinnvoll ist, zu kategorisieren. Gruppen erscheinen in der Seitenleiste unter Script-Gruppen und als Spalte in der Script-Auflistung.
Um eine Gruppe zu erstellen, klicken Sie auf das Symbol + neben Script-Gruppen in der Seitenleiste. Ein Dialog erscheint und fordert einen Gruppennamen.
Um ein Script einer Gruppe zuzuweisen, öffnen Sie das Menü Aktionen des Scripts (oben rechts) und wählen Sie Einer Gruppe zuweisen.
💡 TIPP: Script-Gruppen spiegeln typischerweise Zweck oder Rolle wider — Sicherheit, Software, Monitore, Dienstprogramme — nicht die Struktur Ihrer Gerätegruppen. Die Organisation nach Funktion macht es dem ganzen Team einfacher, das richtige Script zu finden, unabhängig davon, auf welchen Geräten es läuft.
Ein Script Löschen
Öffnen Sie das Menü Aktionen des Scripts und wählen Sie Löschen. Ein Bestätigungsdialog erscheint.
⚠️ WARNUNG: Das Löschen von Scripts kann nicht rückgängig gemacht werden. Wenn das Script verknüpfte Automatisierungen oder Monitore hat, blockiert Level das Löschen — heben Sie zuerst alle Verknüpfungen mit den Registerkarten Verknüpfte Automatisierungen und Verknüpfte Monitore auf.
Scripts Ausführen
Scripts können auf mehrere Weisen ausgeführt werden:
In einer Automatisierung — über die Aktion Script ausführen. Das Script läuft auf jedem Zielgerät als Teil der Automatisierungspipeline. Dies ist der primäre Weg, um Scripts in großem Umfang oder zeitgesteuert auszuführen. Siehe Aktion Script Ausführen für die vollständige Referenz.
Ad-hoc aus der Geräteliste oder Gerätedetails — wählen Sie Geräte aus und öffnen Sie das Menü Aktionen. Drei Script-bezogene Optionen erscheinen:
Gespeichertes Script ausführen — wählen Sie ein Script aus Ihrer Bibliothek. Level erstellt eine neue Script-Ausführungs-Automatisierung mit zwei Aktionen: Auf Genehmigung warten und Script ausführen.
Neues Script ausführen — schreiben Sie spontan ein neues Script. Das Script wird in Ihrer Bibliothek gespeichert und eine Script-Ausführungs-Automatisierung wird dafür erstellt.
Zu einer kürzlichen Script-Ausführung hinzufügen — fügen Sie die ausgewählten Geräte zu einer bestehenden Script-Ausführungs-Automatisierung hinzu, anstatt eine neue zu starten.
In einem Script-Monitor — ein Monitor führt ein Script nach Zeitplan aus und bewertet die Ausgabe, um die Gerätegesundheit zu bestimmen. Siehe Script-Monitore für Setup-Details.
ℹ️ HINWEIS: Script-Ausführungs-Automatisierungen sind wiederverwendbar. Sie können sie umbenennen, in eine Gruppe verschieben, weitere Aktionen hinzufügen oder ihren Auslöser vor Genehmigung anpassen. Das Script wird nicht ausgeführt, bis der Schritt Auf Genehmigung warten manuell genehmigt ist. Alle Script-Ausführungen werden unter Automatisierungen → Script-Ausführungen in der Seitenleiste verfolgt.
Häufig Gestellte Fragen
Was ist der Unterschied zwischen „Gespeichertes Script ausführen", „Neues Script ausführen" und „Zu einer kürzlichen Script-Ausführung hinzufügen"? Alle drei befinden sich im Menü Aktionen auf der Geräteliste und in Gerätedetails. Gespeichertes Script ausführen wählt ein bestehendes Bibliotheks-Script und erstellt eine neue Script-Ausführungs-Automatisierung. Neues Script ausführen ermöglicht es, spontan ein neues Script zu schreiben — es wird in der Bibliothek gespeichert und eine Script-Ausführungs-Automatisierung wird erstellt. Zu einer kürzlichen Script-Ausführung hinzufügen fügt die ausgewählten Geräte zu einer bestehenden Script-Ausführungs-Automatisierung hinzu, anstatt eine neue zu starten. In allen Fällen wird das Script nicht ausgeführt, bis die Aktion Auf Genehmigung warten genehmigt ist.
Was ist der Unterschied zwischen einem gespeicherten Script und einer Shell-Aktion? Ein gespeichertes Script ist in der Bibliothek vorhanden und wiederverwendbar — referenzieren Sie es aus jeder Automatisierung, jedem Monitor oder Ad-hoc-Lauf und Änderungen an einer Stelle aktualisieren alle Verweise. Die Aktion Shell führt ein Script aus, das inline in der Automatisierung geschrieben ist, ohne Bibliothekseintrag. Verwenden Sie gespeicherte Scripts für alles, das Sie mehr als einmal ausführen oder über die Zeit verwalten möchten.
Kann ich ein Script bearbeiten, ohne die Automatisierungen zu unterbrechen, die es verwenden? Ja. Änderungen an einem gespeicherten Script treten beim nächsten Lauf jeder referenzierenden Automatisierung in Kraft — es ist nicht erforderlich, die Automatisierung selbst zu aktualisieren. Die Registerkarte Verknüpfte Automatisierungen zeigt genau, welche Automatisierungen betroffen sind.
Welche Sprachen unterstützt Level? Ansible, Bash, Go, osquery, PowerShell, Python und Zsh.
Kann ein Script eine Ausgabe an nachfolgende Automatisierungsaktionen übergeben? Ja — zwei Möglichkeiten. Definieren Sie Script-Variablen in der Registerkarte Variablen und ordnen Sie sie Automatisierungsvariablen im Aktionspanel Script ausführen zu. Oder verwenden Sie Aktionsausgabe einer Variablen zuweisen in den zusätzlichen Optionen der Aktion, um die vollständige Script-Stdout zu erfassen. Siehe Aktion Script Ausführen für Details.
Wer kann Scripts erstellen und bearbeiten? Techniker mit Berechtigung zum Bearbeiten von Automatisierungen in der relevanten Gruppe. Siehe Arbeitsbereich → Berechtigungen für die Konfiguration der Zugriffskontrolle.
Was passiert mit Automatisierungen, wenn ich ein Script lösche? Level blockiert das Löschen eines Scripts, das mit aktiven Automatisierungen oder Monitoren verknüpft ist. Verwenden Sie die Registerkarten Verknüpfte Automatisierungen und Verknüpfte Monitore, um zu sehen, was zuerst entfernt werden muss.