Trouver et corriger les appareils manquants dans Device Update for IoT Hub en utilisant la vérification des agents

Apprenez à utiliser la fonction de vérification des agents pour trouver, diagnostiquer et corriger les appareils manquants dans votre instance de mise à jour des appareils pour IoT Hub.

Prerequisites

Note

La fonction de vérification de l’agent ne peut effectuer des vérifications de validation que sur les appareils ayant l’agent de mise à jour de l’appareil installé et qui rapportent un identifiant de modèle PnP correspondant à ceux compatibles avec Device Update for IoT Hub.

Navigateurs pris en charge :

Contrôles de validation pris en charge par la vérification de l’agent

La fonction de vérification de l’agent effectue actuellement les vérifications de validation suivantes sur tous les appareils qui répondent aux prérequis ci-dessus.

Contrôle de validation Criteria
ID de modèle PnP L’ID du modèle PnP est une chaîne rapportée par l’agent de mise à jour des dispositifs au jumeau de périphériques qui décrit quel modèle PnP doit être utilisé pour la communication appareil/cloud. Cette chaîne doit être un identifiant de modèle numérique twin (DTMI) valide qui prend en charge l’interface de mise à jour de l’appareil.
ID d’interface L’identifiant de l’interface est une chaîne rapportée par l’agent de mise à jour de périphérique au jumeau d’appareil, qui décrit quelle version de l’interface de mise à jour de périphérique doit être utilisée pour la communication appareil/cloud. Cette chaîne doit être un DTMI valide qui prend en charge l’interface de mise à jour des appareils.
Noms des propriétés de compatibilité CompatPropertyNames est un champ que l’agent de mise à jour de l’appareil rapporte au jumeau de l’appareil. Il décrit quels deviceProperties champs utiliser pour déterminer la compatibilité de l’appareil avec un déploiement donné. La valeur de ce champ doit être une chaîne de noms délimités par des virgules. La chaîne doit contenir au moins un nom et au maximum cinq noms. Chaque nom doit comporter moins de 32 caractères.
Valeurs des propriétés de compatibilité Les valeurs de propriété de compatibilité sont les paires champ:valeur spécifiées par le champ compatPropertyNames et signalées par l’agent Device Update dans le jumeau d’appareil sous la forme deviceProperties. Chaque nom défini dans les noms de propriétés de compatibilité doit avoir une paire champ :valeur correspondante rapportée. La valeur de chaque paire est limitée à 64 caractères.
Groupe ADU La balise de groupe ADU est une étiquette facultative que vous définissez dans le jumeau numérique de l’appareil. Il détermine à quel groupe d’appareils appartient l’appareil. Si spécifié, la chaîne de balises est limitée à 255 caractères et ne peut contenir que des caractères alphanumériques ainsi que les caractères spéciaux suivants : « . » "-" "_" "~"

Si un appareil ne remplit pas l’un de ces critères, il peut ne pas apparaître correctement dans la mise à jour de l’appareil. Corriger la valeur invalide pour qu’elle remplisse les critères spécifiés devrait faire apparaître correctement l’appareil dans Mise à jour de l’appareil. Si l’appareil n’apparaît ni dans la mise à jour ni dans la vérification de l’agent, il se peut que vous deviez lancer la synchronisation des appareils pour résoudre le problème.

Voir les résultats des vérifications de l’agent

Les résultats de la vérification de l’agent se trouvent dans l’onglet diagnostic de Mise à jour de l’appareil.

  1. Accédez à votre IoT Hub dans le portail Azure.
  2. Sélectionnez Mises à jour dans le menu de navigation, puis sélectionnez l’onglet Diagnostics.
  3. Développez la section Trouver les appareils manquants .

Lancer une opération de synchronisation de périphérique

La synchronisation des appareils devrait être déclenchée si un appareil a été enregistré dans le hub IoT mais n’apparaît ni dans la mise à jour de l’appareil ni dans les résultats de vérification de l’agent.

Une seule opération de synchronisation de périphérique peut être active à la fois pour chaque instance de mise à jour de l’appareil.

  1. Accédez à votre IoT Hub dans le portail Azure.
  2. Sélectionnez Mises à jour dans le menu de navigation, puis sélectionnez l’onglet Diagnostics.
  3. Agrandir la section Afficher l’état de l’appareil.
  4. Sélectionne Lancer la synchronisation d’un appareil.

Étapes suivantes

Pour en savoir plus sur les capacités de diagnostic de Device Update, consultez l’aperçu des fonctionnalités de diagnostic de mise à jour des appareils

  • Dernière mise à jour :