Apparaatgroepen beheren voor Azure Device Update voor IoT Hub

Met Azure Device Update voor IoT Hub kunt u updates implementeren voor door de gebruiker gedefinieerde groepen IoT-apparaten. Elk beheerd apparaat dat door Device Update wordt beheerd, is lid van een apparaatgroep, maar het definiëren van apparaatgroepen is optioneel. U kunt ook implementeren in de standaardapparaatgroep die Device Update biedt.

Als u door de gebruiker gedefinieerde tagwaarden voor Device Update maakt en toewijst aan apparaten, maakt Device Update automatisch groepen op basis van de toegewezen tags en eigenschappen van apparaatcompatibiliteit. Voor elke apparaatgroep kan Device Update meerdere subgroepen met verschillende apparaatklassen maken. Device Update plaatst apparaten zonder tags in de default apparaatgroep.

In dit artikel wordt beschreven hoe u Azure Portal of Azure CLI gebruikt om door de gebruiker gedefinieerde apparaatupdate-apparaattags en -groepen te maken en te beheren. Zie Een apparaatupdate implementeren als u updates wilt implementeren voor door de gebruiker gedefinieerde of standaardapparaatgroepen.

Vereisten

Voordat je begint, noteer de volgende vereisten:

  • Apparaten moeten eerst succesvol aan Device Update zijn toegevoegd voordat groepstoewijzing kan plaatsvinden.
  • Apparaten moeten een ondersteund Plug en Play model-ID rapporteren. Voor een lijst van ondersteunde model-ID's, zie Device Update modellen.
  • Voor IoT Edge-scenario's draait de Device Update-agent als een module en moet de model-ID via de juiste identiteit rapporteren.

Tags toevoegen aan uw apparaten

Om een Device Update-apparaat groep toe te wijzen, voeg je de ADUGroup tag toe aan een doelset van Device Update-verbonden apparaten in IoT Hub. Voeg de tag toe aan de apparaatdubbel als uw Device Update-agent is ingericht met apparaat-id of aan de bijbehorende moduledubbel als de Device Update-agent is ingericht met een module-id.

De tag 'Device Update' ADUGroup gebruikt een sleutel-waardeformaat, zoals weergegeven in het volgende voorbeeld van een apparaat- of moduletwin:

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

Important

Het toevoegen van een ADUGroup-tag onboardt een apparaat niet bij Device Update. Groepstoewijzing vindt pas plaats nadat Device Update het apparaat succesvol heeft herkend en beheerd.

Zie Apparaatdubbels begrijpen en gebruiken of Moduledubbels begrijpen en gebruiken voor meer informatie en voorbeelden van de JSON-syntaxis voor dubbels.

De ADUGroup tag heeft de volgende eigenschappen en beperkingen:

  • Een apparaat kan slechts één ADUGroup tag hebben en tot slechts één apparaatupdategroep tegelijk behoren. Als u een andere tag met de naam ADUGroup toevoegt, wordt de bestaande ADUGroup waarde overschreven.
  • U kunt elke waarde voor de tag gebruiken, behalve de gereserveerde waarden Uncategorized en $default.
  • De tagwaarde mag niet langer zijn dan 200 tekens.
  • De tagwaarde kan alfanumerieke tekens en de volgende speciale tekens bevatten: . - _ ~
  • De ADUGroup tagnaam en groepsnaamwaarden zijn hoofdlettergevoelig.

In de volgende secties worden verschillende manieren beschreven om de tag toe te voegen en bij te werken.

Tags toevoegen met SDK's

U kunt de apparaat- of moduletwin met de juiste tag bijwerken met behulp van RegistryManager nadat u het apparaat voor Device Update hebt geregistreerd. Raadpleeg voor meer informatie de volgende artikelen:

Tags toevoegen met behulp van taken

U kunt taken plannen om tags van Device Update toe te voegen of bij te werken op meerdere apparaten. Zie Taken plannen op meerdere apparaten voor voorbeelden van taakbewerkingen. U kunt met taken zowel apparaattweelingen als moduletweelingen bijwerken, afhankelijk van of de Device Update-agent is geconfigureerd met een apparaat- of module-identiteit. Zie Taken plannen en publiceren voor meer informatie.

Notitie

Deze bewerking telt mee voor het quotum voor IoT Hub-berichten. Als u 50.000 of meer tags van apparaat- of moduletwins tegelijk wijzigt, kunt u uw dagelijkse quotum voor IoT Hub-berichten overschrijden en extra IoT Hub-eenheden moeten aanschaffen. Zie Quota en beperking voor meer informatie.

Tags toevoegen door twins bij te werken

U kunt de tag ADUGroup ook rechtstreeks in de apparaat- of module-twin toevoegen of bijwerken.

  1. Navigeer in Azure Portal naar uw IoT-hub.

  2. Selecteer Apparaten onder Apparaatbeheer in het linkernavigatiedeelvenster. Als u een IoT Edge-apparaat hebt, selecteert u in plaats daarvan IoT Edge .

  3. Selecteer uw apparaat op de pagina Apparaten .

  4. Selecteer op de apparaatpagina in het bovenste menu Apparaat-twin of selecteer onder Module-identiteiten de module-identiteit en selecteer vervolgens de module-twin.

  5. Voeg in de twin de ADUGroup tag toe met een door de gebruiker gedefinieerde waarde. Als u een bestaande ADUGroup tagwaarde wilt bijwerken, overschrijft u deze met een andere door de gebruiker gedefinieerde waarde.

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

  6. Selecteer Opslaan.

Apparaatgroepen weergeven

  1. Ga in het Azure-portaal naar de IoT-hub die verbonden is met je Device Update-instantie.

  2. Selecteer de optie Updates onder Apparaatbeheer in het linkernavigatievenster.

  3. Selecteer het tabblad Groepen en implementaties .

    Schermopname van niet-gegroepeerde apparaten.

Wanneer je een groep aanmaakt, worden de compliance-grafiek en de groepenlijst bijgewerkt. In de grafiek Apparaatupdate-naleving ziet u het aantal apparaten in verschillende nalevingsstatussen: Bij de meest recente update, nieuwe updates die beschikbaar zijn en updates die worden uitgevoerd. Zie Apparaatupdate-naleving voor meer informatie.

De groepenlijst toont bestaande Device Update-groepen en eventuele beschikbare updates voor de apparaten in die groepen. Apparaten die niet voldoen aan de apparaatklasse-eisen van de groep verschijnen in een overeenkomstige ongeldige groep. In deze weergave kunt u de best beschikbare update voor een groep implementeren door Implementeren naast de groep te selecteren.

Schermopname van de weergave voor updatecompatibiliteit.

Apparaatdetails voor een groep weergeven

  1. Selecteer op het tabblad Groepen en implementaties de naam van de groep.

    Op de pagina Groepsdetails ziet u het updatenalevingsdiagram met het aantal apparaten van groepsleden in verschillende nalevingsstatussen en de lijst met apparaten van groepsleden met de eigenschappen van de apparaatupdate.

    Schermopname van de weergave details van apparaatgroep.

  2. Selecteer een afzonderlijk apparaat in een groep om naar de pagina met apparaatdetails in IoT Hub te gaan.

    Schermopname van de weergave apparaatdetails.

    Schermopname van de weergave apparaatdetails in IoT Hub.

Een apparaat verwijderen uit een apparaatgroep

Als u een apparaat uit een apparaatgroep wilt verwijderen, wijzigt u de waarde van de tag ADUGroup in null in de twin en selecteert u Opslaan.

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

Met deze actie verwijdert u het groepslabel uit de apparaattwin en verwijdert u het apparaat uit de apparaatgroep.

Een apparaatgroep verwijderen

Device Update maakt automatisch apparaatgroepen en behoudt apparaatgroepen, apparaatklassen en implementaties voor historische records of andere gebruikersbehoeften, in plaats van ze automatisch op te schonen. U kunt apparaatgroepen verwijderen via Azure Portal door de groepen afzonderlijk te selecteren en te verwijderen, of door de az iot du device group delete Azure CLI-opdracht in de groep aan te roepen.

Een groep moet voldoen aan de volgende vereisten om te worden verwijderd:

  • Mag geen default groep zijn.
  • Mag geen aangesloten apparaten bevatten. Dat wil gezegd dat er geen apparaat dat is ingericht in het Device Update-exemplaar, een ADUGroup tag kan bevatten met een waarde die overeenkomt met de naam van de groep.
  • Er mogen geen actieve of geannuleerde implementaties zijn gekoppeld.

Notitie

Als u een groep die aan de voorgaande vereisten voldoet niet kunt verwijderen, controleert u of u ongezonde apparaten hebt die als onderdeel van de groep zijn getagd. Beschadigde apparaten kunnen geen implementatie ontvangen, dus ze worden niet rechtstreeks weergegeven in de lijst met lidapparaten in een groep.

Ga als volgt te werk om te controleren of u niet goed werkende apparaten hebt:

  1. Ga in Azure Portal naar uw IoT-hub.
  2. Selecteer Updates in het linkernavigatievenster en selecteer vervolgens het tabblad Diagnostische gegevens .
  3. Vouw de sectie Ontbrekende apparaten zoeken uit.

Als u apparaten met een slechte status hebt gelabeld als onderdeel van de groep, moet u de tagwaarde wijzigen of het apparaat verwijderen voordat u de groep kunt verwijderen.

Als een apparaat ooit opnieuw is toegewezen aan een verwijderde groepsnaam, wordt de groep automatisch opnieuw gemaakt met Device Update, maar er is geen gekoppelde apparaat- of implementatiegeschiedenis.

Troubleshooting

Als je een apparaat markeert maar geen groep ziet, probeer dan de volgende stappen voor probleemoplossing:

  • Controleer of de tag correct is geconfigureerd.
  • Controleer of het apparaat een geldig Plug en Play-model-ID en een geldig ADUGroup label bevat.
  • Bevestig dat de IoT Hub-berichtroutes correct zijn geconfigureerd. Voor meer informatie, zie Berichtroutering.
  • Zorg ervoor dat de IoT Hub correct is gekoppeld aan de Device Update-instantie.
  • Voer apparaatupdates diagnostiek uit en controleer de agent.
  • Voer apparaatsynchronisatie uit indien nodig.

Voor meer informatie raadpleegt u Plug en Play in Azure Device Update en agentcontrole voor Device Update voor Azure IoT Hub.

Gerelateerde inhoud

  • Laatst bijgewerkt om