Sdílet prostřednictvím

az iot du device deployment

  • 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 device deployment . Přečtěte si další informace o rozšířeních.

Správa nasazení zařízení

Nasazení použijí požadovanou kompatibilní aktualizaci pro cílovou skupinu zařízení, která distribuuje aktualizaci napříč třídami zařízení v rámci skupiny. Zásady vrácení zpět iniciované cloudem je možné volitelně nakonfigurovat.

Příkazy

Name Description Typ Stav
az iot du device deployment cancel

Zrušte nasazení podskupiny třídy zařízení.

 Rozšíření GA
az iot du device deployment create

Vytvořte nasazení pro skupinu zařízení. Nasazení bude vícenásobné přetypování pro každou podskupinu třídy zařízení v rámci cílové skupiny.

 Rozšíření GA
az iot du device deployment delete

Odstraňte nasazení podle skupiny zařízení nebo podskupiny třídy zařízení.

 Rozšíření GA
az iot du device deployment list

Zobrazí seznam nasazení pro skupinu zařízení nebo podskupinu třídy zařízení.

 Rozšíření GA
az iot du device deployment list-devices

Zobrazí seznam zařízení v nasazení podskupiny třídy zařízení spolu s jejich stavem. Užitečné pro získání seznamu zařízení, která selhala.

 Rozšíření GA
az iot du device deployment retry

Zopakujte nasazení podskupiny třídy zařízení.

 Rozšíření GA
az iot du device deployment show

Zobrazí nasazení pro skupinu zařízení nebo podskupinu třídy zařízení, včetně stavu, ve kterém je podrobně rozpis počtu probíhajících, dokončených nebo neúspěšných zařízení v nasazení.

 Rozšíření GA

az iot du device deployment cancel

Zrušte nasazení podskupiny třídy zařízení.

az iot du device deployment cancel --account
                                   --cid
                                   --deployment-id
                                   --gid
                                   --instance
                                   [--resource-group]

Příklady

Zrušte nasazení podskupiny cílové třídy zařízení.

az iot du device deployment cancel -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}

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

--cid --class-id

ID třídy zařízení. To se vygeneruje z ID modelu a vlastností compat hlášených agentem aktualizace zařízení v rozhraní PnP služby Device Update v IoT Hubu. Jedná se o šestnáctkovou hodnotu hash SHA1.

--deployment-id --did

ID nasazení poskytnuté volajícím. Nesmí být delší než 73 znaků, musí obsahovat všechna malá písmena a nesmí obsahovat znak &, ^, [, ], {, }, |, |, lomítko<>, zpětné lomítko nebo dvojité uvozovky.

--gid --group-id

ID skupiny zařízení. Vytvoří se z hodnoty značky ADUGroup ve dvojčeti zařízení nebo modulu připojené služby IoT Hub nebo $default pro zařízení bez značky.

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

--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 device deployment create

Vytvořte nasazení pro skupinu zařízení. Nasazení bude vícenásobné přetypování pro každou podskupinu třídy zařízení v rámci cílové skupiny.

az iot du device deployment create --account
                                   --deployment-id
                                   --gid
                                   --instance
                                   --un
                                   --up
                                   --update-version
                                   [--failed-count]
                                   [--failed-percentage]
                                   [--rbun]
                                   [--rbup]
                                   [--rbuv]
                                   [--resource-group]
                                   [--start-time]

Příklady

Vytvořte nasazení skupiny zařízení naplánované tak, aby se spustilo okamžitě (s ohledem na čas UTC).

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version}

Vytvořte nasazení skupiny zařízení naplánované tak, aby se začalo s požadovaným datem datetime kompatibilním se standardem ISO-8601.

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --start-time "2022-12-20T01:00:00"

Vytvořte nasazení skupiny zařízení naplánované tak, aby se okamžitě spustilo s definovanou zásadou vrácení zpět iniciovanou cloudem. Vrácení zpět do cloudu se zahájí, když se splní počet neúspěšných nebo neúspěšných cílů v procentech.

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --failed-count 10 --failed-percentage 5 --rollback-update-name {rollback_update_name} --rollback-update-provider {rollback_update_provider} --rollback-update-version {rollback_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>.

--deployment-id --did

ID nasazení poskytnuté volajícím. Nesmí být delší než 73 znaků, musí obsahovat všechna malá písmena a nesmí obsahovat znak &, ^, [, ], {, }, |, |, lomítko<>, zpětné lomítko nebo dvojité uvozovky.

--gid --group-id

ID skupiny zařízení. Vytvoří se z hodnoty značky ADUGroup ve dvojčeti zařízení nebo modulu připojené služby IoT Hub nebo $default pro zařízení bez značky.

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

--failed-count --fc

Celé číslo představující počet neúspěšných zařízení v nasazení před inicializačním vrácením do cloudu. Vyžaduje se při definování zásad vrácení zpět.

--failed-percentage --fp

Celé číslo představující procento neúspěšných zařízení v nasazení před inicializačním vrácením do cloudu. Vyžaduje se při definování zásad vrácení zpět.

--rbun --rollback-update-name

Název aktualizace vrácení zpět.

--rbup --rollback-update-provider

Zprostředkovatel aktualizace vrácení zpět.

--rbuv --rollback-update-version

Verze aktualizace vrácení zpět.

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

--start-time

Čas zahájení nasazení kompatibilní se standardem iso-8601. Pokud není zadaná žádná hodnota, použije se odpovídající hodnota pro UTC "now".

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 device deployment delete

Odstraňte nasazení podle skupiny zařízení nebo podskupiny třídy zařízení.

az iot du device deployment delete --account
                                   --deployment-id
                                   --gid
                                   --instance
                                   [--cid]
                                   [--resource-group]
                                   [--yes {false, true}]

Příklady

Odstraňte nasazení cílové skupiny zařízení.

az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id}

Odstraňte nasazení podskupiny cílové třídy zařízení.

az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}

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

--deployment-id --did

ID nasazení poskytnuté volajícím. Nesmí být delší než 73 znaků, musí obsahovat všechna malá písmena a nesmí obsahovat znak &, ^, [, ], {, }, |, |, lomítko<>, zpětné lomítko nebo dvojité uvozovky.

--gid --group-id

ID skupiny zařízení. Vytvoří se z hodnoty značky ADUGroup ve dvojčeti zařízení nebo modulu připojené služby IoT Hub nebo $default pro zařízení bez značky.

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

--cid --class-id

ID třídy zařízení. To se vygeneruje z ID modelu a vlastností compat hlášených agentem aktualizace zařízení v rozhraní PnP služby Device Update v IoT Hubu. Jedná se o šestnáctkovou hodnotu hash SHA1.

--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 device deployment list

Zobrazí seznam nasazení pro skupinu zařízení nebo podskupinu třídy zařízení.

az iot du device deployment list --account
                                 --gid
                                 --instance
                                 [--cid]
                                 [--order-by]
                                 [--resource-group]

Příklady

Zobrazení seznamu nasazení pro skupinu zařízení

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id}

Zobrazení seznamu nasazení pro řazení výsledků skupiny zařízení podle hodnoty startDateTime sestupně

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --order-by "startDateTime desc"

Zobrazení seznamu nasazení pro podskupinu třídy zařízení

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id}

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

--gid --group-id

ID skupiny zařízení. Vytvoří se z hodnoty značky ADUGroup ve dvojčeti zařízení nebo modulu připojené služby IoT Hub nebo $default pro zařízení bez značky.

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

--cid --class-id

ID třídy zařízení. To se vygeneruje z ID modelu a vlastností compat hlášených agentem aktualizace zařízení v rozhraní PnP služby Device Update v IoT Hubu. Jedná se o šestnáctkovou hodnotu hash SHA1.

--order-by

Objedná sadu vrácených nasazení. Objednávku můžete objednat podle startDateTime [desc/asc].

--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 device deployment list-devices

Zobrazí seznam zařízení v nasazení podskupiny třídy zařízení spolu s jejich stavem. Užitečné pro získání seznamu zařízení, která selhala.

az iot du device deployment list-devices --account
                                         --cid
                                         --deployment-id
                                         --gid
                                         --instance
                                         [--filter]
                                         [--resource-group]

Příklady

Zobrazí seznam zařízení v nasazení podskupiny třídy zařízení.

az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id}

Zobrazí seznam zařízení v podskupině nasazení třídy zařízení filtrování podle deviceId a deviceState.

az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --filter "deviceId eq 'd0' and deviceState eq 'InProgress'"

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

--cid --class-id

ID třídy zařízení. To se vygeneruje z ID modelu a vlastností compat hlášených agentem aktualizace zařízení v rozhraní PnP služby Device Update v IoT Hubu. Jedná se o šestnáctkovou hodnotu hash SHA1.

--deployment-id --did

ID nasazení poskytnuté volajícím. Nesmí být delší než 73 znaků, musí obsahovat všechna malá písmena a nesmí obsahovat znak &, ^, [, ], {, }, |, |, lomítko<>, zpětné lomítko nebo dvojité uvozovky.

--gid --group-id

ID skupiny zařízení. Vytvoří se z hodnoty značky ADUGroup ve dvojčeti zařízení nebo modulu připojené služby IoT Hub nebo $default pro zařízení bez značky.

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

--filter

Omezí vrácenou sadu stavů zařízení nasazení. Můžete filtrovat podle id zařízení a moduleId a/nebo deviceState.

--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 device deployment retry

Zopakujte nasazení podskupiny třídy zařízení.

az iot du device deployment retry --account
                                  --cid
                                  --deployment-id
                                  --gid
                                  --instance
                                  [--resource-group]

Příklady

Opakujte nasazení podskupiny cílové třídy zařízení.

az iot du device deployment retry -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}

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

--cid --class-id

ID třídy zařízení. To se vygeneruje z ID modelu a vlastností compat hlášených agentem aktualizace zařízení v rozhraní PnP služby Device Update v IoT Hubu. Jedná se o šestnáctkovou hodnotu hash SHA1.

--deployment-id --did

ID nasazení poskytnuté volajícím. Nesmí být delší než 73 znaků, musí obsahovat všechna malá písmena a nesmí obsahovat znak &, ^, [, ], {, }, |, |, lomítko<>, zpětné lomítko nebo dvojité uvozovky.

--gid --group-id

ID skupiny zařízení. Vytvoří se z hodnoty značky ADUGroup ve dvojčeti zařízení nebo modulu připojené služby IoT Hub nebo $default pro zařízení bez značky.

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

--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 device deployment show

Zobrazí nasazení pro skupinu zařízení nebo podskupinu třídy zařízení, včetně stavu, ve kterém je podrobně rozpis počtu probíhajících, dokončených nebo neúspěšných zařízení v nasazení.

az iot du device deployment show --account
                                 --deployment-id
                                 --gid
                                 --instance
                                 [--cid]
                                 [--resource-group]
                                 [--status {false, true}]

Příklady

Zobrazení nasazení pro skupinu zařízení

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id}

Zobrazí stav nasazení skupiny zařízení.

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --status

Zobrazení nasazení pro podskupinu třídy zařízení

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id}

Zobrazí stav nasazení podskupiny třídy zařízení.

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --status

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

--deployment-id --did

ID nasazení poskytnuté volajícím. Nesmí být delší než 73 znaků, musí obsahovat všechna malá písmena a nesmí obsahovat znak &, ^, [, ], {, }, |, |, lomítko<>, zpětné lomítko nebo dvojité uvozovky.

--gid --group-id

ID skupiny zařízení. Vytvoří se z hodnoty značky ADUGroup ve dvojčeti zařízení nebo modulu připojené služby IoT Hub nebo $default pro zařízení bez značky.

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

--cid --class-id

ID třídy zařízení. To se vygeneruje z ID modelu a vlastností compat hlášených agentem aktualizace zařízení v rozhraní PnP služby Device Update v IoT Hubu. Jedná se o šestnáctkovou hodnotu hash SHA1.

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

--status

Získá stav nasazení, včetně rozpisu počtu probíhajících, dokončených nebo neúspěšných zařízení v nasazení.

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.