Einführung
Die Skriptbibliothek ist der Ort, an dem Sie Skripte erstellen, organisieren und pflegen, die in Automatisierungen, Skript-Monitoren und Ad-hoc-Ausführungen aus der Geräteliste oder den Gerätedetails verwendet werden können. Skripte werden einmalig gespeichert und sind in Ihrer gesamten Umgebung wiederverwendbar — ändern Sie ein Skript in der Bibliothek, wird die Aktualisierung überall dort übernommen, wo es referenziert wird.
Skripte
Gehen Sie zu Skripte in der Seitenleiste.
Die linke Seitenleiste enthält oben drei feste Einträge:
Alle Skripte — zeigt jedes Skript in Ihrer Bibliothek, über alle Gruppen hinweg
Neues Skript — öffnet den Dialog „Skript erstellen"
Nicht gruppierte Skripte — Skripte, die noch keiner Gruppe zugewiesen wurden
Darunter listet der Abschnitt Skriptgruppen Abschnitt listet alle benutzerdefinierten Gruppen auf, die Sie erstellt haben. Wählen Sie eine Gruppe aus, um die Tabelle auf die Skripte dieser Gruppe zu filtern.
Die Haupttabelle zeigt alle Skripte, die der aktuellen Auswahl entsprechen. Spalten umfassen Name, Gruppe, Beschreibung, Typ (Sprache) und Erstellt. Klicken Sie auf einen Skriptnamen, um ihn im Editor zu öffnen.
Ein Skript erstellen
Klicken Sie auf + Skript erstellen oben rechts oder Neues Skript in der Seitenleiste. Ein Dialog erscheint, der nach einem Namen fragt.
Geben Sie einen Namen ein und klicken Sie auf Erstellen. Der Skript-Editor öffnet sich sofort.
💡 TIPP: Benennen Sie Skripte präzise — „Gastkonto deaktivieren - Windows" ist leichter zu finden und wiederzuverwenden als „Gastkonto-Skript". Sie können den Namen jederzeit ändern.
Skript-Editor
Jedes Skript hat vier Reiter im linken Bereich: Skript, Variablen, Verknüpfte Automatisierungenund Verknüpfte Monitore.
Die konfigurierbaren Felder:
Skriptname — der Name, der in der Bibliothek und in der Auswahlmaske der Aktion „Skript ausführen" angezeigt wird.
Beschreibung — optional. Wird in der Skriptliste angezeigt. Lohnt sich für gemeinsam genutzte Bibliotheken.
Sprache — die Skriptsprache. Unterstützte Optionen:
Ansible
Bash
Go
osquery
PowerShell
Python
Zsh
Zeitüberschreitung (in Sekunden) — wie lange Level wartet, bis das Skript abgeschlossen ist, bevor die Ausführung als fehlgeschlagen markiert wird. Standard sind 100 Sekunden.
Ausführen als — der Kontobenutzungskontext, 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 angemeldeter Benutzer ausgeführt — verwenden Sie dies für benutzerkontextbezogene Vorgänge wie das Festlegen eines Hintergrundbildes oder das Konfigurieren benutzerspezifischer Einstellungen |
Der Code-Editor nimmt die rechte Seite des Bildschirms ein. Schreiben oder fügen Sie Ihr Skript direkt ein. Klicken Sie auf {x} in der unteren rechten Ecke des Editors, um eine Variable, eine Systemvariable oder eine Referenz auf ein benutzerdefiniertes Feld inline einzufügen.
Klicken Sie auf Skript speichern zum Speichern. Änderungen treten erst nach dem Speichern in Kraft.
⚠️ WARNUNG: Nicht gespeicherte Änderungen gehen verloren, wenn Sie die Seite verlassen. Speichern Sie, bevor Sie den Editor verlassen.
Variablen
Der Variablen Reiter zeigt alle für dieses Skript deklarierten Skriptvariablen. Skriptvariablen sind benannte Ausgabeplätze — das Skript schreibt während der Ausführung einen Wert darin, und Sie können diesen Wert einer Automatisierungsvariable im Skript ausführen Aktionsbereich, um ihn in der Pipeline weiterzuleiten.
Klicken Sie auf + Neue Variable hinzufügen , um eine neue Variable zu definieren. Nach der Definition erscheinen Variablen in der Skriptvariablen Abschnitt jeder Skript ausführen Aktion, die dieses Skript referenziert, zuordnen.
ℹ️ HINWEIS: Skriptvariablen erfassen die Ausgabe eines Skripts. Um Daten in ein Skript — Gerätekontext, benutzerdefinierte Feldwerte, Systeminformationen — verwenden Sie die {x} Auswahlmaske im Code-Editor, um Variablen oder benutzerdefinierte Felder inline zu referenzieren.
Die vollständige Referenz zum Zuordnen von Skriptvariablen zu Automatisierungsvariablen und deren Verwendung in nachfolgenden Aktionen finden Sie unter Aktion „Skript ausführen", Automatisierungsvariablen, und Systemvariablen.
Verknüpfte Automatisierungen
Der Verknüpfte Automatisierungen Reiter listet jede Automatisierung auf, die dieses Skript über eine Skript ausführen Aktion. Klicken Sie auf einen Automatisierungsnamen, um sie zu öffnen.
ℹ️ HINWEIS: Ein Skript kann nicht gelöscht werden, solange es verknüpfte Automatisierungen hat. Sie müssen das Skript zunächst aus jeder referenzierenden Automatisierung entfernen oder diese Automatisierungen löschen. Der Reiter macht es einfach zu sehen, was genau betroffen wäre.
Verknüpfte Monitore
Der Verknüpfte Monitore Reiter listet alle Skript-Monitore auf, die dieses Skript verwenden. Die gleiche Löschregel gilt: Trennen Sie die Verknüpfung zu allen Monitoren, bevor ein Skript gelöscht werden kann.
Skriptaktivität
Der Aktivität Reiter zeichnet jede gespeicherte Änderung am Skript auf, einschließlich des Codes. Gehen Sie zu Skripte → [Skript] → Aktivität.
Ein Änderungseintrag fasst zusammen, was gespeichert wurde, zum Beispiel „2 Änderungen an Osquery Monitor - Uptime gespeichert." Erweitern Sie ihn, um jede einzelne Änderung zu sehen.
Bei einer Code-Bearbeitung zeigt die Änderung das Zeilenanzahl-Delta (zum Beispiel „+3 −1") und einen Änderungen anzeigen Link.
Klicken Sie auf Änderungen anzeigen , um das Diff-Panel zu öffnen: entfernte Zeilen in Rot, hinzugefügte Zeilen in Grün, Zeilennummern und ein Einheitlich / Geteilt Umschalter. Die Kopfzeile nennt das Skript, den Techniker und den Zeitstempel.
Für die vollständige Funktion und die globale Aktivitätsseite siehe Aktivität.
💡 TIPP: Das Diff-Panel ist der Prüfnachweis für Skriptänderungen. Verwenden Sie es, um genau zu bestätigen, was sich geändert hat, bevor ein Monitor oder eine Automatisierung ein anderes Verhalten zeigte — ohne eine alte Version zum visuellen Vergleich wiederherstellen zu müssen.
Organisieren mit Skriptgruppen
Skriptgruppen ermöglichen es Ihnen, Skripte nach Plattform, Funktion, Team oder was auch immer für Ihre Umgebung sinnvoll ist, zu kategorisieren. Gruppen erscheinen in der Seitenleiste unter Skriptgruppen und als Spalte in der Skriptliste.
Um eine Gruppe zu erstellen, klicken Sie auf das + Symbol neben Skriptgruppen in der Seitenleiste. Ein Dialog erscheint, der nach einem Gruppennamen fragt.
Um ein Skript einer Gruppe zuzuweisen, öffnen Sie das Aktionen Menü (oben rechts) und wählen Sie Gruppe zuweisen.
💡 TIPP: Skriptgruppen spiegeln typischerweise Zweck oder Rolle wider — Sicherheit, Software, Monitore, Hilfsprogramme — nicht die Struktur Ihrer Gerätegruppen. Eine Gliederung nach Funktion erleichtert es dem gesamten Team, das richtige Skript zu finden, unabhängig davon, auf welchen Geräten es ausgeführt wird.
Ein Skript löschen
Öffnen Sie das Aktionen Menü und wählen Sie Löschen. Ein Bestätigungsdialog erscheint.
⚠️ WARNUNG: Das Löschen eines Skripts kann nicht rückgängig gemacht werden. Wenn das Skript verknüpfte Automatisierungen oder Monitore hat, blockiert Level das Löschen — entfernen Sie zunächst alle Verknüpfungen über die Verknüpfte Automatisierungen und Verknüpfte Monitore Reiter.
Skripte ausführen
Skripte können auf verschiedene Arten ausgeführt werden:
In einer Automatisierung — über die Skript ausführen Aktion. Das Skript wird auf jedem Zielgerät als Teil der Automatisierungspipeline ausgeführt. Dies ist die primäre Methode, um Skripte in großem Maßstab oder nach einem Zeitplan auszuführen. Siehe Aktion „Skript ausführen" für die vollständige Referenz.
Ad-hoc aus der Geräteliste oder den Gerätedetails — Geräte auswählen und das Aktionen Menü. Drei skriptbezogene Optionen erscheinen:
Gespeichertes Skript ausführen — ein Skript aus Ihrer Bibliothek auswählen. Level erstellt eine neue Skriptausführungs-Automatisierung mit zwei Aktionen: Auf Genehmigung warten und Skript ausführen.
Neues Skript ausführen — ein neues Skript direkt verfassen. Das Skript wird in Ihrer Bibliothek gespeichert und eine Skriptausführungs-Automatisierung wird dafür erstellt.
Zu letzter Skriptausführung hinzufügen — die ausgewählten Geräte zu einer bestehenden Skriptausführungs-Automatisierung hinzufügen, anstatt eine neue zu starten.
In einem Skript-Monitor — ein Monitor führt ein Skript nach einem Zeitplan aus und wertet dessen Ausgabe aus, um den Gerätezustand zu bestimmen. Siehe Skript-Monitore für Einrichtungsdetails.
ℹ️ HINWEIS: Skriptausführungs-Automatisierungen sind wiederverwendbar. Sie können sie umbenennen, in eine Gruppe verschieben, weitere Aktionen hinzufügen oder ihren Auslöser anpassen, bevor sie genehmigt werden. Das Skript wird erst ausgeführt, wenn der Auf Genehmigung warten Schritt manuell genehmigt wurde. Alle Skriptausführungen werden unter Automatisierungen → Skriptausführungen in der Seitenleiste.
Häufig gestellte Fragen
Was ist der Unterschied zwischen „Gespeichertes Skript ausführen", „Neues Skript ausführen" und „Zu letzter Skriptausführung hinzufügen"? Alle drei befinden sich im Aktionen Menü auf der Geräteliste und in den Gerätedetails. Gespeichertes Skript ausführen wählt ein vorhandenes Bibliotheksskript aus und erstellt eine neue Skriptausführungs-Automatisierung dafür. Neues Skript ausführen ermöglicht es Ihnen, ein neues Skript direkt zu verfassen — es wird in der Bibliothek gespeichert und eine Skriptausführungs-Automatisierung wird erstellt. Zu letzter Skriptausführung hinzufügen fügt die ausgewählten Geräte zu einer bestehenden Skriptausführungs-Automatisierung hinzu, anstatt eine neue zu starten. In allen Fällen wird das Skript erst ausgeführt, wenn der Auf Genehmigung warten Aktion genehmigt wurde.
Was ist der Unterschied zwischen einem gespeicherten Skript und einer Shell-Aktion? Ein gespeichertes Skript lebt in der Bibliothek und ist wiederverwendbar — referenzieren Sie es aus jeder Automatisierung, jedem Monitor oder Ad-hoc-Lauf, und Änderungen an einer Stelle aktualisieren alle Referenzen. Die Shell Aktion führt ein direkt in der Automatisierung geschriebenes Skript aus, ohne einen Bibliothekseintrag. Verwenden Sie gespeicherte Skripte für alles, was Sie mehr als einmal ausführen oder langfristig pflegen möchten.
Kann ich ein Skript bearbeiten, ohne Automatisierungen zu beschädigen, die es verwenden? Ja. Änderungen an einem gespeicherten Skript treten beim nächsten Ausführen einer referenzierenden Automatisierung in Kraft — die Automatisierung selbst muss nicht aktualisiert werden. Der Verknüpfte Automatisierungen Reiter zeigt genau, welche Automatisierungen betroffen sein werden.
Welche Sprachen unterstützt Level? Ansible, Bash, Go, osquery, PowerShell, Python und Zsh.
Kann ein Skript Ausgaben an nachfolgende Automatisierungsaktionen übergeben? Ja — auf zwei Arten. Definieren Sie Skriptvariablen im Variablen Reiter und ordnen Sie sie Automatisierungsvariablen im Skript ausführen Aktionsbereich. Oder verwenden Sie Aktionsausgabe einer Variable zuweisen in den zusätzlichen Optionen der Aktion, um die vollständige Skript-Standardausgabe zu erfassen. Siehe Aktion „Skript ausführen" für Details.
Wer kann Skripte erstellen und bearbeiten? Techniker mit der Berechtigung, Automatisierungen in der entsprechenden Gruppe zu bearbeiten. Siehe Arbeitsbereich → Berechtigungen für die Konfiguration der Zugriffskontrolle.
Was passiert mit Automatisierungen, wenn ich ein Skript lösche? Level blockiert das Löschen eines Skripts, das mit aktiven Automatisierungen oder Monitoren verknüpft ist. Verwenden Sie die Verknüpfte Automatisierungen und Verknüpfte Monitore Reiter, um zu sehen, was zuerst getrennt werden muss.