Attività iniziali di scripting di automazione

Argomento

Questo articolo descrive come iniziare a scrivere script per le automazioni nella NinjaOne Automation Library.

Ambiente

NinjaOne Endpoint Management

Descrizione

NinjaOne fornisce diversi script nativi pronti all'uso, ma è anche possibile creare e modificare script personalizzati oppure installare ed eseguire automazioni delle app. Quando si eseguono script personalizzati sui dispositivi, NinjaOne chiederà di specificare i parametri opzionali e se si desidera eseguire gli script come Sistema, Utente corrente o con le credenziali presenti nell'archivio delle credenziali.

Guarda altri tutorial nella nostra libreria video.

Seleziona un argomento per saperne di più:

Considerazioni sugli script
- Linguaggi di script supportati
- Applicazioni automatizzate
Aggiungi nuovi script
Importa nuovi script
Ordina e filtra gli script di automazione nella Libreria di automazione
Modifica, copia o elimina script o applicazioni esistenti
Automazioni in fase di revisione
Libreria dei modelli
Risorse aggiuntive

Considerazioni sullo scripting

Quando pianifichi i tuoi script, tieni presente quanto segue:

L'agente NinjaOne non fornisce supporto per la risoluzione dei problemi relativi agli script di riavvio personalizzati. Per eseguire un riavvio, si consiglia di utilizzare lo script di riavvio nativo di NinjaOne per garantire che l'agente sia in grado di gestire correttamente l'azione.
Le automazioni contrassegnate come All per il parametro Architecture vengono eseguite in base all'architettura nativa del dispositivo (32 o 64 bit).
Non è possibile utilizzare i seguenti caratteri speciali nei parametri: &|;$><`!.
È possibile assegnare gli script a una categoria (o a più categorie) per organizzare ulteriormente la Libreria delle automazioni. Per creare nuove categorie o modificare o eliminare quelle esistenti, fare clic sulla scheda Categorie in Amministrazione → Libreria → Automazione.
NinjaOne accetta solo parametri con valori stringa. Questi includono stringhe, numeri interi decimali e opzioni di caselle di controllo.

Linguaggi di script supportati

NinjaOne supporta i seguenti linguaggi di script:

JavaScript
PowerShell
Batch
ShellScript
VBS Script

Applicazioni automatizzate

Gli amministratori possono configurare script per eseguire o installare un'applicazione. Le opzioni di automazione "Esegui " e "Installa" consentono di creare una libreria di script di applicazioni installate ed in esecuzione da aggiungere a una politica o a un'attività pianificata, oppure da eseguire su richiesta. Ad esempio, se si esegue CCleaner sugli endpoint, è possibile utilizzare NinjaOne per richiamarlo.

Una volta installata un'applicazione nella Libreria di automazione, è possibile utilizzarla più volte su diverse organizzazioni e dispositivi. Per ulteriori informazioni, consultare NinjaOne Endpoint Management: Esegui o installa automazioni delle applicazioni.

Aggiungere nuovi script

Per aggiungere nuovi script, completare i seguenti passaggi:

Configurare i parametri di scripting

Accedere a Amministrazione → Libreria → Automazione, quindi fare clic su Aggiungi automazione → Nuovo script.

automation_add new script.png — **Figura 1**: Aggiungi un nuovo script (clicca per ingrandire)

Si aprirà la pagina Crea script. Configurare i seguenti parametri in base ai requisiti linguistici di ciascuno script:

Parametro	Descrizione
Nome	Assegnare allo script un nome descrittivo.
Descrizione	Aggiungi una descrizione facoltativa che spieghi la funzione dello script.
Categorie	Scegli le categorie della Libreria di automazione in cui desideri inserire lo script. Puoi selezionare una o più categorie.
Linguaggio	Seleziona la lingua in cui scriverai lo script. La formattazione dei comandi cambierà automaticamente in base alla lingua selezionata.
Sistema operativo	Seleziona il sistema operativo appropriato per lo script. Questa opzione sarà disattivata finché non selezioni una lingua.
Architettura	Seleziona un'architettura a 32 bit o a 64 bit.
Esegui come	Specifica il ruolo con cui verrà eseguito lo script. Queste opzioni cambieranno in base al sistema operativo selezionato.
Variabili dello script	Fare clic su Aggiungi per scegliere le variabili dello script dal menu a discesa. Per ulteriori informazioni sulle variabili dello script, consultare NinjaOne Endpoint Management: Utilizzo delle variabili negli script di automazione.
Parametri	Definire i parametri che accetteranno gli argomenti dalle chiamate per i valori dei parametri. Per ulteriori informazioni sui parametri, consultare NinjaOne Endpoint Management: Parametri di automazione.

**Figura 2**: Editor di script → configura impostazioni (clicca per ingrandire)

Scrivi e implementa lo script

Inserisci lo script nel riquadro di modifica. Se desideri che lo script interagisca con i dati dei campi personalizzati, digita Ctrl+Spazio. Digita Get o Set per accedere agli snippet, ovvero elementi costitutivi che puoi utilizzare per leggere o scrivere in script personalizzati specifici. Per ulteriori informazioni, consulta Lettura o scrittura in campi personalizzati negli script. Al termine, fai clic su Salva per salvare lo script.

**Figura 3**: Snippet nell'editor di script (clicca per ingrandire)

Lo script è ora disponibile per l'uso nell'automazione pianificata come attività pianificata o come esecuzione manuale. Per ulteriori informazioni, consultare le seguenti risorse:

Importazione di nuovi script

Per importare nuovi script o file in NinjaOne, procedere come segue:

Accedere a Amministrazione → Libreria → Automazione, quindi fare clic su Aggiungi automazione → Importa da file o Importa da modello.

**Figura 4**: Importazione di script (clicca per ingrandire)

Selezionare il file dello script che si desidera importare. Se si sceglie di importare da un modello, NinjaOne reindirizzerà l'utente alla scheda Libreria modelli, dove sarà possibile selezionare uno degli script nativi offerti da NinjaOne. Per ulteriori informazioni sugli script presenti nella Libreria modelli, consultare NinjaOne Endpoint Management: Script di automazione nativi.

Ordina e filtra gli script di automazione nella Libreria di automazione

È possibile modificare i parametri di ordinamento nelle impostazioni della tabella della Libreria di automazione eseguendo i seguenti passaggi:

Nella Libreria di automazione, fare clic sull'icona a forma di ingranaggio.

automation_table settings.png — **Figura 5**: Impostazioni della tabella della Libreria di automazione (clicca per ingrandire)

Seleziona i criteri di ordinamento. Puoi ordinare, aggiungere, rimuovere e riordinare la visualizzazione delle colonne. Per riordinare le colonne visualizzate nella pagina, fai clic e tieni premuto il nome della colonna, quindi trascinala verso l'alto o verso il basso. Al termine, fai clic su Salva.

Modifica, copia o eliminazione di script o applicazioni esistenti

Quando si lavora con script esistenti, tenere presente quanto segue:

È possibile modificare, copiare o eliminare solo script e applicazioni personalizzati.
Non è possibile eliminare gli script nativi di NinjaOne, ma è possibile modificarne le categorie.
È possibile eliminare o modificare le applicazioni Esegui e Installa, ma non è possibile copiarle.
È possibile solo eliminare o visualizzare i programmi di installazione legacy.

Procedura

Accedere a Amministrazione → Libreria → Automazione e posizionare il cursore su uno script o un'applicazione. Fare clic sull'icona con i puntini di sospensione per visualizzare le opzioni del menu.

automation_edit copy delete.png — **Figura 6**: Modifica, copia o eliminazione di un'automazione (clicca per ingrandire)

Fare clic su Modifica per aprire l'editor di script e apportare le modifiche. Fare clic su Salva per finalizzare il nuovo script.
Fare clic su Elimina per rimuovere lo script o l'applicazione dalla libreria. Se si elimina una categoria, NinjaOne la etichetterà come Senza categoria.
Seleziona Copia per creare un nuovo script identico a quello originale. NinjaOne ti chiederà di assegnare un nome al nuovo script. Al termine, clicca su Salva.

Automazioni in fase di revisione

Quando aggiungi un'applicazione di installazione alla Libreria delle automazioni, questa apparirà nella scheda In revisione prima di passare alla scheda Automazioni.

Mentre le automazioni sono in fase di revisione, NinjaOne convalida i file primari e di supporto per assicurarsi che siano privi di malware, virus o problemi relativi all'URL di installazione che potrebbero causare errori nell'applicazione.

automation under review.png — **Figura 7**: Automazioni in fase di revisione (clicca per ingrandire)

Libreria dei modelli

La Libreria dei modelli è una raccolta di script scritti dal team interno di sviluppo script di NinjaOne, compilati sulla base delle richieste più frequenti della comunità NinjaOne. NinjaOne fornisce questi script "così come sono" ed è responsabilità dell'utente testarli e valutarli prima dell'implementazione.

Per ulteriori informazioni sugli script presenti nella Libreria dei modelli, consultare NinjaOne Endpoint Management: Script di automazione nativi.

Risorse aggiuntive

Per un elenco delle domande frequenti sulla Libreria di automazioni, consultare Libreria di automazioni: Domande frequenti.

Fare riferimento a Scripting, Automazione, CLI: Catalogo delle risorse per ulteriori informazioni sull'automazione in NinjaOne.