Skapa enhetsgrupper i Enhetsuppdatering för IoT Hub

Enhetsuppdatering för IoT Hub gör det möjligt att distribuera en uppdatering till en grupp IoT-enheter.

Förutsättningar

• Åtkomst till en IoT-hubb med aktiverad Enhetsuppdatering för IoT-hubb. Vi rekommenderar att du använder en S1-nivå (Standard) eller högre för din IoT Hub.
• En IoT-enhet (eller simulator) som har konfigurerats för Device Update för IoT Hub.
• Minst en uppdatering har importerats för den etablerade enheten.
• Installera och starta enhetsuppdateringsagenten på din IoT-enhet antingen som en modul- eller enhetsnivåidentitet

Lägga till en tagg till dina enheter

Enhetsuppdatering för IoT Hub gör det möjligt att distribuera en uppdatering till en grupp IoT-enheter. För att skapa en grupp är det första steget att lägga till en tagg i måluppsättningen med enheter i IoT Hub. Taggar kan endast läggas till på enheten när den har anslutits till Device Update.

Dokumentationen nedan beskriver hur du lägger till och uppdaterar en tagg.

Uppdatera enhetstvillingar programmatiskt

Du kan uppdatera en enhetstvilling med lämplig tagg med hjälp av RegistryManager efter att du har registrerat enheten med enhetsuppdatering.

• Lär dig hur du lägger till taggar med hjälp av en .NET-exempelapp.
• Läs mer om taggegenskaper.

Taggformat för enhetsuppdatering

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

Att använda jobb

Det går att schemalägga ett jobb på flera enheter för att lägga till eller uppdatera en tagg för enhetsuppdatering. Exempel finns i Schemalägga jobb på flera enheter. Du kan uppdatera en enhetstvilling eller modultvilling (om enhetsuppdateringsagenten har konfigurerats som en modulidentitet) med hjälp av jobb. Mer information finns i Schemalägg och sända jobb.

Direkta uppdateringar av tvillingar

Taggar kan också läggas till eller uppdateras direkt i en enhetstvilling eller modultvilling.

1. Logga in på Azure Portal och navigera till din IoT Hub.

2. Välj Enheter på navigeringsmenyn och välj din IoT-enhet för att öppna enhetsinformationen.

3. Öppna tvillinginformationen.

   • Om enhetsuppdateringsagenten har konfigurerats som en enhetsidentitet väljer du Device twin.
   • Om enhetsuppdateringsagenten har konfigurerats som en modulidentitet väljer du modulen Enhetsuppdatering och sedan Modulidentitetstvilling.

4. Ta bort ett befintligt taggvärde för enhetsuppdatering i enhetstvillingen eller modultvillingen genom att ställa in dem på null.

5. Lägg till ett nytt taggvärde för enhetsuppdatering enligt nedan. Exempel på JSON-dokument för enhetstvillingar med taggar.

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

Begränsningar

• Du kan lägga till valfritt värde i taggen förutom "Ej kategoriserad" som är ett reserverat värde.
• Taggvärdet får inte överstiga 255 tecken.
• Taggvärdet kan innehålla alfanumeriska tecken och följande specialtecken ".","-","_","~".
• Tagg- och gruppnamn är skiftlägeskänsliga.
• En enhet kan bara ha en tagg med namnet ADUGroup. Eventuella efterföljande tillägg av en tagg med det namnet åsidosätter det befintliga värdet för taggnamnet ADUGroup.
• En enhet kan bara tillhöra en grupp.

Skapa en enhetsgrupp genom att välja en befintlig IoT Hub-tagg

1. Gå till Azure-portalen.

2. Välj den IoT Hub som du tidigare anslöt till din enhetsuppdateringsinstans.

3. Välj alternativet Uppdateringar under Enhetshantering i det vänstra navigeringsfältet.

4. Välj fliken Grupper och distributioner överst på sidan.

   

5. Välj Lägg till grupp för att skapa en ny grupp.

   

6. Välj en IoT Hub-tagg och enhetsklass i listan och välj sedan Skapa grupp.

   

7. När gruppen har skapats ser du att diagrammet för uppdateringsefterlevnad och listan över grupper uppdateras. Diagrammet för uppdateringsefterlevnad visar antalet enheter i olika efterlevnadstillstånd: Vid den senaste uppdateringen, Nya tillgängliga uppdateringar och Pågående uppdateringar. Läs mer om uppdateringsefterlevnad.

   

8. Du bör se din nyligen skapade grupp och eventuella tillgängliga uppdateringar för enheterna i den nya gruppen. Om det finns enheter som inte uppfyller enhetens klasskrav för gruppen visas de i en motsvarande ogiltig grupp. Du kan distribuera den bästa tillgängliga uppdateringen till den nya användardefinierade gruppen från den här vyn genom att klicka på knappen "Distribuera" bredvid gruppen. Mer information finns i Nästa steg: Distribuera uppdatering.

Visa enhetsinformation för den grupp som du skapade

1. Gå till din nyligen skapade grupp och klicka på gruppnamnet.

2. En lista över enheter som ingår i gruppen visas tillsammans med deras enhetsuppdateringsegenskaper. I den här vyn kan du också se information om uppdateringsefterlevnad för alla enheter som är medlemmar i gruppen. Diagrammet för uppdateringsefterlevnad visar antalet enheter i olika efterlevnadstillstånd: Vid den senaste uppdateringen är nya uppdateringar tillgängliga och Uppdateringar pågår.

   

3. Du kan också klicka på varje enskild enhet i en grupp för att omdirigeras till enhetens informationssida i IoT Hub.

   

Nästa steg

Distribuera uppdatering

Läs mer om enhetsgrupper

Läs mer om uppdateringsefterlevnad.