Apparaatgroepen maken in Device Update voor IoT Hub

Met Apparaatupdate voor IoT Hub kunt u een update implementeren naar een groep IoT-apparaten.

Benodigdheden

• Toegang tot een IoT Hub met ingeschakelde Apparaatupdate voor IoT Hub. Het wordt aanbevolen om een S1-laag (Standard) of hoger te gebruiken voor uw IoT Hub.
• Een IoT-apparaat (of simulator) dat is ingericht voor Apparaatupdate in IoT Hub.
• Er is ten minste één update geïmporteerd voor het ingerichte apparaat.
• Installeer en start de Device Update-agent op uw IoT-apparaat als een module- of apparaatniveau-identiteit.

Een tag toevoegen aan uw apparaten

Met Apparaatupdate voor IoT Hub kunt u een update implementeren naar een groep IoT-apparaten. Als u een groep wilt maken, moet u eerst een tag toevoegen aan de doelset apparaten in IoT Hub. Tags kunnen alleen worden toegevoegd aan uw apparaat nadat het is verbonden met Device Update.

In de onderstaande documentatie wordt beschreven hoe u een tag toevoegt en bijwerkt.

Apparaatstweelingen programmatisch bijwerken

U kunt een device twin bijwerken met de juiste tag met behulp van RegistryManager nadat u het apparaat hebt geregistreerd bij Device Update.

• Meer informatie over het toevoegen van tags met behulp van een .NET-voorbeeld-app.
• Meer informatie over tageigenschappen.

Tagindeling voor apparaatupdates

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

Taken gebruiken

Het is mogelijk om een taak op meerdere apparaten te plannen om een Device Update-tag toe te voegen of bij te werken. Zie Taken plannen op meerdere apparaten voor voorbeelden. U kunt een apparaatdubbel of moduledubbel bijwerken (als de Device Update-agent is ingesteld als een module-id) met behulp van taken. Zie Taken plannen en uitzenden voor meer informatie.

Updates voor directe dubbels

Tags kunnen ook rechtstreeks worden toegevoegd of bijgewerkt in een apparaat-tweeling of module-tweeling.

1. Meld u aan bij Azure Portal en navigeer naar uw IoT Hub.

2. Selecteer Apparaten in het navigatiemenu en selecteer uw IoT-apparaat om de apparaatdetails te openen.

3. Open de details van de tweeling.

   • Als de Device Update-agent is geconfigureerd als een apparaat-id, selecteert u Apparaatdubbel.
   • Als de Device Update-agent is geconfigureerd als een module-id, selecteert u de module Device Update en vervolgens de module-iddubbel.

4. Verwijder in de device twin of module twin een bestaande tagwaarde voor Device Update door deze op null te zetten.

5. Voeg een nieuwe tagwaarde voor Device Update toe, zoals hieronder wordt weergegeven. Voorbeeld van een JSON-document van een apparaat-twin met tags.

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

Beperkingen

• U kunt elke waarde toevoegen aan uw tag, met uitzondering van 'Niet-gecategoriseerd'. Dit is een gereserveerde waarde.
• De tagwaarde mag niet langer zijn dan 255 tekens.
• Tagwaarde kan alfanumerieke tekens bevatten en de volgende speciale tekens ".","-","_","~".
• Tag- en groepsnamen zijn hoofdlettergevoelig.
• Een apparaat kan slechts één tag met de naam ADUGroup hebben, eventuele volgende toevoegingen van een tag met die naam overschrijven de bestaande waarde voor tagnaam ADUGroup.
• Eén apparaat kan slechts tot één groep behoren.

Een apparaatgroep maken door een bestaande IoT Hub-tag te selecteren

1. Ga naar Azure Portal.

2. Selecteer de IoT Hub die u eerder hebt verbonden met uw Device Update-exemplaar.

3. Selecteer de optie Updates onder Apparaatbeheer in de linkernavigatiebalk.

4. Selecteer het tabblad Groepen en implementaties boven aan de pagina.

   

5. Selecteer Groep toevoegen om een nieuwe groep te maken.

   

6. Selecteer een IoT Hub-tag en apparaatklasse in de lijst en selecteer vervolgens Groep Maken.

   

7. Zodra de groep is gemaakt, ziet u dat het updatenalevingsdiagram en de lijst met groepen worden bijgewerkt. De grafiek met updatecompliance toont het aantal apparaten in verschillende compliantiestatussen: Bij de nieuwste update, Beschikbare nieuwe updates, en Updates in uitvoering. Meer informatie over updatecompatibiliteit.

   

8. U ziet nu de zojuist gemaakte groep en eventuele beschikbare updates voor de apparaten in de nieuwe groep. Als er apparaten zijn die niet voldoen aan de apparaatklassevereisten van de groep, worden ze weergegeven in een overeenkomstige ongeldige groep. U kunt de beste beschikbare update implementeren voor de nieuwe door de gebruiker gedefinieerde groep vanuit deze weergave door te klikken op de knop Implementeren naast de groep. Zie volgende stap: Update implementeren voor meer informatie.

Apparaatdetails weergeven voor de groep die u hebt gemaakt

1. Ga naar de zojuist gemaakte groep en klik op de groepsnaam.

2. Een lijst met apparaten die deel uitmaken van de groep, worden samen met de eigenschappen van de apparaatupdate weergegeven. In deze weergave kunt u ook de informatie over updatenaleving bekijken voor alle apparaten die lid zijn van de groep. In het diagram Updatecompatibiliteit ziet u het aantal apparaten in verschillende nalevingsstatussen: Bij de meest recente update, nieuwe updates die beschikbaar zijn en updates die worden uitgevoerd.

   

3. U kunt ook op elk afzonderlijk apparaat in een groep klikken om te worden omgeleid naar de pagina met apparaatdetails in IoT Hub.

   

Volgende stappen

Update implementeren

Meer informatie over apparaatgroepen

Meer informatie over updatecompatibiliteit.