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

Skript-Bibliothek: Parameter

 

Inhaltsverzeichnis:

 

Was sind Parameter? 

Die Begriffe „Parameter“ und „Argumente“ werden oft austauschbar verwendet, aber sie sind sehr unterschiedlich. Wenn Sie eine Funktion, ein Skript oder eine ausführbare Datei aufrufen, verwenden Sie Argumente. Wenn Sie die Funktion definieren, definieren Sie die Parameter, die die Argumente des Aufrufs für die Parameterwerte übernehmen. Im Rahmen der Erstellung von Automatisierungsskripten für NinjaOne können diese Begriffe austauschbar verwendet werden, daher verwendet NinjaOne durchgehend den Begriff „Parameter“.

In benutzerdefinierten Skripten sind standardmäßig keine Parameter erforderlich. Wenn Ihr benutzerdefiniertes Skript jedoch so konzipiert, dass es Parameter akzeptiert, können Sie im Skript-Editor voreingestellte Parameterzeichenfolgen angeben.

 

Woher weiß ich, welche Parameter ich in den NinjaOne-eigenen Anwendungsskripten für die Installation/Ausführung verwenden soll?

Bei EXE-Dateien sind die Parameter anwendungsspezifisch. Es ist nicht den einen Parametersatz.

Für MSI-Dateien klicken Sie bitte hier, um sich eine Liste möglicher Parameter anzeigen zu lassen.

Wichtiger Hinweis: Bei dem NinjaOne-eigenen Skript „Installationsanwendung“ werden alle MSI-Dateien mit folgenden Parametern ausgeführt:

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

NinjaOne akzeptiert ausschließlich String-Wertparameter. 

 

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

Jede Skriptsprache verfügt über eine eigene Methode des Verbrauchens von Skriptparametern. Die Parameter sollten gemäß den Anforderungen der von Ihrem benutzerdefinierten Skript verwendeten Sprache formatiert sein. Im Folgenden finden Sie einige Ressourcen zur Funktionsweise von Parametern in den verschiedenen von NinjaOne unterstützten Skriptsprachen:

Wichtige Hinweise:
  • Die folgenden Sonderzeichen dürfen in Parametern nicht verwendet werden: &|;$><`!
  • NinjaOne ist nicht in der Lage, mehrere Werte für Array-Parameter zu übergeben. Wenn Sie zum Beispiel -param 1, 2 in unserer Parameter-Textbox hinzufügen, ist das Ergebnis lediglich „1“ statt „1“ „2“. 
  • NinjaOne ist derzeit nicht in der Lage, Boolesche Werte durch unsere Parameter zu übergeben.
  • NinjaOne akzeptiert ausschließlich String-Wertparameter. 

Zudem stellen wir die folgenden Umgebungsvariablen zur Verfügung, die in allen Arten von Skripten (Windows, Mac und Linux) verwendet werden können:

NINJA_EXECUTING_PATH -Install location
NINJA_AGENT_VERSION_INSTALLED -Agent Version
NINJA_PATCHER_VERSION_INSTALLED -Patcher Version
NINJA_DATA_PATH -Agent data folder (scripts, policy, downloads, logs)
NINJA_AGENT_PASSWORD -Agent password for obtaining session key
NINJA_AGENT_MACHINE_ID -The machine ID used on the server
NINJA_AGENT_NODE_ID -The node ID used on the server.
NINJA_ORGANIZATION_NAME -The organization name used on the server.
NINJA_ORGANIZATION_ID -The organization ID used on the server.
NINJA_COMPANY_NAME -The company name used on the server.
NINJA_LOCATION_ID -The location ID used on the server.
NINJA_LOCATION_NAME -The name of the location used on the server

 

Wie sehen voreingestellte Parameter in NinjaOne aus?

Das folgende Beispiel zeigt die Übergabe von Parametern an ein Batch-Skript, das auf einem Gerät einen neuen Benutzer angelegt.

script

Im obigen Beispiel verwenden wir zum Anlegen eines neuen Benutzers folgendes Batch-Skript:

net user %1 %2

%1 und %2 sind Werte, die Parameter verbrauchen (in diesem Fall einen Benutzernamen und ein Passwort für den neuen Benutzer).

Wir haben drei voreingestellte Parameterzeichenfolgen erstellt:

  • Bob Password1
  • Linda NewPassword
  • Joe Passw0rd

Bei der Ausführung des Skripts können wir Parameter entweder spontan spezifizieren oder aus unserer Liste voreingestellter Parameterzeichenfolgen auswählen.

run

Die Parameter werden in der Reihenfolge ihrer Eingabe an die jeweiligen Werte übergeben. Wenn wir die voreingestellten Parameter Bob Password1 auswählen, wird also Bob im Skript an den Wert %1 und Password1 an den Wert %2 übergeben, was zu einem neuem Benutzer mit dem Benutzernamen Bob und dem Passwort Password1 führt.

Immer wenn Sie in NinjaOnes Skript-Bibliothek ein neues Skript erstellen, wird eine neue Datei wie zum Beispiel „customscript1.bat“ erstellt. Der Befehl sieht also mit den folgenden Parametern ungefähr so aus:

customscript1.bat <IHRE PARAMETER HIER>

 

Andere Verwendung für voreingestellte Parameter:

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

Hier ein Beispiel eines Skripts, das drei Variablen aufruft und in der Ausgabe des Skripts 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, die die einzelnen Variablen annehmen sollen, in der Reihenfolge ein, in der sie in Ihrem Skript geschrieben wurden. Verwenden Sie ein Leerzeichen zwischen den einzelnen Variablen, um sie unterscheidbar zu machen. 
In diesem Beispiel erhält variable1 den Wert „5.1.1574“, variable2 den Wert „5“ und variable3 den Wert „1“: 

run

Wenn Sie Werte haben, die Leerzeichen enthalten, müssen Sie Anführungszeichen hinzufügen, damit sie von den anderen Variablen zu unterscheiden sind.
Angenommen, Sie möchten Peter Smith als $Benutzername und Pa5sW0rd als sein $Passwort hinzufügen. Dann müssen Sie dies wie folgt eingeben: 
"Peter Smith" Pa5sW0rd
Wichtiger Hinweis: NinjaOne bietet derzeit keine Unterstützung für benutzerdefinierte Skripte. Das Thema Skriptfreigabe in unseren Foren ist jedoch eine hervorragende Ressource, wenn Sie benutzerdefinierte Skripte teilen und anfordern möchten. 

 

Siehe auch:

Automatisierungsbibliothek

Automatisierungsbibliothek: FAQ

FAQ

Nächste Schritte