ファイルのアップロード カスタムコマンド
Upload file customコマンドを使用して、任意のデバイス上の指定したパスにファイルを直接アップロードします。 IBM® MaaS360® Android バージョン 9.15 以降では、管理者は、以下の方法で管理対象デバイスにファイルをリモートでアップロードできます。 upload-file カスタムコマンド。 このコマンドは、セキュアな URL、またはカスタムコマンド内に直接ファイルデータを埋め込むことでファイル転送を可能にする。 ユーザーの介入を必要とせずにファイルの展開、更新、クリーンアップ操作を可能にすることで、デバイス管理を強化します。
サポートされるオプション
以下のオプションは、ファイルがデバイスにアップロードされる方法を制御します。
- -url <url>
- 指定された HTTPS URL からファイルをアップロードする。 URL は一般にアクセス可能で、適切な書式でなければならない。
- -base64 <base64>
- 小さなファイルに適した Base64-encoded データを使用してファイルをアップロードします。
- -delete
- アップロード済みのファイルをデバイスから削除します。
- -notify
- (オプション）ファイルのアップロードまたは削除をユーザーに通知します。
- -verify <sha-256>
- (オプション）ダウンロードしたファイルの SHA-256 ハッシュを検証する。 ハッシュは64文字の16進文字列でなければならない。
保存先ファイル名とパス
宛先パスは、絶対パス（たとえば、
/path/to/file.ext ）または定義済みの定数を使用した相対パスにすることができます。 指定されたパスにファイルが存在する場合、そのファイルは置き換えられる。注： 絶対パスはAndroid 10以前でのみサポートされています。
以下の表は、カスタム・コマンド・アクションでサポートされているパス定数について説明したものです。
| 定数 | Android のバージョン | ファイルの種類 | 説明 |
|---|---|---|---|
%directory_external% |
アンドロイド10以前 | 任意 | 外部記憶装置のルート |
%directory_alarms% |
すべて | 音声 | アラーム音声ファイル用ディレクトリ |
%directory_audiobooks% |
アンドロイド10以降 | 音声 | オーディオブック・ファイル用ディレクトリ |
%directory_dcim% |
すべて | 画像、ビデオ | 写真とビデオの撮影場所 |
%directory_documents% |
すべて | 任意 | ユーザーが作成した文書用のディレクトリ |
%directory_downloads% |
すべて | 任意 | ダウンロードしたファイルのディレクトリ |
%directory_movies% |
すべて | ビデオ | 映画のディレクトリ |
%directory_music% |
すべて | 音声 | 音楽ファイル用ディレクトリ |
%directory_notifications% |
すべて | 音声 | 通知音用ディレクトリ |
%directory_pictures% |
すべて | 画像、ビデオ | ユーザー写真用ディレクトリ |
%directory_podcasts% |
すべて | 音声 | ポッドキャストファイル用ディレクトリ |
%directory_recordings% |
アンドロイド12以降 | 音声 | 音声録音用ディレクトリ |
%directory_ringtones% |
すべて | 音声 | 着信音用ディレクトリ |
%directory_screenshots% |
アンドロイド10以降 | イメージ | スクリーンショット用ディレクトリ |
注:
- レガシー・パスへのアクセスは、Android 10以前に限定されるか、カスタム・ファームウェアのパーミッションが必要となる。
- ファイルタイプが各ディレクトリで期待される形式と一致していることを確認する（例えば、画像は.jpg）。
- Android 10以前では、外部ストレージの読み書き権限が必要です。
- ワークプロファイルに登録されたデバイスは、制限されたフォルダにのみアクセスできます。
例
- URL、現在のユーザーのダウンロードフォルダのサブパスにファイルをアップロードする。
upload-file -url https://example.com/file.ext %directory_downloads%/file.ext - SHA-256 のハッシュを検証した後、 URL から現在のユーザーのダウンロードフォルダーのサブパスにファイルをアップロードし、ユーザーに通知する。
upload-file -url https://example.com/file.ext -notify -verify 70ba33708cbfb103f1a8e34afef333ba7dc021022b2d9aaa583aabb8058d8d67 %directory_downloads%/file.ext - Base64 エンコードされたファイルデータをデバイス上の直接パスにアップロードする。
upload-file -base64 ZmlsZSBkYXRhIGdvZXMgaGVyZQphbm90aGVyIGxpbmUKeWV0IGFub3RoZXI= /some/path/file.ext - 以前にアップロードしたファイルを削除します。
upload-file -delete %directory_downloads%/file.ext