az iot du update init

Preview

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az iot du update init. Learn more about extensions.

Tato skupina příkazů je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Nástroj pro inicializaci manifestu importu

Příkazy

Name	Description	Typ	Stav
az iot du update init v5	Inicializace manifestu importu v5 s požadovaným stavem	Extension	Preview

az iot du update init v5

Preview

Skupina příkazů iot du update init je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Inicializace manifestu importu v5 s požadovaným stavem

Tento příkaz podporuje všechny atributy manifestu importu v5. Všimněte si, že mezi poziční citlivostí --step--filea , stejně jako --file a --related-file. Podrobnosti o tom, jak plně využít operaci, najdete v příkladech a popisech parametrů.

Přečtěte si další informace o použití uvozovek a řídicích znaků v různých prostředích zde: 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]

Příklady

Inicializace minimálního manifestu importu obsahu Vložený json optimalizovaný pro 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

Inicializace minimálního manifestu importu obsahu Vložený json optimalizovaný pro 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

Inicializace minimálního manifestu importu obsahu Vložený json optimalizovaný pro 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

Inicializace minimálního manifestu importu obsahu Pro json použijte vstup souboru.

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

Inicializace nesaditelné aktualizace typu list, na které se má odkazovat v sbalené aktualizaci Vložený json optimalizovaný pro 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

Inicializace sbalené aktualizace odkazující na aktualizaci typu list a definování nezávislých kroků Příklad optimalizovaný pro bash pomocí pokračování příkazu k vymezení segmentů manifestu importu.

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

Povinné parametry

--compat

Pár klíč=hodnota oddělený mezerníkem odpovídající vlastnostem zařízení, se kterým je tato aktualizace kompatibilní. Obvykle se používá k definování vlastností, jako je výrobce a model. --compat lze použít 1 nebo vícekrát.

--step

Pár klíč=hodnota oddělený mezerníkem odpovídající vlastnostem elementu instructions.steps Klient určí, jestli je krok vložený nebo referenční krok na základě zadaných párů klíč-hodnota. Pokud je možné provést vložený nebo referenční krok, bude upřednostněn krok odkazu. Použití souboru --file se přidružuje k nejbližší vložené položce --step, která odvozuje hodnotu pro soubory. Podporují se následující referenční klíče: updateId.provider, updateId.name, updateId.version a description. Podporují se následující vložené klíče kroku: handler (např. microsoft/script:1 nebo microsoft/swupdate:1 nebo microsoft/apt:1), properties (vložený objekt JSON, který agent předá obslužné rutině) a description. --step lze použít 1 nebo vícekrát.

--update-name

Název aktualizace jako součást updateId.

--update-provider

Zprostředkovatel aktualizací jako součást updateId.

--update-version

Verze aktualizace jako součást updateId.

Volitelné parametry

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

--description

Popis manifestu importu

--file

Pár klíč=hodnota oddělený mezerníkem odpovídající vlastnostem elementu "files". Položka --file může v případě zadání obsahovat nejbližší položky souvisejícího souboru. Podporují se následující klíče: path [povinné] místní cesta k souboru pro aktualizaci souboru, downloadHandler (např. microsoft/delta:1) pro využití souvisejících souborů ke stažení souboru datové části properties (objekt JSON v řádku, který agent předá obslužné rutině). --soubor lze použít 1 nebo vícekrát.

--is-deployable

Určuje, jestli je aktualizace nezávisle nasaditelná.

Vlastnost	Hodnota
Přípustné hodnoty:	false, true

--no-validation

Zakáže ověření schématu JSON na straně klienta u obsahu manifestu importu.

Vlastnost	Hodnota
Přípustné hodnoty:	false, true

--related-file

Pár klíč=hodnota oddělený mezerníkem odpovídající vlastnostem elementu files[*].relatedFiles Položka --related-file se přidružuje k nejbližší položce --file, pokud existuje. Podporují se následující klíče: path [povinné] místní cestu k souboru aktualizace souvisejícímu properties (objekt JSON vložený předaný obslužné rutině stahování). --related-file lze použít 1 nebo vícekrát.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Output format.

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False