Sdílet prostřednictvím

az iot du update

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

 Extension GA
az iot du update delete

Odstraňte konkrétní verzi aktualizace.

 Extension GA
az iot du update file

Aktualizujte operace se soubory.

 Extension GA
az iot du update file list

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

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

 Extension GA
az iot du update import

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

 Extension GA
az iot du update init

Nástroj pro inicializaci manifestu importu

 Extension Preview
az iot du update init v5

Inicializace manifestu importu v5 s požadovaným stavem

 Extension Preview
az iot du update list

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

 Extension GA
az iot du update show

Zobrazí konkrétní verzi aktualizace.

 Extension GA
az iot du update stage

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

 Extension 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

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.

--hash-algo

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

Vlastnost Hodnota
Default value: sha256
Přípustné hodnoty: sha256
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

az iot du update delete

Odstraňte konkrétní verzi aktualizace.

az iot du update delete --account
                        --instance
                        --un --update-name
                        --up --update-provider
                        --update-version --uv
                        [--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í Výchozí název účtu můžete nakonfigurovat pomocí az config set defaults.adu_account={name}.

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments
--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}.

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments
--un --update-name

Název aktualizace.

--up --update-provider

Zprostředkovatel aktualizací.

--update-version --uv

Verze aktualizace.

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.

--no-wait

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

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

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments
--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.

Vlastnost Hodnota
Přípustné hodnoty: false, true
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

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í Výchozí název účtu můžete nakonfigurovat pomocí az config set defaults.adu_account={name}.

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments
--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}.

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments
--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

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.

--defer

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

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

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

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments
--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í.

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

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

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í Výchozí název účtu můžete nakonfigurovat pomocí az config set defaults.adu_account={name}.

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments
--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}.

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments

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.

--by-provider

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

Vlastnost Hodnota
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.

Vlastnost Hodnota
Skupina parametrů: Filter Arguments
--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}.

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments
--search

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

Vlastnost Hodnota
Skupina parametrů: Filter Arguments
--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í.

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

az iot du update show

Zobrazí konkrétní verzi aktualizace.

az iot du update show --account
                      --instance
                      --un --update-name
                      --up --update-provider
                      --update-version --uv
                      [--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í Výchozí název účtu můžete nakonfigurovat pomocí az config set defaults.adu_account={name}.

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments
--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}.

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments
--un --update-name

Název aktualizace.

--up --update-provider

Zprostředkovatel aktualizací.

--update-version --uv

Verze aktualizace.

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.

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

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments
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

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í Výchozí název účtu můžete nakonfigurovat pomocí az config set defaults.adu_account={name}.

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments
--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}.

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments
--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

Vlastnost Hodnota
Skupina parametrů: Storage Arguments
--storage-container

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

Vlastnost Hodnota
Skupina parametrů: Storage Arguments

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.

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

Vlastnost Hodnota
Default value: False
Přípustné hodnoty: false, true
--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}.

Vlastnost Hodnota
Skupina parametrů: Account Identifier Arguments
--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.

Vlastnost Hodnota
Skupina parametrů: Storage Arguments
--then-import

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

Vlastnost Hodnota
Přípustné hodnoty: false, true
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