Android カスタム・コマンド
管理下のAndroidデバイス上でカスタムコマンドを使用して、リモートアクションを実行します。
IBM® MaaS360® ポータルで使用できるデフォルトのデバイス アクションに加えて、カスタム コマンドを使用して管理対象デバイスで動的なアクションを実行できます。 カスタム コマンドを送信した後、 IBM MaaS360 ポータルのデバイス履歴ページですべてのコマンドの実行ステータスを追跡できます。 この機能は、Androidアプリバージョン 7.40 以降で MaaS360 が必要です。
サポートされるカスタム・コマンド
| アクション | 説明 | コマンド |
|---|---|---|
| キオスク・モードを有効にする | Kiosk mode 。以下の要件を満たす必要があります。
|
enable-kiosk |
| アプリケーションの起動 | デバイス上の指定のアプリを起動します。 以下の要件を満たす必要があります。
|
launch-app <package name>. 例、
|
| 開始アクティビティー | インテントを持つアクティビティのインスタンスを開始します。 デバイス・サポート
以下の要件を満たす必要があります。
|
start-activity <intent options> |
| 放送開始 | デバイスに、指定されたインテントをブロードキャストします。 | send-broadcast <intent options> |
| アプリ・データをクリア | アプリケーション・データをクリアします。 このコマンドは、複数のアプリケーション IDをサポートしています。 要件は以下の通りです。
|
clear-app-data <comma-separated app IDs>
|
| eSIM をダウンロード | デバイスに eSIM をダウンロードします。 要件は以下の通りです。
|
<download e-sim options> |
| eSIM を削除する | デバイス上の eSIM を削除します。 要件は以下の通りです。
|
<delete e-sim options> |
| キオスクのランチャー項目をリセットする | Kioskホーム画面のランチャーアイコンをポリシーで定義された位置にリセットします。 注意: このコマンドは、ポリシーで [ユーザーによるアイコンの並べ替えを許可] が有効になっている場合に使用できます。 キオスクランチャーのバージョンは 以降 9.17 である必要があります。
条件が満たされない場合、以下のエラーメッセージが表示されます。
|
reset-kiosk-launcher |
| アプリを1つアンインストールする | 以下の要件を満たす必要があります。
条件が満たされない場合、以下のエラーメッセージが表示されます。
|
uninstall-single-app <packageName> |
| ファイルのアップロード | カスタムコマンドアクションを使用して、任意のデバイス上の指定したパスにファイルを直接アップロードする機能を追加します。 ファイルのアップロードは、 https:// URL、またはカスタムコマンド内に直接ファイルデータを埋め込んで行うことができます。 詳細については、 「ファイルアップロードカスタムコマンド」 を参照してください。 |
upload-file [options] <destination file name and path> |
意図オプション
| インテント・オプション | 説明 | 例 |
|---|---|---|
| -a | インテントでアクションを設定します。 |
|
| -c | インテントにカテゴリーを追加します。 | start-activity -c android.intent.category.HOME -a android.intent.action.MAIN ホーム画面が起動します。 |
| -d | インテントでデータ URL を設定します。 | start-activity -a android.intent.action.VIEW -d http://www.google.com google.com をブラウザアプリで開きます。 ブラウザー・アプリがインストールされていない場合、コマンドは失敗します。 |
| -t | インテントで MIME タイプを設定します。 | start-activity -t image/* -a android.intent.action.VIEW ギャラリーまたは画像を表示するアプリを開きます。 複数のアプリがある場合は、アプリの一覧が表示されます。 |
| -n | 特定のインテント・コンポーネントを設定します。 | start-activity -n com.example.sampleapp/.SaveFileActivity サンプルアプリの 「ファイルを保存」 画面を開きます。 "SaveFileActivity" がエクスポートされていない場合、コマンドは失敗します。 |
-es, -eb, -ei, -ed, -en, -eia, -esa, -eba, -eda （文字列データの場合は、値を指定するために引用符で囲む必要があります） |
data/extras をキーと値のペアとして intent に追加します | -es - String start-activity -n com.example.sampleapp/.MyActivity -es EXTRA "Life is Great" 特定のアクティビティ "MyActivity" を開き、キーと値のペア（キー：「EXTRA」値：「Life is Great」）の形式で文字列データをアクティビティに送信します。 "MyActivity"がエクスポートされていない場合、コマンドは失敗します。 |
| -eb - Boolean start-activity -n
com.example.sampleapp/.MyActivity -eb Status true 特定のアクティビティ "MyActivity" を開き、キーと値のペア（キー：「ステータス」、値：true）の形式でブール値データをアクティビティに送信します。
注意: "MyActivity" がエクスポートされない場合、コマンドは失敗します。
|
||
| -ed - Double/Float start-activity -n com.example.sampleapp/.MyActivity -ed Code 999.9878 特定のアクティビティ "MyActivity" を開き、キーと値のペア（キー：「Code」値 999.9878 ）の形式で、ダブルまたはフロートデータをアクティビティに送信します。 "MyActivity"がエクスポートされていない場合、コマンドは失敗します。 |
||
| -ei - Integer start-activity -n com.example.sampleapp/.MyActivity -ei Code 999 特定のアクティビティ "MyActivity" を開き、キーと値のペア（キー：「Code」値：999）の形式で整数値データをアクティビティに送信します。 "MyActivity"がエクスポートされていない場合、コマンドは失敗します。 |
||
| -esa - String Array start-activity -n com.example.sampleapp/.MyActivity -esa Months "[Jan,Feb,March]" 特定のアクティビティ "MyActivity" を開き、キーと値のペア（キー：「Months」、値：「[Jan,Feb,Mar]」）の形式で文字列配列データをアクティビティに送信します。 "MyActivity"がエクスポートされていない場合、コマンドは失敗します。 |
||
| -eba - Boolean Array start-activity -n com.example.sampleapp/.MyActivity -eba Status [true, false, false, false] 特定のアクティビティ "MyActivity" を開き、キーと値のペア（キー：「ステータス」、値：[true, false, false, false]）の形式で、ブール値の配列データをアクティビティに送信します。 "MyActivity"がエクスポートされていない場合、コマンドは失敗します。 |
||
| -eda - Double/Float Array start-activity -n com.example.sampleapp/.MyActivity -eda Codes [10.33, 12.33, 14.33, 15.33]特定のアクティビティ "MyActivity" を開き、キーと値のペアの形式で double または float 配列データ (キー:「Codes」、値: [ 10.33、 12.33、 14.33、 15.33 ]) をアクティビティに送信します。 "MyActivity"がエクスポートされていない場合、コマンドは失敗します。 |
||
| -eia - Integer Array start-activity -n com.example.sampleapp/.MyActivity -eia Codes [998, 999, 1000] 特定のアクティビティ "MyActivity" を開き、キーと値のペア（キー：「Codes」、値：[998, 999, 1000]）の形式で整数の配列データをアクティビティに送信します。 "MyActivity"がエクスポートされていない場合、コマンドは失敗します。 |
||
| -en - Null start-activity -n com.example.sampleapp/.MyActivity -en DataValue null 特定のアクティビティ "MyActivity" を開き、キーと値のペア（キー "DataValue" 」、値：null）の形式でnullデータをアクティビティに送信します。 "MyActivity"がエクスポートされていない場合、コマンドは失敗します。 ヌルを渡す場合は、-en オプションを使用します。 その他のオプションを使用してヌルを渡した場合、コマンドは失敗します。 |
Download-eSIM オプション
指揮系統は download-esim -ac
LPA:1$<SDMP+ADDRESS>$<ACTIVATION_CODE>
| ダウンロードオプション | 説明 | 必須またはオプション | 例 |
|---|---|---|---|
| -ac | eSIMのアクティベーションコードを設定する | 必須 | download-esim -ac
LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL |
| -sd | ダウンロード後に自動的に eSIMに切り替えるかどうかを選択します。 値は true または false （デフォルト）です。注:
|
オプション | download-esim -sd true -ac
LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL |
| -sn | ダウンロード後にユーザーに通知するかどうかを選択します。 値は true （デフォルト）または false です。 |
オプション | download-esim -sn false -ac
LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL |
| -fd | SIM 解決可能なエラーが発生した場合に、 eSIM を強制的にダウンロードするかどうかを選択します。 値は true または false （デフォルト）です。注:
|
オプション | download-esim -fd true -ac
LPA:1$prod.smdp-plus.rsp.goog$052X-UFXS-CQIY-PNGL |
Delete-eSIM オプション
| オプション削除 | 説明 | 必須またはオプション | 例 |
|---|---|---|---|
| -ic | eSIMの ICCID番号を設定します。 | 必須 | delete-esim -ic 8988303000000614227 |
| -sn | ダウンロード後にユーザーに通知するかどうかを選択します。 値は true （デフォルト）または false です。 |
オプション | delete-esim -sn false -ic 8988303000000614227 |
カスタム・コマンドの要件
- 不等号括弧 < および > はサポートされていません。
- script という単語、および < と > という記号は、1回以上使用することはできません。
- 最大文字数制限は 2500 です。
デバイスへのカスタム・コマンドのプッシュ
個々のデバイスまたはデバイスのグループにカスタム・コマンドを発行できます。
- に移動し、デバイスを選択します。
- デバイスサマリーページで 、「詳細」 をクリックし 、「Androidカスタムコマンド」 を選択します。
- カスタムコマンドを入力し、 [実行] をクリックします。
- に移動します。
- デバイスグループの 「その他」オプションにカーソルを合わせ 、「Androidデバイスの管理」 を選択します。
- Androidデバイスの管理ウィンドウで、 アクションから Androidカスタムコマンドを選択します。
- カスタムコマンドを入力し、 [実行] をクリックします。
コマンドの実行ステータスのトラッキング
- 完了、デバイスにアクションが正常に実装された場合。
- エラー、アクションが実行できなかった場合。 エラーの詳細は 「エラー内容」の列に表示されます。