Freigeben über


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

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.

Unterstützte Browser:

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

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.

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.

  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.

Nächste Schritte

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