Delen via


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

Tags toevoegen aan uw apparaten

Als u een apparaatgroep Device Update wilt toewijzen, voegt u de ADUGroup tag toe aan een doelset 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 maakt gebruik van een sleutelwaarde-indeling, zoals wordt weergegeven in het volgende voorbeeld van een apparaat of moduledubbel:

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

Zie Apparaatdubbels begrijpen en gebruiken of Moduledubbels begrijpen en gebruiken voor meer informatie en voorbeelden van JSON-syntaxis van 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 het apparaat of de moduledubbel bijwerken met de juiste tag met Behulp van RegistryManager nadat u het apparaat bij Device Update hebt ingeschreven. 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 apparaatdubbels of moduledubbels bijwerken met behulp van taken, afhankelijk van of de Device Update-agent is ingericht met een apparaat- of module-id. Zie Taken plannen en uitzenden voor meer informatie.

Notitie

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

Tags toevoegen door dubbels bij te werken

U kunt de ADUGroup tag ook rechtstreeks op het apparaat of de moduledubbel 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 apparaatdubbel op de apparaatpagina in het bovenste menu of selecteer de module-id onder Module-identiteiten en selecteer vervolgens de moduledubbel.

  5. Voeg in de dubbel de tag als volgt toe met een door de ADUGroup 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. Navigeer in Azure Portal naar de IoT-hub die is verbonden met uw Device Update-exemplaar.

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

  3. Selecteer het tabblad Groepen en implementaties .

    Schermopname van niet-gegroepeerde apparaten.

Zodra u een groep hebt gemaakt, worden het nalevingsdiagram en de groepslijst 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.

Bestaande Apparaatupdate-groepen en eventuele beschikbare updates voor de apparaten in deze groepen worden weergegeven in de lijst met groepen. Alle apparaten die niet voldoen aan de apparaatklassevereisten van de groep, worden weergegeven 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 ADUGroup tagwaarde null in de dubbel en selecteert u Opslaan.

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

Met deze actie wordt de groepstag van de apparaatdubbel verwijderd en wordt het apparaat uit de apparaatgroep verwijderd.

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 groep zijn default .
  • Er mogen geen lidapparaten zijn. 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 voldoet aan de voorgaande vereisten niet kunt verwijderen, controleert u of er beschadigde apparaten zijn gelabeld als onderdeel van de groep. Beschadigde apparaten kunnen geen implementatie ontvangen, dus ze worden niet rechtstreeks weergegeven in de lijst met lidapparaten in een groep.

Ga als volgende te werk om te controleren of u apparaten met een slechte status 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.