Einführung
Die Skriptbibliothek ist der Ort, an dem Sie Skripte erstellen, organisieren und verwalten, die in Automatisierungen, Skriptmonitoren und Ad-hoc-Ausführungen aus der Geräteliste oder den Gerätedetails verwendet werden können. Skripte werden einmal 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 alle Skripte in Ihrer Bibliothek, über alle Gruppen hinweg
Neues Skript — öffnet den Dialog „Skript erstellen"
Skripte ohne Gruppe — Skripte, die noch keiner Gruppe zugewiesen wurden
Darunter befindet sich der 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 und fordert zur Eingabe eines Namens auf.
Geben Sie einen Namen ein und klicken Sie auf Erstellen. Der Skripteditor öffnet sich sofort.
💡 TIPP: Benennen Sie Skripte aussagekräftig – „Gastkonto deaktivieren - Windows" ist leichter zu finden und wiederzuverwenden als „Gastkonto-Skript." Sie können den Namen jederzeit ändern.
Skripteditor
Jedes Skript hat vier Registerkarten im linken Bereich: Skript, Variablen, Verknüpfte Automatisierungen, und Verknüpfte Monitore.
Die konfigurierbaren Felder:
Skriptname — der Name, der in der Bibliothek und in der Aktionsauswahl „Skript ausführen" angezeigt wird.
Beschreibung — optional. Wird in der Skriptliste angezeigt. Lohnt sich auszufüllen für gemeinsam genutzte Bibliotheken.
Sprache — die Skriptsprache. Unterstützte Optionen:
Ansible
Bash
Go
osquery
PowerShell
Python
Zsh
Timeout (in Sekunden) — wie lange Level wartet, bis das Skript abgeschlossen ist, bevor die Ausführung als fehlgeschlagen markiert wird. Standardwert 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 angemeldeter Benutzer ausgeführt – verwenden Sie dies für benutzerkontextbezogene Vorgänge wie das Anwenden von Hintergrundbildern oder das Konfigurieren benutzerspezifischer Einstellungen |
Der Code-Editor befindet sich auf der rechten Seite des Bildschirms. 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 benutzerdefinierte Feldreferenz 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
Die Variablen Registerkarte zeigt alle für dieses Skript deklarierten Skriptvariablen. Skriptvariablen sind benannte Ausgabe-Slots – das Skript schreibt während der Ausführung einen Wert in sie, und Sie können diesen Wert im Skript ausführen Aktionsbereich, um es durch die Pipeline weiterzuleiten.
Klicken Sie auf + Neue Variable hinzufügen , um eine neue Variable zu definieren. Einmal definiert, erscheinen Variablen in der Skriptvariablen Abschnitt einer beliebigen Skript ausführen Aktion, die dieses Skript referenziert, einer Automatisierungsvariable zuordnen.
ℹ️ HINWEIS: Skriptvariablen erfassen die Ausgabe eines Skripts. Um Daten in an ein Skript – Gerätekontext, benutzerdefinierte Feldwerte, Systeminformationen – verwenden Sie die {x} Auswahl 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
Die Verknüpfte Automatisierungen Registerkarte listet alle Automatisierungen 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 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 Verknüpfte Monitore Registerkarte listet alle Skriptmonitore auf, die dieses Skript verwenden. Die gleiche Löschregel gilt: Heben Sie die Verknüpfung zu allen Monitoren auf, bevor ein Skript gelöscht werden kann.
Mit Skriptgruppen organisieren
Mit Skriptgruppen können Sie Skripte nach Plattform, Funktion, Team oder was auch immer für Ihre Umgebung sinnvoll ist, 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 und fordert zur Eingabe eines Gruppennamens auf.
Um ein Skript einer Gruppe zuzuweisen, öffnen Sie das Aktionen Menü (oben rechts) und wählen Sie Gruppe zuweisen.
💡 TIPP: Skriptgruppen spiegeln in der Regel Zweck oder Rolle wider – Sicherheit, Software, Monitore, Dienstprogramme – nicht die Struktur Ihrer Gerätegruppen. Die Organisation 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 Registerkarten.
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" die vollständige Referenz.
Ad-hoc aus der Geräteliste oder den Gerätedetails — Wählen Sie Geräte aus und öffnen Sie das Aktionen Menü. Drei skriptbezogene Optionen erscheinen:
Gespeichertes Skript ausführen — Wählen Sie ein Skript aus Ihrer Bibliothek. Level erstellt eine neue Skriptausführungs-Automatisierung mit zwei Aktionen: Auf Genehmigung warten und Skript ausführen.
Neues Skript ausführen — Schreiben Sie ein neues Skript direkt an Ort und Stelle. Das Skript wird in Ihrer Bibliothek gespeichert und eine Skriptausführungs-Automatisierung wird dafür erstellt.
Zu letzter Skriptausführung hinzufügen — Fügen Sie die ausgewählten Geräte einer vorhandenen Skriptausführungs-Automatisierung hinzu, anstatt eine neue zu starten.
In einem Skriptmonitor — Ein Monitor führt ein Skript nach einem Zeitplan aus und bewertet seine Ausgabe, um den Gerätezustand zu bestimmen. Siehe Skriptmonitore 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 wird. Alle Skriptausführungen werden unter Automatisierungen → Skriptausführungen in der Seitenleiste.
FAQ
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ü in der Geräteliste und 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 an Ort und Stelle zu schreiben – 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 einer vorhandenen 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 wird.
Was ist der Unterschied zwischen einem gespeicherten Skript und einer Shell-Aktion? Ein gespeichertes Skript befindet sich in der Bibliothek und ist wiederverwendbar – referenzieren Sie es aus einer beliebigen Automatisierung, einem Monitor oder einer Ad-hoc-Ausführung, und Änderungen an einem Ort aktualisieren alle Referenzen. Die Shell Aktion führt ein inline in der Automatisierung geschriebenes Skript aus, ohne einen Bibliothekseintrag. Verwenden Sie gespeicherte Skripte für alles, was Sie mehr als einmal ausführen oder im Laufe der Zeit pflegen möchten.
Kann ich ein Skript bearbeiten, ohne Automatisierungen zu beeinträchtigen, 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. Die Verknüpfte Automatisierungen Registerkarte zeigt genau, welche Automatisierungen betroffen sein werden.
Welche Sprachen unterstützt Level? Ansible, Bash, Go, osquery, PowerShell, Python und Zsh.
Kann ein Skript die Ausgabe an nachfolgende Automatisierungsaktionen weitergeben? Ja – auf zwei Arten. Definieren Sie Skriptvariablen in der Variablen Registerkarte 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-Stdout 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 Registerkarten, um zu sehen, was zuerst verknüpft werden muss.