Gestire i gruppi di dispositivi per Azure Device Update per hub IoT

Aggiornamento dei dispositivi di Azure per hub IoT consente la distribuzione di aggiornamenti a gruppi definiti dall'utente di dispositivi IoT. Ogni dispositivo gestito da Device Update fa parte di un gruppo di dispositivi, ma la definizione dei gruppi di dispositivi è facoltativa. In alternativa, è possibile eseguire la distribuzione nel gruppo di dispositivi predefinito fornito da Device Update.

Se si creano e si assegnano valori di tag di Aggiornamento dispositivi definiti dall'utente ai dispositivi, Aggiornamento dispositivo crea automaticamente gruppi in base ai tag assegnati e alle proprietà di compatibilità dei dispositivi. Per ciascun gruppo di dispositivi, Device Update può creare più sottogruppi che hanno classi di dispositivi diverse. Device Update colloca i dispositivi senza tag nel gruppo di dispositivi default.

Questo articolo descrive come utilizzare il portale di Azure o l'interfaccia della riga di comando di Azure (CLI di Azure) per creare e gestire i tag dei dispositivi e i gruppi di Device Update definiti dall'utente. Per distribuire gli aggiornamenti ai gruppi di dispositivi definiti dall'utente o predefiniti, vedere Distribuire un aggiornamento del dispositivo.

Prerequisiti

Prima di iniziare, tieni presente i seguenti prerequisiti:

• I dispositivi devono essere onboardati con successo su Device Update prima che possa avvenire l'assegnazione di gruppo.
• I dispositivi devono segnalare un ID modello Plug and Play supportato. Per un elenco degli ID dei modelli supportati, vedi Modelli di aggiornamento dispositivo.
• Per gli scenari IoT Edge, l'agente Device Update funziona come modulo e deve riportare l'ID del modello tramite l'identità appropriata.

Aggiungere tag ai dispositivi

Per assegnare un gruppo di dispositivi Device Update, aggiungi il ADUGroup tag a un set target di dispositivi connessi Device Update in hub IoT. Aggiungere il tag al dispositivo gemello se viene effettuato il provisioning dell'agente di Aggiornamento dispositivi con identità del dispositivo o al modulo gemello corrispondente se viene effettuato il provisioning dell'agente di Aggiornamento dispositivi con un'identità del modulo.

Il tag Device Update ADUGroup usa un formato chiave-valore, come illustrato nell'esempio di dispositivo o modulo gemello seguente:

"etag": "",
"deviceId": "",
"deviceEtag": "",
"version": <version>,
"tags": {
   "ADUGroup": "<CustomTagValue>"
}

Per altre informazioni ed esempi di sintassi JSON gemella, vedere Informazioni e uso dei dispositivi gemelli o Informazioni e uso dei moduli gemelli.

Il ADUGroup tag presenta le proprietà e le limitazioni seguenti:

• Un dispositivo può avere un solo tag ADUGroup e appartenere a un solo gruppo di Device Update alla volta. L'aggiunta di un altro tag denominato ADUGroup esegue l'override del valore esistente ADUGroup .
• È possibile usare qualsiasi valore per il tag, ad eccezione dei valori Uncategorized riservati e $default.
• Il valore del tag non può superare i 200 caratteri.
• Il valore del tag può contenere caratteri alfanumerici e i caratteri speciali seguenti: . - _ ~.
• I ADUGroup valori del nome del tag e del nome del gruppo fanno distinzione tra maiuscole e minuscole.

Le sezioni seguenti descrivono diversi modi per aggiungere e aggiornare il tag.

Aggiungere tag con SDK

È possibile aggiornare il dispositivo o il modulo gemello con il tag appropriato usando RegistryManager dopo aver registrato il dispositivo con Device Update. Per altre informazioni, vedere gli articoli seguenti:

• Introduzione ai dispositivi gemelli con .NET
• Informazioni sul formato di tag e proprietà

Aggiungere tag usando processi

È possibile pianificare processi per aggiungere o aggiornare i tag di Device Update su più dispositivi. Per esempi di operazioni sui processi, vedere Pianificare processi in più dispositivi. È possibile aggiornare dispositivi gemelli o moduli gemelli usando processi, a seconda che l'agente di Aggiornamento dispositivi sia sottoposto a provisioning con un'identità del dispositivo o del modulo. Per altre informazioni, vedere Pianificare e trasmettere processi.

Aggiungere tag aggiornando i gemelli

È anche possibile aggiungere o aggiornare il ADUGroup tag direttamente nel dispositivo o nel modulo gemello.

az iot hub module-twin update \
    --hub-name <IoT hub name> \
    --device-id <device name> \
    --module-id <module name> \
    --tags '{"ADUGroup": "<custom_tag_value"}'

Visualizzare i gruppi di dispositivi

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>

Visualizzare i dettagli del dispositivo per un gruppo

az iot du device group show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <value of the ADUGroup tag for this group>
    --best-updates
    --update-compliance

Rimuovere un dispositivo da un gruppo di dispositivi

Per rimuovere un dispositivo da un gruppo di dispositivi, modificare il valore del tag ADUGroup in null nel gemello digitale e selezionare Salva.

    "tags": {
            "ADUGroup": "null"
            }

Questa azione elimina il tag di gruppo dal dispositivo gemello e rimuove il dispositivo dal gruppo di dispositivi.

Eliminare un gruppo di dispositivi

Device Update crea automaticamente gruppi di dispositivi e mantiene i gruppi di dispositivi, le classi di dispositivi e le distribuzioni per fini di archiviazione storica o per altre esigenze degli utenti, invece di eliminarli automaticamente. È possibile eliminare i gruppi di dispositivi tramite il portale di Azure selezionando ed eliminando singolarmente i gruppi oppure chiamando il comando dell'interfaccia az iot du device group delete della riga di comando di Azure nel gruppo.

Per essere eliminato, un gruppo deve soddisfare i requisiti seguenti:

• Non deve essere un gruppo default.
• Non deve contenere alcun dispositivo associato. Vale a dire, nessun dispositivo di cui è stato eseguito il provisioning nell'istanza di Device Update può avere un tag ADUGroup il cui valore corrisponda al nome del gruppo.
• Non devono essere associate distribuzioni attive o annullate.

Se un dispositivo viene assegnato di nuovo a un nome di gruppo eliminato, Aggiornamento dispositivo ricrea automaticamente il gruppo, ma non esiste alcuna cronologia di distribuzione o dispositivo associato.

Troubleshooting

Se taggi un dispositivo ma non vedi un gruppo, prova i seguenti passaggi di troubleshooting:

• Verifica che il tag sia configurato correttamente.
• Verifica che il dispositivo includa un ID modello Plug and Play valido e un tag validoADUGroup.
• Conferma che le rotte dei messaggi dell'hub IoT siano configurate correttamente. Per maggiori informazioni, vedi Instradamento dei messaggi.
• Assicurati che l'hub IoT sia correttamente associato all'istanza di Aggiornamento Dispositivi.
• Eseguire la diagnostica di aggiornamento dispositivo e il controllo agente.
• Esegui la sincronizzazione dei dispositivi se necessario.

Per ulteriori informazioni, consulta Plug and Play in Azure Device Update e Device Update per il controllo dell'agente hub IoT di Azure.

Contenuto correlato

• Gruppi di dispositivi
• Conformità degli aggiornamenti dei dispositivi
• Distribuire un aggiornamento