Comando personalizzato di caricamento file

Utilizzare il comando Upload file custom per caricare un file direttamente in un percorso specificato su qualsiasi dispositivo. A partire dalla versione IBM® MaaS360® e dalla versione Android 9.15, gli amministratori possono caricare file in remoto sui dispositivi gestiti utilizzando il upload-file comando personalizzato. Questo comando consente il trasferimento di file da un sito URL sicuro o incorporando i dati del file direttamente nel comando personalizzato. Migliora la gestione dei dispositivi consentendo la distribuzione dei file, gli aggiornamenti e le operazioni di pulizia senza richiedere l'intervento dell'utente.

Opzioni supportate

Le seguenti opzioni controllano il modo in cui il file viene caricato sul dispositivo.
-url <url>
Carica un file dal sito HTTPS URL specificato. Il sito URL deve essere pubblicamente accessibile e correttamente formattato.
-base64 <base64>
Carica un file utilizzando i dati di Base64-encoded, adatti a file di piccole dimensioni.
-delete
Elimina un file precedentemente caricato dal dispositivo.
-notify
(Facoltativo) Notifica all'utente il caricamento o l'eliminazione del file.
-verify <sha-256>
(Facoltativo) Verifica l'hash SHA-256 del file scaricato. L'hash deve essere una stringa esadecimale di 64 caratteri.

Nome e percorso del file di destinazione

Il percorso di destinazione può essere un percorso assoluto (ad esempio, /path/to/file.ext) o un percorso relativo utilizzando delle costanti predefinite. Se esiste un file nel percorso specificato, viene sostituito.
Nota: i percorsi assoluti sono supportati solo su Android 10 o precedenti.
La tabella seguente descrive le costanti di percorso supportate per l'azione di comando personalizzata.
Tabella 1. Costanti di percorso supportate
Costante Versione Android Tipo di file Descrizione
%directory_external% Android 10 e precedenti Qualsiasi Radice del dispositivo di archiviazione esterno
%directory_alarms% Tutti Audio Directory per i file audio di allarme
%directory_audiobooks% Android 10 e successivi Audio Directory per i file degli audiolibri
%directory_dcim% Tutti Immagine, Video Posizione per immagini e video
%directory_documents% Tutti Qualsiasi Directory per i documenti creati dall'utente
%directory_downloads% Tutti Qualsiasi Directory per i file scaricati
%directory_movies% Tutti Video Elenco dei film
%directory_music% Tutti Audio Directory per i file musicali
%directory_notifications% Tutti Audio Directory per i suoni di notifica
%directory_pictures% Tutti Immagine, Video Directory per le immagini degli utenti
%directory_podcasts% Tutti Audio Directory per i file podcast
%directory_recordings% Android 12 e successivi Audio Directory per le registrazioni vocali
%directory_ringtones% Tutti Audio Elenco delle suonerie
%directory_screenshots% Android 10 e successivi Immagine Directory per le schermate
Note:
  • L'accesso ai percorsi legacy è limitato ad Android 10 e precedenti o richiede le autorizzazioni del firmware personalizzato.
  • Assicurarsi che i tipi di file corrispondano ai formati previsti per ciascuna directory (ad esempio,.jpg per le immagini).
  • Le autorizzazioni di lettura e scrittura dell'archiviazione esterna sono necessarie su Android 10 o precedenti.
  • I dispositivi iscritti al profilo di lavoro possono accedere solo alle cartelle riservate.

Esempi

  • Carica un file da URL a un sottopercorso della cartella Download per l'utente corrente.
    
            upload-file -url https://example.com/file.ext %directory_downloads%/file.ext
          
  • Carica un file da URL a un sottopercorso della cartella Download per l'utente corrente dopo aver verificato l'hash di SHA-256 e lo notifica all'utente.
    
            upload-file -url https://example.com/file.ext -notify -verify 70ba33708cbfb103f1a8e34afef333ba7dc021022b2d9aaa583aabb8058d8d67 %directory_downloads%/file.ext
          
  • Carica i dati dei file codificati Base64 in un percorso diretto sul dispositivo.
    
            upload-file -base64 ZmlsZSBkYXRhIGdvZXMgaGVyZQphbm90aGVyIGxpbmUKeWV0IGFub3RoZXI= /some/path/file.ext
          
  • Elimina un file caricato in precedenza.
    
            upload-file -delete %directory_downloads%/file.ext