Gestire i gruppi di dispositivi in Aggiornamento dispositivi per hub IoT

Aggiornamento dei dispositivi per hub IoT consente la distribuzione di un aggiornamento in un gruppo di dispositivi IoT. Questo passaggio è facoltativo quando si distribuiscono gli aggiornamenti ai dispositivi gestiti. È possibile distribuire gli aggiornamenti ai dispositivi usando il gruppo predefinito creato automaticamente. In alternativa, è possibile assegnare un tag definito dall'utente ai dispositivi e verranno raggruppati automaticamente in base al tag e alle proprietà di compatibilità del dispositivo.

Prerequisiti

• Accesso a un hub IoT con Aggiornamento del dispositivo per hub IoT abilitato. È consigliabile usare un livello S1 (Standard) o superiore per il hub IoT.
• Provisioning di un dispositivo IoT (o simulatore) per Aggiornamento dispositivi all'interno di hub IoT.
  • Installare e avviare l'agente di Aggiornamento dispositivi nel dispositivo IoT come identità a livello di modulo o dispositivo.
• Aggiornamento importato per il dispositivo di cui è stato effettuato il provisioning.

Aggiungere un tag ai dispositivi

Per creare un gruppo di dispositivi, il primo passaggio consiste nell'aggiungere un tag al set di destinazione di dispositivi in hub IoT. I tag possono essere aggiunti correttamente al dispositivo solo dopo la connessione a Device Update.

I tag di Aggiornamento dispositivi usano il formato nell'esempio 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.

Le sezioni seguenti descrivono diversi modi per aggiungere e aggiornare i 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:

• Informazioni su come aggiungere tag usando un'app .NET di esempio.
• Informazioni sulle proprietà dei tag.

Aggiungere 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.

Aggiungere tag usando processi

È possibile pianificare un processo in più dispositivi per aggiungere o aggiornare un tag di Aggiornamento 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 dispositivi gemelli

I tag possono anche essere aggiunti o aggiornati direttamente nei dispositivi o nei moduli gemelli.

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

Limiti

• È possibile aggiungere qualsiasi valore al tag, ad eccezione Uncategorized di e $default, che sono valori riservati.
• Il valore del tag non può superare i 200 caratteri.
• Il valore del tag può contenere caratteri alfanumerici e i caratteri speciali seguenti: . - _ ~.
• I nomi di tag e gruppi fanno distinzione tra maiuscole e minuscole.
• Un dispositivo può avere un solo tag con il nome ADUGroup. Eventuali aggiunte di un tag con tale nome sostituiranno il valore esistente per il nome del tag ADUGroup.
• Un dispositivo può appartenere a un solo gruppo.

Visualizzare i gruppi di dispositivi

I gruppi vengono creati automaticamente in base ai tag assegnati e alle proprietà di compatibilità dei dispositivi. Un gruppo può avere più sottogruppi con classi di dispositivi diverse.

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>

Rimozione di un dispositivo da un gruppo di dispositivi

Per rimuovere un dispositivo da un gruppo di dispositivi, il valore del tag ADUGroup deve essere modificato in "null".

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

Questo eliminerà il tag ADUGroup dal dispositivo gemello e rimuoverà il dispositivo dal gruppo di dispositivi.

Eliminazione di gruppi di dispositivi

Anche se i gruppi di dispositivi vengono creati automaticamente, i gruppi, le classi di dispositivi e le distribuzioni non vengono puliti automaticamente in modo da conservarli per i record cronologici o altre esigenze utente. I gruppi di dispositivi possono essere eliminati tramite portale di Azure selezionando ed eliminando singolarmente i gruppi desiderati oppure chiamando l'API DELETE nel gruppo. Ulteriori informazioni

Se un dispositivo viene connesso di nuovo per questo gruppo dopo l'eliminazione del gruppo, mentre il gruppo verrà ricreato automaticamente non sarà presente alcun dispositivo o cronologia di distribuzione associato.

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

• Il gruppo deve avere dispositivi no membro. Ciò significa che nessun dispositivo di cui è stato effettuato il provisioning nell'istanza di Aggiornamento dispositivi deve avere un tag ADUGroup con un valore corrispondente al nome del gruppo selezionato.
• Il gruppo non deve essere un gruppo predefinito.
• Al gruppo devono essere associate distribuzioni no attive o annullate.

Passaggi successivi

• Distribuire un aggiornamento

• Altre informazioni sui gruppi di dispositivi

• Altre informazioni sulla conformità degli aggiornamenti dei dispositivi