Thema
In diesem Artikel wird erläutert, wie man Umgebungsvariablen beim Ausführen von Skripten in NinjaOne verwendet.
Umgebung
NinjaOne Endpunkt-Management
Beschreibung
Wenn Sie ein Skript ausführen, das Variablen enthält, fügt der NinjaOne-Agent diese nur für die Dauer der Skriptausführung als Umgebungsvariablen hinzu. Wenn in NinjaOne bereits eine Umgebungsvariable aus dem Skript besteht, schlägt das Skript fehl und sendet einen Aktivitätsprotokolleintrag, aus dem hervorgeht, welches Skript fehlgeschlagen ist und warum.
Skripte senden außerdem einen Aktivitätsprotokolleintrag für an einer Variablen vorgenommene Änderungen. Diese Informationen können Benutzern dabei helfen, Debugging- oder Fehlerbehebungsmaßnahmen zu identifizieren und zu planen.
Auswählen Sie eine Kategorie, um mehr zu erfahren:
- Umgebungsvariablen
- Skript-Variablen erstellen
- Erstellte Variablen bearbeiten oder löschen
- Variablen zu einem Skript hinzufügen
- Zusätzliche Ressourcen
Umgebungsvariablen
Wir stellen außerdem die folgenden Umgebungsvariablen zur Verfügung, die Sie für alle Skript-Typen (Windows, macOS und Linux) verwenden können:
NINJA_EXECUTING_PATH – Installationspfad
NINJA_AGENT_VERSION_INSTALLED – Agenten-Version
NINJA_PATCHER_VERSION_INSTALLED – Patcher-Version
NINJA_DATA_PATH – Datenordner des Agenten (Skripte, Richtlinien, Downloads, Protokolle)
NINJA_AGENT_PASSWORD – Agent-Passwort zum Abrufen des Sitzungsschlüssels
NINJA_AGENT_MACHINE_ID – Die auf dem Server verwendete Maschinen-ID
NINJA_AGENT_NODE_ID – Die auf dem Server verwendete Knoten-ID.
NINJA_ORGANISATION_NAME – Der auf dem Server verwendete Organisationsname.
NINJA_ORGANIZATION_ID – Die auf dem Server verwendete Organisations-ID.
NINJA_COMPANY_NAME – Der auf dem Server verwendete Unternehmensname.
NINJA_LOCATION_ID – Die auf dem Server verwendete Standort-ID.
NINJA_LOCATION_NAME – Der auf dem Server verwendete StandortnameWindows verfügt über eine zusätzliche Variable „NINJARMMCLI“ mit dem folgenden Wert:
C:Programm-DatenNinjaRMMAgentninjarmm-cli.exeDer Ausdruck „C:Programm-Daten “ bei diesem Pfad entspricht den folgenden nativen Umgebungsvariablenwerten:
$env:ALLUSERSPROFILE$env:Programm-Daten
Skript-Variablen erstellen
Sie können neue Skriptvariablen über das Feld „Skriptvariablen“ im Skript-Editor hinzufügen. Mehr erfahren Sie unter „NinjaOne Endpunkt-Management: Erste Schritte mit Automatisierungsskripten “.
&|;$><`!.Um eine Skript-Variable hinzuzufügen, führen Sie die folgenden Schritte aus:
- Erstellen Sie ein neues Skript oder öffnen Sie eine Vorlage aus der NinjaOne-Automatisierungsbibliothek.
- Klicken Sie im Abschnitt „Skriptvariablen“ auf „Hinzufügen“ und wählen Sie eine Option aus dem Drop-down-Menü aus. Sie können maximal 20 Variablen zu einem einzelnen Skript hinzufügen. Eine Beschreibung der einzelnen Variablen finden Sie unter „NinjaOne Endpunkt-Management: Typen von Automatisierungsskriptvariablen“.
- Das Dialogfeld „Variable hinzufügen“ wird geöffnet und zeigt Konfigurationsoptionen an, die für den von Ihnen ausgewählten Variablentyp relevant sind. In der folgenden Tabelle finden Sie Erläuterungen zu den einzelnen Feldern und den Variablentypen, für die sie gelten.
| Feld | Beschreibung | Relevante Variablentypen |
|---|---|---|
| Variable als obligatorisch festlegen | Aktivieren Sie den Schalter, um die Variable bei der Ausführung des Skripts zur Pflichtangabe zu machen. Bei Aktivierung wird das vom Skript generierte Formular nicht ausgeführt, wenn dieser Wert fehlt. | Alle außer Kontrollkästchen |
| Name | Geben Sie Ihrer Variablen einen aussagekräftigen Namen. | Alle |
| Berechneter Name | NinjaOne füllt dieses Feld automatisch mit einem Variablennamen aus. | Alle |
| Beschreibung | Dieses optionale Feld dient zur Angabe einer Beschreibung der Variablen. Bei der Ausführung eines Skripts zeigt NinjaOne die Beschreibung als informatives Tooltip-Icon (i) über der Variablen an, das weitere Informationen oder hilfreiche Tipps bereitstellt. | Alle |
| Standardwert festlegen | Dieser optionale Wert verwendet vordefinierte Inhalte, wenn Sie das Skript ausführen. Das Format dieses Feldes ändert sich je nach ausgewähltem Variablentyp. | Alle |
| Optionswert | Dieser obligatorische Wert ermöglicht es Benutzern, Optionen aus einer Liste auszuwählen. Jeder eingegebene Wert stellt eine separate Option dar. | Dropdown |
Erstellte Variablen bearbeiten oder löschen
Sie können Skriptvariablen nach Bedarf bearbeiten oder löschen. Verschieben Sie den Mauszeiger über den Variablennamen und klicken Sie dann auf das Icon „Bearbeiten“ oder auf das „X“, um die Variable zu löschen. Sie können die Reihenfolge der Variablen auch ändern, indem Sie sie im Stapel nach oben oder unten ziehen.
Variablen zu einem Skript hinzufügen
Klicken Sie im Skript-Editor auf den Bearbeitungsbereich und drücken Sie dann STRG + Leertaste. Die Skriptvariablenauswahl wird als Kontextmenü angezeigt. Bewegen Sie den Mauszeiger über eine Variable, um eine Beschreibung anzuzeigen. In dieser Skriptvariablenauswahl werden auch Benutzerdefinierte Felder angezeigt.
Nach dem Auswählen der Variable fügt NinjaOne sie in den Code im Skript-Editor ein, formatiert für die Sprache, die Sie beim Hinzufügen der Variable ausgewählt haben.
Zusätzliche Ressourcen
Weitere Informationen zur Automatisierungsbibliothek von NinjaOne finden Sie im Ressourcenkatalog „NinjaOne Endpunkt-Management: Skripterstellung, Automatisierung und CLI “.