az iot du update

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione azure-iot per l'interfaccia della riga di comando di Azure (versione 2.46.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot du update . Altre informazioni sulle estensioni.

Gestione degli aggiornamenti dei dispositivi.

Comandi

Nome Descrizione Tipo Status
az iot du update calculate-hash

Calcolare la rappresentazione con hash base64 di un file.

 Estensione Disponibilità generale
az iot du update delete

Eliminare una versione di aggiornamento specifica.

 Estensione Disponibilità generale
az iot du update file

Aggiornare le operazioni dei file.

 Estensione Disponibilità generale
az iot du update file list

Elencare gli ID del file di aggiornamento in relazione al provider di aggiornamento, al nome e alla versione.

 Estensione Disponibilità generale
az iot du update file show

Visualizzare i dettagli di un file di aggiornamento specifico in relazione al provider di aggiornamento, al nome e alla versione.

 Estensione Disponibilità generale
az iot du update import

Importare una nuova versione di aggiornamento nell'istanza di Aggiornamento dispositivi.

 Estensione Disponibilità generale
az iot du update init

Utilità per l'inizializzazione del manifesto di importazione.

 Estensione Anteprima
az iot du update init v5

Inizializzare un manifesto di importazione v5 con lo stato desiderato.

 Estensione Anteprima
az iot du update list

Elencare gli aggiornamenti importati nell'istanza di Aggiornamento dispositivi.

 Estensione Disponibilità generale
az iot du update show

Visualizzare una versione di aggiornamento specifica.

 Estensione Disponibilità generale
az iot du update stage

Preparare un aggiornamento per l'importazione in un'istanza di destinazione.

 Estensione Anteprima

az iot du update calculate-hash

Calcolare la rappresentazione con hash base64 di un file.

az iot du update calculate-hash --file-path
                                [--hash-algo {sha256}]

Esempio

Calcolare la rappresentazione base64 di un digest sha256 per un file di aggiornamento di destinazione.

az iot du update calculate-hash --file-path /path/to/file

Calcolare la rappresentazione base64 di un digest sha256 per più file di aggiornamento di destinazione.

az iot du update calculate-hash --file-path /path/to/file1 --file-path /path/to/file2 --file-path /path/to/file3

Parametri necessari

--file-path -f

Percorso locale del file di destinazione per il calcolo hash. --file-path può essere usato 1 o più volte.

Parametri facoltativi

--hash-algo

Algoritmo di crittografia da usare per l'hashing.

Valori accettati: sha256
Valore predefinito: sha256
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot du update delete

Eliminare una versione di aggiornamento specifica.

az iot du update delete --account
                        --instance
                        --un
                        --up
                        --update-version
                        [--no-wait]
                        [--resource-group]
                        [--yes {false, true}]

Esempio

Eliminare un aggiornamento di destinazione in relazione al provider di aggiornamento, al nome e alla versione.

az iot du update delete -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

Parametri necessari

--account -n

Nome dell'account di Aggiornamento dispositivi. È possibile configurare il nome dell'account predefinito usando az config set defaults.adu_account=<name>.

--instance -i

Nome dell'istanza di Aggiornamento dispositivi. È possibile configurare il nome predefinito dell'istanza usando az config set defaults.adu_instance=<name>.

--un --update-name

Nome dell'aggiornamento.

--up --update-provider

Provider di aggiornamento.

--update-version --uv

Versione di aggiornamento.

Parametri facoltativi

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--resource-group -g

Nome del gruppo di risorse dell'account di Aggiornamento dispositivi. È possibile configurare il gruppo predefinito con az config set defaults.adu_group=<name>.

--yes -y

Ignorare le richieste dell'utente. Indica l'accettazione dell'azione. Usato principalmente per gli scenari di automazione. Valore predefinito: false.

Valori accettati: false, true
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot du update import

Importare una nuova versione di aggiornamento nell'istanza di Aggiornamento dispositivi.

Questo comando supporta la --defer funzionalità . Se usato, il comando archivierà il payload dell'oggetto da inviare ad Azure in una cache locale. L'utilizzo successivo di questo comando senza --defer combina il nuovo payload della richiesta con gli oggetti memorizzati nella cache che li inviano insieme.

Al termine dell'operazione, la voce della cache locale corrispondente verrà rimossa. Se si verifica un errore, il contenuto memorizzato nella cache non verrà rimosso. Usare az cache i comandi per gestire le voci della cache locale in modo indipendente.

Il supporto di rinvio è destinato principalmente agli aggiornamenti con più passaggi di riferimento, in modo che gli aggiornamenti padre e figlio possano essere inviati insieme.

az iot du update import --account
                        --instance
                        --url
                        [--defer]
                        [--file]
                        [--friendly-name]
                        [--hashes]
                        [--no-wait]
                        [--resource-group]
                        [--size]

Esempio

Importare un aggiornamento con due file correlati e senza passaggi di riferimento, specificando in modo esplicito il valore hash del manifesto e le dimensioni del manifesto in byte.

az iot du update import -n {account_name} -i {instance_name} --hashes sha256={hash_value} --size {size_in_bytes} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Importare un aggiornamento con due file correlati e senza passaggi di riferimento, consentendo all'interfaccia della riga di comando di calcolare il valore hash e le dimensioni del manifesto di importazione in byte.

az iot du update import -n {account_name} -i {instance_name} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Importare un aggiornamento padre con due passaggi di riferimento per l'aggiornamento figlio, in cui tutti e tre i manifesti di importazione hanno un file correlato. Consentire all'interfaccia della riga di comando di calcolare il valore hash e le dimensioni in byte per tutti. Questa operazione si baserà sulla funzionalità '--defer'.

az iot du update import -n {account_name} -i {instance_name} --url {parent_manifest_location} --file filename={parent_file_name} url={parent_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child1_manifest_location} --file filename={child1_file_name} url={child1_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child2_manifest_location} --file filename={child2_file_name} url={child2_file_url}

Parametri necessari

--account -n

Nome dell'account di Aggiornamento dispositivi. È possibile configurare il nome dell'account predefinito usando az config set defaults.adu_account=<name>.

--instance -i

Nome dell'istanza di Aggiornamento dispositivi. È possibile configurare il nome predefinito dell'istanza usando az config set defaults.adu_instance=<name>.

--url

Percorso instradabile da cui il manifesto di importazione può essere scaricato da Aggiornamento del dispositivo per hub IoT. Si tratta in genere di un URL BLOB protetto da firma di accesso condiviso di sola lettura con una scadenza impostata su almeno 3 ore.

Parametri facoltativi

--defer

Archiviare temporaneamente l'oggetto nella cache locale anziché inviarlo ad Azure. Usare az cache i comandi per visualizzare/cancellare.

--file

Coppie chiave=valore separate da spazi corrispondenti all'importazione delle proprietà del file di metadati manifesto. Le chiavi obbligatorie includono nome file e URL. --file può essere usato 1 o più volte.

--friendly-name

Nome descrittivo associato alla definizione di aggiornamento.

--hashes

Coppie chiave=valore separate da spazi in cui la chiave è l'algoritmo hash usato e il valore è l'hash del file manifesto di importazione codificato base64. È necessaria almeno una voce sha256. Se non viene specificato, verrà calcolato dall'URL specificato.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--resource-group -g

Nome del gruppo di risorse dell'account di Aggiornamento dispositivi. È possibile configurare il gruppo predefinito con az config set defaults.adu_group=<name>.

--size

Dimensioni del file in numero di byte. Se non viene specificato, verrà calcolato dall'URL specificato.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot du update list

Elencare gli aggiornamenti importati nell'istanza di Aggiornamento dispositivi.

Quando si elencano i provider di aggiornamento, è necessario specificare solo il flag --by-provider oltre agli argomenti di ricerca dell'istanza comune. Quando si elencano i nomi degli aggiornamenti, è necessario specificare il provider di aggiornamento. Quando si elencano le versioni di aggiornamento, è necessario specificare il provider di aggiornamento e il nome dell'aggiornamento.

az iot du update list --account
                      --instance
                      [--by-provider {false, true}]
                      [--filter]
                      [--resource-group]
                      [--search]
                      [--un]
                      [--up]

Esempio

Elencare tutti gli aggiornamenti.

az iot du update list -n {account_name} -i {instance_name}

Elencare tutti gli aggiornamenti che soddisfano i criteri di ricerca free-text, in questo caso il provider di aggiornamento di Contoso.

az iot du update list -n {account_name} -i {instance_name} --search 'Contoso'

Elencare tutti gli aggiornamenti che soddisfano un filtro odata, in questo caso filtrando per gli aggiornamenti non distribuibili.

az iot du update list -n {account_name} -i {instance_name} --filter 'isDeployable eq false'

Elencare tutti i provider di aggiornamento.

az iot du update list -n {account_name} -i {instance_name} --by-provider

Elencare tutti i nomi di aggiornamento in base al provider di aggiornamento.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name}

Elencare tutte le versioni degli aggiornamenti in base al provider di aggiornamento e al nome dell'aggiornamento.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name}

Parametri necessari

--account -n

Nome dell'account di Aggiornamento dispositivi. È possibile configurare il nome dell'account predefinito usando az config set defaults.adu_account=<name>.

--instance -i

Nome dell'istanza di Aggiornamento dispositivi. È possibile configurare il nome predefinito dell'istanza usando az config set defaults.adu_instance=<name>.

Parametri facoltativi

--by-provider

Flag che indica che il set di risultati deve essere vincolato ai provider di aggiornamento.

Valori accettati: false, true
--filter

Limita il set di aggiornamenti restituiti dai valori delle proprietà. Supportato quando si elencano gli aggiornamenti senza vincoli o quando si elenca in base alla versione.

--resource-group -g

Nome del gruppo di risorse dell'account di Aggiornamento dispositivi. È possibile configurare il gruppo predefinito con az config set defaults.adu_group=<name>.

--search

Richiedere aggiornamenti corrispondenti a un'espressione di ricerca free-text. Supportato quando si elencano gli aggiornamenti senza vincoli.

--un --update-name

Nome dell'aggiornamento.

--up --update-provider

Provider di aggiornamento.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot du update show

Visualizzare una versione di aggiornamento specifica.

az iot du update show --account
                      --instance
                      --un
                      --up
                      --update-version
                      [--resource-group]

Esempio

Visualizzare un aggiornamento specifico in relazione al provider di aggiornamento, al nome e alla versione.

az iot du update show -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

Parametri necessari

--account -n

Nome dell'account di Aggiornamento dispositivi. È possibile configurare il nome dell'account predefinito usando az config set defaults.adu_account=<name>.

--instance -i

Nome dell'istanza di Aggiornamento dispositivi. È possibile configurare il nome predefinito dell'istanza usando az config set defaults.adu_instance=<name>.

--un --update-name

Nome dell'aggiornamento.

--up --update-provider

Provider di aggiornamento.

--update-version --uv

Versione di aggiornamento.

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse dell'account di Aggiornamento dispositivi. È possibile configurare il gruppo predefinito con az config set defaults.adu_group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot du update stage

Anteprima

Questo comando è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Preparare un aggiornamento per l'importazione in un'istanza di destinazione.

La gestione temporanea di un aggiornamento si riferisce all'accelerazione dei passaggi necessari per l'importazione di un aggiornamento in un'istanza di destinazione. Per un determinato manifesto di importazione, il processo determinerà i file pertinenti, li esegue il push in un contenitore di archiviazione desiderato, genera URI di firma di accesso condiviso e illustra altri passaggi di preparazione per un'importazione con successo.

Questo comando dipende da un'organizzazione basata su convenzioni di file di aggiornamento. Tutti i file di aggiornamento per un manifesto di destinazione devono trovarsi nella stessa directory in cui risiede il manifesto di importazione.

L'accesso basato su chiavi viene usato per caricare artefatti BLOB e per generare 3 URI di firma di accesso condiviso con accesso in lettura.

Se --then-import viene specificato il flag, il comando importerà l'aggiornamento a fasi. In caso contrario, il risultato di questa operazione è un comando di importazione da eseguire per ottenere lo stesso risultato in un secondo momento.

Questo comando elimina e aggiorna qualsiasi voce della cache locale per l'istanza di destinazione.

az iot du update stage --account
                       --instance
                       --manifest-path
                       --storage-account
                       --storage-container
                       [--friendly-name]
                       [--overwrite {false, true}]
                       [--resource-group]
                       [--storage-subscription]
                       [--then-import {false, true}]

Esempio

Preparare un aggiornamento autonomo. È previsto che i file di aggiornamento risiedano nella stessa directory del manifesto. Il comando di importazione risultante può essere eseguito in un secondo momento per avviare l'importazione dell'aggiornamento a fasi prima della scadenza del token di firma di accesso condiviso.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json

Preparare un aggiornamento autonomo. Dopo la gestione temporanea, importare l'aggiornamento nell'istanza usando un nome descrittivo desiderato.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json --then-import --friendly-name myAptUpdate

Preparare un aggiornamento a più riferimenti. I file di aggiornamento verranno caricati in un contenitore BLOB di archiviazione che si trova in una sottoscrizione diversa per l'account di aggiornamento.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --storage-subscription {storage_account_subscription} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json

Preparare un aggiornamento a più riferimenti, sovrascrivendo i BLOB esistenti, se esistenti. Dopo la gestione temporanea, importare l'aggiornamento nell'istanza di .

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json --then-import --overwrite

Parametri necessari

--account -n

Nome dell'account di Aggiornamento dispositivi. È possibile configurare il nome dell'account predefinito usando az config set defaults.adu_account=<name>.

--instance -i

Nome dell'istanza di Aggiornamento dispositivi. È possibile configurare il nome predefinito dell'istanza usando az config set defaults.adu_instance=<name>.

--manifest-path

Percorso del file locale del manifesto di importazione che deve essere risolto in staging. Può essere usato 1 o più volte.

--storage-account

Nome dell'account di archiviazione desiderato per l'importazione temporanea degli artefatti manifesto.

--storage-container

Nome del contenitore di archiviazione desiderato per l'importazione temporanea degli artefatti manifesto.

Parametri facoltativi

--friendly-name

Nome descrittivo associato alla definizione di aggiornamento.

--overwrite

Flag che indica se i BLOB esistenti devono essere sovrascritti se esiste un conflitto.

Valori accettati: false, true
Valore predefinito: False
--resource-group -g

Nome del gruppo di risorse dell'account di Aggiornamento dispositivi. È possibile configurare il gruppo predefinito con az config set defaults.adu_group=<name>.

--storage-subscription

Sottoscrizione dell'account di archiviazione desiderata per l'importazione temporanea degli artefatti del manifesto. Applicabile quando gli account di archiviazione e aggiornamento del dispositivo si trovano in sottoscrizioni diverse.

--then-import

Flag che indica se l'aggiornamento deve essere importato dopo la gestione temporanea.

Valori accettati: false, true
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.