Angepasste Android-Befehle

Führen Sie Remote-Aktionen mithilfe benutzerdefinierter Befehle auf den verwalteten Android-Geräten aus.

Zusätzlich zu den im IBM® MaaS360® -Portal verfügbaren Standardgeräteaktionen können Sie benutzerdefinierte Befehle verwenden, um dynamische Aktionen auf verwalteten Geräten auszuführen. Nachdem Sie einen benutzerdefinierten Befehl gesendet haben, können Sie den Ausführungsstatus aller Befehle auf der Seite „Geräteverlauf“ im IBM MaaS360 Portal verfolgen. Diese Funktion erfordert MaaS360 für die Android-App-Version 7.40 und höher.

Unterstützte angepasste Befehle

IBM MaaS360 unterstützt die folgenden benutzerdefinierten Android-Befehle.

Aktion	Beschreibung	Befehl
Kioskmodus aktivieren	Startet `Kiosk mode` auf den Geräten. Die folgenden Anforderungen müssen erfüllt werden. `Kiosk mode` nicht bereits auf den Zielgeräten aktiviert ist. Eine unbeaufsichtigte Aktivierung ist zulässig. `Kiosk mode` in den MDM-Richtlinien aktiviert ist.	`enable-kiosk`
App starten	Startet die angegebene App auf dem Gerät. Die folgende Anforderung muss erfüllt sein. Die Ziel-App muss auf dem Gerät installiert sein.	`launch-app <package name>`. Beispiele, `launch-app com.google.android.gm` `launch-app us.zoom.videomeetings`
Aktivität starten	Startet eine Instanz der Aktivität, die eine Absicht hat. Geräteunterstützung "Device Admin" wird von Android-Version 9 oder früher unterstützt. "Profilinhaber" wird auf Android-Version 9 oder früher unterstützt. Device Owner wird auf allen Betriebssystemversionen unterstützt. Das Arbeitsprofil für unternehmenseigene (WPCO ) wird nicht unterstützt. Die folgende Anforderung muss erfüllt sein. Für bestimmte Zwecke können Sie die Aktivitäten der Pakete starten, die nur auf dem Gerät installiert sind.	`start-activity <intent options>`
Sendung starten	Überträgt die angegebene Absicht im Broadcastbetrieb an das Gerät.	`send-broadcast <intent options>`
App-Daten löschen	Löscht App-Daten. Dieser Befehl unterstützt mehrere App-IDs. Die Anforderungen sind wie folgt. Erfordert MaaS360 für Android-App, Version 7.60 und höher. Nur auf Android Enterprise-Geräten mit Betriebssystemversion 9 und höher unterstützt. Die Aktion schlägt fehl, wenn keine Zielapps auf dem Gerät installiert sind.	`clear-app-data <comma-separated app IDs>` `clear-app-data com.ibm.security.verifyapp, com.ibm.gts.banorte.epass`
eSIM herunterladen	Lädt eSIM auf das Gerät herunter. Die Anforderungen sind wie folgt. eSIM Android-Geräte mit Version 15 und höher	`<download e-sim options>`
eSIM löschen	Löscht eSIM auf dem Gerät. Die Anforderungen sind wie folgt. eSIM Android-Geräte mit Version 15 und höher	`<delete e-sim options>`
Startobjekte im Kiosk zurücksetzen	Setzt die Startsymbole auf dem Kiosk-Startbildschirm auf die in der Richtlinie festgelegten Positionen zurück. Hinweis: Dieser Befehl kann verwendet werden, wenn in der Richtlinie die Option Benutzer darf Symbole neu anordnen aktiviert ist. Die Kiosk-Launcher-Version muss oder höher 9.17 sein. Die folgenden Fehlermeldungen werden angezeigt, wenn die Bedingungen nicht erfüllt sind. `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`
Einzelne App deinstallieren	Die folgende Anforderung muss erfüllt sein. Das Gerät muss im DeviceOwner modus Die App muss auf dem Gerät installiert sein. Die App darf in der MDM-Richtlinie nicht als erforderliche App gekennzeichnet sein. Die App darf keine System-App sein. Die folgenden Fehlermeldungen werden angezeigt, wenn die Bedingungen nicht erfüllt sind. Wenn das Gerät nicht im Gerätebesitzermodus registriert ist, wird `Silent uninstall command is only supported on Device owner devices` angezeigt. Wenn der Paketname oder andere Parameter nicht angegeben werden, wenn Sie den Befehl hinzufügen, wird `Action failed. Invalid command` angezeigt. Wenn die App nicht auf dem Gerät gefunden wird, wird `Application not found on the device` angezeigt. In dieser Nachricht wird die Aktion als Erfolg gekennzeichnet. Wenn es sich bei der App um eine System-App handelt und sie nicht deinstalliert werden kann, wird `System installed App cannot be uninstalled` angezeigt.	`uninstall-single-app <packageName>`
Datei hochladen	Ermöglicht das direkte Hochladen einer Datei in einen bestimmten Pfad auf einem beliebigen Gerät mit Hilfe einer benutzerdefinierten Befehlsaktion. Dateien können entweder von einer `https://` URL hochgeladen werden oder indem die Dateidaten direkt in den benutzerdefinierten Befehl eingebettet werden. Weitere Informationen finden Sie unter Benutzerdefinierter Befehl „Datei hochladen “.	`upload-file [options] <destination file name and path>`

Optionen für Absichten

In der folgenden Tabelle werden die unterstützten Intent-Optionen mit den Beispielbefehlen beschrieben.

Optionen für Absichten	Beschreibung	Beispiel
`-a`	Legt die Aktion in der Absicht fest.	`start-activity -a android.intent.action.VIEW` listet die Apps auf, die diese Aktion unterstützen. `send-broadcast -a 'my_action'` überträgt die Aktion auf dem Android-Betriebssystem. Apps können die Aktion verwenden, wenn die Aktion in der App registriert ist. `send-broadcast -a 'my_action' -n com.example.sampleapp/.MyActivity -es EXTRA "SampleData"` sendet die Broadcast-Nachricht "my-action" an die Aktivität "MyActivity" der Beispiel-App mit den Zeichenkettendaten in Form eines Schlüssel-Wert-Paars (Schlüssel: "EXTRA", Wert: "SampleData" ").
`-c`	Fügt einer Absicht eine Kategorie hinzu.	`start-activity -c android.intent.category.HOME -a android.intent.action.MAIN` startet den Startbildschirm.
`-d`	Legt die Daten-URL in der Absicht fest.	`start-activity -a android.intent.action.VIEW -d http://www.google.com` öffnet google.com in einer Browser-App. Der Befehl schlägt fehl, wenn keine Browser-App installiert ist.
`-t`	Legt den MIME-Typ in der Absicht fest.	`start-activity -t image/* -a android.intent.action.VIEW` öffnet die Galerie oder eine beliebige App, die Bilder anzeigt. Bei mehreren Apps wird eine Liste der Apps angezeigt.
`-n`	Legt die spezielle Absichtskomponente fest.	`start-activity -n com.example.sampleapp/.SaveFileActivity` öffnet den Bildschirm "Datei speichern" der Beispiel-App. Wenn "SaveFileActivity" nicht exportiert wird, schlägt der Befehl fehl.
`-es, -eb, -ei, -ed, -en, -eia, -esa, -eba, -eda` (Bei Zeichenketten müssen Sie Anführungszeichen um die Zeichenkette verwenden, um den Wert anzugeben)	Fügen Sie `data/extras` als Schlüssel-Wert-Paar zur Absicht hinzu	`-es - String` `start-activity -n com.example.sampleapp/.MyActivity -es EXTRA "Life is Great"` öffnet die spezifische Aktivität "MyActivity" und sendet die Zeichenkettendaten in Form eines Schlüssel-Wert-Paares (Schlüssel: "EXTRA", Wert: "Life is Great") an die Aktivität. Wenn "MyActivity" nicht exportiert wird, schlägt der Befehl fehl.
		`-eb - Boolean` `start-activity -n com.example.sampleapp/.MyActivity -eb Status true` öffnet die spezifische Aktivität "MyActivity" und sendet die booleschen Daten in Form eines Schlüssel-Wert-Paares (Schlüssel: "Status", Wert: "true") an die Aktivität. Anmerkung: Wenn "MyActivity" nicht exportiert wird, schlägt der Befehl fehl.
		`-ed - Double/Float` `start-activity -n com.example.sampleapp/.MyActivity -ed Code 999.9878` öffnet die spezifische Aktivität "MyActivity" und sendet die Double- oder Float-Daten in Form eines Schlüssel-Wert-Paares (Schlüssel: "Code", Wert: 999.9878 ) an die Aktivität. Wenn "MyActivity" nicht exportiert wird, schlägt der Befehl fehl.
		`-ei - Integer` `start-activity -n com.example.sampleapp/.MyActivity -ei Code 999` öffnet die spezifische Aktivität "MyActivity" und sendet die Integer-Daten in Form eines Schlüssel-Wert-Paares (Schlüssel: "Code", Wert: 999) an die Aktivität. Wenn "MyActivity" nicht exportiert wird, schlägt der Befehl fehl.
		`-esa - String Array` `start-activity -n com.example.sampleapp/.MyActivity -esa Months "[Jan,Feb,March]"` öffnet die spezifische Aktivität "MyActivity" und sendet die Daten des String-Arrays in Form eines Schlüssel-Wert-Paares (Schlüssel: "Monate", Wert: "[Jan, Feb, Mär]") an die Aktivität. Wenn "MyActivity" nicht exportiert wird, schlägt der Befehl fehl.
		`-eba - Boolean Array` `start-activity -n com.example.sampleapp/.MyActivity -eba Status [true, false, false, false]` öffnet die spezifische Aktivität "MyActivity" und sendet die booleschen Array-Daten in Form eines Schlüssel-Wert-Paares (Schlüssel: "Status", Wert: [true, false, false, false]) an die Aktivität. Wenn "MyActivity" nicht exportiert wird, schlägt der Befehl fehl.
		`-eda - Double/Float Array` `start-activity -n com.example.sampleapp/.MyActivity -eda Codes [10.33, 12.33, 14.33, 15.33]`öffnet die spezifische Aktivität "MyActivity" und sendet die Double- oder Float-Array-Daten in Form eines Schlüssel-Wert-Paares (Schlüssel:„Codes“-Wert: [ 10.33, 12.33, 14.33, 15.33 ]) an die Aktivität. Wenn "MyActivity" nicht exportiert wird, schlägt der Befehl fehl.
		`-eia - Integer Array` `start-activity -n com.example.sampleapp/.MyActivity -eia Codes [998, 999, 1000]` öffnet die spezifische Aktivität "MyActivity" und sendet die Integer-Array-Daten in Form eines Schlüssel-Wert-Paares (Schlüssel: "Codes", Wert: [998, 999, 1000]) an die Aktivität. Wenn "MyActivity" nicht exportiert wird, schlägt der Befehl fehl.
		`-en - Null` `start-activity -n com.example.sampleapp/.MyActivity -en DataValue null` öffnet die spezifische Aktivität "MyActivity" und sendet die Null-Daten in Form eines Schlüssel-Wert-Paares (Schlüssel: "DataValue" ", Wert: null) an die Aktivität. Wenn "MyActivity" nicht exportiert wird, schlägt der Befehl fehl. Wenn Sie null übergeben möchten, verwenden Sie die Option `-en`. Wenn Sie andere Optionen zur Übergabe von null verwenden, schlägt der Befehl fehl.

Download-eSIM

In der folgenden Tabelle werden die unterstützten download-eSIM Optionen mit den Beispielbefehlen beschrieben.

Die Befehlsstruktur ist download-esim -ac LPA:1$<SDMP+ADDRESS>$<ACTIVATION_CODE>

Download-Optionen	Beschreibung	Erforderlich oder optional	Beispiel
`-ac`	Legen Sie eSIM fest	Erforderlich	`download-esim -ac LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL`
`-sd`	Wählen Sie aus, ob nach dem Download automatisch eSIM gewechselt werden soll. Die Werte sind `true` oder `false` (Standard). Hinweis: Diese Option erfordert den Gerätebesitzermodus. Der Wert ist standardmäßig auf `false` für den Profilbesitzer-Modus eingestellt.	Optionale	`download-esim -sd true -ac LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL`
`-sn`	Wählen Sie aus, ob der Benutzer nach dem Download benachrichtigt werden soll. Die Werte sind `true` (Standard) oder `false`.	Optionale	`download-esim -sn false -ac LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL`
`-fd`	Legen Sie fest, ob der Download von eSIM erzwungen werden soll, wenn ein durch SIM behebbarer Fehler auftritt. Die Werte sind `true` oder `false` (Standard). Hinweis: Wenn während des Herunterladens von eSIM ein behebbarer SIM-Fehler auftritt, stellen Sie `-fd=true` ein, um das erzwungene Herunterladen zu aktivieren und das Gerät aufzufordern. Um zugehörige Aktionen und Fehlerdetails anzuzeigen, gehen Sie auf der Seite Gerätedetails auf die Registerkarte Verlauf. Diese Option wird für Dual-SIM-Telefone empfohlen und wird nur auf Geräten unterstützt, die im Modus "Gerätebesitzer" (DO) angemeldet sind.	Optionale	`download-esim -fd true -ac LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL`

Optionen Delete-eSIM

In der folgenden Tabelle werden die unterstützten Optionen delete-eSIM mit den Beispielbefehlen beschrieben.

Optionen löschen	Beschreibung	Erforderlich oder optional	Beispiel
`-ic`	Legen Sie die ICCID-Nummer eSIM fest.	Erforderlich	`delete-esim -ic 8988303000000614227`
`-sn`	Wählen Sie aus, ob der Benutzer nach dem Download benachrichtigt werden soll. Die Werte sind `true` (Standard) oder `false`.	Optionale	`delete-esim -sn false -ic 8988303000000614227`

Voraussetzungen für angepasste Befehle

Die spitzen Klammern < und > werden nicht unterstützt.
Sie können das Wort script und die Zeichen &lt und &gt nicht mehr als einmal verwenden.
Die maximal zulässige Anzahl von Zeichen ist 2500.

Angepasste Befehle mit Push an Geräte übertragen

Sie können angepasste Befehle an ein einzelnes Gerät oder an eine Gruppe von Geräten absetzen.

Wichtig: Sie können die benutzerdefinierten eSIM -Befehle vom IBM MaaS360 Portal nur für Android an ein einzelnes Gerät senden. Sie können die Befehle nicht an eine Gruppe von Geräten senden, da die Parameter für ein einzelnes Gerät spezifisch sind.

Um benutzerdefinierte Befehle an ein einzelnes Gerät zu senden, gehen Sie wie folgt vor.

Gehen Sie zu „Gerät > Zusammenfassung“ und wählen Sie dann ein Gerät aus.
Klicken Sie auf der Seite "Geräteübersicht" auf "Mehr" und wählen Sie "Android-Benutzerdefinierter Befehl" aus.
Geben Sie den benutzerdefinierten Befehl ein und klicken Sie auf "Ausführen ".

Um benutzerdefinierte Befehle an eine Gruppe von Geräten zu senden, gehen Sie wie folgt vor.

Gehen Sie zu „Geräte “ > „Gruppen “.
Bewegen Sie den Mauszeiger über die Option "Mehr" für die Gerätegruppe und wählen Sie "Android-Geräte verwalten" aus.
Wählen Sie im Fenster "Android-Geräte verwalten" unter "Aktion" die Option "Benutzerdefinierter Android-Befehl" aus.
Geben Sie den benutzerdefinierten Befehl ein und klicken Sie auf "Ausführen ".

Ausführungsstatus von Befehlen verfolgen

Sie können den Ausführungsstatus aller Befehle, die an das ausgewählte Gerät gesendet wurden, auf der Seite "Geräteverlauf" anzeigen. Wenn der benutzerdefinierte Befehl ausgeführt wird, werden die folgenden Status zurückgegeben.

Abgeschlossen, wenn die Aktion erfolgreich auf dem Gerät implementiert wurde.
Fehler, wenn die Aktion nicht ausgeführt werden konnte. Die Fehlerdetails werden in der Spalte "Fehlerbeschreibung" angezeigt.