Sei già un cliente NinjaOne? Effettua il login per visualizzare le altre guide e gli ultimi aggiornamenti.

Libreria di script: parametri

 

Indice:

 

Definizione dei parametri 

I termini “parametri” e “argomenti” sono spesso usati in modo intercambiabile, ma sono leggermente diversi. Quando si chiama una funzione, uno script o un file eseguibile, si usano gli argomenti. Quando si definisce la funzione, si definiscono i parametri che prenderanno gli argomenti dalla chiamata per i valori dei parametri. Nell'ambito della creazione di script di automazione per NinjaOne, questi termini possono essere utilizzati in modo intercambiabile, pertanto NinjaOne utilizza sempre il termine “parametri”.

I parametri non sono richiesti per impostazione predefinita negli script personalizzati. Tuttavia, se lo script personalizzato è definito in modo da accettare parametri, è possibile specificare stringhe di parametri preimpostate nell'editor degli script.

 

Riconoscere i parametri da utilizzare negli script dell'applicazione nativa di installazione/esecuzione di NinjaOne

Per i file .EXE, i parametri sono specifici dell'applicazione. Non esiste un set di parametri da utilizzare.

Per i file .MSI, fai clic qui per un elenco dei possibili parametri.

Nota importante: per lo script nativo di NinjaOne "Installa applicazione", tutti i file .MSI vengono eseguiti utilizzando i seguenti parametri:

/quiet /qn /norestart /log {path to our script folder}ninjascript-output-{current-time}.txt 

NinjaOne accetta solo parametri di valore stringa. 

 

Riconoscere i parametri da utilizzare negli script personalizzati

Ogni linguaggio di scripting dispone di un metodo univoco per l'utilizzo dei parametri di script. I parametri devono essere formattati in base ai requisiti del linguaggio che usa lo script personalizzato. Di seguito sono riportate alcune risorse relative al funzionamento dei parametri nei diversi linguaggi di scripting supportati da NinjaOne:

Note importanti:
  • I seguenti caratteri speciali non possono essere utilizzati nei parametri: &|;$><`!
  • NinjaOne non è in grado di passare più valori per i parametri dell'array. Per esempio, quando si aggiunge -param 1, 2 nella casella di testo dei parametri, l'output sarà solamente "1" anziché "1" "2". 
  • Al momento NinjaOne non è in grado di passare valori booleani tramite i nostri parametri.
  • NinjaOne accetta solo parametri di valore stringa. 

Esponiamo inoltre le seguenti variabili di ambiente che possono essere utilizzate per tutti i tipi di script (Windows, Mac e Linux):

NINJA_EXECUTING_PATH -Posizione di installazione
NINJA_AGENT_VERSION_INSTALLED -Versione agente
NINJA_PATCHER_VERSION_INSTALLED -Versione patcher
NINJA_DATA_PATH -Cartella dati dell'agente (script, criterio, download, log)
NINJA_AGENT_PASSWORD -Password agente per ottenere la chiave di sessione
NINJA_AGENT_MACHINE_ID -ID della macchina usato sul server
NINJA_AGENT_NODE_ID -ID del nodo usato sul server.
NINJA_ORGANIZATION_NAME -Nome dell'organizzazione usato sul server.
NINJA_ORGANIZATION_ID -ID dell'organizzazione usato sul server.
NINJA_COMPANY_NAME -Nome dell'azienda usato sul server.
NINJA_LOCATION_ID -L'ID della posizione utilizzata sul server.
NINJA_LOCATION_NAME -Il nome della posizione utilizzata sul server

 

Aspetto dei parametri in NinjaOne

Di seguito è riportato un esempio di passaggio di parametri a uno script Batch che crea un nuovo utente su un dispositivo.

script

Nello scenario precedente, abbiamo utilizzato il seguente script Batch per creare un nuovo utente:

net user %1 %2

%1 e %2 corrispondono ai valori che useranno parametri (in questo caso, un nome utente e una password per il nuovo utente).

Abbiamo creato 3 stringhe di parametri preimpostate:

  • Bob Password1
  • Linda NewPassword
  • Joe Passw0rd

Durante l'esecuzione dello script, possiamo specificare i parametri in modo istantaneo o scegliere dal nostro elenco di stringhe di parametri preimpostati.

esecuzione

I parametri vengono passati ai rispettivi valori nell'ordine in cui sono inseriti. Quindi, se scegliamo i parametri preimpostati Bob Password1, Bob viene passato al valore %1 nello script mentre Password1 viene passato al valore %2, il che si traduce in un nuovo utente con il nome utente Bob e la password Password1.

Ogni volta che viene creato un nuovo script nella Libreria di script di NinjaOne, viene creato un nuovo file come 'customscript1.bat'. Quindi, il comando avrà un aspetto simile a questo con i parametri:

customscript1.bat <INSERIRE QUI I PROPRI PARAMETRI>

 

Altro utilizzo dei parametri preimpostati:

Se non si desidera inserire parametri di testo nello script, è anche possibile richiamare variabili vuote all'interno dello script e inserire i rispettivi valori nel campo riservato ai parametri proprio prima di eseguire lo script.

Ecco un esempio di uno script che richiama 3 variabili mostrandole nell'output dello script: 

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


Write-Host $variable1
Write-Host $variable2
Write-Host $variable3
All'esecuzione dello script, inserisci i valori da far assumere a ogni variabile nell'ordine in cui sono scritte nello script. Utilizzare uno spazio per differenziare ogni variabile. 
Nell'esempio mostrato, variable1 assume il valore "5.1.1574", variable2 il valore "5" e variable3 il valore "1": 

esecuzione

Se i valori presentano degli spazi all'interno, bisogna aggiungere delle virgolette per differenziarli da altre variabili.
Ad esempio, se si desidera aggiungere Peter Smith come $Username e Pa5sW0rd come $Password, occorrerà inserirli come segue: 
"Peter Smith" Pa5sW0rd
Nota importante: NinjaOne attualmente non fornisce supporto per lo scripting personalizzato. Tuttavia, il topic Script Share nei nostri forum è un'ottima risorsa per condividere e richiedere script personalizzati. 

 

Documentazione correlata:

Libreria di automazioni

Libreria di automazioni: domande frequenti

Domande frequenti

Passi successivi