Argomento
Questo articolo fornisce una spiegazione delle variabili di script e indicazioni su come utilizzarle.
Ambiente
Automazione e scripting in NinjaOne
Descrizione
Seleziona un'opzione per ulteriori informazioni:
- Cosa sono i tipi di variabili?
- Utilizzo di una variabile nell'editor di script
- Visualizzazione di uno script con variabili
- Invio delle variabili di script a un agente
- Risorse aggiuntive
Cosa sono i tipi di variabili?
Quando si creano script nella Libreria di automazioni, è possibile aggiungere diversi tipi di variabili di script che influenzano il modulo interattivo visualizzato all'esecuzione dello script. Le variabili sono supportate in Batch, PowerShell, ShellScript e VBScript.
Consultare la tabella sottostante per una breve spiegazione di ciascun tipo di variabile.
| Tipo di variabile | Descrizione |
|---|---|
| Stringa/Testo | Utilizzata per qualsiasi elemento che richieda una combinazione di lettere, numeri e/o caratteri. Esempi includono nomi utente, URL e frasi. Nota importante: non è possibile utilizzare i seguenti caratteri speciali: Å Ä Ö &|;$><`! |
| Numero intero | Utilizzato per qualsiasi elemento che richieda un numero intero senza decimali. |
| Decimale | Utilizzato per qualsiasi elemento che richieda un numero con la virgola decimale (ad es. 3,145). |
| Casella di controllo | Utilizzata per qualsiasi cosa che richieda un valore vero o falso. |
| Data | Utilizzato per qualsiasi cosa che richieda di rappresentare una data. Nota importante: lo script utilizza il formato ISO 8601. |
| Data/Ora | Utilizzato per qualsiasi elemento che richieda di rappresentare una data e un'ora. Nota importante: lo script utilizza il formato ISO 8601. |
| Menu a tendina | Utilizzato per qualsiasi elemento che richieda una scelta tra più opzioni. |
| Indirizzo IP | Utilizzato per qualsiasi elemento che richieda di rappresentare un indirizzo IP. |
Uso di una variabile nell'Editor di script
Una volta impostate le variabili desiderate sul lato destro dell’editor di script, è possibile utilizzarle all’interno dello script premendo CTRL + Spazio sulla tastiera e selezionando l’opzione dalla finestra a comparsa che si apre. Passa il mouse sulla variabile per visualizzarne la descrizione e cliccaci sopra per inserirla nello script.
Figura 1: Pagina degli script di NinjaOne → Aggiunta e utilizzo delle variabili (clicca per ingrandire)
È inoltre possibile inserire le variabili manualmente, facendo riferimento al loro nome così come appare nella casella di immissione sulla destra.
I diversi linguaggi di scripting richiedono input diversi per fare riferimento alla variabile: consulta la tabella sottostante per alcuni esempi.
| Linguaggio di scripting | Esempio di riferimento |
|---|---|
| Powershell | $env:<nome_variabile> |
| Batch | %<nomeVariabile>% |
| VBScript | <nome_variabile> = CreateObject("WScript.Shell").ExpandEnvironmentStrings("%nome_variabile%") |
| ShellScript | $<nomeVariabile> |
Si prega di notare che tutte le variabili sono impostate come stringhe nel codice che si sta scrivendo, pertanto potrebbe essere necessario convertire o convertire i valori. Si prega di consultare la sezione sull'esecuzione degli script per vedere i valori che vengono inviati e il loro formato.
Visualizzazione di uno script con variabili
Le variabili vengono visualizzate in modo diverso a seconda delle selezioni effettuate nell'editor di script. Di seguito è riportato un esempio di come appaiono le diverse variabili in uno script pronto per essere eseguito su un dispositivo.
Si noti che se una variabile è stata contrassegnata come obbligatoria, accanto al nome della variabile viene visualizzato un asterisco (*). Se questo campo non viene compilato dall'utente che esegue lo script, o se non è stato fornito un valore predefinito, lo script non verrà eseguito: il campo obbligatorio diventerà rosso e agli utenti verrà richiesto di inserire un valore per procedere.
Figura 2: Esempio di campi variabili in uno script NinjaOne
Invio delle variabili di script a un agente
Note importanti:
- Le variabili di script inviate vuote (senza alcun valore) vengono sempre inviate come stringa vuota. Si consiglia di verificare la presenza di un valore vuoto se non si è contrassegnata una variabile di script come obbligatoria.
- Le variabili di script inviate all’agente non sono fortemente tipizzate. Tutti i valori saranno inviati come stringhe. Se si desidera convertirle in un determinato tipo, sarà necessario farlo nel proprio codice.
Alcuni linguaggi consentono di convertire le stringhe in oggetti con tipizzazione forte nel codice. Ad esempio, Powershell può convertire in data/ora come segue:
$Test1 = [datetime]$ENV:Test1È possibile convertire in un valore booleano come segue:
$Test2 = [System.Boolean]::Parse($ENV:Test2)Esistono alcune semplici regole che il motore di script segue quando invia le variabili di script a un agente:
| Tipo di variabile | Regole dello script |
|---|---|
| Stringa/Testo | Invia esattamente la stringa immessa (ad es. “Hello World”). |
| Numero intero | Inviato come numero intero (ad es., "314"). |
| Decimale | Inviato come numero in virgola mobile (ad es., “3,14”). |
| Casella di controllo | Se selezionate, le caselle di controllo vengono inviate come valore stringa "true". Se deselezionate, le caselle di controllo vengono inviate come valore stringa "false". |
| Data | Inviata come stringa formattata secondo lo standard ISO 8601 nel formato AAAA-MM-ggT00:00:00.000+00:00 |
| Data/Ora | Inviata come stringa in formato ISO 8601 nella forma YYYY-MM-ddTHH:MM:SS.SSSZ (ad esempio, 2023-07-28T03:00:00.000+01:00). |
| Menu a tendina | Inviato come stringa contenente il valore selezionato. |
| Indirizzo IP | Inviato come stringa contenente l’Indirizzo IP inserito. |