Freigeben über

Verwalten von Gerätegruppen für Azure Device Update for IoT Hub

  • Artikel

Azure Device Update for IoT Hub ermöglicht die Bereitstellung von Updates für benutzerdefinierte Gruppen von IoT-Geräten. Jedes verwaltete Gerät für Geräteupdates ist Mitglied einer Gerätegruppe, aber das Definieren von Gerätegruppen ist optional. Sie können alternativ für die Standardgerätegruppe bereitstellen, die Geräteupdate bereitstellt.

Wenn Sie benutzerdefinierte Geräteupdate-Tagwerte für Geräte erstellen und zuweisen, erstellt Device Update automatisch Gruppen basierend auf den zugewiesenen Tags und Gerätekompatibilitätseigenschaften. Für jede Gerätegruppe kann Die Geräteaktualisierung mehrere Untergruppen mit unterschiedlichen Geräteklassen erstellen. Geräteaktualisierung platziert Geräte ohne Tags in der default Gerätegruppe.

In diesem Artikel wird beschrieben, wie Sie das Azure-Portal oder die Azure CLI verwenden, um benutzerdefinierte Geräteupdate-Gerätetags und -gruppen zu erstellen und zu verwalten. Informationen zum Bereitstellen von Updates für benutzerdefinierte oder Standardgerätegruppen finden Sie unter Bereitstellen eines Geräteupdates.

Voraussetzungen

Hinzufügen von Tags zu Ihren Geräten

Um eine Geräteaktualisierungsgerätegruppe zuzuweisen, fügen Sie das ADUGroup Tag einem Zielsatz von verbundenen Geräten im IoT Hub hinzu. Fügen Sie Tags dem Gerätezwilling hinzu, wenn Ihr Device Update-Agent mit Geräteidentität bereitgestellt wird, oder dem entsprechenden Modulzwilling hinzu, wenn der Device Update-Agent mit einer Modulidentität bereitgestellt wird.

Das Device Update-Tag ADUGroup verwendet ein Schlüsselwertformat, wie im folgenden Beispiel für Gerät oder Modulzwilling gezeigt:

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

Weitere Informationen und Beispiele zur JSON-Syntax für Zwillinge finden Sie unter Verstehen und Verwenden von Gerätezwillingen bzw. Verstehen und Verwenden von Modulzwillingen.

Das ADUGroup Tag weist die folgenden Eigenschaften und Einschränkungen auf:

  • Ein Gerät kann nur ein ADUGroup Tag haben und gleichzeitig nur einer Geräteaktualisierungsgruppe angehören. Durch Hinzufügen eines weiteren Tags mit dem Namen ADUGroup wird der vorhandene ADUGroup Wert außer Kraft gesetzt.
  • Sie können einen beliebigen Wert für das Tag verwenden, mit Ausnahme der reservierten Werte Uncategorized und $default.
  • Der Tagwert darf maximal 200 Zeichen enthalten.
  • Der Tagwert darf alphanumerische Zeichen und die folgenden Sonderzeichen enthalten: . - _ ~.
  • Bei ADUGroup den Tagnamen- und Gruppennamenwerten wird die Groß-/Kleinschreibung beachtet.

In den folgenden Abschnitten werden verschiedene Möglichkeiten zum Hinzufügen und Aktualisieren des Tags beschrieben.

Hinzufügen von Tags mit SDKs

Nachdem Sie das Gerät bei Device Update registriert haben, können Sie den Geräte- oder Modulzwilling mithilfe von RegistryManager mit dem entsprechenden Tag aktualisieren. Weitere Informationen finden Sie in den folgenden Artikeln:

Hinzufügen von Tags mithilfe von Aufträgen

Sie können Aufträge planen, um Geräteupdatetags auf mehreren Geräten hinzuzufügen oder zu aktualisieren. Beispiele für Auftragsvorgänge finden Sie unter Planen von Aufträgen auf mehreren Geräten. Sie können entweder Gerätezwillinge oder Modulzwillinge mithilfe von Aufträgen aktualisieren – je nachdem, ob der Device Update-Agent mit einer Geräte- oder Modulidentität bereitgestellt wird. Weitere Informationen finden Sie unter Planen und Übertragen von Aufträgen.

Hinweis

Dieser Vorgang wird auf Ihr IoT Hub-Nachrichtenkontingent angerechnet. Wenn Sie 50.000 oder mehr Geräte- oder Modul-Twin-Tags gleichzeitig ändern, überschreiten Sie möglicherweise Ihr tägliches IoT Hub-Nachrichtenkontingent und müssen weitere IoT Hub-Einheiten kaufen. Weitere Informationen finden Sie unter Kontingente und Drosselung.

Hinzufügen von Tags durch Aktualisieren von Zwillingen

Sie können das ADUGroup Tag auch direkt im Gerät oder Modul Twin hinzufügen oder aktualisieren.

  1. Navigieren Sie im Azure-Portal zu Ihrem IoT Hub.

  2. Wählen Sie im linken Navigationsbereich unter Geräteverwaltung die Option Updates aus. Wenn Sie über ein IoT Edge-Gerät verfügen, wählen Sie stattdessen IoT Edge aus.

  3. Wählen Sie auf der Seite Geräte Ihr Geräts aus.

  4. Wählen Sie auf der Geräteseite entweder "Gerätezwilling" im oberen Menü aus, oder wählen Sie die Modulidentität unter Modulidentitäten aus, und wählen Sie dann den Modulzwilling aus.

  5. Fügen Sie im Twin das ADUGroup Tag mit einem benutzerdefinierten Wert wie folgt hinzu. Um einen vorhandenen ADUGroup Tagwert zu aktualisieren, überschreiben Sie ihn mit einem anderen benutzerdefinierten Wert.

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

  6. Wählen Sie Speichern.

Anzeigen von Gerätegruppen

  1. Navigieren Sie im Azure-Portal zum IoT Hub, der mit Ihrer Device Update-Instanz verbunden ist.

  2. Wählen Sie im linken Navigationsbereich die Option "Updates" unter "Geräteverwaltung " aus.

  3. Wählen Sie die Registerkarte Gruppen und Bereitstellungen aus.

    Screenshot: Nicht gruppierte Geräte.

Nachdem Sie eine Gruppe erstellt haben, werden das Konformitätsdiagramm und die Gruppenliste aktualisiert. Das Konformitätsdiagramm „Device Update“ zeigt die Anzahl von Geräten in verschiedenen Konformitätszuständen: Mit neuestem Update, Neue Updates verfügbar und Updates werden ausgeführt. Weitere Informationen finden Sie unter Konformität von Device Update.

Vorhandene Geräteaktualisierungsgruppen und alle verfügbaren Updates für die Geräte in diesen Gruppen werden in der Gruppenliste angezeigt. Alle Geräte, die nicht den Anforderungen der Geräteklasse der Gruppe entsprechen, erscheinen in einer entsprechenden ungültigen Gruppe. Sie können für eine Gruppe aus dieser Ansicht das beste verfügbare Update bereitstellen, indem Sie neben der Gruppe Bereitstellen auswählen.

Screenshot: Ansicht der Updatekonformität.

Anzeigen von Gerätedetails für eine Gruppe

  1. Wählen Sie auf der Registerkarte "Gruppen und Bereitstellungen " den Namen der Gruppe aus.

    Auf der Seite "Gruppendetails " wird das Updatekonformitätsdiagramm mit der Anzahl von Gruppenmitgliedsgeräten in verschiedenen Konformitätszuständen und der Liste der Gruppenmitgliedsgeräte mit ihren Geräteaktualisierungseigenschaften angezeigt.

    Screenshot: Ansicht der Gerätegruppendetails.

  2. Wählen Sie ein einzelnes Gerät in einer Gruppe aus, um zur Seite mit den Gerätedetails im IoT Hub zu wechseln.

    Screenshot: Ansicht der Gerätedetails.

    Screenshot der Ansicht mit den Gerätedetails in IoT Hub

Entfernen eines Geräts aus einer Gerätegruppe

Wenn Sie ein Gerät aus einer Gerätegruppe entfernen möchten, ändern Sie den ADUGroup Tagwert null in den Zwilling, und wählen Sie Speichern aus.

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

Diese Aktion löscht das Gruppentag vom Gerätezwilling und entfernt das Gerät aus der Gerätegruppe.

Löschen einer Gerätegruppe

Device Update erstellt automatisch Gerätegruppen und behält Gerätegruppen, Geräteklassen und Bereitstellungen für historische Datensätze oder andere Benutzeranforderungen bei, anstatt sie automatisch zu bereinigen. Sie können Gerätegruppen über das Azure-Portal löschen, indem Sie die Gruppen einzeln auswählen und löschen oder den az iot du device group delete Azure CLI-Befehl für die Gruppe aufrufen.

Für das Löschen muss eine Gruppe die folgenden Anforderungen erfüllen:

  • Darf keine default Gruppe sein.
  • Darf keine Mitgliedsgeräte haben. Das heißt, kein Gerät, das in der Device Update-Instanz bereitgestellt wird, kann ein ADUGroup Tag mit einem Wert aufweisen, der dem Namen der Gruppe entspricht.
  • Es darf keine aktiven oder abgebrochenen Bereitstellungen vorhanden sein.

Hinweis

Wenn Sie eine Gruppe, die die vorherigen Anforderungen erfüllt, nicht löschen können, überprüfen Sie, ob fehlerhafte Geräte als Teil der Gruppe gekennzeichnet sind. Fehlerhafte Geräte können keine Bereitstellung erhalten, sodass sie nicht direkt in der Liste der Mitgliedergeräte in einer Gruppe angezeigt werden.

So überprüfen Sie, ob fehlerhafte Geräte vorhanden sind:

  1. Navigieren Sie im Azure-Portal zu Ihrem IoT Hub.
  2. Wählen Sie im linken Navigationsbereich Updates aus, und wählen Sie dann die Registerkarte Diagnose aus.
  3. Erweitern Sie den Abschnitt Fehlende Geräte suchen.

Wenn Sie nicht fehlerhafte Geräte als Teil der Gruppe markiert haben, müssen Sie den Tagwert ändern oder das Gerät löschen, bevor Sie die Gruppe löschen können.

Wenn einem gelöschten Gruppennamen jemals ein Gerät zugewiesen wird, erstellt Device Update die Gruppe automatisch neu, es gibt jedoch keinen zugeordneten Geräte- oder Bereitstellungsverlauf.

Zugehöriger Inhalt