Tutti gli script
Applicabile a: dispositivi macOS e Windows
Nella pagina Amministratore > Script e file > Tutti gli script, Ivanti Neurons per MDM consente agli utenti con ruolo Gestione sistemi di creare o caricare e gestire script utilizzabili nelle configurazioni e distribuiti ai dispositivi. È possibile associare attributi personalizzati agli script e assegnare i valori risultanti ai dispositivi configurati. Utilizzare Audit Trail per visualizzare i registri delle modifiche allo script e la pagina Dettagli dispositivo per visualizzare i risultati dell'esecuzione.
È possibile creare uno script che configura qualunque impostazione sui dispositivi. Ad esempio, è possibile eseguire script che:
- imporre agli utenti del dispositivo di cambiare la password mensilmente,
- bloccare lo schermo dopo 5 minuti di inattività o
- configurare una rete WiFi protetta.
Argomenti della sezione:
Aggiunta di uno script
È possibile creare o caricare un repository di script bash (per macOS) e script ps1 (per Windows). Tale repository può essere utilizzato in una configurazione per selezionare uno script e distribuirlo per l'esecuzione sui dispositivi in base alla pianificazione specificata nella configurazione.
Ad esempio, è possibile creare uno script della shell da eseguire nei dispositivi. Se necessario, è possibile utilizzare wrapper. L'esecuzione di file binari dall'interno di uno script della shell non è supportata.
Ivanti raccomanda vivamente di testare gli script della shell prima di eseguirli sui dispositivi, per verificarne la qualità e l'affidabilità. Eseguire lo script localmente e correggere eventuali errori che risultano.
Procedura
- Andare in Amministratore > Script > Tutti gli script.
- Fare clic su + Aggiungi.
- Immettere un nome e una descrizione per lo script.
- Sotto Tipo di piattaforma, selezionare macOS o Windows.
- Selezionare uno degli Script Type seguenti:
- bash
- zsh
- python
- swift
- ps1
- Selezionare la casella di controllo Esegui come utente root per eseguire lo script come utente root sui dispositivi. Per impostazione predefinita, questa opzione è cancellata.
- Nell'Editor script è possibile digitare, trascinare o copiare e incollare uno script nella casella di testo.
- In alternativa, fare clic su Importa codice da uno script per trascinare un file di script esistente oppure fare clic su Scegli file per cercare e selezionare il file dello script da caricare in Ivanti Neurons per MDM. Qualsiasi script esistente nell'editor di script verrà sostituito. Questa azione non può essere annullata. Fare clic su Importa. Il codice dello script caricato verrà visualizzato nell'editor di script.
- (Facoltativo) Nella sezione Attributi personalizzati disponibili selezionare uno o più attributi personalizzati dei dispositivi per associarli allo script. Tali attributi possono essere utilizzati per assegnare i valori dei risultati dell'esecuzione dello script agli attributi personalizzati dei dispositivi configurati. Fare clic su Codice esempio per attributi personalizzati per visualizzare un esempio di codice che utilizza attributi personalizzati in uno script.
- Fare clic su Salva.
I nomi degli attributi personalizzati nello script devono scritti in lettere minuscole. Gli attributi personalizzati referenziati in uno script non possono essere rimossi. Se si modifica un attributo personalizzato associato a uno script (ad esempio, si cambia il nome), è necessario apportare le modifiche corrispondenti anche agli script associati.
Modifica di uno script
Per modificare o rimuovere uno script:
- Andare in Amministratore > Script > Tutti gli script.
- Nella colonna Azioni dello script, fare clic sull'icona corrispondente all'azione di modifica o eliminazione.
- Seguire le istruzioni visualizzate per completare l'azione.
Quando uno script viene modificato (contenuto, nome, descrizione), tutte le configurazioni associate allo script vengono redistribuite ai dispositivi.
Utilizzo di variabili script (applicabili a Windows e macOS)
Definire e memorizzare gli input di script come le variabili di ambiente e sostituzione nel repository degli script. Nella configurazione degli script Mobile@Work for macOS o nella configurazione di Ivanti Bridge for Windows Scripts and Actions, a seconda dello script collegato, le variabili script correlate saranno disponibili per l'uso come richiesto. Per macOS, questa funzionalità richiede Mobile@Work per macOS 1.71.0 fino alla versione più recente supportata da Ivanti Neurons per MDM. Per Windows, questa funzione richiede Ivanti Bridge.
Utilizzare le variabili per eseguire uno script con valori diversi ogni volta che viene eseguito. Ad esempio, un amministratore può creare uno script per utilizzare la variabile di ambiente $ come variabile di script e associarla a Mobile@Work per la configurazione di script macOS o la configurazione Windows. Quando la configurazione viene distribuita e installata su ciascun dispositivo degli utenti, Ivanti Neurons per MDM invia un indirizzo e-mail utente registrato diverso per ogni dispositivo perché siano intraprese determinate azioni. Il portale amministrativo di Ivanti Neurons per MDM supporta le variabili personalizzate.
Per aggiungere una variabile di script:
- Andare in Amministratore > Script > Tutti gli script.
- Nella sezione Input script, fare clic su + Aggiungi.
- Nella pagina pop-up Aggiungi input script - Variabile di ambiente, inserire i seguenti dati:
- Etichetta da mostrare - Questo testo verrà visualizzato come etichetta nella pagina di configurazione script di Mobile@Work per macOS. Ad esempio, Inserire cartella SO, Inserire numero Apache, e così via.
- Nome variabile di ambiente - Per esempio, JAVA_HOME, OS_VERSION, e così via. Ivanti Neurons per MDM sostituisce i valori delle variabili di script durante l'invio dei dettagli di configurazione a un dispositivo di destinazione, mentre i valori vengono mantenuti nel database.
- Valore predefinito variabile di ambiente - Per esempio, 1024, $, e così via. Le variabili di input possono essere utilizzate nello script caricato o modificato da un amministratore. Vedere anche le seguenti note.
Nell'area Anteprima, rivedere come il valore di una variabile di ambiente verrà mostrato come input script nella pagina di configurazione.
- Fare clic su Salva.
In questo modo, solo l'etichetta e il valore predefinito sono disponibili per la configurazione e non il nome della variabile di ambiente, che fornisce un livello di astrazione.
- Un valore alfanumerico (per esempio, 1024 bin/java, root@localhost) o attributi di sistema (per esempio, $) sono accettabili come valori della variabile di ambiente.
- Il valore della variabile di ambiente può essere modificato o eliminato durante il deployment nella pagina di configurazione.
- Se il valore della variabile di ambiente non viene fornito, assicurarsi che venga fornito un valore durante il deployment dello script. In caso contrario, allo script verrà passato un valore vuoto.
- Dopo che una configurazione dello script è stata distribuita e installata sul dispositivo, la modifica delle variabili di ambiente nella pagina Amministratore > Script e file > Tutti gli script non avrà alcun impatto sulle configurazioni esistenti associate allo script. Vedere anche Configurazione di script in Mobile@Work per macOS. Per Windows, vedere Configurazione di Ivanti Bridge for Windows Scripts and Actions.
Modifica di una variabile di script
Per modificare una variabile di script, fare clic sull'icona di modifica (matita) accanto alla variabile e salvare le modifiche.
Se una configurazione di script si riferisce a uno script con variabili di script, la modifica dell'etichetta di una variabile di script esistente si rifletterà anche nella configurazione dello script. Tuttavia:
- Un cambiamento nel valore predefinito della variabile di script non si rifletterà nelle configurazioni esistenti.
- Un cambiamento nel valore predefinito della variabile di script si rifletterà in tutte le nuove configurazioni create con lo script precedente.
Eliminazione di una variabile di script
Per eliminare una variabile di script, fare clic sull'icona di eliminazione (segno meno) accanto alla variabile e confermare.
Una variabile di script appena creata, o l'eliminazione di una variabile di script esistente, si rifletterà anche in una configurazione già esistente.
Test di script
Eseguire il test di uno script nello strumento di debug velocemente prima di testarlo su un dispositivo e senza necessariamente salvare gli script.
Prerequisiti
- For macOS, questa funzionalità richiede Mobile@Work per macOS 1.67 fino alla versione più recente supportata da Ivanti Neurons per MDM.
- Per Windows, questa funzione richiede la Configurazione di Ivanti Bridge per Windows Scripts and Actions.
Procedura
- Andare in Amministratore > Script > Tutti gli script.
- Nell'editor di script, aggiungere o importare uno script.
- Se il tenant include più spazi, selezionare uno spazio.
- Nella sezione Test script, selezionare macOS o Windows come piattaforma.
- Nel campo di testo Trova dispositivi, trovare e selezionare il dispositivo in cui è possibile testare lo script. È possibile cercare il dispositivo in base al numero di serie, al nome utente, al nome dispositivo e alla versione del sistema operativo.
- Fare clic su Effettua test. In questo modo, una variabile di ambiente può essere aggiunta, modificata ed eliminata e lo script può essere testato con quello stato (senza nemmeno salvare le modifiche apportate). Per lo Script Windows, a schermo viene visualizzata una finestra pop-up in cui verrà avviata l'esecuzione dello Script e dopo qualche tempo sarà possibile visualizzare lo stato dalla scheda Registri dettagli dispositivo.
- Fare clic su Salva.
- Per macOS, attendere che lo script venga inviato ed eseguito nel dispositivo.
- Esaminare i risultati del test pubblicati nelle sezioni Input script (contenente i dettagli della variabile di ambiente), Output script, e Attributi personalizzati sezioni. Vengono visualizzati anche i valori predefiniti delle variabili di ambiente.
Verifica dei risultati dell'esecuzione di uno script
Per visualizzare i registri dei risultati dell'esecuzione di uno script:
- Andare su Dispositivi.
- Fare clic sul nome del dispositivo.
- Fare clic sulla scheda Registri.
- Nella riga che mostra l'azione Esecuzione script, è possibile verificare le informazioni seguenti:
- Nome dello script nella colonna Dettagli.
- Stato di esecuzione dello script nella colonna Stato.
- Data e ora di esecuzione dello script nella colonna Data.
- Registri di esecuzione dello script (plist di registri del dispositivo), facendo clic sull'icona dell'occhio nella colonna Azione.
Utilizzare i filtri per visualizzare le righe Esecuzione script. I registri di tali righe includono l'output (plist) per l'output standard e gli errori standard per gli script.
- Per visualizzare le righe Elaborazione risultato esecuzione script, utilizzare i filtri. I registri di tali righe includono i dettagli (plist) relativi alla modalità di elaborazione dei risultati.
- Se a uno script non sono associati attributi personalizzati, non viene generato alcun risultato da elaborare. Tali script non vengono visualizzati nell'elenco delle righe filtrate.
- Se a uno script sono associati attributi personalizzati e tali attributi sono nel formato previsto, gli attributi personalizzati dei risultati vengono mappati e viene visualizzato lo stato Operazione riuscita. Gli attributi personalizzati mappati e i relativi valori possono essere verificati nella scheda Attributi.
- Se a uno script sono associati attributi personalizzati e tali attributi non sono nel formato previsto, gli attributi personalizzati dei risultati non vengono mappati e viene visualizzato lo stato Errore.
- Se il formato dei risultati è corretto ma non tutti gli attributi personalizzati associati vengono inviati nel risultato, viene visualizzato lo stato Errore.
- Se una variabile di script viene inviata con lo script, i registri Elaborazione risultato esecuzione script includeranno dettagli (plist) della variabile di script.
Argomenti correlati:
