Ermitteln und Beheben von Problemen mit Geräten, die in Device Update for IoT Hub fehlen, mit der Agent-Überprüfung

Erfahren Sie, wie Sie die Agent-Überprüfungsfunktion verwenden, um Geräte zu ermitteln, zu diagnostizieren und zu korrigieren, die in Ihrer Device Update for IoT Hub-Instanz fehlen.

Voraussetzungen

• Zugriff auf einen IoT Hub mit aktivierter Device Update for IoT Hub-Instanz.
• Ein IoT-Gerät (oder -Simulator), das für Device Update bereitgestellt wird und eine kompatible PnP-Modell-ID (Plug & Play) meldet.

Hinweis

Die Agent-Überprüfungsfunktion kann nur Überprüfungen auf Geräten durchführen, auf denen der Device Update-Agent installiert ist und die eine PnP-Modell-ID melden, die mit Device Update for IoT Hub kompatibel ist.

Azure portal

Unterstützte Browser:

• Microsoft Edge
• Google Chrome

Azure-Befehlszeilenschnittstelle

Eine Azure CLI-Umgebung:

• Verwenden Sie die Bash-Umgebung in Azure Cloud Shell.

  

• Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI

  1. Melden Sie sich mit dem Befehl az login bei der Azure CLI an.
  2. Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.
  3. Installieren Sie die Azure CLI-Erweiterungen bei der ersten Verwendung, wenn Sie dazu aufgefordert werden. Die Befehle in diesem Artikel verwenden die azure-iot-Erweiterung . Führen Sie az extension update --name azure-iot aus, um sicherzustellen, dass Sie die neueste Version der Erweiterung verwenden.

Von der Agent-Überprüfung unterstützte Überprüfungen

Die Agent-Überprüfungsfunktion führt derzeit die folgenden Überprüfungen auf allen Geräten durch, die die oben genannten Voraussetzungen erfüllen.

Validierungsüberprüfung	Kriterien
PnP-Modell-ID	Die PnP-Modell-ID ist eine Zeichenfolge, die vom Device Update-Agent an den Gerätezwilling gemeldet wird und beschreibt, welches PnP-Modell für die Geräte-/Cloudkommunikation verwendet werden soll. Diese Zeichenfolge muss ein gültiger Digital Twin Model Identifier (DTMI) sein, der die Device Update-Schnittstelle unterstützt.
Schnittstellen-ID	Die Schnittstellen-ID ist eine Zeichenfolge, die vom Device Update-Agent an den Gerätezwilling gemeldet wird und beschreibt, welche Device Update-Schnittstellenversion für die Geräte-/Cloudkommunikation verwendet werden soll. Diese Zeichenfolge muss eine gültige DTMI sein, die die Device Update-Schnittstelle unterstützt.
Kompatibilitätseigenschaftennamen	CompatPropertyNames ist ein Feld, das vom Device Update-Agent an den Gerätezwilling gemeldet wird und beschreibt, welche deviceProperties-Felder verwendet werden sollen, um die Kompatibilität des Geräts mit einer bestimmten Bereitstellung zu ermitteln. Der Wert dieses Felds muss eine Zeichenfolge mit durch Trennzeichen getrennten Namen sein. Die Zeichenfolge muss mindestens einen Namen und darf nicht mehr als fünf Namen enthalten. Jeder Name muss <32 Zeichen lang sein.
Kompatibilitätseigenschaftenwerte	Kompatibilitätseigenschaftenwerte sind die Feld-Wert-Paare, die vom compatPropertyNames-Feld angegeben und vom Device Update-Agent an den Gerätezwilling als deviceProperties gemeldet werden. Für jeden Namen, der in Kompatibilitätseigenschaftennamen definiert ist, muss ein entsprechendes Feld-Wert-Paar gemeldet werden. Der Wert für jedes Paar ist auf 64 Zeichen beschränkt.
ADU-Gruppe	Das ADU-Gruppentag ist ein optionales Tag, das im Gerätezwilling des Geräts definiert ist und bestimmt, zu welcher Gerätegruppe das Gerät gehört. Wenn angegeben, ist die Tagzeichenfolge auf 255 Zeichen beschränkt und darf nur alphanumerische Zeichen und die folgenden Sonderzeichen enthalten: „.“, „-“, „_“, „~“

Wenn ein Gerät eines dieser Kriterien nicht erfüllt, wird es möglicherweise nicht ordnungsgemäß in Device Update angezeigt. Wenn Sie den ungültigen Wert korrigieren, um die angegebenen Kriterien zu erfüllen, sollte dies dazu führen, dass das Gerät ordnungsgemäß in Device Update angezeigt wird. Wenn das Gerät weder in Device Update noch in der Agent-Überprüfung angezeigt wird, müssen Sie möglicherweise Gerätesynchronisierung ausführen, um das Problem zu beheben.

Anzeigen der Ergebnisse der Agent-Überprüfung

Azure portal

Die Ergebnisse der Agent-Überprüfung finden Sie auf der Registerkarte Diagnose von Device Update.

1. Navigieren Sie im Azure-Portal zu Ihrem IoT Hub.
2. Wählen Sie im Navigationsmenü Updates und dann die Registerkarte Diagnosen aus.
3. Erweitern Sie den Abschnitt Fehlende Geräte suchen.

Azure-Befehlszeilenschnittstelle

Verwenden Sie az iot du device health list, um die Integrität Ihrer Geräte anzuzeigen.

Der Befehl device health list akzeptiert folgende Argumente:

• --account: Der Name des Device Update-Kontos.
• --instance: Der Name der Device Update-Instanz.
• --filter: Ein Geräteintegritätsfilter, der entweder nach Gerätestatus oder nach Geräte-ID filtert. Beispiel:
  • Um alle fehlerfreien Geräte aufzulisten, filtern Sie nach state eq 'Healthy'.
  • Um alle fehlerhaften Geräte aufzulisten, filtern Sie nach state eq 'Unhealthy'.
  • Um den Integritätszustand eines Zielgeräts anzuzeigen, filtern Sie nach deviceId eq '<device_name>' oder deviceId eq '<device_name>' and moduleId eq '<module_name>'.

az iot du device health list --account <Device Update account name> --instance <Device Update instance name> --filter "<filter query>"

Initiieren eines Gerätesynchronisierungsvorgangs

Gerätesynchronisierung sollte ausgelöst werden, wenn ein Gerät in IoT Hub registriert wurde, aber weder in Device Update noch in den Ergebnissen der Agent-Überprüfung angezeigt wird.

Für jede Device Update-Instanz kann jeweils nur ein Gerätesynchronisierungsvorgang gleichzeitig aktiv sein.

Azure portal

1. Navigieren Sie im Azure-Portal zu Ihrem IoT Hub.
2. Wählen Sie im Navigationsmenü Updates und dann die Registerkarte Diagnosen aus.
3. Erweitern Sie den Abschnitt Geräteintegrität anzeigen.
4. Wählen Sie Gerätesynchronisierung starten aus.

Azure-Befehlszeilenschnittstelle

Verwenden Sie az iot du device import, um Geräte und Module aus einem verknüpften IoT Hub in die Device Update-Instanz zu importieren.

az iot du device import --account <Device Update account name> --instance <Device Update instance name>

Nächste Schritte

Weitere Informationen zu den Diagnosefunktionen von Device Update finden Sie unter Übersicht über die Diagnosefunktion von Geräteaktualisierungen