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 einmal gespeichert und sind in Ihrer gesamten Umgebung wiederverwendbar – ändern Sie ein Skript in der Bibliothek, und die Aktualisierung wird überall dort übernommen, wo es referenziert wird.
Skripte
Navigieren Sie zu Skripte in der Seitenleiste.
Die linke Seitenleiste hat drei feste Einträge oben:
Alle Skripte — zeigt jedes Skript in Ihrer Bibliothek, über alle Gruppen hinweg
Neues Skript — öffnet den Dialog „Skript erstellen"
Skripte ohne Gruppe — Skripte, die noch keiner Gruppe zugewiesen sind
Darunter listet der Skriptgruppen Abschnitt listet alle benutzerdefinierten Gruppen auf, die Sie erstellt haben. Wählen Sie eine Gruppe aus, um die Tabelle auf Skripte in 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 Registerkarten im linken Bereich: Skript, Variablen, Verknüpfte Automatisierungenund 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
Zeitüberschreitung (in Sekunden) — wie lange Level wartet, bis das Skript abgeschlossen ist, bevor die Ausführung als fehlgeschlagen markiert wird. Standard 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 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 benutzerdefinierte Feldreferenz inline einzufügen.
Klicken Sie auf Skript speichern zum Speichern. Änderungen werden erst nach dem Speichern wirksam.
⚠️ 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 einer Automatisierungsvariablen im Skript ausführen Aktionsbereich, um sie durch die Pipeline weiterzuleiten.
Klicken Sie auf + Neue Variable hinzufügen , um eine neue Variable zu definieren. Sobald sie definiert sind, erscheinen Variablen im Skriptvariablen Abschnitt einer beliebigen Skript ausführen Aktion zuordnen, die dieses Skript referenziert.
ℹ️ HINWEIS: Skriptvariablen erfassen die Ausgabe eines Skripts. Um Daten in 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 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 zuerst aus jeder referenzierenden Automatisierung entfernen oder diese Automatisierungen löschen. Die Registerkarte macht es einfach, genau zu sehen, was betroffen wäre.
Verknüpfte Monitore
Die Verknüpfte Monitore Registerkarte listet alle Skript-Monitore auf, die dieses Skript verwenden. Dieselbe Löschregel gilt: Entfernen Sie alle Verknüpfungen zu Monitoren, bevor ein Skript gelöscht werden kann.
Organisation mit Skriptgruppen
Skriptgruppen ermöglichen es Ihnen, Skripte nach Plattform, Funktion, Team oder nach dem zu kategorisieren, was für Ihre Umgebung sinnvoll ist. 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 in der Regel Zweck oder Funktion 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 zuerst alle Verknüpfungen mithilfe der 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 im großen 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 — 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 aus. 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 vor Ort. 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 zu einer bestehenden Skriptausführungs-Automatisierung hinzu, 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 wird. 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ü 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 vor Ort 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 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 wird.
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 einer beliebigen Automatisierung, einem Monitor oder einer Ad-hoc-Ausführung, und Änderungen an einer Stelle aktualisieren alle Referenzen. Die Shell Aktion führt ein direkt in der Automatisierung geschriebenes Skript aus, ohne 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 beschädigen, die es verwenden? Ja. Änderungen an einem gespeicherten Skript werden wirksam, wenn eine referenzierende Automatisierung das nächste Mal ausgeführt wird – 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 Ausgaben 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-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 Registerkarten, um zu sehen, was zuerst aufgehoben werden muss.