az iot du device class

  • Reference

Poznámka

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

Správa podskupiny třídy zařízení a třídy zařízení

Třída zařízení popisuje sadu zařízení, která sdílejí společnou sadu atributů napříč skupinami, zatímco podskupina třídy zařízení je podmnožinou zařízení ve skupině, která sdílí stejné ID třídy zařízení. Třídy zařízení se vytvářejí automaticky, když jsou zařízení s podporou aktualizace zařízení připojená k centru.

Příkazy

Name Description Typ Stav
az iot du device class delete

Odstraňte podskupinu třídy zařízení nebo třídy zařízení.

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

Vypíše třídy zařízení nebo podskupiny tříd zařízení.

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

Umožňuje zobrazit podrobnosti o třídě zařízení nebo podskupině třídy zařízení, včetně instalovatelných aktualizací, nejlepší aktualizace a dodržování předpisů aktualizací.

 Rozšíření GA
az iot du device class update

Aktualizujte třídu zařízení.

 Rozšíření GA

az iot du device class delete

Odstraňte podskupinu třídy zařízení nebo třídy zařízení.

Třídy zařízení se automaticky vytvoří, když jsou zařízení s podporou aktualizace zařízení připojená k centru, ale automaticky se nevyčistí, protože na zařízení odkazují podskupiny tříd zařízení. Pokud jsou odstraněny všechny podskupiny třídy zařízení pro cílovou třídu zařízení, můžete také odstranit samotnou třídu zařízení, která odebere záznamy ze systému, a zastavit kontrolu kompatibility třídy zařízení s novými aktualizacemi. Pokud se zařízení někdy znovu připojí ke své třídě zařízení, vytvoří se znovu, pokud neexistuje.

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

Příklady

Odstraňte třídu zařízení.

az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id}

Odstraňte třídu zařízení a přeskočte potvrzovací výzvu.

az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} -y

Odstraňte podskupinu třídy zařízení.

az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_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.

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

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

--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řijímané 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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: 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 class list

Vypíše třídy zařízení nebo podskupiny tříd zařízení.

az iot du device class list --account
                            --instance
                            [--filter]
                            [--gid]
                            [--resource-group]

Příklady

Vypíše třídy zařízení v rámci instance.

az iot du device class list -n {account_name} -i {instance_name}

Vypsat třídy zařízení instance filtrované podle popisného názvu

az iot du device class list -n {account_name} -i {instance_name} --filter "friendlyName eq 'my-favorite-class'"

Vypíše podskupiny tříd zařízení pro skupinu.

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

Vypsat podskupiny tříd zařízení pro skupinu filtrované podle compatProperties/manufacturer.

az iot du device class list -n {account_name} -i {instance_name} --group-id {device_group_id} --filter "compatProperties/manufacturer eq 'Contoso'"

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

--filter

Pokud je k dispozici parametr --group-id, podporuje filtrování na základě názvů a hodnot vlastností třídy zařízení. Například compatProperties/manufacturer eq 'Contoso'. V opačném případě podporuje filtrování podle popisného názvu třídy.

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

--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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: 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 class show

Umožňuje zobrazit podrobnosti o třídě zařízení nebo podskupině třídy zařízení, včetně instalovatelných aktualizací, nejlepší aktualizace a dodržování předpisů aktualizací.

az iot du device class show --account
                            --cid
                            --instance
                            [--best-update {false, true}]
                            [--gid]
                            [--installable-updates {false, true}]
                            [--resource-group]
                            [--update-compliance {false, true}]

Příklady

Zobrazení třídy zařízení

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id}

Umožňuje zobrazit instalovatelné aktualizace pro třídu zařízení. Tento příznak upraví příkaz tak, aby vrátil seznam.

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --installable-updates

Zobrazí podskupinu třídy zařízení.

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

Zobrazí nejlepší dostupnou aktualizaci pro podskupinu třídy zařízení.

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

Zobrazí dodržování předpisů aktualizací pro podskupinu třídy zařízení.

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

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.

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

--best-update

Příznak označující, že příkaz by měl načíst nejlepší dostupnou aktualizaci pro podskupinu třídy zařízení, včetně počtu zařízení, která aktualizaci potřebují. Pro tento příznak se vyžaduje ID skupiny. Nejlepší aktualizací je nejnovější aktualizace, která splňuje všechny specifikace kompatibility třídy zařízení.

přijímané hodnoty: false, true
--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.

--installable-updates

Příznak označující příkaz by měl načíst instalovatelné aktualizace pro třídu zařízení.

přijímané 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>.

--update-compliance

Příznak označující, že příkaz by měl načíst informace o kompatibilitě aktualizací třídy zařízení, například kolik zařízení je na nejnovější aktualizaci, kolik potřebuje nové aktualizace a kolik probíhá při přijímání nové aktualizace. Pro tento příznak se vyžaduje ID skupiny.

přijímané 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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: 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 class update

Aktualizujte třídu zařízení.

az iot du device class update --account
                              --cid
                              --instance
                              [--friendly-name]
                              [--resource-group]

Příklady

Aktualizujte popisný název třídy zařízení.

az iot du device class update -n {account_name} -i {instance_name} --class-id {device_class_id} --friendly-name "EU-region"

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.

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

--friendly-name

Popisný název třídy zařízení. Popisný název musí být 1 až 100 znaků a podporuje alfanumerické hodnoty, tečky a pomlčky.

--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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: 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.