Erstellen von Gerätegruppen in Device Update for IoT Hub

Artikel
2/17/2021

Device Update for IoT Hub ermöglicht die Bereitstellung eines Updates für eine Gruppe von IoT-Geräten.

Hinweis

Wenn Sie die Bereitstellung in einer Standardgruppe und nicht in einer vom Benutzer erstellten Gruppe durchführen möchten, können Sie direkt mit Bereitstellen eines Updates fortfahren.

Voraussetzungen

Zugriff auf einen IoT Hub mit aktiviertem Device Update for IoT Hub. Es wird empfohlen, dass Sie für Ihren IoT Hub einen S1-Tarif (Standard) oder höher verwenden.
Ein IoT-Gerät (oder Simulator), das/der für Device Update in IoT Hub bereitgestellt wird.
Mindestens ein Update wurde für das bereitgestellte Gerät erfolgreich importiert.
Installieren und Starten des Device Update-Agents auf Ihrem IoT-Gerät als Modulidentität oder Identität auf Geräteebene

Hinzufügen eines Tags zu Ihren Geräten

Device Update for IoT Hub ermöglicht die Bereitstellung eines Updates für eine Gruppe von IoT-Geräten. Um eine Gruppe zu erstellen, müssen Sie im ersten Schritt dem Zielsatz von Geräten in IoT Hub ein Tag hinzufügen. Tags können Ihrem Gerät nur erfolgreich hinzugefügt werden, nachdem eine Verbindung mit Device Update hergestellt wurde.

In der Dokumentation unten wird das Hinzufügen und Aktualisieren eines Tags beschrieben.

Programmgesteuertes Aktualisieren des Gerätezwillings

Nachdem Sie das Gerät bei Device Update registriert haben, können Sie einen Gerätezwilling mit RegistryManager mit dem entsprechenden Tag aktualisieren.

Device Update-Tagformat

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

Verwenden von Aufträgen

Sie können einen Auftrag auf mehreren Geräten planen, um ein Device Update-Tag hinzuzufügen oder zu aktualisieren. Beispiele finden Sie unter Planen von Aufträgen auf mehreren Geräten. Sie können den Geräte- oder Modulzwilling (wenn der Device Update-Agent als Modulidentität eingerichtet wurde) mithilfe von Aufträgen aktualisieren. Weitere Informationen finden Sie unter Planen und Übertragen von Aufträgen.

Hinweis

Diese Aktion belastet Ihr IoT Hub-Nachrichtenkontingent. Es wird empfohlen, nur bis zu 50.000 Tags von Geräte- oder Modulzwillingen gleichzeitig zu ändern. Andernfalls müssen Sie möglicherweise mehr IoT Hub-Einheiten erwerben, wenn Sie Ihr tägliches IoT Hub-Nachrichtenkontingent überschreiten. Details finden Sie unter Kontingente und Drosselung.

Direkte Zwillingsupdates

Tags können auch direkt im Geräte- oder Modulzwilling hinzugefügt oder aktualisiert werden.

Melden Sie sich beim Azure-Portal an, und navigieren Sie zu Ihrer IoT Hub-Instanz.
Wählen Sie Geräte im Navigationsmenü aus, und wählen Sie Ihr IoT-Gerät aus, um die Gerätedetails zu öffnen.
Öffnen Sie die Zwillingsdetails.
- Wählen Sie Gerätezwilling aus, wenn der Device Update-Agent als Geräteidentität konfiguriert ist.
- Wenn der Device Apdate-Agent als Modulidentität konfiguriert ist, wählen Sie das Device Update-Modul und dann Zwilling der Modulkennung aus.
Löschen Sie alle vorhandenen Device Update-Tagwerte im Geräte- oder Modulzwilling, indem Sie sie auf NULL festlegen.
Fügen Sie wie unten gezeigt einen neuen Device Update-Tagwert hinzu. Gerätezwilling-JSON-Beispieldokument mit Tags.

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

Einschränkungen

Sie können Ihrem Tag einen beliebigen Wert hinzufügen (mit Ausnahme von „Uncategorized“ (Nicht kategorisiert), da es sich dabei um einen reservierten Wert handelt).
Der Tagwert darf maximal 255 Zeichen enthalten.
Der Tagwert darf alphanumerische Zeichen und die folgenden Sonderzeichen enthalten: „.“, „-“, „_“, „~“.
Für Tag- und Gruppennamen wird Groß-/Kleinschreibung beachtet.
Ein Gerät kann nur über ein Tag mit dem Namen ADUGroup verfügen. Alle nachfolgenden Hinzufügungen eines Tags mit diesem Namen überschreiben den vorhandenen Wert für den Tagnamen ADUGroup.
Ein Gerät kann nur zu einer Gruppe gehören.

Erstellen einer Gerätegruppe durch Auswählen eines vorhandenen IoT Hub-Tags

Öffnen Sie das Azure-Portal.
Wählen Sie den IoT Hub aus, den Sie zuvor mit Ihrer Device Update-Instanz verbunden haben.
Wählen Sie in der linken Navigationsleiste unter Geräteverwaltung die Option Updates aus.
Wählen Sie oben auf der Seite die Registerkarte Gruppen und Bereitstellungen aus.
Klicken Sie auf Gruppe hinzufügen, um eine neue Gruppe zu erstellen.
Wählen Sie in der Liste ein IoT Hub-Tag und eine Geräteklasse und dann Gruppe erstellen aus.
Nachdem die Gruppe erstellt wurde, werden Sie feststellen, dass das Updatekonformitätsdiagramm und die Liste der Gruppen aktualisiert wurden. Das Updatekonformitätsdiagramm gibt Aufschluss über die Anzahl von Geräten mit verschiedenen Konformitätszuständen: „Mit neuestem Update“, „Neue Updates verfügbar“ und „Updates werden ausgeführt“. Weitere Informationen zur Updatekonformität
Die neu erstellte Gruppe und alle verfügbaren Updates für die Geräte in der neuen Gruppe sollten angezeigt werden. Wenn Geräte vorhanden sind, die die Geräteklassenanforderungen der Gruppe nicht erfüllen, werden sie in einer entsprechenden Gruppe ungültiger Geräte angezeigt. Sie können das beste verfügbare Update für die neue benutzerdefinierte Gruppe aus dieser Ansicht bereitstellen, indem Sie neben der Gruppe auf die Schaltfläche „Bereitstellen“ klicken. Weitere Informationen finden Sie unter „Nächster Schritt: Bereitstellen des Updates“.

Anzeigen von Gerätedetails für die von Ihnen erstellte Gruppe

Navigieren Sie zu ihrer neu erstellten Gruppe, und klicken Sie auf den Gruppennamen.
Eine Liste der Geräte, die Teil der Gruppe sind, wird zusammen mit den Geräteupdateeigenschaften angezeigt. In dieser Ansicht können Sie auch die Updatekonformitätsinformationen für alle Geräte anzeigen, die Mitglieder der Gruppe sind. Das Updatekonformitätsdiagramm gibt Aufschluss über die Anzahl von Geräten mit verschiedenen Konformitätszuständen: „On latest update“ (Mit aktuellem Update), „New updates available“ (Neue Updates verfügbar) und „Updates in progress“ (Updates werden ausgeführt).
Sie können auch auf jedes einzelne Gerät innerhalb einer Gruppe klicken, um in IoT Hub auf die Seite mit den Gerätedetails umgeleitet zu werden.