az iot du device group
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 device group. Přečtěte si další informace o rozšířeních.
Správa skupin zařízení
Skupina zařízení je kolekce zařízení. Skupiny zařízení poskytují způsob, jak škálovat nasazení na mnoho zařízení. Každé zařízení patří do přesně jedné skupiny zařízení najednou. Skupina zařízení se automaticky vytvoří, když je zařízení s podporou aktualizace zařízení připojené k centru a hlásí jeho vlastnosti.
Příkazy
| Name | Description | Typ | Stav |
|---|---|---|---|
| az iot du device group delete |
Odstraňte skupinu zařízení. |
Extension | GA |
| az iot du device group list |
Vypíše skupiny zařízení v rámci instance. |
Extension | GA |
| az iot du device group show |
Zobrazit podrobnosti o skupině zařízení, včetně nejlepší aktualizace a dodržování předpisů aktualizací. |
Extension | GA |
az iot du device group delete
Odstraňte skupinu zařízení.
Skupiny zařízení se automaticky nevyčistí, ale zachovají se pro účely historie. Tuto operaci je možné použít, pokud skupinu nepotřebujete nebo si ji potřebujete zachovat historii. Pokud se zařízení znovu připojí ke skupině po odstranění skupiny, automaticky se znovu vytvoří bez historie.
az iot du device group delete --account
--gid --group-id
--instance
[--acquire-policy-token]
[--change-reference]
[--resource-group]
[--yes {false, true}]
Příklady
Odstraňte skupinu zařízení.
az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id}
Odstraňte skupinu zařízení, která přeskočí výzvu k potvrzení.
az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id} -y
Povinné parametry
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 |
ID skupiny zařízení. Vytvoří se z hodnoty značky ADUGroup ve dvojčeti zařízení/modulu připojeného IoT Hub nebo $default pro zařízení bez značky.
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.
Získání tokenu Azure Policy automaticky pro tuto operaci prostředku
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Global Policy Arguments |
Související referenční ID odkazu na změnu pro tuto operaci prostředku.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Global Policy Arguments |
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 |
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
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
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 device group list
Vypíše skupiny zařízení v rámci instance.
az iot du device group list --account
--instance
[--order-by]
[--resource-group]
Příklady
Vypsat skupiny zařízení
az iot du device group list -n {account_name} -i {instance_name}
Vypište skupiny zařízení v požadovaném pořadí, v tomto případě podle počtu zařízení.
az iot du device group list -n {account_name} -i {instance_name} --order-by deviceCount
Povinné parametry
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 |
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.
Objedná sadu vrácených skupin. Můžete objednat podle groupId, deviceCount, createdDateTime, subgroupsWithNewUpdatesAvailableCount, subgroupsWithUpdatesInProgressCount nebo subgroupsWithOnLatestUpdateCount.
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
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
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 device group show
Zobrazit podrobnosti o skupině zařízení, včetně nejlepší aktualizace a dodržování předpisů aktualizací.
az iot du device group show --account
--gid --group-id
--instance
[--best-updates {false, true}]
[--resource-group]
[--update-compliance {false, true}]
Příklady
Zobrazení skupiny zařízení
az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id}
Zobrazí nejlepší dostupné aktualizace pro skupinu zařízení. Tento příznak upraví příkaz tak, aby vrátil seznam.
az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --best-updates
Zobrazit kompatibilitu aktualizací pro skupinu zařízení
az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --update-compliance
Povinné parametry
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 |
ID skupiny zařízení. Vytvoří se z hodnoty značky ADUGroup ve dvojčeti zařízení/modulu připojeného IoT Hub nebo $default pro zařízení bez značky.
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.
Příznak označující, že příkaz by měl načíst nejlepší dostupné aktualizace pro skupinu zařízení, včetně počtu zařízení, které potřebují každou aktualizaci. Nejlepší aktualizací je nejnovější aktualizace, která splňuje všechny specifikace kompatibility třídy zařízení.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Update Arguments |
| Přípustné hodnoty: | false, true |
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 |
Příznak označující, že příkaz by měl načíst informace o dodržování předpisů pro skupinu zařízení, například kolik zařízení je na nejnovější aktualizaci, kolik je potřeba nových aktualizací a kolik probíhá při přijímání nové aktualizace.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Update Arguments |
| Přípustné hodnoty: | false, true |
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |