Thema
Dieser Artikel enthält eine Erläuterung zu Skriptvariablen und Anweisungen zu deren Verwendung.
Umgebung
NinjaOne-Automatisierung und Skripting
Beschreibung
Bitte wählen Sie eine Option aus, um mehr zu erfahren:
- Was sind Variablentypen?
- Verwendung einer Variablen im Skript-Editor
- Visualisierung eines Skripts mit Variablen
- Senden von Skriptvariablen an einen Agenten
- Weitere
Was sind Variablentypen?
Beim Erstellen von Skripten in der Automatisierungsbibliothek haben Sie die Möglichkeit, mehrere Arten von Skriptvariablen hinzuzufügen, die sich auf das interaktive Formular auswirken, das bei der Ausführung eines Skripts angezeigt wird. Variablen werden in Batch, PowerShell, ShellScript und VBScript unterstützt.
In der folgenden Tabelle finden Sie eine kurze Erläuterung der einzelnen Variablentypen.
| Variablentyp | Beschreibung |
|---|---|
| Zeichenfolge/Text | Wird für alles verwendet, was Buchstaben, Zahlen und/oder Zeichen als Kombination benötigt. Beispiele hierfür sind Benutzernamen, URLs und Sätze. Wichtiger Hinweis: Die folgenden Sonderzeichen können nicht verwendet werden: Å Ä Ö &|;$><`! |
| Ganzzahl | Wird für alles verwendet, das eine ganze Zahl ohne Dezimalstellen benötigt. |
| Dezimal | Wird für alles verwendet, das eine Zahl mit Dezimalstellen benötigt (z. B. 3,145). |
| Kontrollkästchen | Wird für alles verwendet, das einen Wert "Ja" oder "Nein" benötigt. |
| Datum | Wird für alles verwendet, das ein Datum darstellen muss. Wichtiger Hinweis: Das Skript verwendet das ISO 8601-Format. |
| Datum/Uhrzeit | Wird für alles verwendet, das ein Datum und eine Uhrzeit darstellen muss. Wichtiger Hinweis: Das Skript verwendet das ISO 8601-Format. |
| DropDown | Wird für alles verwendet, was eine Auswahl mit mehreren Optionen darstellen soll. |
| IP-Adresse | Wird für alles verwendet, was eine IP-Adresse darstellen muss. |
Verwendung einer Variablen im Skript-Editor
Sobald die gewünschten Variablen auf der rechten Seite des Skript-Editors festgelegt sind, können sie innerhalb des Skripts verwendet werden, indem Sie STRG + Leertaste auf Ihrer Tastatur drücken und dann die Option aus dem daraufhin angezeigten Popup-Fenster auswählen. Bewegen Sie den Mauszeiger über die Variable, um eine Beschreibung anzuzeigen, und klicken Sie darauf, um sie in das Skript einzufügen.
Abbildung 1: NinjaOne-Skriptseite → Variablen hinzufügen und verwenden (zum Vergrößern anklicken)
Sie können Variablen auch manuell eingeben, indem Sie sie anhand ihres Namens referenzieren, wie sie im Eingabefeld auf der rechten Seite angezeigt werden.
Verschiedene Skriptsprachen erfordern unterschiedliche Eingaben, um auf die Variable zu verweisen – Beispiele finden Sie in der folgenden Tabelle.
| Skriptsprache | Referenzbeispiel |
|---|---|
| PowerShell | $env:<Variablenname> $env:dateOfBirth |
| Batch | %<Variablenname>% %dateOfBirth% |
| VBScript | <Variablenname> = CreateObject("WScript.Shell").ExpandEnvironmentStrings("%Variablenname%") dateOfBirth = CreateObject("WScript.Shell").ExpandEnvironmentStrings("%dateOfBirth%") |
| ShellScript | $<Variablenname> $dateOfBirth |
Bitte beachten Sie, dass alle Variablen in dem von Ihnen geschriebenen Code als Zeichenfolgen festgelegt sind, sodass Sie möglicherweise Werte konvertieren oder umwandeln müssen. Im Abschnitt zur Skriptausführung finden Sie Informationen zu den übertragenen Werten und deren Format.
Visualisierung eines Skripts mit Variablen
Variablen werden je nach den im Skript-Editor getroffenen Auswahlen unterschiedlich dargestellt. Nachfolgend finden Sie ein Beispiel dafür, wie verschiedene Variablen in einem Skript aussehen, das für die Ausführung auf einem Gerät vorbereitet ist.
Beachten Sie, dass neben dem Namen einer Variablen, die als obligatorisch gekennzeichnet wurde, ein Sternchen (*) angezeigt wird. Wenn dieses Feld vom Benutzer, der das Skript ausführt, nicht ausgefüllt wurde oder kein Standardwert angegeben wurde, wird das Skript nicht ausgeführt – das erforderliche Feld wird rot angezeigt und der Benutzer wird aufgefordert, einen Wert einzugeben, um fortzufahren.
Abbildung 2: Beispiel für Variablenfelder in einem NinjaOne-Skript
Senden von Skriptvariablen an einen Agenten
- Skriptvariablen, die leer übermittelt werden (ohne Wert), werden immer als leere Zeichenfolge gesendet. Wir empfehlen, auf leere Werte zu prüfen, wenn Sie eine Skriptvariable nicht als obligatorisch markiert haben.
- An den Agenten gesendete Skriptvariablen sind nicht stark typisiert. Alle Werte werden als Zeichenfolge gesendet. Wenn Sie diese in einen bestimmten Typ umwandeln möchten, müssen Sie dies in Ihrem eigenen Code tun.
Bestimmte Sprachen ermöglichen es Ihnen, Zeichenfolgen im Code in streng typisierte Objekte umzuwandeln. PowerShell kann beispielsweise wie folgt in ein Datum/eine Uhrzeit umwandeln:
$Test1 = [datetime]$ENV:Test1
Sie können wie folgt in einen booleschen Wert konvertieren:
$Test2 = [System.Boolean]::Parse($ENV:Test2)
Es gibt einige einfache Regeln, die die Skript-Engine beim Senden von Skriptvariablen an einen Agenten befolgt:
| Variablentyp | Skript-Engine-Regel |
|---|---|
| Zeichenfolge/Text | Wird rein als eingegebene Zeichenfolge gesendet (z. B. "Hello World"). |
| Ganzzahl | Wird als ganze Zahl gesendet (z. B. "314"). |
| Dezimal | Als Gleitkommazahl gesendet (z. B. "3,14"). |
| Kontrollkästchen | Wenn aktiviert, werden Kontrollkästchen als Zeichenfolge mit dem Wert "true" gesendet. Wenn deaktiviert, werden Kontrollkästchen als Zeichenfolge mit dem Wert "false" gesendet. |
| Datum | Wird als ISO 8601-formatierte Zeichenfolge im Format JJJJ-MM-TTT00:00:00.000+00:00 gesendet |
| Datum/Uhrzeit | Wird als ISO 8601-formatierte Zeichenfolge im Format JJJJ-MM-TTTHH:MM:SS.SSSZ gesendet (z. B. 2023-07-28T03:00:00.000+01:00). |
| DropDown | Wird als Zeichenfolge mit dem ausgewählten Wert gesendet. |
| IP-Adresse | Wird als Zeichenfolge mit der eingegebenen IP-Adresse gesendet. |