Sie sind bereits NinjaOne-Kunde? Melden Sie sich an, um weitere Leitfäden und die neuesten Updates zu sehen.

Skript-Bibliothek: Parameter

Thema

In diesem Artikel wird der Zweck von Parametern und Umgebungsvariablen bei der Installation oder Ausführung von Skripten und Automatisierungen in NinjaOne erläutert. 

Umgebung

NinjaOne-Automatisierung

Beschreibung

Die Begriffe „Parameter“ und „Argumente“ werden oft synonym verwendet, unterscheiden sich jedoch geringfügig. Wenn Sie eine Funktion, ein Skript oder eine ausführbare Datei aufrufen, verwenden Sie Argumente. Wenn Sie die Funktion definieren, legen Sie die Parameter fest, die die Argumente aus dem Aufruf als Parameterwerte übernehmen. Im Zusammenhang mit der Erstellung von Automatisierungsskripten für NinjaOne verwendet NinjaOne durchgehend den Begriff „Parameter“.

Parameter sind in benutzerdefinierten Skripten standardmäßig nicht erforderlich. Wenn Ihr benutzerdefiniertes Skript jedoch so geschrieben ist, dass es Parameter akzeptiert, haben Sie die Möglichkeit, im Skript-Editor voreingestellte Parameterzeichenfolgen anzugeben.

NinjaOne verwendet Umgebungsvariablen, um auf Parameter zu verweisen und die Befehlseingabe zu vereinfachen. Weitere Informationen hierzu finden Sie in unserem Artikel „NinjaOne Endpoint Management: Verwendung von Variablen in Automatisierungsskripten “. 

Index

Wählen Sie eine Kategorie aus, um mehr zu erfahren:

Wichtige Hinweise

Beachten Sie die folgenden Hinweise, bevor Sie fortfahren:

  • Die folgenden Sonderzeichen dürfen in Parametern nicht verwendet werden: &|;$><`!
  • NinjaOne kann keine mehreren Werte für Array-Parameter übergeben. Wenn Sie beispielsweise -param 1, 2 in das Textfeld für Parameter eingeben, wird nur 1 statt 1 2 ausgegeben.
  • NinjaOne kann derzeit keine booleschen Werte über unsere Parameter übergeben.
  • NinjaOne akzeptiert nur Parameter mit String-Werten.

Verwendung von Parametern in einem Skript

Im Folgenden wird ein Beispiel für die Übergabe von Parametern an ein PowerShell-Skript gezeigt, das einen lokalen Benutzer umbenennt.

Abbildung 1: Hinzufügen von Parametern zu einem Skript

In Abbildung 1 haben wir drei voreingestellte Parameter-Zeichenfolgen erstellt:

  • Tonya
  • Tony
  • T.S.

Diese Parameter entsprechen dem im Skript hervorgehobenen CmdletBinding-Attribut und ersetzen die Zeichenfolgenvariablen in der eingegebenen Reihenfolge wie folgt:

  • $CurrentName: Tonya
  • $NewName: Tony
  • $NewDisplayName: T.S.

Sie können diese Parameter auch festlegen, wenn Sie das Skript über eine Richtlinienbedingung oder eine geplante Aufgabe ausführen. In der Eingabeaufforderung werden Sie aufgefordert, Werte für die Parameter einzugeben.

scheduled task_run automation_parameters.png
Abbildung 2: Hinzufügen von Parametern zu einer Automatisierung

Weitere Verwendungsmöglichkeiten für voreingestellte Parameter

Wenn Sie keine festen Textparameter in Ihr Skript eingeben möchten, können Sie auch leere Variablen innerhalb Ihres Skripts aufrufen und deren Werte vor der Ausführung des Skripts in das Feld für Parameter einfügen.

Im Folgenden finden Sie ein Beispiel für ein Skript, das drei Variablen aufruft und diese in der Skript-Ausgabe anzeigt: 

param(
 [String]$variable1='',
 [String]$variable2='',
 [String]$variable3='')


Write-Host $variable1
Write-Host $variable2
Write-Host $variable3

Wenn Sie dieses Skript ausführen, geben Sie die Werte ein, die jede Variable annehmen soll, und zwar in der Reihenfolge, in der sie in Ihrem Skript geschrieben wurden. Verwenden Sie ein Leerzeichen zwischen den einzelnen Variablen. Wenn Ihre Werte Leerzeichen enthalten, müssen Sie Anführungszeichen hinzufügen, um sie von den anderen Variablen zu unterscheiden.

Wenn ich beispielsweise Peter Smith als $Username und Pa5sW0rd als sein $Password hinzufügen möchte, muss ich sie wie folgt eingeben:

"Peter Smith" Pa5sW0rd
NinjaOne bietet derzeit keine Unterstützung für benutzerdefinierte Skripte. Das Thema „Script Share “ in unseren Foren ist jedoch eine hervorragende Ressource zum Teilen und Anfordern von benutzerdefinierten Skripten. Weitere Informationen finden Sie unter „Community Scripting – NinjaOne Dojo “.

Häufig gestellte Fragen

Woher weiß ich, welche Parameter ich bei der nativen Installation von NinjaOne oder beim Ausführen von Anwendungsskripten verwenden muss?

Bei EXE-Dateien sind die Parameter anwendungsspezifisch. Es gibt keinen einheitlichen Satz von Parametern, der verwendet werden muss.

Für MSI-Dateien finden Sie unter „MSIEXEC – Windows Installer – Windows CMD – SS64.com“ (externer Link) eine Liste möglicher Parameter.

Für das native Skript „Install Application “ von NinjaOne werden alle MSI-Dateien mit den folgenden Parametern ausgeführt:

/quiet /qn /norestart /log {Pfad zu unserem Skriptordner}ninjascript-output-{aktuelle-Uhrzeit}.txt 

Woher weiß ich, welche Parameter ich in meinen benutzerdefinierten Skripten verwenden muss?

Jede Skriptsprache hat ihre eigene Methode zur Verwendung von Skriptparametern. Sie sollten die Parameter entsprechend den Anforderungen der Sprache formatieren, die Ihr benutzerdefiniertes Skript verwendet. Hier finden Sie einige externe Ressourcen dazu, wie Parameter in den verschiedenen von NinjaOne unterstützten Skriptsprachen funktionieren:

Wir stellen außerdem die folgenden Umgebungsvariablen bereit, die Sie für alle Skripttypen (Windows, Apple macOS und Linux) verwenden können:

NINJA_EXECUTING_PATH – Installationspfad
NINJA_AGENT_VERSION_INSTALLED – Agent-Version
NINJA_PATCHER_VERSION_INSTALLED – Patcher-Version
NINJA_DATA_PATH – Agent-Datenordner (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_ORGANIZATION_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 Firmenname.
NINJA_LOCATION_ID – Die auf dem Server verwendete Standort-ID.
NINJA_LOCATION_NAME – Der auf dem Server verwendete Standortname
Wenn Sie eine Variable ändern und ein Skript ausführen, um den neuen Wert abzurufen, starten Sie das Ziel neu, falls sich dieser nicht geändert hat. Durch den Neustart des Ziels werden die Variablen aktualisiert.

Weitere Ressourcen

Weitere Tools der Automatisierungsbibliothek finden Sie im NinjaOne Endpoint Management: Skripting, Automatisierung und CLI-Ressourcenkatalog.

FAQ

Nächste Schritte