Eszközök tömeges kezelése az Azure IoT Central-alkalmazásban
Az Azure IoT Central használatával nagy léptékben kezelheti csatlakoztatott eszközeit a feladatokon keresztül. A feladatok lehetővé teszik az eszköz- és felhőtulajdonságok tömeges frissítését és parancsok futtatását. Ez a cikk bemutatja, hogyan használhatja a feladatokat a saját alkalmazásában, és hogyan használhatja az importálási és exportálási funkciókat.
Ha meg szeretné tudni, hogyan kezelheti a feladatokat az IoT Central REST API használatával, olvassa el az IoT Central REST API eszközök kezelésére való használatát ismertető témakört.
Tipp.
Ismétlődő feladat létrehozásakor jelentkezzen be az alkalmazásba Egy Microsoft-fiók vagy Egy Microsoft Entra-fiók használatával. Ha Microsoft Entra-csoporttal jelentkezik be, lehetséges, hogy a csoporthoz társított Microsoft Entra-jogkivonat a jövőben egy bizonyos ponton lejár, és a feladat meghiúsul.
Feladat létrehozása és futtatása
Az alábbi példa bemutatja, hogyan hozhat létre és futtathat feladatokat egy eszközcsoport egyszerűsített küszöbértékének beállításához. A feladat varázslóval hozhat létre és futtathat feladatokat. A feladatokat mentheti a későbbi futtatáshoz:
A bal oldali panelen válassza a Feladatok lehetőséget.
Válassza a + Új lehetőséget.
A Feladat konfigurálása lapon adjon meg egy nevet és egy leírást a létrehozott feladat azonosításához.
Ha az alkalmazás szervezeteket használ, válassza ki azt a szervezetet, amelyhez társítani szeretné a feladatot. A feladatot csak a szervezet felhasználói tekinthetik meg vagy módosíthatják. A felhasználó szerepköre határozza meg a felhasználó engedélyeit.
Válassza ki azt a céleszközcsoportot, amelybe a feladatot alkalmazni szeretné. Ha az alkalmazás szervezeteket használ, a kijelölt szervezet határozza meg az elérhető eszközcsoportokat. Láthatja, hogy a feladatkonfiguráció hány eszközre vonatkozik az eszközcsoport kiválasztása alatt.
Válassza a Cloud tulajdonságot, a Tulajdonságot, a Parancsot, az Eszközsablon módosítását vagy a Peremhálózati telepítési jegyzék módosítását feladattípusként. Konfigurálás:
- Tulajdonságfeladat , válasszon ki egy tulajdonságot, és állítsa be az új értékét. A tulajdonságfeladatok több tulajdonságot is beállíthatnak.
- Parancsfeladat , válassza ki a futtatni kívánt parancsot.
- Módosítsa az eszközsablon feladatát, válassza ki azt az eszközsablont, amelyet az eszközcsoport eszközeihez szeretne hozzárendelni.
- Módosítsa a peremhálózati üzembehelyezési jegyzékfeladatot , válassza ki az IoT Edge üzembehelyezési jegyzékfájlját az eszközcsoport IoT Edge-eszközeihez való hozzárendeléshez.
A Mentés és kilépés lehetőséget választva felveheti a feladatot a Feladatok lap mentett feladatainak listájára. Később visszatérhet egy feladathoz a mentett feladatok listájából.
A Tovább gombra kattintva lépjen a Kézbesítési beállítások lapra. A Kézbesítési beállítások lapon megadhatja a batches és a lemondási küszöbérték szállítási beállításait ehhez a feladathoz:
A kötegek lehetővé teszik, hogy nagy számú eszközhöz használjon átmeneti feladatokat. A feladat több kötegre van osztva, és minden köteg tartalmazza az eszközök egy részhalmazát. A kötegek várólistára kerülnek, és egymás után futnak.
A lemondási küszöbérték lehetővé teszi, hogy automatikusan megszakítsa a feladatokat, ha a hibák száma meghaladja a beállított korlátot. A küszöbérték vonatkozhat a feladat összes eszközére vagy az egyes kötegekre.
A Tovább gombra kattintva lépjen az Ütemezés lapra. Az Ütemezés lap lehetővé teszi, hogy az ütemezés a jövőben is futtassa a feladatot.
Válasszon egy ismétlődési lehetőséget az ütemezéshez. Beállíthat egy feladatot a futtatáshoz:
- Egyszeri
- Daily
- Weekly
Ütemezett feladat kezdési dátumának és időpontjának beállítása. A dátum és az idő az ön időzónájára vonatkozik, nem pedig az eszköz helyi idejére.
Ismétlődő ütemezés befejezéséhez válassza a következőt:
- Ezen a napon adja meg az ütemezés befejezési dátumát.
- Miután beállította a feladat futtatásának hányszorosát.
Az ütemezett feladatok mindig az eszközcsoport eszközein futnak, még akkor is, ha az eszközcsoport tagsága idővel megváltozik.
A Tovább gombra kattintva lépjen a Véleményezés lapra. A Feladatkonfiguráció részleteit a Véleményezés lapon találja. A feladat ütemezéséhez válassza az Ütemezés lehetőséget:
A feladat részletei lapon az ütemezett feladatokra vonatkozó információk láthatók. Az ütemezett feladat végrehajtásakor megjelenik a feladatpéldányok listája. Az ütemezett feladat végrehajtása az utolsó 30 napos feladatlista része is.
Ezen a lapon leküldheti a feladatot, vagy szerkesztheti az ütemezett feladatot. Az ütemezett feladatok listájából visszatérhet egy ütemezett feladathoz.
A feladat varázslóban dönthet úgy, hogy nem ütemez egy feladatot, és azonnal futtatja.
Egy feladat függőben lévő, futó és befejezett fázisokon megy keresztül. A feladat végrehajtásának részletei eredménymetrikákat, időtartamadatokat és egy eszközlistarácsot tartalmaznak.
Ha a feladat befejeződött, az Eredmények naplót választva letöltheti a feladat adatainak CSV-fájlját, beleértve az eszközöket és azok állapotértékeit. Ezek az információk hasznosak lehetnek a hibaelhárításhoz:
A feladat most megjelenik az Elmúlt 30 nap listában a Feladatok lapon. Ez a lap az aktuálisan futó feladatokat és a korábban futtatott vagy mentett feladatok előzményeit mutatja be.
Megjegyzés:
A korábban futtatott feladatok 30 napos előzményeit tekintheti meg.
Feladatok kezelése
Egy futó feladat leállításához nyissa meg, és válassza a Leállítás lehetőséget. A feladat állapota úgy változik, hogy a feladat le van állítva. Az Összegzés szakasz azt mutatja be, hogy mely eszközök fejeződtek be, sikertelenek vagy függőben vannak.
Ha egy feladat leállított állapotban van, a Folytatás gombra kattintva folytathatja a feladat futtatását. A feladat állapota úgy változik, hogy a feladat újra fut. Az Összegzés szakasz folyamatosan frissül a legújabb folyamattal.
Feladat másolása
Meglévő feladat másolásához válasszon ki egy végrehajtott feladatot. Válassza a Másolás lehetőséget a feladat eredményoldalán vagy a feladatok részletei lapon. Megnyílik a feladatkonfiguráció egy példánya, amelyet szerkeszthet, és a másolás hozzá lesz fűzve a feladat nevéhez.
Feladat állapotának megtekintése
A feladat létrehozása után az Állapot oszlop a legújabb feladatállapot-üzenettel frissül. Az alábbi táblázat a feladat lehetséges állapotértékeket sorolja fel:
| Állapotüzenet | Állapot jelentése |
|---|---|
| Befejeződött | Ez a feladat minden eszközön futott. |
| Sikertelen | Ez a feladat nem sikerült, és nem futott teljes mértékben az eszközökön. |
| Függőben | Ez a feladat még nem kezdődött el az eszközökön. |
| Futó | Ez a feladat jelenleg eszközökön fut. |
| Leállítva | A felhasználó manuálisan állította le ezt a feladatot. |
| Megszakított | Ez a feladat megszakadt, mert túllépte a Szállítási beállítások lapon beállított küszöbértéket. |
Az állapotüzenetet a feladatban lévő eszközök áttekintése követi. Az alábbi táblázat a lehetséges eszközállapot-értékeket sorolja fel:
| Állapotüzenet | Állapot jelentése |
|---|---|
| Sikeres | A feladat által sikeresen futtatott eszközök száma. |
| Sikertelen | Azon eszközök száma, amelyeken a feladat nem futott. |
A feladat és az összes érintett eszköz állapotának megtekintéséhez nyissa meg a feladatot. Az egyes eszköznevek mellett az alábbi állapotüzenetek egyikét láthatja:
| Állapotüzenet | Állapot jelentése |
|---|---|
| Befejeződött | A feladat ezen az eszközön futott. |
| Sikertelen | A feladat nem futott ezen az eszközön. A hibaüzenet további információkat jelenít meg. |
| Függőben | A feladat még nem fut ezen az eszközön. |
Ha le szeretne tölteni egy CSV-fájlt, amely tartalmazza a feladat részleteit, az eszközök listáját és állapotértékeit, válassza az Eredmények naplóját.
Az eszközlista szűrése
A Feladat részletei lapon szűrheti az eszközlistát a szűrőikon kiválasztásával. Az Eszközazonosító vagy az Állapot mezőre szűrhet:
Az eszközlista oszlopainak testreszabása
Az oszlopbeállítások ikon kiválasztásával oszlopokat vehet fel az eszközlistára:
Az Eszközlista oszlopainak kiválasztásához használja az Oszlopbeállítások párbeszédpanelt. Jelölje ki a megjeleníteni kívánt oszlopokat, kattintson a jobbra mutató nyílra, majd az OK gombra. Az összes elérhető oszlop kijelöléséhez válassza az Összes kijelölése lehetőséget. A kijelölt oszlopok megjelennek az eszközlistában.
A kijelölt oszlopok megmaradnak egy felhasználói munkamenetben vagy az alkalmazáshoz hozzáféréssel rendelkező felhasználói munkamenetekben.
Feladatok újrafuttatva
A sikertelen eszközökkel rendelkező feladatokat újrafuttathatja. Válassza a Sikertelen futtatás lehetőséget.
Adja meg a feladat nevét és leírását, majd válassza az Újrafuttatandó feladat lehetőséget. A rendszer új feladatot küld a művelet sikertelen eszközökön való újrapróbálkozásához.
Megjegyzés:
Egy Azure IoT Central-alkalmazásból egyszerre legfeljebb öt feladatot futtathat.
Ha egy feladat befejeződött, és töröl egy eszközt, amely szerepel a feladat eszközlistájában, az eszközbejegyzés az eszköznévben töröltként jelenik meg. A részletek hivatkozása nem érhető el a törölt eszközhöz.
Eszközök importálása
Ha nagy számú eszközt szeretne regisztrálni az alkalmazásba, tömegesen importálhat eszközöket egy CSV-fájlból. Egy példa CSV-fájlt talál az Azure Samples adattárban. A CSV-fájlnak a következő oszlopfejléceket kell tartalmaznia:
| Oszlop | Leírás |
|---|---|
| IOTC_DEVICEID | Az eszközazonosító egy egyedi azonosító, amelyet az eszköz a csatlakozáshoz fog használni. Az eszközazonosító szóköz nélkül tartalmazhat betűket, számokat és karaktereket - . A maximális hossz 128 karakter. |
| IOTC_DEVICENAME | Opcionális. Az eszköznév egy rövid név, amely az egész alkalmazásban megjelenik. Ha nincs megadva, az eszköz neve megegyezik az eszközazonosítóval. A maximális hossz 148 karakter. |
Eszközök tömeges regisztrálása az alkalmazásban:
Válassza az Eszközök lehetőséget a bal oldali panelen.
A bal oldali panelen válassza ki azt az eszközsablont, amelyhez tömegesen létre szeretné hozni az eszközöket.
Megjegyzés:
Ha még nem rendelkezik eszközsablonnal, importálhat eszközöket a Minden eszköz területen, és sablon nélkül regisztrálhatja őket. Az eszközök importálása után áttelepítheti őket egy sablonba.
Select Import.
Válasszon ki egy szervezetet, amelyhez az eszközöket hozzá szeretné rendelni. Minden importált eszköz ugyanahhoz a szervezethez van rendelve. Ha különböző szervezetekhez szeretne eszközöket rendelni, hozzon létre több importálási fájlt, egyet minden szervezethez. Másik lehetőségként töltse fel az összeset a legfelső szintű szervezetbe, majd a felhasználói felületen rendelje őket újra a megfelelő szervezetekhez.
Válassza ki azt a CSV-fájlt, amely tartalmazza az importálandó eszközazonosítók listáját.
Az eszköz importálása a fájl feltöltése után kezdődik. Az importálási állapotot az Eszközművelet panelen követheti nyomon. Ez a panel automatikusan megjelenik az importálás indítása után, vagy a jobb felső sarokban lévő harang ikonon keresztül érheti el.
Az importálás befejeződése után megjelenik egy sikeres üzenet az Eszközművelet panelen.
Ha az eszközimportálási művelet meghiúsul, hibaüzenet jelenik meg az Eszközművelet panelen. A rendszer létrehoz egy naplófájlt, amely rögzíti az összes hibát, amelyet letölthet.
Ha az eszközei SAS-jogkivonatokat használnak a hitelesítéshez, exportáljon egy CSV-fájlt az IoT Central-alkalmazásból. Az exportált CSV-fájl tartalmazza az eszközazonosítókat és az SAS-kulcsokat.
Ha az eszközök X.509-tanúsítványokat használnak a hitelesítéshez, hozzon létre X.509 levéltanúsítványokat az eszközeihez az X.509 regisztrációs csoportban található főtanúsítvány vagy köztes tanúsítvány használatával. Használja az importált eszközazonosítókat a CNAME levéltanúsítványok értékeként.
Eszközök exportálása
Ha valódi eszközt szeretne csatlakoztatni az IoT Centralhoz, szüksége van a kapcsolati sztring. Az eszközadatok tömeges exportálásával lekérheti az eszköz kapcsolati sztring létrehozásához szükséges információkat. Az exportálási folyamat létrehoz egy CSV-fájlt az eszköz identitásával, az eszköz nevével és kulcsaival az összes kiválasztott eszközhöz.
Eszközök tömeges exportálása az alkalmazásból:
Válassza az Eszközök lehetőséget a bal oldali panelen.
A bal oldali panelen válassza ki azt az eszközsablont, amelyből exportálni szeretné az eszközöket.
Jelölje ki az exportálni kívánt eszközöket, majd válassza az Exportálás műveletet.
Elindul az exportálási folyamat. Az állapotot az Eszközművelet panelen követheti nyomon.
Amikor az exportálás befejeződik, megjelenik egy sikeres üzenet, valamint a létrehozott fájl letöltésére mutató hivatkozás.
A Fájl letöltése hivatkozásra kattintva töltse le a fájlt a lemez egy helyi mappájába.
Az exportált CSV-fájl a következő oszlopokat tartalmazza: eszközazonosító, eszköznév, eszközkulcsok és X509-tanúsítvány ujjlenyomatai:
- IOTC_DEVICEID
- IOTC_DEVICENAME
- IOTC_SASKEY_PRIMARY
- IOTC_SASKEY_Standard kiadás KONDÁRIUM
- IOTC_X509THUMBPRINT_PRIMARY
- IOTC_X509THUMBPRINT_Standard kiadás KONDÁRIUM
A valós eszközök IoT Central-alkalmazáshoz való csatlakoztatásáról további információt az Eszközök csatlakoztatása című témakörben talál.
Következő lépések
Most, hogy megtanulta, hogyan kezelheti tömegesen az eszközöket az Azure IoT Central-alkalmazásban, javasolt következő lépésként megtudhatja, hogyan szerkesztheti az eszközsablonokat.