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

--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
--gid --group-id

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.

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

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost Hodnota
Skupina parametrů: Global Policy 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
--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 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

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

--order-by

Objedná sadu vrácených skupin. Můžete objednat podle groupId, deviceCount, createdDateTime, subgroupsWithNewUpdatesAvailableCount, subgroupsWithUpdatesInProgressCount nebo subgroupsWithOnLatestUpdateCount.

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

--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
--gid --group-id

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.

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

--best-updates

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

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