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

Libreria di script: parametri

Argomento

Questo articolo spiega lo scopo dei parametri e delle variabili d'ambiente durante l'installazione o l'esecuzione di script e automazioni in NinjaOne. 

Ambiente

Automazione NinjaOne

Descrizione

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 utilizzano gli argomenti. Quando si definisce la funzione, si definiscono i parametri che accetteranno gli argomenti dalla chiamata come valori dei parametri. Nell'ambito della creazione di script di automazione per NinjaOne, NinjaOne utilizza il termine "parametri" in tutto il testo.

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

NinjaOne utilizza variabili d'ambiente per fare riferimento ai parametri e semplificare l'immissione dei comandi. Puoi approfondire l'argomento nel nostro articolo NinjaOne Endpoint Management: Utilizzo delle variabili negli script di automazione. 

Indice

Seleziona una categoria per saperne di più:

Considerazioni importanti

Prima di procedere, tieni presente quanto segue:

  • I seguenti caratteri speciali non possono essere utilizzati nei parametri: &|;$><`!
  • NinjaOne non è in grado di passare più valori per i parametri Array. Ad esempio, quando si aggiunge -param 1, 2 nella casella di testo dei parametri, viene visualizzato solo 1 invece di 1 2.
  • NinjaOne attualmente non è in grado di trasmettere valori booleani tramite i nostri parametri.
  • NinjaOne accetta solo parametri con valori di tipo stringa.

Come utilizzare i parametri in uno script

Di seguito è riportato un esempio di passaggio di parametri a uno script PowerShell che rinomina un utente locale.

Figura 1: Aggiunta di parametri a uno script

Nella Figura 1, abbiamo creato tre stringhe di parametri predefiniti:

  • Tonya
  • Tony
  • T.S.

Questi parametri corrispondono all'attributo CmdletBinding evidenziato nello script e sostituiranno le variabili stringa nell'ordine in cui sono state inserite, come segue:

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

È inoltre possibile impostare questi parametri durante l'esecuzione dello script tramite una condizione di criterio o un'attività pianificata. Il prompt richiederà di aggiungere valori per i parametri.

scheduled task_run automation_parameters.png
Figura 2: Aggiungere parametri a un'automazione

Altri utilizzi dei parametri predefiniti

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

Di seguito è riportato un esempio con uno script che richiama tre variabili e le visualizza nell'output dello script: 

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


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

Quando esegui questo script, inserisci i valori che vuoi che ogni variabile assuma nell'ordine in cui sono stati scritti nello script. Usa uno spazio tra ogni variabile. Se hai valori con spazi al loro interno, devi aggiungere le virgolette per distinguerli dalle altre variabili.

Ad esempio, se voglio aggiungere Peter Smith come $Username e Pa5sW0rd come sua $Password, devo digitarli come segue:

"Peter Smith" Pa5sW0rd
NinjaOne attualmente non supporta gli script personalizzati. Tuttavia, l'argomento Script Share nei nostri forum è un'ottima risorsa per condividere e richiedere script personalizzati. Consulta Community Scripting – NinjaOne Dojo per saperne di più.

Domande frequenti

Come faccio a sapere quali parametri utilizzare negli script di installazione o di esecuzione nativi di NinjaOne?

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

Per i file MSI, consultare MSIEXEC - Windows installer - Windows CMD - SS64.com (link esterno) per un elenco dei parametri possibili.

Per lo script nativo di installazione dell'applicazione di NinjaOne, tutti i file MSI vengono eseguiti utilizzando i seguenti parametri:

/quiet /qn /norestart /log {percorso della cartella dello script}ninjascript-output-{ora-corrente}.txt 

Come faccio a sapere quali parametri utilizzare nei miei script personalizzati?

Ogni linguaggio di scripting ha un proprio metodo unico per utilizzare i parametri dello script. È necessario formattare i parametri in base ai requisiti del linguaggio utilizzato dallo script personalizzato. Di seguito sono riportate alcune risorse esterne relative al funzionamento dei parametri nei diversi linguaggi di scripting supportati da NinjaOne:

Mettiamo inoltre a disposizione le seguenti variabili di ambiente che è possibile utilizzare per tutti i tipi di script (Windows, Apple macOS e Linux):

NINJA_EXECUTING_PATH - Percorso di installazione
NINJA_AGENT_VERSION_INSTALLED - Versione dell'agente
NINJA_PATCHER_VERSION_INSTALLED - Versione del patcher
NINJA_DATA_PATH - Cartella dei dati dell'agente (script, criteri, download, registri)
NINJA_AGENT_PASSWORD - Password dell'agente per ottenere la chiave di sessione
NINJA_AGENT_MACHINE_ID - L'ID macchina utilizzato sul server
NINJA_AGENT_NODE_ID - L'ID nodo utilizzato sul server.
NINJA_ORGANIZATION_NAME - Il nome dell'organizzazione utilizzato sul server.
NINJA_ORGANIZATION_ID - ID dell'organizzazione utilizzato sul server.
NINJA_COMPANY_NAME - Nome dell'azienda utilizzato sul server.
NINJA_LOCATION_ID - ID della sede utilizzato sul server.
NINJA_LOCATION_NAME - Nome della sede utilizzato sul server
Se si modifica una variabile ed si esegue uno script per recuperare il nuovo valore, riavviare il target se non è cambiato. Il riavvio del target aggiornerà le variabili.

Risorse aggiuntive

Fare riferimento al Catalogo delle risorse di NinjaOne Endpoint Management: Scripting, Automazione e CLI per ulteriori strumenti della Libreria di automazione.

Domande frequenti

Passi successivi