Megosztás a következőn keresztül:

az iot du device class

  • Referencia

Feljegyzés

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

Eszközosztály és eszközosztály alcsoportkezelése.

Az eszközosztályok olyan eszközök készletét ismertetik, amelyek közös attribútumkészletet osztanak meg a csoportok között, míg az eszközosztály alcsoportja az azonos eszközosztály-azonosítóval rendelkező csoportok eszközeinek egy részhalmaza. Az eszközosztályok automatikusan jönnek létre, amikor az eszközfrissítés-kompatibilis eszközök csatlakoznak a központhoz.

Parancsok

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

Eszközosztály vagy eszközosztály alcsoport törlése.

 Mellék FE
az iot du device class list

Eszközosztályok vagy eszközosztály-alcsoportok listázása.

 Mellék FE
az iot du device class show

Az eszközosztály vagy az eszközosztály alcsoportjának részleteinek megjelenítése, beleértve a telepíthető frissítéseket, a legjobb frissítési és frissítési megfelelőséget.

 Mellék FE
az iot du device class update

Eszközosztály frissítése.

 Mellék FE

az iot du device class delete

Eszközosztály vagy eszközosztály alcsoport törlése.

Az eszközosztályok automatikusan létrejönnek, amikor az eszközfrissítés-kompatibilis eszközök csatlakoznak a központhoz, de nem törlődnek automatikusan, mivel az eszközosztály-alcsoportok hivatkoznak rájuk. Ha egy céleszközosztály összes eszközosztály-alcsoportja törlődik, akkor maga az eszközosztály is törölhető, hogy eltávolítsa a rekordokat a rendszerből, és ne ellenőrizze az eszközosztály kompatibilitását az új frissítésekkel. Ha egy eszköz újracsatlakozik, az eszközosztálya újra létrejön, ha nem létezik.

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

Példák

Eszközosztály törlése.

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

Törölje az eszközosztályt, és hagyja ki a megerősítést kérő üzenetet.

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

Eszközosztály-alcsoport törlése.

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

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a következővel az config set defaults.adu_account=<name>konfigurálhatja: .

--cid --class-id

Eszközosztály azonosítója. Ez a modellazonosítóból és az eszközfrissítési ügynök által jelentett kompatibilitási tulajdonságokból jön létre az IoT Hub eszközfrissítési PnP-felületén. Ez egy hexán kódolt SHA1 kivonat.

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a következővel az config set defaults.adu_instance=<name>konfigurálhatja: .

Opcionális paraméterek

--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 ikereszközén/moduljában vagy $default címkével nem rendelkező eszközök esetében.

--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot konfigurálhatja a következővel az config set defaults.adu_group=<name>: .

--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 érték: false (hamis).

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.

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

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--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 konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

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

az iot du device class list

Eszközosztályok vagy eszközosztály-alcsoportok listázása.

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

Példák

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

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

Felhasználóbarát névvel szűrt példány-eszközosztályok listázása.

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

A csoport eszközosztály-alcsoportjainak listázása.

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

A csoport eszközosztály-alcsoportjainak listázása compatProperties/manufacturer szerint szűrve.

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

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a következővel az config set defaults.adu_account=<name>konfigurálhatja: .

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a következővel az config set defaults.adu_instance=<name>konfigurálhatja: .

Opcionális paraméterek

--filter

Ha --group-id van megadva, támogatja az eszközosztály-compat tulajdonságnevek és értékek alapján történő szűrést. Például: "compatProperties/manufacturer eq "Contoso". Ellenkező esetben az osztálybarát név alapján történő szűrést támogatja.

--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 ikereszközén/moduljában vagy $default címkével nem rendelkező eszközök esetében.

--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot konfigurálhatja a következővel az config set defaults.adu_group=<name>: .

Globális paraméterek
--debug

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

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

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--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 konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

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

az iot du device class show

Az eszközosztály vagy az eszközosztály alcsoportjának részleteinek megjelenítése, beleértve a telepíthető frissítéseket, a legjobb frissítési és frissítési megfelelőséget.

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éldák

Eszközosztály megjelenítése.

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

Az eszközosztály telepíthető frissítéseinek megjelenítése. Ez a jelző módosítja a parancsot, hogy egy listát adjon vissza.

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

Eszközosztály alcsoport megjelenítése.

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

Az eszközosztály alcsoportja számára elérhető legjobb frissítés megjelenítése.

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

Eszközosztály-alcsoport frissítési megfelelőségének megjelenítése.

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --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 következővel az config set defaults.adu_account=<name>konfigurálhatja: .

--cid --class-id

Eszközosztály azonosítója. Ez a modellazonosítóból és az eszközfrissítési ügynök által jelentett kompatibilitási tulajdonságokból jön létre az IoT Hub eszközfrissítési PnP-felületén. Ez egy hexán kódolt SHA1 kivonat.

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a következővel az config set defaults.adu_instance=<name>konfigurálhatja: .

Opcionális paraméterek

--best-update

A parancsot jelző jelzőnek le kell kérnie az eszközosztály alcsoportja számára elérhető legjobb frissítést, beleértve annak számát, hogy hány eszköznek van szüksége a frissítésre. A jelölőhöz csoportazonosító szükséges. A legjobb frissítés a legújabb frissítés, amely megfelel az eszközosztály összes kompatibilitási specifikációjának.

elfogadott értékek: false, true
--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 ikereszközén/moduljában vagy $default címkével nem rendelkező eszközök esetében.

--installable-updates

A parancsot jelző jelzőnek le kell kérnie az eszközosztály telepíthető frissítéseit.

elfogadott értékek: false, true
--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot konfigurálhatja a következővel az config set defaults.adu_group=<name>: .

--update-compliance

A parancsot jelző jelölőnek le kell kérnie az eszközosztály alcsoportjának frissítési megfelelőségi adatait, például hogy hány eszköz van a legújabb frissítésen, hányan igényelnek új frissítéseket, és hány van folyamatban az új frissítés fogadása során. A jelölőhöz csoportazonosító szükséges.

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.

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

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--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 konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

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

az iot du device class update

Eszközosztály frissítése.

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

Példák

Frissítse az eszközosztály felhasználóbarát nevét.

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

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a következővel az config set defaults.adu_account=<name>konfigurálhatja: .

--cid --class-id

Eszközosztály azonosítója. Ez a modellazonosítóból és az eszközfrissítési ügynök által jelentett kompatibilitási tulajdonságokból jön létre az IoT Hub eszközfrissítési PnP-felületén. Ez egy hexán kódolt SHA1 kivonat.

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a következővel az config set defaults.adu_instance=<name>konfigurálhatja: .

Opcionális paraméterek

--friendly-name

Az eszközosztály felhasználóbarát neve. A rövid névnek 1–100 karakternek kell lennie, és támogatja az alfanumerikus, a pont- és a kötőjelértékeket.

--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot konfigurálhatja a következővel az config set defaults.adu_group=<name>: .

Globális paraméterek
--debug

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

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

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--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 konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

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