Finden und beheben Sie fehlende Geräte im Device Update für den IoT Hub mit Agent Check

Erfahren Sie, wie Sie die Agentenprüfung nutzen, um fehlende Geräte in Ihrer Device Update for IoT Hub-Instanz zu finden, zu diagnostizieren und zu beheben.

Voraussetzungen

Note

Die Agenten-Check-Funktion kann nur Validierungsprüfungen an Geräten durchführen, bei denen der Device Update Agent installiert ist und eine PnP-Modell-ID meldet, die mit denen kompatibel ist, die mit Device Update for IoT Hub kompatibel sind.

Unterstützte Browser:

Validierungsprüfungen, die durch Agentenprüfung unterstützt werden

Die Agentenprüffunktion führt derzeit die folgenden Validierungsprüfungen auf allen Geräten durch, die die oben genannten Voraussetzungen erfüllen.

Prüfung der Gültigkeit Criteria
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 Zeichenkette muss ein gültiger Digital Twin Model Identifier (DTMI) sein, der die Device Update-Schnittstelle unterstützt.
Schnittstellen-ID Die Schnittstellen-ID ist eine Zeichenkette, die vom Device Update Agent an den Gerätezwilling gemeldet wird und beschreibt, welche Device Update Schnittstellenversion für die Geräte-/Cloud-Kommunikation verwendet werden soll. Dieser String muss ein gültiges DTMI sein, das die Device Update-Schnittstelle unterstützt.
Namen der Kompatibilitätseigenschaften CompatPropertyNames ist ein Feld, das der Device Update-Agent an den Gerätezwilling meldet. Sie beschreibt, welche deviceProperties Felder verwendet werden sollen, um die Kompatibilität des Geräts mit einer bestimmten Bereitstellung zu bestimmen. Der Wert dieses Feldes muss eine Folge von komma-getrennten Namen sein. Der String muss mindestens einen und nicht mehr als fünf Namen enthalten. Jeder Name muss weniger als 32 Zeichen haben.
Werte der Kompatibilitätseigenschaft Die Werte der Kompatibilitätseigenschaft sind die Feld-Wert-Paare, die im Feld compatPropertyNames angegeben sind und vom Device Update-Agent als deviceProperties an den Gerätezwilling gemeldet werden. Für jeden in den Namen der Kompatibilitätseigenschaften definierten Namen muss ein entsprechendes Feld:Wert-Paar gemeldet werden. Der Wert für jedes Paar ist auf 64 Zeichen begrenzt.
ADU-Gruppe Das ADU-Gruppen-Tag ist ein optionales Tag, das Sie im Gerätezwilling des Geräts definieren. Es bestimmt, zu welcher Gerätegruppe das Gerät gehört. Wenn angegeben, ist die Tag-Zeichenkette auf 255 Zeichen begrenzt und kann nur alphanumerische Zeichen und die folgenden Sonderzeichen enthalten: "." "-" "_" "~"

Wenn ein Gerät eines dieser Kriterien nicht erfüllt, wird es möglicherweise nicht korrekt im Geräte-Update angezeigt. Die Korrektur des ungültigen Werts, um die angegebenen Kriterien zu erfüllen, sollte dazu führen, dass das Gerät im Device Update korrekt erscheint. Wenn das Gerät weder im Device Update noch im Agentencheck angezeigt wird, musst du eventuell eine Device Sync durchführen, um das Problem zu beheben.

Ergebnisse der Agentenprüfung anzeigen

Die Ergebnisse der Agentenprüfung finden Sie im Diagnose-Tab von Device Update.

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

Starten Sie eine Gerätesynchronisationsoperation

Die Gerätesynchronisation sollte ausgelöst werden, wenn ein Gerät im IoT-Hub registriert wurde, aber weder im Geräte-Update noch in den Agenten-Check-Ergebnissen angezeigt wird.

Für jede Device Update-Instanz kann jeweils nur eine Gerätesynchronisationsoperation aktiv sein.

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

Nächste Schritte

Um mehr über die Diagnosefunktionen von Device Update zu erfahren, siehe Übersicht der Diagnosefunktionen für Geräteaktualisierungen

  • Zuletzt aktualisiert um