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 und die Aktualisierung wird überall dort widergespiegelt, wo es referenziert wird.
Scripts
Go to Scripts in the sidebar.
Die linke Seitenleiste hat drei feste Elemente oben:
All scripts— zeigt jedes Skript in Ihrer Bibliothek über alle Gruppen hinweg an
New script— öffnet den Dialog Skript erstellen
Nicht gruppierte Skripte— Skripte, die noch keiner Gruppe zugeordnet sind
Darunter derScript groupsIm Abschnitt werden alle benutzerdefinierten Gruppen aufgelistet, die Sie erstellt haben. Wählen Sie eine Gruppe aus, um die Tabelle auf Skripte nur in dieser Gruppe zu filtern.
Die Haupttabelle zeigt alle Skripte, die der aktuellen Auswahl entsprechen. Spalten enthaltenName, Group, Description, Type (language), and Created. Klicken Sie auf einen beliebigen Skriptnamen, um ihn im Editor zu öffnen.
Erstellen eines Skripts
Click + Create scriptoben rechts oderNew scriptin der Seitenleiste. Ein Dialog wird angezeigt, in dem Sie nach einem Namen gefragt werden.
Geben Sie einen Namen ein und klicken Sie aufCreate. Der Skript-Editor wird sofort geöffnet.
💡 TIP:Benennen Sie Skripte spezifisch — "Gastkonto deaktivieren - Windows" ist leichter zu finden und wiederverwendbar als "Gastkonto-Skript". Sie können später immer umbenennen.
Script Editor
Jedes Skript hat vier Registerkarten im linken Bereich:Script, Variables, Verknüpfte Automatisierungen, and Linked monitors.
Die konfigurierbaren Felder:
Script name— der Name, der in der Bibliothek und in der Auswahl der Aktion Skript ausführen angezeigt wird.
Description— optional. Wird in der Skriptliste angezeigt. Lohnt sich für gemeinsame Bibliotheken.
Language— 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. Der Standardwert ist 100 Sekunden.
Run as— der Kontokontext, unter dem das Skript ausgeführt wird:
Option | Behavior |
Local system | Wird unter dem SYSTEM-Konto ausgeführt — erhöht, kein Benutzerkontext |
Current user | Wird als angemeldeter Benutzer ausgeführt — verwenden Sie dies für Vorgänge im Benutzerkontext wie das Anwenden von Hintergrund oder die Konfiguration von Benutzereinstellungen |
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 einen variablen, Systemvariablen- oder benutzerdefinierten Feldverweis inline einzufügen.
Click Save scriptzum Speichern. Änderungen werden erst nach dem Speichern wirksam.
⚠️ WARNING:Nicht gespeicherte Änderungen gehen verloren, wenn Sie den Editor verlassen. Speichern Sie vor dem Verlassen.
Variables
The VariablesDie Registerkarte zeigt alle für dieses Skript deklarierten Skriptvariablen. Skriptvariablen sind benannte Ausgabeslots — das Skript schreibt während der Ausführung einen Wert darin und Sie können diesen Wert einer Automatisierungsvariablen imRun ScriptAktionsfenster zuordnen, um es durch die Pipeline zu leiten.
Click + Neue Variable hinzufügenum eine neue Variable zu definieren. Nachdem sie definiert sind, werden Variablen in derSkriptvariablen section of any Run ScriptAktion, die dieses Skript referenziert.
ℹ️ HINWEIS:Skriptvariablen erfassen Ausgaben aus einem Skript. Um Daten zu übermittelnintoein 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 unterSkriptaktion ausführen, Automatisierungsvariablen, and Systemvariablen.
Verknüpfte Automatisierungen
The Die Registerkarte Verknüpfte Automatisierungenlistet jede Automatisierung auf, die dieses Skript über eineRun ScriptAktion referenziert. Klicken Sie auf einen beliebigen Automatisierungsnamen, um ihn zu öffnen.
ℹ️ HINWEIS:Ein Skript kann nicht gelöscht werden, während 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, genau was betroffen wäre.
Linked Monitors
The Linked monitorsDie Registerkarte listet alle Skriptmonitore auf, die dieses Skript verwenden. Die gleiche Löschregel gilt: Heben Sie die Verknüpfung mit allen Monitoren auf, bevor ein Skript gelöscht werden kann.
Organisation 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 werden in der Seitenleiste unterScript groupsund als Spalte in der Skriptliste angezeigt.
Um eine Gruppe zu erstellen, klicken Sie auf die+ icon next to Script groupsin der Seitenleiste. Ein Dialog wird angezeigt, in dem Sie nach einem Gruppennamen gefragt werden.
Um ein Skript einer Gruppe zuzuordnen, öffnen Sie das SkriptActionsMenü (oben rechts) und wählen SieAssign to group.
💡 TIP:Skriptgruppen spiegeln normalerweise Zweck oder Rolle wider — Sicherheit, Software, Monitore, Dienstprogramme — nicht die Struktur Ihrer Gerätegruppen. Das Organisieren nach Funktion macht es für das gesamte Team einfacher, das richtige Skript zu finden, unabhängig davon, auf welchen Geräten es ausgeführt wird.
Löschen eines Skripts
Öffnen Sie das SkriptActions menu and select Delete. Ein Bestätigungsdialog wird angezeigt.
⚠️ WARNING: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 derVerknüpfte Automatisierungen und Linked monitors tabs.
Running Scripts
Skripte können auf mehrere Arten ausgeführt werden:
In einer Automatisierung — via the Run ScriptAktion. Das Skript wird auf jedem Zielgerät als Teil der Automatisierungs-Pipeline ausgeführt. Dies ist die Hauptweise zum Ausführen von Skripten in großem Maßstab oder nach Zeitplan. SieheSkriptaktion ausführenfür die vollständige Referenz.
Ad-hoc aus der Geräteliste oder Gerätedetails— Wählen Sie Geräte aus und öffnen Sie dasActionsMenü. Es werden drei skriptbezogene Optionen angezeigt:
Gespeichertes Skript ausführen— wählen Sie ein Skript aus Ihrer Bibliothek. Level erstellt eine neue Skriptlauf-Automatisierung mit zwei Aktionen:Auf Genehmigung warten und Run script.
Run new script— schreiben Sie ein neues Skript sofort. Das Skript wird in Ihrer Bibliothek gespeichert und eine Skriptlauf-Automatisierung wird dafür erstellt.
Zur letzten Skriptausführung hinzufügen— Fügen Sie die ausgewählten Geräte zu einer vorhandenen Skriptlauf-Automatisierung hinzu, anstatt eine neue zu starten.
In einem Skriptmonitor— ein Monitor führt ein Skript nach Zeitplan aus und bewertet seine Ausgabe, um die Geräteintegrität zu bestimmen. SieheScript Monitorsfür Setup-Details.
ℹ️ HINWEIS:Skriptlauf-Automatisierungen sind wiederverwendbar. Sie können sie umbenennen, in eine Gruppe verschieben, weitere Aktionen hinzufügen oder ihren Auslöser vor Genehmigung anpassen. Das Skript wird erst ausgeführt, wenn dasAuf Genehmigung wartenDer Schritt wird manuell genehmigt. Alle Skriptausführungen werden verfolgt unterAutomatisierungen → Skriptausführungen in the sidebar.
Häufig gestellte Fragen
Was ist der Unterschied zwischen Gespeichertes Skript ausführen, Neues Skript ausführen und Zur letzten Skriptausführung hinzufügen?Alle drei sind imActionsMenü auf der Geräteliste und Gerätedetails.Gespeichertes Skript ausführenwählt ein vorhandenes Bibliotheksskript und erstellt eine neue Skriptlauf-Automatisierung dafür.Run new scriptermöglicht es Ihnen, ein neues Skript sofort zu schreiben — es wird in der Bibliothek gespeichert und eine Skriptlauf-Automatisierung wird erstellt.Zur letzten Skriptausführung hinzufügenfügt die ausgewählten Geräte zu einer vorhandenen Skriptlauf-Automatisierung hinzu, anstatt eine neue zu starten. In allen Fällen wird das Skript erst ausgeführt, wenn dasAuf Genehmigung wartenDie Aktion wird genehmigt.
Was ist der Unterschied zwischen einem gespeicherten Skript und einer Shell-Aktion?Ein gespeichertes Skript existiert in der Bibliothek und ist wiederverwendbar — verweisen Sie darauf von einer beliebigen Automatisierung, einem Monitor oder einer Ad-hoc-Ausführung aus, und Änderungen an einer Stelle aktualisieren alle Verweise. DieShellAktion führt ein inline in der Automatisierung geschriebenes Skript aus, ohne Bibliothekseintrag. Verwenden Sie gespeicherte Skripte für alles, das Sie mehr als einmal ausführen oder über längere Zeit verwalten möchten.
Kann ich ein Skript bearbeiten, ohne Automatisierungen zu beschädigen, die es verwenden?Ja. Änderungen an einem gespeicherten Skript werden beim nächsten Ausführen einer referenzierenden Automatisierung wirksam — es ist nicht erforderlich, die Automatisierung selbst zu aktualisieren. DerVerknüpfte AutomatisierungenDie Registerkarte zeigt genau, welche Automatisierungen betroffen sind.
Welche Sprachen unterstützt Level?Ansible, Bash, Go, osquery, PowerShell, Python und Zsh.
Kann ein Skript Ausgaben an nachfolgende Automatisierungsaktionen übergeben?Ja — zwei Wege. Definieren Sie Skriptvariablen imVariablesRegisterkarte und ordnen Sie sie den Automatisierungsvariablen in derRun ScriptAktionsfenster. Oder verwenden SieAktionsausgabe einer Variablen zuweisenin den Zusatzoptionen, um die vollständige Standardausgabe des Skripts zu erfassen. SieheSkriptaktion ausführen für Details.
Wer kann Skripte erstellen und bearbeiten?Techniker mit Berechtigung zum Bearbeiten von Automatisierungen in der relevanten Gruppe. SieheArbeitsbereich → Berechtigungenfü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 dieVerknüpfte Automatisierungen und Linked monitorsRegisterkarten, um zu sehen, was zuerst entfernt werden muss.