Mit Automatisierungsvariablen können Aktionen Daten untereinander innerhalb der gleichen Pipeline übergeben. Eine Aktion schreibt einen Wert in eine Variable - einen Exit-Code eines Skripts, einen benutzerdefinierten Feldwert, ein Patch-Ergebnis - und eine spätere Aktion oder Bedingung liest ihn.
Variablen sind auf die Automatisierung beschränkt, in der sie definiert sind. Sie werden nicht zwischen Automatisierungen übertragen.
Erstellen von Automatisierungsvariablen
Es gibt zwei Möglichkeiten, eine Automatisierungsvariable zu erstellen.
Aus der Registerkarte Variablen
Öffnen Sie eine Automatisierung und klicken Sie auf Variablen in der linken Seitenleiste.
Klicken Sie auf + Variable hinzufügen.
Geben Sie einen Namen (ohne Leerzeichen) und optional einen Standardwert ein.
Klicken Sie auf Speichern.
Die hier erstellten Variablen sind sofort in allen Aktionen und Bedingungen der Automatisierung verfügbar.
Aus der Ausgabe einer Aktion
Jede Aktion kann ihre Ausgabe zur Laufzeit in eine Variable schreiben.
Öffnen Sie eine Aktion im Bearbeitungsmodus und scrollen Sie zu Weitere Optionen.
Geben Sie im Feld Aktionsausgabe einer Variable zuweisen einen Variablennamen ein oder wählen Sie einen bestehenden.
Speichern Sie die Aktion.
ℹ️ HINWEIS: Dies ist der gleiche Mechanismus, der durch das orange (x)-Badge auf Pipeline-Karten angezeigt wird. Wenn Sie ein (x)-Badge auf einer Aktion sehen, liest oder schreibt diese Aktion in einer Variable.
Variablen verwenden
In Aktionen und Skripten
Überall dort, wo das Variable Rendering unterstützt wird, klicken Sie auf das Variablensymbol, um eine Variable nach Name einzufügen. Sie können die Referenz auch direkt mit Doppel-Klammer-Syntax eingeben:
##{{MyVariable}}In Aktionsbedingungen
Variablen können in Aktionsbedingungen gelesen werden, um zu steuern, ob ein Schritt ausgeführt wird. Beispiel: Triggern Sie eine Aktion „Warnung erstellen" nur, wenn eine Variable namens PatchingStatus gleich failed ist.
Siehe Aktionsbedingungen für die vollständige Referenz zu Bedingungstypen und Operatoren.
Zuordnung zu Skriptvariablen
Skriptvariablen sind benannte Ausgabe-Slots, die auf der Registerkarte Variablen eines Skripts definiert sind. Das Skript schreibt während der Ausführung einen Wert in eine Skriptvariable, und die Zuordnung im Aktionsfeld Skript ausführen bestimmt, welche Automatisierungsvariable diesen Wert speichert - und macht ihn für nachfolgende Aktionen und Bedingungen in der Pipeline verfügbar.
Skriptvariablen dienen der Erfassung der Ausgabe, nicht der Bereitstellung der Eingabe. Um Daten in ein Skript zu übergeben (Gerätekontext, benutzerdefinierte Feldwerte, Systeminformationen), verwenden Sie Systemvariablen oder benutzerdefinierte Felder über die Auswahl {x} im Skript-Editor.
So ordnen Sie eine Skriptvariable einer Automatisierungsvariable zu:
Öffnen Sie die Aktion Skript ausführen im Bearbeitungsmodus.
Suchen Sie im Abschnitt Skriptvariablen die Skriptvariable, die Sie erfassen möchten.
Öffnen Sie die Dropdown-Liste Automatisierungsvariablen in dieser Zeile.
Wählen Sie eine bestehende Automatisierungsvariable aus oder klicken Sie auf Neue Variable erstellen.
Wenn das Skript ausgeführt wird, wird der Wert, den es in diese Skriptvariable schreibt, in der zugeordneten Automatisierungsvariable gespeichert und durch die Pipeline übertragen.
ℹ️ HINWEIS: Der Abschnitt Skriptvariablen wird nur angezeigt, wenn das ausgewählte Skript auf seiner Registerkarte „Variablen" mindestens eine Variable definiert hat.
Sie können auch eine Automatisierungsvariable inline aus einem Skript festlegen. Verwenden Sie die Inline-Syntax ##{{variable=value}}, wenn Ihr Skript andere Ausgaben erzeugt, die Sie nicht in die Variable aufnehmen möchten (Protokolle, Statusmeldungen usw.). Verwenden Sie Aktionsausgabe einer Variable zuweisen, wenn die einzige Ausgabe des Skripts der Wert ist, den Sie erfassen möchten.
Betten Sie dies überall in Ihre Skriptausgabe ein:
##{{variable_name=value}}Der Agent von Level analysiert die Skriptausgabe nach diesem Muster, während das Skript ausgeführt wird. Alle andere Ausgaben werden unverändert durchgelassen. Die Variable muss zunächst auf der Registerkarte Variablen des Skripts erstellt werden.
💡 TIPP: Dieses Muster - Ausgabe erfassen → in einer Bedingung überprüfen - ist die Standardmethode zur Konstruktion bedingter Fehlerbehandlung in Level. Siehe Automatisierungen erstellen für eine vollständige Anleitung mit diesem Muster.
FAQ
Wo kann ich alle Variablen sehen, die in einer Automatisierung verfügbar sind? Öffnen Sie die Automatisierung und klicken Sie auf Variablen in der linken Seitenleiste. Dies listet alle für diese Automatisierung definierten Automatisierungsvariablen auf. Systemvariablen sind ebenfalls immer verfügbar, erscheinen aber nicht hier - siehe Systemvariablen für die vollständige Liste.
Kann ich den gleichen Variablennamen in mehreren Automatisierungen verwenden? Ja. Variablennamen sind auf die Automatisierung beschränkt -
PatchingStatusin einer Automatisierung hat nichts mitPatchingStatusin einer anderen zu tun.Welchen Wert hat eine Variable, bevor eine Aktion darein schreibt? Es verwendet den Standardwert, der beim Erstellen der Variablen festgelegt wurde. Wenn kein Standard festgelegt wurde, ist es leer.
Kann ich eine Variable aus einem vorherigen Automatisierungslauf lesen? Nein. Variablen setzen sich zu Beginn jedes Laufs zurück. Sie werden nicht zwischen Läufen beibehalten.