Comandi personalizzati Android

Eseguire azioni remote utilizzando comandi personalizzati sui dispositivi Android gestiti.

Oltre alle azioni predefinite disponibili nel portale IBM® MaaS360®, l'amministratore può utilizzare comandi personalizzati per eseguire azioni dinamiche sui dispositivi gestiti. Dopo aver inviato un comando personalizzato, è possibile monitorare lo stato di esecuzione di tutti i comandi nella pagina Cronologia dispositivo del portale IBM MaaS360. Questa funzione richiede l'applicazione Android " MaaS360 " versione 7.40 e successive.

Comandi personalizzati supportati

IBM MaaS360 supporta i seguenti comandi personalizzati di Android.
Azione Descrizione Comando
Abilita modalità a schermo intero Avvia Kiosk mode sui dispositivi.
Devono essere soddisfatti i seguenti requisiti.
  • Kiosk mode non sia già attivato sui dispositivi di destinazione.
  • L'abilitazione non presidiata è consentita.
  • Kiosk mode è abilitato nei criteri MDM.
 enable-kiosk
Avvia app Avvia l'applicazione specificata sul dispositivo.
Devono essere soddisfatti i seguenti requisiti.
  • L'app di destinazione deve essere installata sul dispositivo.
 launch-app <package name>.
Esempi,
  • launch-app com.google.android.gm
  • launch-app us.zoom.videomeetings
Avvia attività Avvia un'istanza dell'attività che ha un intento.
Supporto dispositivo
  • Device Admin è supportato dalla versione 9 o precedente di Android.
  • Profile Owner è supportato su Android versione 9 o precedente.
  • Device Owner è supportato da tutte le versioni del sistema operativo.
  • Il profilo di lavoro su proprietà aziendale (WPCO) non è supportato.
Devono essere soddisfatti i seguenti requisiti.
  • Per scopi espliciti, è possibile avviare le attività dei soli pacchetti installati sul dispositivo.
 start-activity <intent options>
Avvia broadcast Trasmettere l'intento specificato al dispositivo. send-broadcast <intent options>
Cancella dati app Cancella i dati app. Questo comando supporta più ID app. I requisiti sono i seguenti.
  • Richiede l'applicazione MaaS360 per Android versione 7.60 e successive.
  • Supportato solo su dispositivi Android Enterprise con versione OS 9 e successive.
  • L'azione non riesce se le app di destinazione non sono installate sul dispositivo.
 clear-app-data <comma-separated app IDs>
  • clear-app-data com.ibm.security.verifyapp, com.ibm.gts.banorte.epass
Scaricare eSIM Scarica la eSIM sul dispositivo. I requisiti sono i seguenti.
  • dispositivo supportato da eSIM
  • Dispositivi Android con versione 15 e successive
 <download e-sim options>
Eliminare la eSIM Elimina la eSIM sul dispositivo. I requisiti sono i seguenti.
  • dispositivo supportato da eSIM
  • Dispositivi Android con versione 15 e successive
 <delete e-sim options>
Ripristino degli elementi del Launcher nel Kiosk Ripristina le icone del launcher sulla schermata iniziale del Kiosk nelle posizioni definite dal criterio.
Nota: Questo comando può essere utilizzato quando il criterio Consenti all'utente di riorganizzare le icone è abilitato. La versione del programma di avvio Kiosk deve essere 9.17 e successive.
I seguenti messaggi di errore vengono visualizzati quando le condizioni non sono soddisfatte.
  • Action failed as Kiosk app not installed.
  • Action failed. Kiosk is not enabled on the device.
  • Action failed. Reset is not supported on the installed Kiosk app version (min version of kiosk launcher has to be 9.17).
 reset-kiosk-launcher
Disinstallare singola app

Devono essere soddisfatti i seguenti requisiti.

  • Il dispositivo deve essere registrato in DeviceOwner modalità.
  • L'app deve essere installata sul dispositivo.
  • L'app non deve essere contrassegnata come app obbligatoria nella politica MDM.
  • L'app non deve essere un'app di sistema.
I seguenti messaggi di errore vengono visualizzati quando le condizioni non sono soddisfatte.
  • Se il dispositivo non è registrato in modalità Device Owner (Proprietario dispositivo), viene visualizzato Silent uninstall command is only supported on Device owner devices (Il dispositivo non è registrato in modalità Device Owner).
  • Se il nome del pacchetto o qualsiasi altro parametro non sono specificati quando si aggiunge il comando, viene visualizzato Action failed. Invalid command .
  • Se l'app non viene trovata sul dispositivo, viene visualizzato Application not found on the device . Durante questo messaggio, l'azione viene contrassegnata come riuscita.
  • Se l'app è un'app di sistema e non può essere disinstallata, viene visualizzato System installed App cannot be uninstalled .
 uninstall-single-app <packageName>
Carica file Aggiunge la possibilità di caricare un file direttamente in un percorso specificato su qualsiasi dispositivo, utilizzando un'azione di comando personalizzata. I file possono essere caricati da https:// URL o incorporando i dati del file direttamente nel comando personalizzato. Per ulteriori informazioni, consulta il comando personalizzato Carica file. upload-file [options] <destination file name and path>

Opzioni di intento

La tabella seguente descrive le opzioni di intento supportate con i comandi di esempio.
Opzioni di intento Descrizione Esempio
-a Imposta l'azione sull'intento
  • start-activity -a android.intent.action.VIEW elenca le applicazioni che supportano questa azione.
  • send-broadcast -a 'my_action' trasmette l'azione sul sistema operativo Android. Le app possono utilizzare l'azione se l'azione è registrata sull'app.
  • send-broadcast -a 'my_action' -n com.example.sampleapp/.MyActivity -es EXTRA "SampleData" invia il broadcast "my-action" all'attività "MyActivity" dell'applicazione campione con la stringa di dati sotto forma di coppia chiave-valore (chiave: "EXTRA" valore: "SampleData" ).
-c Aggiungi una categoria a un intento start-activity -c android.intent.category.HOME -a android.intent.action.MAIN avvia la schermata iniziale.
-d Impostare l' URL dei dati sull'intento start-activity -a android.intent.action.VIEW -d http://www.google.com apre google.com in un'applicazione del browser. Il comando non riesce se non è installata un'app browser.
-t Imposta il tipo MIME sull'intento start-activity -t image/* -a android.intent.action.VIEW apre la Galleria o qualsiasi altra applicazione che visualizzi immagini. Per le applicazioni multiple viene visualizzato un elenco di applicazioni.
-n Imposta il componente intento specifico start-activity -n com.example.sampleapp/.SaveFileActivity apre la schermata Salva file dell'applicazione campione. Se "SaveFileActivity" non è esportato, il comando fallisce.

-es, -eb, -ei, -ed, -en, -eia, -esa, -eba, -eda

(Per i dati stringa, è necessario utilizzare le virgolette intorno alla stringa per specificare il valore)

 Aggiungere data/extras come coppia chiave-valore all'intento -es - String

start-activity -n com.example.sampleapp/.MyActivity -es EXTRA "Life is Great" apre l'attività specifica "MyActivity" e invia i dati della stringa sotto forma di coppia chiave-valore (chiave: "EXTRA", valore: "Life is Great") all'attività. Se "MyActivity" non è esportato, il comando fallisce.
-eb - Boolean
start-activity -n com.example.sampleapp/.MyActivity -eb Status true apre l'attività specifica "MyActivity" e invia i dati booleani sotto forma di coppia chiave-valore (chiave: "Status" valore: true) all'attività.
Nota: se "MyActivity" non è esportato, il comando non riesce.
-ed - Double/Float

start-activity -n com.example.sampleapp/.MyActivity -ed Code 999.9878 apre l'attività specifica "MyActivity" e invia i dati double o float sotto forma di coppia chiave-valore (chiave: "Codice" valore: 999.9878 ) all'attività. Se "MyActivity" non è esportato, il comando fallisce.
-ei - Integer

start-activity -n com.example.sampleapp/.MyActivity -ei Code 999 apre l'attività specifica "MyActivity" e invia i dati interi sotto forma di coppia chiave-valore (chiave: "Codice" valore: 999) all'attività. Se "MyActivity" non è esportato, il comando fallisce.
-esa - String Array

start-activity -n com.example.sampleapp/.MyActivity -esa Months "[Jan,Feb,March]" apre l'attività specifica "MyActivity" e invia i dati dell'array di stringhe sotto forma di coppia chiave-valore (chiave: "Months" valore: "[Jan,Feb,Mar]") all'attività. Se "MyActivity" non è esportato, il comando fallisce.
-eba - Boolean Array

start-activity -n com.example.sampleapp/.MyActivity -eba Status [true, false, false, false] apre l'attività specifica "MyActivity" e invia i dati dell'array booleano sotto forma di coppia chiave-valore (chiave: "Status" valore: [true, false, false, false]) all'attività. Se "MyActivity" non è esportato, il comando fallisce.
-eda - Double/Float Array

start-activity -n com.example.sampleapp/.MyActivity -eda Codes [10.33, 12.33, 14.33, 15.33] apre l'attività specifica "MyActivity" e invia i dati dell'array double o float sotto forma di coppia chiave-valore (chiave: "Codici" valore: 10.33, 12.33, 14.33, 15.33 ]) all'attività. Se "MyActivity" non è esportato, il comando fallisce.
-eia - Integer Array

start-activity -n com.example.sampleapp/.MyActivity -eia Codes [998, 999, 1000] apre l'attività specifica "MyActivity" e invia i dati dell'array di interi sotto forma di coppia chiave-valore (chiave: "Codici" valore: [998, 999, 1000]) all'attività. Se "MyActivity" non è esportato, il comando fallisce.
-en - Null

start-activity -n com.example.sampleapp/.MyActivity -en DataValue null apre l'attività specifica "MyActivity" e invia i dati null sotto forma di coppia chiave-valore (chiave: "DataValue" valore: null) all'attività. Se "MyActivity" non è esportato, il comando fallisce. Se si desidera passare null, utilizzare l'opzione -en . Se si utilizzano altre opzioni per passare null, il comando ha esito negativo.

Opzioni di Download-eSIM

La tabella seguente descrive le opzioni di download-eSIM supportate con i comandi di esempio.

La struttura di comando è download-esim -ac LPA:1$<SDMP+ADDRESS>$<ACTIVATION_CODE>

Opzioni di download Descrizione Richiesto o facoltativo Esempio
-ac Impostare il codice di attivazione della eSIM Obbligatorio download-esim -ac LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL
-sd Selezionare se passare automaticamente alla eSIM dopo il download. I valori sono true o false (valore predefinito).
Nota:
  • Questa opzione richiede la modalità Proprietario dispositivo.
  • Il valore è impostato di default su false per la modalità Proprietario profilo.
 Facoltativo download-esim -sd true -ac LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL
-sn Selezionare se notificare l'utente dopo il download. I valori sono true (predefinito) o false. Facoltativo download-esim -sn false -ac LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL
-fd Selezionare se forzare il download di eSIM quando si verifica un errore risolvibile della SIM. I valori sono true o false (valore predefinito).
Nota:
  • Se durante il download di eSIM si verifica un errore risolvibile della SIM, impostare -fd=true per abilitare il download forzato e richiedere il dispositivo. Per visualizzare le azioni correlate e i dettagli degli errori, accedere alla scheda Cronologia nella pagina dei dettagli del dispositivo.
  • Questa opzione è consigliata per i telefoni dual-SIM ed è supportata solo sui dispositivi registrati in modalità Device Owner (DO).
 Facoltativo download-esim -fd true -ac LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL

Opzioni di Delete-eSIM

La tabella seguente descrive le opzioni delete-eSIM supportate con i comandi di esempio.
Elimina opzioni Descrizione Richiesto o facoltativo Esempio
-ic Impostare il numero ICCID della eSIM. Obbligatorio delete-esim -ic 8988303000000614227
-sn Selezionare se notificare l'utente dopo il download. I valori sono true (predefinito) o false. Facoltativo delete-esim -sn false -ic 8988303000000614227

Requisiti del comando personalizzato

  • Le parentesi angolari < e > non sono supportate.
  • Non è possibile utilizzare la parola script e i segni &lt e &gt più di una volta.
  • Il limite massimo di caratteri è 2500.

Invio di comandi personalizzati ai dispositivi

È possibile immettere comandi personalizzati per un singolo dispositivo o un gruppo di dispositivi.

Importante: è possibile inviare i comandi personalizzati eSIM dal portale IBM MaaS360 a un singolo dispositivo solo per Android. Non è possibile inviare i comandi a un gruppo di dispositivi perché i parametri sono specifici per un singolo dispositivo.
Per inviare comandi personalizzati a un singolo dispositivo, procedere come segue.
  1. Vai su Dispositivo > Riepilogo e seleziona un dispositivo.
  2. Nella pagina Riepilogo dispositivo, fare clic su Altro e selezionare Comando personalizzato Android.
  3. Immettere il comando personalizzato e fare clic su Esegui.
Per inviare comandi personalizzati a un gruppo di dispositivi, procedere come segue.
  1. Vai su Dispositivi > Gruppi.
  2. Passare il mouse sull'opzione Altro del gruppo di dispositivi e selezionare Gestisci dispositivi Android.
  3. Nella finestra Gestione dispositivi Android, selezionare Comando personalizzato Android da Azione.
  4. Immettere il comando personalizzato e fare clic su Esegui.

Traccia dello stato di esecuzione dei comandi

È possibile visualizzare lo stato di esecuzione di tutti i comandi inviati al dispositivo selezionato nella pagina Cronologia dispositivo. Quando viene eseguito il comando personalizzato, vengono restituiti i seguenti stati.
  • Completato, se l'azione è stata implementata con successo sul dispositivo.
  • Errore, se l'azione non è stata eseguita. I dettagli dell'errore sono visualizzati nella colonna Descrizione errore.