Rechercher et corriger les appareils manquants dans Device Update pour IoT Hub à l’aide de la vérification de l’agent
Découvrez comment utiliser la fonctionnalité de vérification de l’agent pour rechercher, diagnostiquer et corriger les appareils manquants dans votre instance Device Update pour IoT Hub.
Prérequis
- Accès à un hub IoT avec Device Update pour IoT Hub activé.
- Un appareil IoT (ou simulateur) provisionné pour Device Update et présentant un ID de modèle compatible Plug-and-Play (PnP).
Notes
La fonctionnalité de vérification de l’agent peut effectuer des contrôles de validation uniquement sur les appareils où l’agent Device Update est installé et qui présentent un ID de modèle PnP compatible avec Device Update pour IoT Hub.
Navigateurs pris en charge :
- Microsoft Edge
- Google Chrome
Contrôles de validation pris en charge par la vérification de l’agent
La fonctionnalité de vérification de l’agent effectue actuellement les contrôles de validation suivants sur tous les appareils qui remplissent les prérequis ci-dessus.
| Contrôle de validation | Critères |
|---|---|
| ID de modèle PnP | L’ID de modèle PnP est une chaîne transmise par l’agent Device Update au jumeau d’appareil qui décrit le modèle PnP à utiliser pour la communication entre l’appareil et le cloud. Cette chaîne doit être un identificateur de modèle de jumeau numérique (DTMI) valide et compatible avec l’interface Device Update. |
| ID d’interface | L’ID d’interface est une chaîne transmise par l’agent Device Update au jumeau d’appareil qui décrit la version de l’interface Device Update à utiliser pour la communication entre l’appareil et le cloud. Cette chaîne doit être un identificateur DTMI valide et compatible avec l’interface Device Update. |
| Noms des propriétés de compatibilité | CompatPropertyNames est un champ transmis par l’agent Device Update au jumeau d’appareil qui décrit les champs deviceProperties à 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, mais pas plus de cinq noms. Chaque nom doit comporter <32 caractères. |
| Valeurs des propriétés de compatibilité | Les valeurs des propriétés de compatibilité sont les paires field:value spécifiées par le champ compatPropertyNames et transmises par l’agent Device Update au jumeau d’appareil en tant que deviceProperties. Chaque nom défini dans les noms de propriétés de compatibilité doit avoir une paire field:value correspondante transmise. La valeur de chaque paire est limitée à 64 caractères. |
| Groupe ADU | L’étiquette Groupe ADU est une étiquette facultative qui est définie dans le jumeau de l’appareil afin de déterminer à quel groupe d’appareils appartient l’appareil. Si elle est spécifiée, l’étiquette est une chaîne limitée à 255 caractères qui peut contenir uniquement des caractères alphanumériques et les caractères spéciaux suivants : « . », « - », « _ », « ~ » |
Si un appareil ne remplit pas l’un de ces critères, il risque de ne pas être affiché dans Device Update. Normalement, après la correction de la valeur non valide selon les critères spécifiés, l’appareil s’affiche correctement dans Device Update. Si l’appareil n’apparaît toujours pas dans Device Update ni dans la vérification de l’agent, essayez de lancer une synchronisation d’appareil pour résoudre le problème.
Examiner les résultats de la vérification de l’agent
Les résultats de la vérification de l’agent se trouvent sous l’onglet Diagnostics de Device Update.
- Accédez à votre IoT Hub dans le portail Azure.
- Sélectionnez Mises à jour dans le menu de navigation, puis sélectionnez l’onglet Diagnostics.
- Développez la section Rechercher les appareils manquants.
Lancer une opération de synchronisation d’appareil
Une synchronisation d’appareil doit être lancée si un appareil a été inscrit dans IoT Hub mais qu’il n’apparaît ni dans Device Update ni dans les résultats de la vérification de l’agent.
Une seule opération de synchronisation d’appareil peut être active à la fois pour chaque instance Device Update.
- Accédez à votre IoT Hub dans le portail Azure.
- Sélectionnez Mises à jour dans le menu de navigation, puis sélectionnez l’onglet Diagnostics.
- Développez la section Afficher l’intégrité des appareils.
- Sélectionnez Démarrer une synchronisation d’appareil.
Étapes suivantes
Pour en savoir plus sur les fonctionnalités de diagnostic de Device Update, consultez la vue d’ensemble des fonctionnalités de diagnostic de mise à jour d’appareil