Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Scopri come utilizzare la funzione di controllo degli agenti per trovare, diagnosticare e correggere dispositivi mancanti nella tua istanza di Aggiornamento Dispositivo per hub IoT.
Prerequisiti
- Accesso a un hub IoT con Device Update for hub IoT abilitato.
- Un dispositivo IoT (o simulatore) provvisionato per l'aggiornamento del dispositivo e che riporta un ID modello Plug and Play (PnP) compatibile.
Annotazioni
La funzione di controllo dell'agente può eseguire controlli di validazione solo su dispositivi che hanno installato l'agente Device Update e che segnalano un ID modello PnP corrispondente a quelli compatibili con Device Update for hub IoT.
- Portale di Azure
- interfaccia della riga di comando di Azure
Browser supportati:
- Microsoft Edge
- Google Chrome
Controlli di validazione supportati dal controllo agente
La funzione di controllo dell'agente attualmente esegue i seguenti controlli di validazione su tutti i dispositivi che soddisfano i prerequisiti sopra indicati.
| Controllo della convalida | Criteria |
|---|---|
| ID del modello PnP | L'ID del modello PnP è una stringa che viene segnalata dall'agente Device Update al gemello del dispositivo e che descrive quale modello PnP deve essere utilizzato per la comunicazione dispositivo/cloud. Questa stringa deve essere un identificatore di modello di gemello digitale (DTMI) valido che supporta l'interfaccia Device Update. |
| ID dell'interfaccia | L'ID dell'interfaccia è una stringa che viene segnalata dall'agente Device Update al dispositivo gemello e che descrive quale versione dell'interfaccia Device Update deve essere utilizzata per la comunicazione dispositivo/cloud. Questa stringa deve essere un DTMI valido che supporti l'interfaccia Device Update. |
| Nomi delle proprietà di compatibilità |
CompatPropertyNames è un campo che l'agente Device Update riporta al device twin. Descrive quali deviceProperties campi utilizzare per determinare la compatibilità del dispositivo con una determinata implementazione. Il valore di questo campo deve essere una sequenza di nomi delimitati da virgole. La stringa deve contenere almeno uno e non più di cinque nomi. Ogni nome deve avere meno di 32 caratteri. |
| Valori delle proprietà di compatibilità | I valori delle proprietà di compatibilità sono le coppie campo:valore specificate dal compatPropertyNames campo e riportate dall'agente Device Update al gemello del dispositivo come deviceProperties. Ogni nome definito nei nomi delle proprietà di compatibilità deve avere una coppia campo:valore corrispondente segnalata. Il valore per ogni coppia è limitato a 64 caratteri. |
| Gruppo ADU | Il tag ADU Group è un tag facoltativo che viene definito nel gemello digitale del dispositivo. Determina a quale gruppo di dispositivi appartiene. Se specificato, la stringa di tag è limitata a 255 caratteri e può contenere solo caratteri alfanumerici e i seguenti caratteri speciali: "." "-" "_" "~" |
Se un dispositivo non soddisfa uno di questi criteri, potrebbe non apparire correttamente in Aggiornamento dispositivo. Correggere il valore non valido per soddisfare i criteri specificati dovrebbe far apparire correttamente il dispositivo in Aggiornamento dispositivo. Se il dispositivo non appare né in Device Update né nel controllo agente, potresti dover eseguire la sincronizzazione dei dispositivi per risolvere il problema.
Visualizza i risultati del controllo dell'agente
- Portale di Azure
- interfaccia della riga di comando di Azure
I risultati del controllo agente si trovano nella scheda diagnostica di Aggiornamento dispositivo.
- Nel portale Azure passare all'hub IoT.
- Seleziona Aggiornamenti dal menu di navigazione, poi seleziona la scheda Diagnostica.
- Espandi la sezione Trova dispositivi mancanti .
Avvia un'operazione di sincronizzazione del dispositivo
La sincronizzazione dei dispositivi dovrebbe essere attivata se un dispositivo è stato registrato nell'IoT hub ma non appare né nell'aggiornamento del dispositivo né nei risultati del controllo agente.
Può essere attiva una sola operazione di sincronizzazione del dispositivo alla volta per ogni istanza di aggiornamento dispositivo.
- Portale di Azure
- interfaccia della riga di comando di Azure
- Nel portale Azure passare all'hub IoT.
- Seleziona Aggiornamenti dal menu di navigazione, poi seleziona la scheda Diagnostica.
- Espandi la sezione Visualizza salute del dispositivo.
- Seleziona Avvia sincronizzazione del dispositivo.
Passaggi successivi
Per saperne di più sulle capacità diagnostiche di Aggiornamento Dispositivi, consulta Panoramica delle funzionalità diagnostiche degli aggiornamenti dispositivi