Apparaatgroepen maken in Apparaatupdate voor IoT Hub
Met Device Update voor IoT Hub kunt u een update implementeren voor een groep IoT-apparaten.
Notitie
Als u wilt implementeren in een standaardgroep in plaats van een door de gebruiker gemaakte groep, kunt u rechtstreeks naar Een update implementeren
Vereisten
- Toegang tot een IoT Hub met Apparaatupdate voor IoT Hub ingeschakeld. Het is raadzaam om een laag S1 (Standard) of hoger te gebruiken voor uw IoT Hub.
- Een IoT-apparaat (of simulator) dat is ingericht voor Device Update binnen IoT Hub.
- Ten minste één update is geïmporteerd voor het ingerichte apparaat.
- Installeer en start de Device Update-agent op uw IoT-apparaat als een module- of apparaatidentiteit
Een tag toevoegen aan uw apparaten
Met Device Update voor IoT Hub kunt u een update implementeren voor 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 aan uw apparaat worden toegevoegd nadat het is verbonden met Device Update.
In de onderstaande documentatie wordt beschreven hoe u een tag toevoegt en bijwerkt.
Apparaatdubbels programmatisch bijwerken
U kunt een apparaatdubbel bijwerken met de juiste tag met behulp van RegistryManager nadat u het apparaat hebt ingeschreven met Device Update.
- Meer informatie over het toevoegen van tags met behulp van een .NET-voorbeeld-app.
- Meer informatie over tag-eigenschappen.
Tagindeling Device Update
"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 op meerdere apparaten plannen 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.
Notitie
Deze actie telt mee voor het quotum voor IoT Hub berichten en het wordt aanbevolen om slechts 50.000 tags voor apparaat- of moduledubbels tegelijk te wijzigen, anders moet u mogelijk meer IoT Hub eenheden kopen als u het dagelijkse quotum voor IoT Hub berichten overschrijdt. Meer informatie vindt u op Quota en beperking.
Updates voor directe dubbels
Tags kunnen ook rechtstreeks in een apparaatdubbel of moduledubbel worden toegevoegd of bijgewerkt.
Meld u aan bij de Azure Portal en navigeer naar uw IoT Hub.
Selecteer Apparaten in het navigatiemenu en selecteer uw IoT-apparaat om de apparaatdetails te openen.
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 module-id, selecteert u de module Device Update en vervolgens de module-id-dubbel.
Verwijder in de apparaatdubbel of moduledubbel een bestaande tagwaarde voor Device Update door deze in te stellen op null.
Voeg een nieuwe tagwaarde voor Device Update toe, zoals hieronder wordt weergegeven. Voorbeeld van JSON-document met apparaatdubbel met tags.
"tags": {
"ADUGroup": "<CustomTagValue>"
}
Beperkingen
- U kunt elke waarde toevoegen aan uw tag, met uitzondering van 'Niet-gecategoriseerd'. Dit is een gereserveerde waarde.
- Tagwaarde mag niet langer zijn dan 255 tekens.
- De 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. Alle 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
Ga naar de Azure Portal.
Selecteer de IoT Hub u eerder verbinding hebt gemaakt met uw Device Update-exemplaar.
Selecteer de optie Updates onder Apparaatbeheer in de navigatiebalk aan de linkerkant.
Selecteer het tabblad Groepen en implementaties boven aan de pagina.
Selecteer Groep toevoegen om een nieuwe groep te maken.
Selecteer een IoT Hub tag en Apparaatklasse in de lijst en selecteer vervolgens Groep maken.
Zodra de groep is gemaakt, ziet u dat de updatecompatibiliteitsgrafiek en de lijst met groepen zijn bijgewerkt. De grafiek Naleving van updates toont het aantal apparaten in verschillende nalevingsstatussen: Bij de meest recente update, Nieuwe updates beschikbaar en Updates wordt uitgevoerd. Meer informatie over updatecompatibiliteit.
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 bijbehorende ongeldige groep. Vanuit deze weergave kunt u de best beschikbare update implementeren voor de nieuwe door de gebruiker gedefinieerde groep door op de knop Implementeren naast de groep te klikken. Zie Volgende stap: Update implementeren voor meer informatie.
Apparaatdetails weergeven voor de groep die u hebt gemaakt
Navigeer naar de zojuist gemaakte groep en klik op de naam van de groep.
Er wordt een lijst met apparaten weergegeven die deel uitmaken van de groep, samen met hun eigenschappen voor apparaatupdates. In deze weergave ziet u ook de informatie over de naleving van updates voor alle apparaten die lid zijn van de groep. Grafiek voor naleving van updates toont het aantal apparaten in verschillende nalevingsstatussen: Bij de meest recente update zijn nieuwe updates beschikbaar en Updates in uitvoering.
U kunt ook op elk afzonderlijk apparaat in een groep klikken om te worden omgeleid naar de pagina met apparaatdetails in IoT Hub.
