az iot du update init

Anteprima
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 init . Altre informazioni sulle estensioni.

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

Utilità per l'inizializzazione del manifesto di importazione.

Comandi

Nome	Descrizione	Tipo	Status
az iot du update init v5	Inizializzare un manifesto di importazione v5 con lo stato desiderato.	Estensione	Anteprima

az iot du update init v5

Anteprima

Il gruppo di comandi 'iot du update init' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Inizializzare un manifesto di importazione v5 con lo stato desiderato.

Questo comando supporta tutti gli attributi del manifesto di importazione v5. Si noti che esiste una sensibilità posizionale tra --step e --filee --file .--related-file Esaminare esempi e descrizioni dei parametri per informazioni dettagliate su come usare completamente l'operazione.

Altre informazioni sull'uso di virgolette e caratteri di escape in shell diverse sono disponibili qui: https://aka.ms/aziotcli-json.

az iot du update init v5 --compat
                         --step
                         --update-name
                         --update-provider
                         --update-version
                         [--description]
                         [--file]
                         [--is-deployable {false, true}]
                         [--no-validation {false, true}]
                         [--related-file]

Esempio

Inizializzare un manifesto di importazione del contenuto minimo. Json inline ottimizzato per 'bash'.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{"installedCriteria": "1.0"}' --file path=/my/apt/manifest/file

Inizializzare un manifesto di importazione del contenuto minimo. Json inline ottimizzato per 'powershell'.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{\"installedCriteria\": \"1.0\"}' --file path=/my/apt/manifest/file

Inizializzare un manifesto di importazione del contenuto minimo. Json inline ottimizzato per 'cmd'.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="{\"installedCriteria\": \"1.0\"}" --file path=/my/apt/manifest/file

Inizializzare un manifesto di importazione del contenuto minimo. Usare l'input del file per json.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="@/path/to/file" --file path=/my/apt/manifest/file

Inizializzare un aggiornamento foglia non distribuibile a cui fare riferimento in un aggiornamento in bundle. Json inline ottimizzato per 'bash'.

az iot du update init v5 --update-provider Microsoft --update-name mySwUpdate --update-version 1.1.0 --compat manufacturer=Contoso model=Microphone --step handler=microsoft/swupdate:1 description="Deploy Update" properties='{"installedCriteria": "1.0"}' --file path=/my/update/image/file1 --file path=/my/update/image/file2 --is-deployable false

Inizializzare un aggiornamento in bundle che fa riferimento a un aggiornamento foglia e definire passaggi indipendenti. Esempio ottimizzato per "bash" usando la continuazione del comando per delineare i segmenti manifesto di importazione.

az iot du update init v5 \
--update-provider Microsoft --update-name myBundled --update-version 2.0 \
--compat manufacturer=Contoso model=SpaceStation \
--step handler=microsoft/script:1 properties='{"arguments": "--pre"}' description="Pre-install script" \
--file path=/my/update/scripts/preinstall.sh downloadHandler=microsoft/delta:1 \
--related-file path=/my/update/scripts/related_preinstall.json properties='{"microsoft.sourceFileHashAlgorithm": "sha256"}' \
--step updateId.provider=Microsoft updateId.name=SwUpdate updateId.version=1.1 \
--step handler=microsoft/script:1 properties='{"arguments": "--post"}' description="Post-install script" \
--file path=/my/update/scripts/postinstall.sh

Parametri necessari

--compat

Coppie chiave=valore separate da spazi corrispondenti alle proprietà di un dispositivo con cui questo aggiornamento è compatibile. In genere usato per definire proprietà come produttore e modello. --compat può essere usato 1 o più volte.

--step

Coppie chiave=valore separate da spazi corrispondenti alle proprietà dell'elemento 'instructions.steps'. Il client determinerà se un passaggio è un passaggio inline o di riferimento in base alle coppie chiave valore specificate. Se un passaggio inline o di riferimento può essere soddisfatto, il passaggio di riferimento verrà prioritario. L'utilizzo di --file verrà associato alla voce inline più vicina, derivando il valore per 'files'. Sono supportate le chiavi dei passaggi di riferimento seguenti: updateId.provider, updateId.nameupdateId.version e description. Sono supportate le chiavi dei passaggi inline seguenti: handler (ad esempio: 'microsoft/script:1' o 'microsoft/swupdate:1' o 'microsoft/apt:1'), properties (oggetto JSON inline che l'agente passerà al gestore) e description. --step può essere usato 1 o più volte.

--update-name

Nome dell'aggiornamento come componente di updateId.

--update-provider

Provider di aggiornamento come componente di updateId.

--update-version

Versione dell'aggiornamento come componente di updateId.

Parametri facoltativi

--description

Descrizione del manifesto di importazione.

--file

Coppie chiave=valore separate da spazi corrispondenti alle proprietà degli elementi 'files'. Una voce --file può includere le voci --related-file più vicine, se specificato. Sono supportate le chiavi seguenti: path [obbligatorio] percorso del file locale per l'aggiornamento del file, downloadHandler ad esempio 'microsoft/delta:1') per l'utilizzo di file correlati per scaricare il file payload, properties (oggetto JSON inline che l'agente passerà al gestore). --file può essere usato 1 o più volte.

--is-deployable

Indica se l'aggiornamento è distribuibile in modo indipendente.

Valori accettati: false, true

--no-validation

Disabilita la convalida dello schema JSON sul lato client del contenuto del manifesto di importazione.

Valori accettati: false, true

--related-file

Coppie chiave=valore separate da spazi corrispondenti alle proprietà dell'elemento 'files[*].relatedFiles'. Una voce --related-file verrà associata alla voce --file più vicina, se presente. Sono supportate le chiavi seguenti: path [obbligatorio] percorso del file locale per il file di aggiornamento correlato, properties (oggetto JSON inline passato al gestore di download). --related-file può essere usato 1 o più volte.

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.

Condividi tramite