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

Eszközcsoportok kezelése az Azure Device Update for IoT Hubhoz

  • Cikk

Az Azure Device Update for IoT Hub lehetővé teszi a frissítések üzembe helyezését az IoT-eszközök felhasználó által meghatározott csoportjaiban. Minden eszközfrissítéssel felügyelt eszköz egy eszközcsoport tagja, de az eszközcsoportok meghatározása nem kötelező. Másik lehetőségként telepítheti az eszközfrissítés által biztosított alapértelmezett eszközcsoportot.

Ha felhasználó által definiált eszközfrissítési címkeértékeket hoz létre és rendel hozzá az eszközökhöz, az Eszközfrissítés automatikusan létrehozza a csoportokat a hozzárendelt címkék és az eszközkompatibilitási tulajdonságok alapján. Az Eszközfrissítés minden eszközcsoporthoz több alcsoportot is létrehozhat, amelyek különböző eszközosztályokkal rendelkeznek. Az Eszközfrissítés olyan eszközöket helyez el, amelyek nem rendelkeznek címkékkel az default eszközcsoportban.

Ez a cikk bemutatja, hogyan hozhat létre és kezelhet felhasználó által definiált eszközfrissítési eszközcímkéket és -csoportokat az Azure Portal vagy az Azure CLI használatával. Ha felhasználó által definiált vagy alapértelmezett eszközcsoportokra szeretne frissítéseket telepíteni, olvassa el az Eszközfrissítés üzembe helyezése című témakört.

Előfeltételek

Címkék hozzáadása az eszközökhöz

Eszközfrissítési eszközcsoport hozzárendeléséhez adja hozzá a címkét az ADUGroup IoT Hub eszközfrissítéshez csatlakoztatott eszközeinek célkészletéhez. Adja hozzá a címkét az ikereszközhöz, ha az Eszközfrissítési ügynök ki van építve az eszközidentitással, vagy ha az eszközfrissítési ügynök ki van építve modulidentitással.

Az Eszközfrissítés ADUGroup címke kulcs-érték formátumot használ az alábbi ikereszköz- vagy modulpéldában látható módon:

"etag": "",
"deviceId": "",
"deviceEtag": "",
"version": <version>,
"tags": {
   "ADUGroup": "<CustomTagValue>"
}

Az iker JSON-szintaxissal kapcsolatos további információkért és példákért tekintse meg az ikereszközök megértését és használatát, illetve a modulikrek megértését és használatát ismertető témakört.

A ADUGroup címke a következő tulajdonságokkal és korlátozásokkal rendelkezik:

  • Egy eszköz csak egy ADUGroup címkével rendelkezhet, és egyszerre csak egy eszközfrissítési csoporthoz tartozhat. Egy másik névvel ellátott ADUGroup címke hozzáadása felülírja a meglévő ADUGroup értéket.
  • A címkéhez bármilyen értéket használhat, kivéve a fenntartott értékeket Uncategorized és $defaulta .
  • A címke értéke nem haladhatja meg a 200 karaktert.
  • A címke értéke alfanumerikus karaktereket és a következő speciális karaktereket tartalmazhat: . - _ ~.
  • A ADUGroup címkenév és a csoportnév értékei megkülönböztetik a kis- és nagybetűket.

Az alábbi szakaszok a címke hozzáadásának és frissítésének számos módját ismertetik.

Címkék hozzáadása SDK-kkal

Az eszköz vagy modul ikerpéldányát a RegistryManagerrel frissítheti a megfelelő címkével, miután regisztrálta az eszközt az Eszközfrissítéssel. További információért tekintse át az alábbi cikkeket:

Címkék hozzáadása feladatok használatával

Ütemezhet feladatokat az eszközfrissítési címkék hozzáadására vagy frissítésére több eszközön. Feladatműveletek például: Feladatok ütemezése több eszközön. Az ikereszközöket vagy a moduli ikerpéldányokat feladatokkal frissítheti attól függően, hogy az eszközfrissítési ügynök ki van-e építve egy eszköz- vagy modulidentitással. További információ: Feladatok ütemezése és közvetítése.

Feljegyzés

Ez a művelet az IoT Hub-üzenetek kvótájához számít. Ha egyszerre 50 000 vagy több ikereszköz- vagy modulcímkét módosít, előfordulhat, hogy túllépi a napi IoT Hub-üzenetkvótát, és további IoT Hub-egységeket kell vásárolnia. További információ: Kvóták és szabályozás.

Címkék hozzáadása ikerpéldányok frissítésével

A címkét közvetlenül az ADUGroup eszközön vagy a modul ikerpéldányában is hozzáadhatja vagy frissítheti.

  1. Az Azure Portalon keresse meg az IoT hubot.

  2. A bal oldali navigációs panelen válassza az Eszközök eszközkezelés területén található eszközöket. Ha rendelkezik IoT Edge-eszközzel, válassza inkább az IoT Edge lehetőséget.

  3. Az Eszközök lapon válassza ki az eszközt.

  4. Az eszközoldalon válassza az ikereszközt a felső menüből, vagy válassza ki a modul identitását a Modulidentitások területen, majd válassza ki a modul ikerpéldányát.

  5. Az ikerpéldányban adja hozzá a ADUGroup felhasználó által megadott értékkel rendelkező címkét az alábbiak szerint. Meglévő ADUGroup címkeérték frissítéséhez írja felül azt egy másik felhasználó által megadott értékkel.

        "tags": {
            "ADUGroup": "<CustomTagValue>"
            }

  6. Válassza a Mentés lehetőséget.

Eszközcsoportok megtekintése

  1. Az Azure Portalon keresse meg az eszközfrissítési példányhoz csatlakoztatott IoT Hubot.

  2. A bal oldali navigációs Eszközkezelés alatt válassza a Frissítések lehetőséget.

  3. Válassza a Csoportok és üzemelő példányok lapot.

    A nem csoportosított eszközök képernyőképe.

Miután létrehozott egy csoportot, a megfelelőségi diagram és a csoportlista frissül. Az Eszközfrissítés megfelelőségi diagramja a különböző megfelelőségi állapotokban lévő eszközök számát mutatja: a legújabb frissítések, az elérhető új frissítések és a folyamatban lévő frissítések. További információ: Eszközfrissítések megfelelősége.

A csoportlistában megjelennek a meglévő eszközfrissítési csoportok és az ezekben a csoportokban lévő eszközök elérhető frissítései. Minden olyan eszköz, amely nem felel meg a csoport eszközosztály-követelményeinek, érvénytelen csoportban jelenik meg. Ebből a nézetből a legjobban elérhető frissítést helyezheti üzembe egy csoportban a csoport mellett található Üzembe helyezés lehetőség kiválasztásával.

Képernyőkép a frissítésmegfeleltségi nézetről.

Csoport eszközadatainak megtekintése

  1. A Csoportok és üzemelő példányok lapon válassza ki a csoport nevét.

    A Csoport részletei lapon látható a frissítési megfelelőségi diagram a különböző megfelelőségi állapotokban lévő csoporttag eszközök számával, valamint a csoporttag eszközök eszközfrissítési tulajdonságaival.

    Képernyőkép az eszközcsoport részletes nézetéről.

  2. Válassza ki a csoporton belüli egyes eszközöket az IoT Hub eszközadatainak lapjára való ugráshoz.

    Képernyőkép az eszköz részleteinek nézetéről.

    Képernyőkép az IoT Hub eszközadatok nézetéről.

Eszköz eltávolítása eszközcsoportból

Ha el szeretne távolítani egy eszközt egy eszközcsoportból, módosítsa a ADUGroup címke értékét null az ikerpéldányban, és válassza a Mentés lehetőséget.

    "tags": {
            "ADUGroup": "null"
            }

Ez a művelet törli a csoportcímkét az ikereszközről, és eltávolítja az eszközt az eszközcsoportból.

Eszközcsoport törlése

Az eszközfrissítés automatikusan létrehozza az eszközcsoportokat, és megtartja az eszközcsoportokat, az eszközosztályokat és az üzemelő példányokat az előzményrekordok vagy más felhasználói igények alapján, ahelyett, hogy automatikusan megtisztítja őket. Az eszközcsoportokat az Azure Portalon törölheti a csoportok egyéni kiválasztásával és törlésével, vagy a az iot du device group delete csoport Azure CLI-parancsának meghívásával.

A törléshez egy csoportnak meg kell felelnie a következő követelményeknek:

  • Nem lehet default csoport.
  • Nem lehetnek tageszközök. Vagyis az Eszközfrissítés példányban kiépített eszköz nem rendelkezhet ADUGroup a csoport nevével egyező értékkel rendelkező címkével.
  • Nincsenek társított aktív vagy megszakított üzemelő példányok.

Feljegyzés

Ha nem tud törölni egy olyan csoportot, amely megfelel az előző követelményeknek, ellenőrizze, hogy rendelkezik-e a csoport részeként címkézett nem megfelelő eszközökkel. A nem megfelelő állapotú eszközök nem fogadhatnak üzembe helyezést, ezért nem jelennek meg közvetlenül a csoport tageszközeinek listájában.

Annak ellenőrzéséhez, hogy vannak-e sérült eszközei:

  1. Az Azure Portalon keresse meg az IoT-központot.
  2. Válassza a Bal oldali navigációs sáv Frissítések elemét, majd a Diagnosztika lapot.
  3. Bontsa ki a Hiányzó eszközök keresése szakaszt .

Ha a csoport részeként nem megfelelő állapotú eszközök vannak megjelölve, a csoport törlése előtt módosítania kell a címke értékét, vagy törölnie kell az eszközt.

Ha egy eszköz ismét egy törölt csoportnévhez van rendelve, az Eszközfrissítés automatikusan újra létrehozza a csoportot, de nincs társított eszköz- vagy üzembehelyezési előzmény.

Kapcsolódó tartalom