Condividi tramite


az iot du update

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot du update. Learn more about extensions.

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.

Extension GA
az iot du update delete

Eliminare una versione di aggiornamento specifica.

Extension GA
az iot du update file

Aggiornare le operazioni dei file.

Extension GA
az iot du update file list

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

Extension GA
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.

Extension GA
az iot du update import

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

Extension GA
az iot du update init

Utilità per l'inizializzazione del manifesto di importazione.

Extension Preview
az iot du update init v5

Inizializzare un manifesto di importazione v5 con lo stato desiderato.

Extension Preview
az iot du update list

Elencare gli aggiornamenti importati nell'istanza di Aggiornamento dispositivi.

Extension GA
az iot du update show

Visualizzare una versione di aggiornamento specifica.

Extension GA
az iot du update stage

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

Extension Preview

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--hash-algo

Algoritmo di crittografia da usare per l'hashing.

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

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Output format.

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

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az iot du update delete

Eliminare una versione di aggiornamento specifica.

az iot du update delete --account
                        --instance
                        --un --update-name
                        --up --update-provider
                        --update-version --uv
                        [--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}.

Proprietà Valore
Parameter group: Account Identifier Arguments
--instance -i

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

Proprietà Valore
Parameter group: Account Identifier Arguments
--un --update-name

Nome dell'aggiornamento.

--up --update-provider

Provider di aggiornamento.

--update-version --uv

Versione di aggiornamento.

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--resource-group -g

Nome del gruppo di risorse dell'account di Aggiornamento dispositivi. È possibile configurare il gruppo predefinito usando az config set defaults.adu_group={name}.

Proprietà Valore
Parameter group: Account Identifier Arguments
--yes -y

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

Proprietà Valore
Valori accettati: false, true
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Output format.

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

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

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}.

Proprietà Valore
Parameter group: Account Identifier Arguments
--instance -i

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

Proprietà Valore
Parameter group: Account Identifier Arguments
--url

Percorso instradabile da cui il manifesto di importazione può essere scaricato da Aggiornamento dispositivi per l'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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--defer

Archiviare temporaneamente l'oggetto nella cache locale anziché inviarlo ad Azure. Usare az cache 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

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--resource-group -g

Nome del gruppo di risorse dell'account di Aggiornamento dispositivi. È possibile configurare il gruppo predefinito usando az config set defaults.adu_group={name}.

Proprietà Valore
Parameter group: Account Identifier Arguments
--size

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

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Output format.

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

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

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 --update-name]
                      [--up --update-provider]

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}.

Proprietà Valore
Parameter group: Account Identifier Arguments
--instance -i

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

Proprietà Valore
Parameter group: Account Identifier Arguments

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--by-provider

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

Proprietà Valore
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.

Proprietà Valore
Parameter group: Filter Arguments
--resource-group -g

Nome del gruppo di risorse dell'account di Aggiornamento dispositivi. È possibile configurare il gruppo predefinito usando az config set defaults.adu_group={name}.

Proprietà Valore
Parameter group: Account Identifier Arguments
--search

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

Proprietà Valore
Parameter group: Filter Arguments
--un --update-name

Nome dell'aggiornamento.

--up --update-provider

Provider di aggiornamento.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Output format.

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

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az iot du update show

Visualizzare una versione di aggiornamento specifica.

az iot du update show --account
                      --instance
                      --un --update-name
                      --up --update-provider
                      --update-version --uv
                      [--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}.

Proprietà Valore
Parameter group: Account Identifier Arguments
--instance -i

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

Proprietà Valore
Parameter group: Account Identifier Arguments
--un --update-name

Nome dell'aggiornamento.

--up --update-provider

Provider di aggiornamento.

--update-version --uv

Versione di aggiornamento.

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Nome del gruppo di risorse dell'account di Aggiornamento dispositivi. È possibile configurare il gruppo predefinito usando az config set defaults.adu_group={name}.

Proprietà Valore
Parameter group: Account Identifier Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Output format.

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

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

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}.

Proprietà Valore
Parameter group: Account Identifier Arguments
--instance -i

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

Proprietà Valore
Parameter group: Account Identifier Arguments
--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.

Proprietà Valore
Parameter group: Storage Arguments
--storage-container

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

Proprietà Valore
Parameter group: Storage Arguments

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--friendly-name

Nome descrittivo associato alla definizione di aggiornamento.

--overwrite

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

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

Nome del gruppo di risorse dell'account di Aggiornamento dispositivi. È possibile configurare il gruppo predefinito usando az config set defaults.adu_group={name}.

Proprietà Valore
Parameter group: Account Identifier Arguments
--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.

Proprietà Valore
Parameter group: Storage Arguments
--then-import

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

Proprietà Valore
Valori accettati: false, true
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Output format.

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

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False