Sdílet prostřednictvím

az iot du update init

  • Preview

Note

Tento odkaz je součástí rozšíření azure-iot pro Azure CLI (verze 2.67.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az iot du update init. Přečtěte si další informace o rozšířeních.

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

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

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

Výstupní formát

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