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

Libreria di script: parametri

Argomento

Questo articolo illustra la funzione 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 presentano alcune differenze. 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 obbligatori per impostazione predefinita negli script personalizzati. Tuttavia, se lo script personalizzato è scritto per accettare parametri, è possibile specificare stringhe di parametri predefinite nell’editor di script.

NinjaOne utilizza le variabili d’ambiente per fare riferimento ai parametri e semplificare l’immissione dei comandi; per approfondimenti in merito, consulta il 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, tenere presente quanto segue:

  • I seguenti caratteri speciali non possono essere utilizzati nei parametri: &|;$><`!
  • NinjaOne non è in grado di passare più valori per i parametri di tipo array. Ad esempio, quando si inserisce -param 1, 2 nella casella di testo dei parametri, viene visualizzato solo 1 invece di 1 2.
  • NinjaOne al momento 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 come passare parametri a uno script PowerShell che rinomina un utente locale.

script parameters.png
Figura 1: Aggiunta di parametri a uno script

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

  • 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. La finestra di dialogo richiederà di aggiungere i valori per i parametri.

scheduled task_run automation_parameters.png
Figura 2: Aggiunta di 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 inserirne i valori nel campo dei parametri prima di eseguire lo script.

Di seguito è riportato un esempio di 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 si esegue questo script, inserire i valori che si desidera assegnare a ciascuna variabile nell’ordine in cui sono stati scritti nello script. Utilizzare uno spazio tra una variabile e l’altra. Se i valori contengono spazi, è necessario aggiungere le virgolette per distinguerli dalle altre variabili.

Ad esempio, se voglio inserire "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 insieme di parametri da utilizzare.

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

Per lo script nativo di NinjaOne "Install Application ", 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 specifico per l’utilizzo dei parametri di 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 d’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 - ID del computer utilizzato sul server
NINJA_AGENT_NODE_ID - ID del nodo utilizzato sul server.
NINJA_ORGANIZATION_NAME - 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 dispositivo di destinazione se non è cambiato. Il riavvio del dispositivo di destinazione aggiornerà le variabili.

Risorse aggiuntive

Consultare NinjaOne Endpoint Management: Scripting, automazione e CLI per ulteriori strumenti della Libreria di automazione.

Domande frequenti

Passi successivi