Erstellen von Gerätegruppen im Geräteupdate für IoT Hub

Das Geräteupdate für IoT Hub ermöglicht die Bereitstellung eines Updates auf einer Gruppe von IoT-Geräten.

Voraussetzungen

• Zugriff auf einen IoT Hub mit aktivierter Geräteaktualisierung für IoT Hub. Es wird empfohlen, eine S1 -Ebene (Standard) oder höher für Ihren IoT Hub zu verwenden.
• Ein IoT-Gerät (oder Simulator), das für das Geräteupdate im IoT Hub bereitgestellt wird.
• Mindestens ein Update wurde für das bereitgestellte Gerät erfolgreich importiert.
• Installieren und starten Sie den Geräte-Update-Agent auf Ihrem IoT-Gerät entweder als Modul oder Identität auf Geräte-Ebene

Hinzufügen eines Tags zu Ihren Geräten

Das Geräteupdate für IoT Hub ermöglicht die Bereitstellung eines Updates auf einer Gruppe von IoT-Geräten. Um eine Gruppe zu erstellen, besteht der erste Schritt darin, dem Zielsatz von Geräten im IoT Hub ein Tag hinzuzufügen. Tags können nur erfolgreich zu Ihrem Gerät hinzugefügt werden, nachdem sie mit dem Geräteupdate verbunden wurde.

In der folgenden Dokumentation wird beschrieben, wie Sie ein Tag hinzufügen und aktualisieren.

Programmgesteuertes Aktualisieren von Gerätezwillingen

Sie können einen Geräte-Zwilling mit dem entsprechenden Tag aktualisieren, nachdem Sie das Gerät bei Device Update registriert haben, indem Sie RegistryManager verwenden.

• Erfahren Sie, wie Sie Tags mithilfe einer .NET-Beispiel-App hinzufügen.
• Erfahren Sie mehr über Tag-Eigenschaften.

Geräteupdate-Tagformat

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

Verwenden von Jobs

Es ist möglich, einen Auftrag auf mehreren Geräten zu programmieren, um ein Geräte-Update-Tag hinzuzufügen oder zu aktualisieren. Beispiele finden Sie unter Planen von Aufträgen auf mehreren Geräten. Sie können einen Geräte-Zwilling oder Modul-Zwilling aktualisieren, falls der Geräteaktualisierungs-Agent als Modulidentität konfiguriert ist, mithilfe von Aufträgen. Weitere Informationen finden Sie unter Planen und Übertragen von Aufträgen.

Direkte Zwilling-Aktualisierungen

Tags können auch direkt in einem Geräte-Zwilling oder Modul-Zwilling hinzugefügt oder aktualisiert werden.

1. Melden Sie sich beim Azure-Portal an, und navigieren Sie zu Ihrer IoT Hub-Instanz.

2. Wählen Sie Geräte aus dem Navigationsmenü aus, und wählen Sie Ihr IoT-Gerät aus, um die Gerätedetails zu öffnen.

3. Öffnen Sie die Details zu den Zwillingen.

   • Wenn der Geräteupdate-Agent als Geräteidentität konfiguriert ist, wählen Sie Device Twinaus.
   • Wenn der Geräteupdate-Agent als Modulidentität konfiguriert ist, wählen Sie das Geräteupdate-Modul aus und dann Modulidentitäts-Zwilling.

4. Löschen Sie im Gerätetwin oder Modultwin alle vorhandenen Tagwerte des Geräteupdates, indem Sie sie auf null festlegen.

5. Fügen Sie einen neuen Geräteupdate-Tagwert hinzu, wie unten dargestellt. Beispiel-JSON-Dokument eines Gerätetwin mit Tags.

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

Einschränkungen

• Sie können Ihrem Tag einen beliebigen Wert hinzufügen, mit Ausnahme von "Nicht kategorisiert", bei dem es sich um einen reservierten Wert handelt.
• Der Tagwert darf nicht mehr als 255 Zeichen überschreiten.
• Der Tagwert kann alphanumerische Zeichen und die folgenden Sonderzeichen ".","-","_";"~" enthalten.
• Tag- und Gruppennamen sind case-sensitive.
• Ein Gerät kann nur ein Tag mit dem Namen ADUGroup haben, alle nachfolgenden Ergänzungen 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

1. Öffnen Sie das Azure-Portal.

2. Wählen Sie den IoT Hub aus, den Sie zuvor mit Ihrer Device Update-Instanz verbunden haben.

3. Wählen Sie in der linken Navigationsleiste die Option Updates unter Geräteverwaltung aus.

4. Wählen Sie oben auf der Seite die Registerkarte Gruppen und Bereitstellungen aus.

   

5. Wählen Sie Gruppe hinzufügen aus, um eine neue Gruppe zu erstellen.

   

6. Wählen Sie ein IoT Hub-Tag und eine Geräteklasse aus der Liste aus und klicken Sie dann auf Gruppe erstellen.

   

7. Nachdem die Gruppe erstellt wurde, sehen Sie, dass das Update-Konformitätsdiagramm und die Gruppenliste aktualisiert werden. Das Diagramm "Update-Compliance" zeigt die Anzahl der Geräte in verschiedenen Compliance-Zuständen an: Mit dem neuesten Update, Neue Updates verfügbar und Updates in Bearbeitung. Erfahren Sie mehr über die Update-Compliance.

   

8. Ihre 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 ungültigen Gruppe angezeigt. Sie können das beste verfügbare Update für die neue benutzerdefinierte Gruppe aus dieser Ansicht bereitstellen, indem Sie auf die Schaltfläche "Bereitstellen" neben der Gruppe klicken. Weitere Informationen finden Sie im nächsten Schritt: Bereitstellen von Update.

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

1. Navigieren Sie zu Ihrer neu erstellten Gruppe, und klicken Sie auf den Gruppennamen.

2. Eine Liste der Geräte, die Teil der Gruppe sind, werden zusammen mit ihren Geräteaktualisierungseigenschaften angezeigt. In dieser Ansicht können Sie auch die Update-Compliance-Informationen für alle Geräte anzeigen, die zur Gruppe gehören. Das Diagramm "Update-Compliance" zeigt die Anzahl der Geräte in verschiedenen Compliance-Zuständen: Aktualisiert auf dem neuesten Stand, Neue Updates verfügbar und Updates in Bearbeitung.

   

3. Sie können auch auf jedes einzelne Gerät innerhalb einer Gruppe klicken, um zur Seite mit den Gerätedetails im IoT Hub umgeleitet zu werden.

   

Nächste Schritte

Update bereitstellen

Weitere Informationen zu Gerätegruppen

Erfahren Sie mehr über die Update-Compliance.