Commandes personnalisées Android

Exécuter des actions à distance en utilisant des commandes personnalisées sur les appareils Android gérés.

En plus des actions par défaut disponibles dans le portail IBM® MaaS360®, vous pouvez utiliser des commandes personnalisées pour exécuter des actions dynamiques sur les appareils gérés. Après avoir envoyé une commande personnalisée, vous pouvez suivre l'état d'exécution de toutes les commandes dans la page Historique des périphériques du portail IBM MaaS360. Cette fonctionnalité nécessite l'application Android d' MaaS360, version 7.40, et ultérieures.

Commandes personnalisées prises en charge

IBM MaaS360 prend en charge les commandes personnalisées Android suivantes.
Action Description Commande
Activer le mode kiosque Lance Kiosk mode sur les appareils.
Les conditions suivantes doivent être remplies.
  • Kiosk mode n'est pas déjà activé sur les appareils cibles.
  • L'activation en mode silencieux est autorisé.
  • Kiosk mode est activée dans les politiques de MDM.
 enable-kiosk
Lancer l'application Démarre l'application spécifiée sur l'appareil.
Les conditions suivantes doivent être remplies.
  • L'application cible doit être installée sur les appareils.
 launch-app <package name>.
Exemples,
  • launch-app com.google.android.gm
  • launch-app us.zoom.videomeetings
Démarrage d'activité Démarre une instance de l'activité qui a une intention.
Prise en charge de l'appareil
  • L' administration des appareils est prise en charge par la version 9 ou antérieure d'Android.
  • Profile Owner est compatible avec la version 9 ou antérieure d'Android.
  • Device Owner est pris en charge par toutes les versions du système d'exploitation.
  • Le profil de travail en entreprise (WPCO) n'est pas pris en charge.
Les conditions suivantes doivent être remplies.
  • À des fins explicites, vous pouvez lancer les activités des paquets installés sur l'appareil uniquement.
 start-activity <intent options>
Début de la diffusion Diffuse l'intention spécifiée sur l'appareil. send-broadcast <intent options>
Effacer les données d'application Efface les données d'application. Cette commande prend en charge plusieurs ID application. Les exigences sont les suivantes.
  • Nécessite l'application MaaS360 pour Android version 7.60 ou ultérieure.
  • Pris en charge uniquement sur les appareils Android Enterprise avec la version 9 du système d'exploitation ou une version ultérieure.
  • L'action échoue si les applications cible ne sont pas installées sur l'appareil.
 clear-app-data <comma-separated app IDs>
  • clear-app-data com.ibm.security.verifyapp, com.ibm.gts.banorte.epass
Télécharger eSIM Télécharge la eSIM sur l'appareil. Les exigences sont les suivantes.
  • appareil compatible eSIM
  • Appareils Android à partir de la version 15
 <download e-sim options>
Supprimer l' eSIM Supprime la eSIM de l'appareil. Les exigences sont les suivantes.
  • appareil compatible eSIM
  • Appareils Android à partir de la version 15
 <delete e-sim options>
Réinitialiser les éléments du lanceur dans le kiosque Réinitialise les icônes du lanceur sur l'écran d'accueil du kiosque aux positions définies par la politique.
Note : Cette commande peut être utilisée lorsque l'option Autoriser l'utilisateur à réorganiser les icônes est activée dans la stratégie. La version du lanceur Kiosk doit être 9.17 ou ultérieure.
Les messages d'erreur suivants s'affichent lorsque les conditions ne sont pas remplies.
  • 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
Désinstaller une application

Les conditions suivantes doivent être remplies.

  • L'appareil doit être en mode d'enregistrement DeviceOwner.
  • L'application doit être installée sur l'appareil.
  • L'application ne doit pas être marquée comme application obligatoire dans la politique MDM.
  • L'application ne doit pas être une application système.
Les messages d'erreur suivants s'affichent lorsque les conditions ne sont pas remplies.
  • Si l'appareil n'est pas inscrit en mode Device Owner (Propriétaire de l'appareil), le message « Silent uninstall command is only supported on Device owner devices » (L'appareil n'est pas inscrit en mode Device Owner (Propriétaire de l'appareil)) s'affiche.
  • Si le nom du package ou tout autre paramètre n'est pas spécifié lors de l'ajout de la commande, alors Action failed. Invalid command s'affiche.
  • Lorsque l'application est introuvable sur l'appareil, le message « Application not found on the device » s'affiche. Pendant ce message, l'action est marquée comme réussie.
  • Si l'application est une application système et ne peut pas être désinstallée, le message « System installed App cannot be uninstalled » s'affiche.
 uninstall-single-app <packageName>
Envoyer un fichier par téléchargement Ajoute la possibilité de télécharger un fichier directement vers un chemin spécifié sur n'importe quel appareil en utilisant une action de commande personnalisée. Les fichiers peuvent être téléchargés à partir d'un site https:// URL ou en intégrant les données du fichier directement dans la commande personnalisée. Pour plus d'informations, consultez la commande personnalisée Télécharger un fichier. upload-file [options] <destination file name and path>

Options d'intention

Le tableau suivant décrit les options d'intention prises en charge avec les exemples de commandes.
Options d'intention Description Exemple
-a Définit l'action sur l'intention
  • start-activity -a android.intent.action.VIEW liste les applications qui prennent en charge cette action.
  • send-broadcast -a 'my_action' diffuse l'action sur le système d'exploitation Android. Les applications peuvent utiliser l'action si cette dernière est enregistrée dans l'application.
  • send-broadcast -a 'my_action' -n com.example.sampleapp/.MyActivity -es EXTRA "SampleData" envoie la diffusion "my-action" à l'activité "MyActivity" de l'application exemple avec la chaîne de données sous la forme d'une paire clé-valeur (clé : "EXTRA" valeur : "SampleData" ).
-c Ajouter une catégorie à une intention start-activity -c android.intent.category.HOME -a android.intent.action.MAIN lance l'écran d' accueil.
-d Définir l'URL de données dans l'intention start-activity -a android.intent.action.VIEW -d http://www.google.com ouvre google.com dans un navigateur. La commande échoue si aucune application de navigateur n'est installée.
-t Définir le type MIME dans l'intention start-activity -t image/* -a android.intent.action.VIEW ouvre la Galerie ou toute autre application permettant d'afficher des images. Une liste d'applications s'affiche pour les applications multiples.
-n Définir le composant d'intention spécifique start-activity -n com.example.sampleapp/.SaveFileActivity ouvre l'écran Save File de l' application d'exemple. Si "SaveFileActivity" n'est pas exporté, la commande échoue.

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

(Pour les données sous forme de chaîne, vous devez utiliser des guillemets autour de la chaîne pour spécifier la valeur)

 Ajouter data/extras en tant que paire clé-valeur à l'intention -es - String

start-activity -n com.example.sampleapp/.MyActivity -es EXTRA "Life is Great" ouvre l'activité spécifique "MyActivity" et envoie la chaîne de données sous la forme d'une paire clé-valeur (clé : "EXTRA" valeur : "Life is Great") à l'activité. Si "MyActivity" n'est pas exporté, la commande échoue.
-eb - Boolean
start-activity -n com.example.sampleapp/.MyActivity -eb Status true ouvre l'activité spécifique "MyActivity" et envoie les données booléennes sous la forme d'une paire clé-valeur (clé : "Status" valeur : true) à l'activité.
Remarque : si "MyActivity" n'est pas exporté, la commande échoue.
-ed - Double/Float

start-activity -n com.example.sampleapp/.MyActivity -ed Code 999.9878 ouvre l'activité spécifique "MyActivity" et envoie les données doubles ou flottantes sous la forme d'une paire clé-valeur (clé : "Code" valeur : 999.9878 ) à l'activité. Si "MyActivity" n'est pas exporté, la commande échoue.
-ei - Integer

start-activity -n com.example.sampleapp/.MyActivity -ei Code 999 ouvre l'activité spécifique "MyActivity" et envoie les données entières sous la forme d'une paire clé-valeur (clé : "Code" valeur : 999) à l'activité. Si "MyActivity" n'est pas exporté, la commande échoue.
-esa - String Array

start-activity -n com.example.sampleapp/.MyActivity -esa Months "[Jan,Feb,March]" ouvre l'activité spécifique "MyActivity" et envoie les données du tableau de chaînes sous la forme d'une paire clé-valeur (clé : "Months" valeur : "[Jan,Feb,Mar]") à l'activité. Si "MyActivity" n'est pas exporté, la commande échoue.
-eba - Boolean Array

start-activity -n com.example.sampleapp/.MyActivity -eba Status [true, false, false, false] ouvre l'activité spécifique "MyActivity" et envoie les données du tableau booléen sous la forme d'une paire clé-valeur (clé : "Status" valeur : [true, false, false, false]) à l'activité. Si "MyActivity" n'est pas exporté, la commande échoue.
-eda - Double/Float Array

start-activity -n com.example.sampleapp/.MyActivity -eda Codes [10.33, 12.33, 14.33, 15.33] ouvre l'activité spécifique "MyActivity" et envoie les données du tableau double ou flottant sous la forme d'une paire clé-valeur (clé : "Codes" valeur : 10.33, 12.33, 14.33, 15.33 ]) à l'activité. Si "MyActivity" n'est pas exporté, la commande échoue.
-eia - Integer Array

start-activity -n com.example.sampleapp/.MyActivity -eia Codes [998, 999, 1000] ouvre l'activité spécifique "MyActivity" et envoie les données du tableau d'entiers sous la forme d'une paire clé-valeur (clé : "Codes" valeur : [998, 999, 1000]) à l'activité. Si "MyActivity" n'est pas exporté, la commande échoue.
-en - Null

start-activity -n com.example.sampleapp/.MyActivity -en DataValue null ouvre l'activité spécifique "MyActivity" et envoie les données null sous la forme d'une paire clé-valeur (clé : "DataValue" valeur : null) à l'activité. Si "MyActivity" n'est pas exporté, la commande échoue. Pour transmettre la valeur null, utilisez l'option -en. Si vous utilisez d'autres options à cette fin, la commande échoue.

Options de Download-eSIM

Le tableau suivant décrit les options de download-eSIM prises en charge avec les exemples de commandes.

La structure de commandement est download-esim -ac LPA:1$<SDMP+ADDRESS>$<ACTIVATION_CODE>

Options de téléchargement Description Obligatoire ou facultatif Exemple
-ac Définir le code d'activation eSIM Requis download-esim -ac LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL
-sd Indiquez si vous souhaitez passer automatiquement à la eSIM après le téléchargement. Les valeurs sont true ou false (par défaut).
Remarque :
  • Cette option nécessite le mode Propriétaire de l'appareil.
  • La valeur est fixée par défaut à false pour le mode Propriétaire de profil.
Facultatif download-esim -sd true -ac LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL
-sn Indiquer si l'utilisateur doit être averti après le téléchargement. Les valeurs sont true (par défaut) ou false. Facultatif download-esim -sn false -ac LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL
-fd Indiquez si vous souhaitez forcer le téléchargement de eSIM en cas d'erreur résoluble de SIM. Les valeurs sont true ou false (par défaut).
Remarque :
  • Si une erreur SIM résoluble se produit pendant le téléchargement de eSIM, définissez -fd=true pour activer le téléchargement forcé et demander à l'appareil de s'exécuter. Pour afficher les actions connexes et les détails de l'erreur, allez dans l'onglet Historique de la page Détails du dispositif.
  • Cette option est conseillée pour les téléphones à double carte SIM et n'est prise en charge que sur les appareils inscrits en mode Propriétaire d'appareil (DO).
 Facultatif download-esim -fd true -ac LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL

Options de Delete-eSIM

Le tableau suivant décrit les options delete-eSIM prises en charge avec les exemples de commandes.
Options de suppression Description Obligatoire ou facultatif Exemple
-ic Définir le numéro ICCID de la eSIM Requis delete-esim -ic 8988303000000614227
-sn Indiquer si l'utilisateur doit être averti après le téléchargement. Les valeurs sont true (par défaut) ou false. Facultatif delete-esim -sn false -ic 8988303000000614227

Exigences requises pour les commandes personnalisées

  • Les crochets < et > ne sont pas pris en charge.
  • Vous ne pouvez pas utiliser le mot script, ni les signes &lt et &gt plus d'une fois.
  • Le nombre maximal de caractères autorisés est 2500.

Envoi de commandes personnalisées à des appareils

Vous pouvez lancer des commandes personnalisées à un appareil individuel ou à un groupe d'appareils.

Important : Vous pouvez envoyer les commandes personnalisées eSIM depuis le portail IBM MaaS360 vers un appareil individuel uniquement pour Android. Vous ne pouvez pas envoyer les commandes à un groupe d'appareils car les paramètres sont spécifiques à un seul appareil.
Pour envoyer des commandes personnalisées à un appareil individuel, procédez comme suit.
  1. Allez dans Appareil > Résumé, puis sélectionnez un appareil.
  2. Sur la page Résumé de l'appareil, cliquez sur Plus et sélectionnez Commande personnalisée Android.
  3. Saisissez la commande personnalisée et cliquez sur Exécuter.
Pour envoyer des commandes personnalisées à un groupe d'appareils, procédez comme suit.
  1. Allez dans Appareils > Groupes.
  2. Survolez l'option Plus pour le groupe d'appareils et sélectionnez Gérer les appareils Android.
  3. Dans la fenêtre Gérer les dispositifs Android, sélectionnez Commande personnalisée Android dans Action.
  4. Saisissez la commande personnalisée et cliquez sur Exécuter.

Suivi du statut d'exécution des commandes

Vous pouvez consulter l'état d'exécution de toutes les commandes qui ont été émises vers le dispositif sélectionné dans la page Historique du dispositif. Lorsque la commande personnalisée est exécutée, les états suivants sont renvoyés.
  • Terminé, si l'action a été mise en œuvre avec succès sur l'appareil.
  • Erreur, si l'action n'a pas été exécutée. Les détails de l'erreur sont affichés dans la colonne Description de l'erreur.