Sdílet prostřednictvím

az iot du update

  • Reference

Poznámka:

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

Správa aktualizací služby Device Update

Příkazy

Name Description Typ Stav
az iot du update calculate-hash

Vypočítejte reprezentaci souboru s hodnotou hash base64.

 Rozšíření GA
az iot du update delete

Odstraňte konkrétní verzi aktualizace.

 Rozšíření GA
az iot du update file

Aktualizujte operace se soubory.

 Rozšíření GA
az iot du update file list

Uveďte ID aktualizačního souboru s ohledem na zprostředkovatele aktualizace, název a verzi.

 Rozšíření GA
az iot du update file show

Umožňuje zobrazit podrobnosti konkrétního souboru aktualizace s ohledem na zprostředkovatele aktualizací, název a verzi.

 Rozšíření GA
az iot du update import

Naimportujte novou verzi aktualizace do instance služby Device Update.

 Rozšíření GA
az iot du update init

Nástroj pro inicializaci manifestu importu

 Rozšíření Preview
az iot du update init v5

Inicializace manifestu importu v5 s požadovaným stavem

 Rozšíření Preview
az iot du update list

Zobrazte seznam aktualizací importovaných do instance služby Device Update.

 Rozšíření GA
az iot du update show

Zobrazí konkrétní verzi aktualizace.

 Rozšíření GA
az iot du update stage

Připravte aktualizaci pro import do cílové instance.

 Rozšíření Preview

az iot du update calculate-hash

Vypočítejte reprezentaci souboru s hodnotou hash base64.

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

Příklady

Vypočítá reprezentaci algoritmu sha256 digest pro cílový soubor aktualizace base64.

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

Výpočet reprezentace algoritmu sha256 hash base64 pro více cílových aktualizačních souborů

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

Povinné parametry

--file-path -f

Místní cesta k cílovému souboru pro výpočet hodnoty hash. --file-path lze použít 1 nebo vícekrát.

Volitelné parametry

--hash-algo

Kryptografický algoritmus, který se má použít k hashování.

Přípustné hodnoty: sha256
Default value: sha256
Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az iot du update delete

Odstraňte konkrétní verzi aktualizace.

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

Příklady

Odstraňte cílovou aktualizaci s ohledem na poskytovatele aktualizací, název a verzi.

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

Povinné parametry

--account -n

Název účtu aktualizace zařízení Můžete nakonfigurovat výchozí název účtu pomocí az config set defaults.adu_account=<name>.

--instance -i

Název instance služby Device Update Výchozí název instance můžete nakonfigurovat pomocí az config set defaults.adu_instance=<name>.

--un --update-name

Název aktualizace.

--up --update-provider

Zprostředkovatel aktualizací.

--update-version --uv

Verze aktualizace.

Volitelné parametry

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--resource-group -g

Název skupiny prostředků účtu služby Device Update Výchozí skupinu můžete nakonfigurovat pomocí az config set defaults.adu_group=<name>.

--yes -y

Přeskočte výzvy uživatele. Označuje přijetí akce. Používá se především pro scénáře automatizace. Výchozí hodnota: false.

Přípustné hodnoty: false, true
Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az iot du update import

Naimportujte novou verzi aktualizace do instance služby Device Update.

Tento příkaz podporuje --defer tuto funkci. Při použití příkazu uloží datovou část objektu určenou k odeslání do Azure v místní mezipaměti. Další použití tohoto příkazu bez --defer sloučení nové datové části požadavku s objekty v mezipaměti, které je odesílají dohromady.

Po úspěšném dokončení se vyprázdní odpovídající položka místní mezipaměti. Pokud dojde k selhání obsahu v mezipaměti, neodebere se. Příkazy slouží az cache ke správě položek místní mezipaměti nezávisle.

Podpora odložení je určena především pro aktualizace s více referenčními kroky, aby bylo možné aktualizace nadřazenosti a podřízenosti odeslat společně.

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

Příklady

Importujte aktualizaci se dvěma souvisejícími soubory a žádnými referenčními kroky a explicitně poskytuje hodnotu hash manifestu a velikost manifestu v bajtech.

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}

Naimportujte aktualizaci se dvěma souvisejícími soubory a žádnými referenčními kroky a nechte rozhraní příkazového řádku vypočítat hodnotu hash manifestu importu a velikost v bajtech.

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}

Import nadřazené aktualizace se dvěma podřízenými referenčními kroky aktualizace, kde všechny tři manifesty importu mají jeden související soubor. Nechte rozhraní příkazového řádku vypočítat hodnotu hash a velikost v bajtech pro všechny. Tato operace bude spoléhat na funkci ---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}

Povinné parametry

--account -n

Název účtu aktualizace zařízení Můžete nakonfigurovat výchozí název účtu pomocí az config set defaults.adu_account=<name>.

--instance -i

Název instance služby Device Update Výchozí název instance můžete nakonfigurovat pomocí az config set defaults.adu_instance=<name>.

--url

Směrovatelné umístění, ze kterého je možné stáhnout manifest importu službou Device Update pro IoT Hub. Obvykle se jedná o adresu URL objektu blob chráněného jen pro čtení s vypršením platnosti nastavenou na alespoň 3 hodiny.

Volitelné parametry

--defer

Dočasně uložte objekt do místní mezipaměti místo odeslání do Azure. K zobrazení nebo vymazání použijte az cache příkazy.

--file

Pár klíč=hodnota oddělený mezerníkem odpovídající vlastnostem souboru metadat manifestu. Požadované klíče zahrnují název souboru a adresu URL. --soubor lze použít 1 nebo vícekrát.

--friendly-name

Popisný název přidružený k definici aktualizace

--hashes

Pár klíč=hodnota oddělený mezerníkem, kde je klíč použitý algoritmus hash a hodnota je hodnota hash souboru manifestu importu s kódováním base64. Vyžaduje se aspoň položka sha256. Pokud ho nezadáte, vypočítá se ze zadané adresy URL.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--resource-group -g

Název skupiny prostředků účtu služby Device Update Výchozí skupinu můžete nakonfigurovat pomocí az config set defaults.adu_group=<name>.

--size

Velikost souboru v počtu bajtů Pokud ho nezadáte, vypočítá se ze zadané adresy URL.

Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az iot du update list

Zobrazte seznam aktualizací importovaných do instance služby Device Update.

Při výpisu zprostředkovatelů aktualizací je potřeba kromě běžných argumentů vyhledávání instance dodat příznak --by-provider. Při výpisu názvů aktualizací musí být zadán poskytovatel aktualizací. Při výpisu verzí aktualizací musí být zadán poskytovatel aktualizací a název aktualizace.

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

Příklady

Zobrazí seznam všech aktualizací.

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

Vypište všechny aktualizace splňující kritéria vyhledávání volného textu, v tomto případě zprostředkovatel aktualizací společnosti Contoso.

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

Zobrazí seznam všech aktualizací vyhovujících filtru odata, v tomto případě filtrování pro nesaditelné aktualizace.

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

Zobrazit seznam všech zprostředkovatelů aktualizací

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

Zobrazí seznam všech názvů aktualizací podle poskytovatele aktualizací.

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

Zobrazí seznam všech verzí aktualizací podle zprostředkovatele aktualizací a názvu aktualizace.

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

Povinné parametry

--account -n

Název účtu aktualizace zařízení Můžete nakonfigurovat výchozí název účtu pomocí az config set defaults.adu_account=<name>.

--instance -i

Název instance služby Device Update Výchozí název instance můžete nakonfigurovat pomocí az config set defaults.adu_instance=<name>.

Volitelné parametry

--by-provider

Příznak označující sadu výsledků by měla být omezena na zprostředkovatele aktualizací.

Přípustné hodnoty: false, true
--filter

Omezuje sadu aktualizací vrácených hodnotami vlastností. Podporováno při výpisu aktualizací bez omezení nebo při výpisu podle verze.

--resource-group -g

Název skupiny prostředků účtu služby Device Update Výchozí skupinu můžete nakonfigurovat pomocí az config set defaults.adu_group=<name>.

--search

Žádosti o aktualizace odpovídající výrazu freetextového vyhledávání Podporováno při výpisu aktualizací bez omezení.

--un --update-name

Název aktualizace.

--up --update-provider

Zprostředkovatel aktualizací.

Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az iot du update show

Zobrazí konkrétní verzi aktualizace.

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

Příklady

Zobrazí konkrétní aktualizaci s ohledem na poskytovatele aktualizací, název a verzi.

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

Povinné parametry

--account -n

Název účtu aktualizace zařízení Můžete nakonfigurovat výchozí název účtu pomocí az config set defaults.adu_account=<name>.

--instance -i

Název instance služby Device Update Výchozí název instance můžete nakonfigurovat pomocí az config set defaults.adu_instance=<name>.

--un --update-name

Název aktualizace.

--up --update-provider

Zprostředkovatel aktualizací.

--update-version --uv

Verze aktualizace.

Volitelné parametry

--resource-group -g

Název skupiny prostředků účtu služby Device Update Výchozí skupinu můžete nakonfigurovat pomocí az config set defaults.adu_group=<name>.

Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az iot du update stage

Preview

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

Připravte aktualizaci pro import do cílové instance.

Příprava aktualizace odkazuje na urychlení požadovaných kroků importu aktualizace do cílové instance. V případě daného manifestu importu proces určí relevantní soubory, nasdílí je do požadovaného kontejneru úložiště, vygeneruje identifikátory URI SAS a probere další přípravné kroky pro úspěšné import.

Tento příkaz závisí na organizaci aktualizací souborů na základě konvence. Očekává se, že všechny soubory aktualizací cílového manifestu budou ve stejném adresáři, ve kterém se nachází manifest importu.

Přístup založený na klíči se používá k nahrání artefaktů objektů blob a k vygenerování 3hodinových identifikátorů URI SAS s přístupem pro čtení.

Pokud --then-import je příznak zadaný, příkaz naimportuje fázovanou aktualizaci. V opačném případě je výsledkem této operace příkaz importu, který se spustí, aby se později dosáhlo stejného výsledku.

Tento příkaz vyprázdní a aktualizuje všechny položky místní mezipaměti pro cílovou instanci.

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

Příklady

Připravte samostatnou aktualizaci. Očekává se, že se soubory aktualizace budou nacházet ve stejném adresáři jako manifest. Výsledný příkaz importu se dá spustit později, aby se spustil import fázované aktualizace před vypršením platnosti tokenu SAS.

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

Připravte samostatnou aktualizaci. Po přípravě naimportujte aktualizaci do instance pomocí požadovaného popisného názvu.

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

Připravte aktualizaci s více referenčními informacemi. Soubory aktualizací se nahrají do kontejneru objektů blob úložiště umístěného v jiném předplatném účtu aktualizace.

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

Připravte aktualizaci s více odkazy, která přepíše existující objekty blob, pokud existují. Po přípravě naimportujte aktualizaci do instance.

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

Povinné parametry

--account -n

Název účtu aktualizace zařízení Můžete nakonfigurovat výchozí název účtu pomocí az config set defaults.adu_account=<name>.

--instance -i

Název instance služby Device Update Výchozí název instance můžete nakonfigurovat pomocí az config set defaults.adu_instance=<name>.

--manifest-path

Místní cesta k manifestu importu, který by měl být připravený. Lze použít 1 nebo vícekrát.

--storage-account

Požadovaný název účtu úložiště pro fázi importu artefaktů manifestu

--storage-container

Požadovaný název kontejneru úložiště pro fázi importu artefaktů manifestu

Volitelné parametry

--friendly-name

Popisný název přidružený k definici aktualizace

--overwrite

Příznak označující, jestli by se existující objekty blob měly přepsat, pokud existuje konflikt.

Přípustné hodnoty: false, true
Default value: False
--resource-group -g

Název skupiny prostředků účtu služby Device Update Výchozí skupinu můžete nakonfigurovat pomocí az config set defaults.adu_group=<name>.

--storage-subscription

Požadované předplatné účtu úložiště pro fázi importu artefaktů manifestu Platí pro účty aktualizace úložiště a zařízení v různých předplatných.

--then-import

Příznak označující, jestli má být aktualizace importována po dokončení přípravy.

Přípustné hodnoty: false, true
Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.