az iot du device group

Note

Ez a hivatkozás az Azure CLI azure-iot bővítményének része (2.67.0-s vagy újabb verzió). A bővítmény automatikusan telepíti az az iot du eszközcsoport parancs első futtatásakor. További információ a bővítményekről.

Eszközcsoport-kezelés.

Az eszközcsoport eszközök gyűjteménye. Az eszközcsoportok számos eszközre skálázhatók az üzemelő példányok. Minden eszköz pontosan egy eszközcsoporthoz tartozik egyszerre. Az eszközcsoport automatikusan létrejön, amikor egy eszközfrissítés-kompatibilis eszköz csatlakozik a központhoz, és jelentést készít a tulajdonságairól.

Parancsok

Name Description Típus Állapot
az iot du device group delete

Eszközcsoport törlése.

Extension GA
az iot du device group list

Eszközcsoportok listázása egy példányon belül.

Extension GA
az iot du device group show

Az eszközcsoport részleteinek megjelenítése, beleértve a legjobb frissítési és frissítési megfelelőséget.

Extension GA

az iot du device group delete

Eszközcsoport törlése.

Az eszközcsoportok nem törlődnek automatikusan, de előzményként megmaradnak. Ez a művelet akkor használható, ha nincs szükség a csoportra, vagy meg kell őriznie az előzményeit. Ha egy eszköz újra csatlakozik egy csoporthoz a csoport törlése után, az automatikusan újra létrejön előzmény nélkül.

az iot du device group delete --account
                              --gid --group-id
                              --instance
                              [--acquire-policy-token]
                              [--change-reference]
                              [--resource-group]
                              [--yes {false, true}]

Példák

Eszközcsoport törlése.

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

Törölje a megerősítési kérést kihagyó eszközcsoportot.

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

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a az config set defaults.adu_account={name}használatával konfigurálhatja.

Tulajdonság Érték
Paramétercsoport: Account Identifier Arguments
--gid --group-id

Eszközcsoport azonosítója. Ez az ADUGroup címke értékéből jön létre a csatlakoztatott IoT Hub eszköz/modul ikereszközén vagy $default címkével nem rendelkező eszközök esetében.

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a az config set defaults.adu_instance={name}használatával konfigurálhatja.

Tulajdonság Érték
Paramétercsoport: Account Identifier Arguments

Opcionális paraméterek

Az alábbi paraméterek megadása nem kötelező, de a környezettől függően előfordulhat, hogy a parancs sikeres végrehajtásához egy vagy több is szükséges lehet.

--acquire-policy-token

Az erőforrásművelethez automatikusan beszerez egy Azure Policy-jogkivonatot.

Tulajdonság Érték
Paramétercsoport: Global Policy Arguments
--change-reference

Az erőforrásművelet kapcsolódó változáshivatkozás-azonosítója.

Tulajdonság Érték
Paramétercsoport: Global Policy Arguments
--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot a az config set defaults.adu_group={name}használatával konfigurálhatja.

Tulajdonság Érték
Paramétercsoport: Account Identifier Arguments
--yes -y

Felhasználói kérések kihagyása. A művelet elfogadását jelzi. Elsősorban automatizálási forgatókönyvekhez használatos. Alapértelmezett: hamis.

Tulajdonság Érték
Elfogadott értékek: false, true
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

Tulajdonság Érték
Alapértelmezett érték: False
--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

Tulajdonság Érték
Alapértelmezett érték: False
--output -o

Kimeneti formátum.

Tulajdonság Érték
Alapértelmezett érték: json
Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

Tulajdonság Érték
Alapértelmezett érték: False

az iot du device group list

Eszközcsoportok listázása egy példányon belül.

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

Példák

Eszközcsoportok listázása.

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

Az eszközcsoportok listázása kívánt sorrendben, ebben az esetben deviceCount szerint.

az iot du device group list -n {account_name} -i {instance_name} --order-by deviceCount

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a az config set defaults.adu_account={name}használatával konfigurálhatja.

Tulajdonság Érték
Paramétercsoport: Account Identifier Arguments
--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a az config set defaults.adu_instance={name}használatával konfigurálhatja.

Tulajdonság Érték
Paramétercsoport: Account Identifier Arguments

Opcionális paraméterek

Az alábbi paraméterek megadása nem kötelező, de a környezettől függően előfordulhat, hogy a parancs sikeres végrehajtásához egy vagy több is szükséges lehet.

--order-by

A visszaadott csoportok készletét rendeli meg. A rendelést groupId, deviceCount, createdDateTime, subgroupsWithNewUpdatesAvailableCount, subgroupsWithUpdatesInProgressCount vagy alcsoportokWithOnLatestUpdateCount szerint lehet megrendelni.

--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot a az config set defaults.adu_group={name}használatával konfigurálhatja.

Tulajdonság Érték
Paramétercsoport: Account Identifier Arguments
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

Tulajdonság Érték
Alapértelmezett érték: False
--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

Tulajdonság Érték
Alapértelmezett érték: False
--output -o

Kimeneti formátum.

Tulajdonság Érték
Alapértelmezett érték: json
Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

Tulajdonság Érték
Alapértelmezett érték: False

az iot du device group show

Az eszközcsoport részleteinek megjelenítése, beleértve a legjobb frissítési és frissítési megfelelőséget.

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

Példák

Eszközcsoport megjelenítése.

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

Az eszközcsoporthoz elérhető legjobb frissítések megjelenítése. Ez a jelző módosítja a parancsot, hogy egy listát adjon vissza.

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

Eszközcsoport frissítési megfelelőségének megjelenítése.

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

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a az config set defaults.adu_account={name}használatával konfigurálhatja.

Tulajdonság Érték
Paramétercsoport: Account Identifier Arguments
--gid --group-id

Eszközcsoport azonosítója. Ez az ADUGroup címke értékéből jön létre a csatlakoztatott IoT Hub eszköz/modul ikereszközén vagy $default címkével nem rendelkező eszközök esetében.

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a az config set defaults.adu_instance={name}használatával konfigurálhatja.

Tulajdonság Érték
Paramétercsoport: Account Identifier Arguments

Opcionális paraméterek

Az alábbi paraméterek megadása nem kötelező, de a környezettől függően előfordulhat, hogy a parancs sikeres végrehajtásához egy vagy több is szükséges lehet.

--best-updates

A parancsot jelző jelzőnek le kell kérnie az eszközcsoport számára elérhető legjobb frissítéseket, beleértve azt is, hogy hány eszköznek van szüksége az egyes frissítésekre. A legjobb frissítés a legújabb frissítés, amely megfelel az eszközosztály összes kompatibilitási specifikációjának.

Tulajdonság Érték
Paramétercsoport: Update Arguments
Elfogadott értékek: false, true
--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot a az config set defaults.adu_group={name}használatával konfigurálhatja.

Tulajdonság Érték
Paramétercsoport: Account Identifier Arguments
--update-compliance

A parancsot jelző jelölőnek le kell kérnie az eszközcsoport frissítési megfelelőségi adatait, például hogy hány eszköz van a legújabb frissítésen, hány új frissítésre van szükség, és hány van folyamatban az új frissítés fogadása során.

Tulajdonság Érték
Paramétercsoport: Update Arguments
Elfogadott értékek: false, true
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

Tulajdonság Érték
Alapértelmezett érték: False
--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

Tulajdonság Érték
Alapértelmezett érték: False
--output -o

Kimeneti formátum.

Tulajdonság Érték
Alapértelmezett érték: json
Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

Tulajdonság Érték
Alapértelmezett érték: False