Benutzerdefinierter Befehl Datei hochladen
Verwenden Sie den benutzerdefinierten Befehl Datei hochladen, um eine Datei direkt in einen angegebenen Pfad auf einem beliebigen Gerät hochzuladen. Ab IBM® MaaS360® Android Version 9.15 können Administratoren Dateien mithilfe der folgenden Funktion remote auf verwaltete Geräte hochladen: upload-file benutzerdefinierter Befehl. Dieser Befehl ermöglicht Dateiübertragungen von einer sicheren URL oder durch Einbettung der Dateidaten direkt in den benutzerdefinierten Befehl. Sie verbessert das Gerätemanagement, indem sie die Bereitstellung, Aktualisierung und Bereinigung von Dateien ermöglicht, ohne dass der Benutzer eingreifen muss.
Unterstützte Optionen
Die folgenden Optionen steuern, wie die Datei auf das Gerät hochgeladen wird.
- -url <url>
- Lädt eine Datei vom angegebenen HTTPS URL hoch. Die Website URL muss öffentlich zugänglich und ordnungsgemäß formatiert sein.
- -base64 <base64>
- Hochladen einer Datei unter Verwendung von Base64-encoded Daten, die für kleine Dateien geeignet sind.
- -delete
- Löscht eine zuvor hochgeladene Datei vom Gerät.
- -notify
- (Optional) Benachrichtigt den Benutzer über das Hochladen oder Löschen einer Datei.
- -verify <sha-256>
- (Optional) Überprüft den SHA-256 Hash der heruntergeladenen Datei. Der Hash muss eine 64-stellige hexadezimale Zeichenfolge sein.
Name und Pfad der Zieldatei
Der Zielpfad kann ein absoluter Pfad sein (z. B.
/path/to/file.ext) oder ein relativer Pfad unter Verwendung vordefinierter Konstanten. Wenn eine Datei unter dem angegebenen Pfad existiert, wird sie ersetzt.Hinweis: Absolute Pfade werden nur unter Android 10 oder früher unterstützt.
In der folgenden Tabelle werden die unterstützten Pfadkonstanten für die benutzerdefinierte Befehlsaktion beschrieben.
| Konstante | Android-Version | Dateityp | Beschreibung |
|---|---|---|---|
%directory_external% |
Android 10 und früher | Beliebig | Wurzel des externen Speichermediums |
%directory_alarms% |
Alle | Ton | Verzeichnis für Alarm-Audiodateien |
%directory_audiobooks% |
Android 10 und höher | Ton | Verzeichnis für Hörbuchdateien |
%directory_dcim% |
Alle | Bild, Video | Standort für Bilder und Videos |
%directory_documents% |
Alle | Beliebig | Verzeichnis für vom Benutzer erstellte Dokumente |
%directory_downloads% |
Alle | Beliebig | Verzeichnis für heruntergeladene Dateien |
%directory_movies% |
Alle | Video | Verzeichnis für Filme |
%directory_music% |
Alle | Ton | Verzeichnis für Musikdateien |
%directory_notifications% |
Alle | Ton | Verzeichnis für Benachrichtigungstöne |
%directory_pictures% |
Alle | Bild, Video | Verzeichnis für Benutzerbilder |
%directory_podcasts% |
Alle | Ton | Verzeichnis für Podcast-Dateien |
%directory_recordings% |
Android 12 und höher | Ton | Verzeichnis für Sprachaufnahmen |
%directory_ringtones% |
Alle | Ton | Verzeichnis für Klingeltöne |
%directory_screenshots% |
Android 10 und höher | Bild | Verzeichnis für Bildschirmphotos |
Hinweise:
- Der Zugriff auf ältere Pfade ist auf Android 10 und früher beschränkt oder erfordert benutzerdefinierte Firmware-Berechtigungen.
- Stellen Sie sicher, dass die Dateitypen den erwarteten Formaten für jedes Verzeichnis entsprechen (z. B..jpg für Bilder).
- Lese- und Schreibrechte für den externen Speicher sind unter Android 10 oder früher erforderlich.
- Für das Arbeitsprofil registrierte Geräte können nur auf eingeschränkte Ordner zugreifen.
Beispiele
- Hochladen einer Datei von URL in einen Unterpfad im Ordner Downloads für den aktuellen Benutzer.
upload-file -url https://example.com/file.ext %directory_downloads%/file.ext - Hochladen einer Datei von URL in einen Unterpfad im Ordner "Downloads" für den aktuellen Benutzer, nachdem der Hash von SHA-256 überprüft wurde, und Benachrichtigung des Benutzers.
upload-file -url https://example.com/file.ext -notify -verify 70ba33708cbfb103f1a8e34afef333ba7dc021022b2d9aaa583aabb8058d8d67 %directory_downloads%/file.ext - Hochladen von Base64 verschlüsselten Dateidaten in einen direkten Pfad auf dem Gerät.
upload-file -base64 ZmlsZSBkYXRhIGdvZXMgaGVyZQphbm90aGVyIGxpbmUKeWV0IGFub3RoZXI= /some/path/file.ext - Löschen Sie eine zuvor hochgeladene Datei.
upload-file -delete %directory_downloads%/file.ext