Gestire i gruppi di dispositivi per Aggiornamento dispositivi di Azure 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 di Aggiornamento dispositivi è un membro 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 ogni gruppo di dispositivi, Aggiornamento dispositivi può creare più sottogruppi con classi di dispositivi diverse. Aggiornamento dispositivi posiziona i dispositivi senza tag nel default gruppo di dispositivi.

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

Prerequisiti

Azure portal

• Istanza Standard (S1) o superiore di hub IoT di Azure con Aggiornamento del dispositivo per hub IoT abilitata.
• Un dispositivo O un simulatore IoT di cui è stato effettuato il provisioning per l'aggiornamento del dispositivo all'interno dell'hub IoT.
• L'agente di Aggiornamento dispositivi installato e avviato nel dispositivo come identità a livello di modulo o dispositivo.
• Aggiornamento importato per il dispositivo di cui è stato effettuato il provisioning.

Interfaccia della riga di comando di Azure

• Istanza Standard (S1) o superiore di hub IoT di Azure con Aggiornamento del dispositivo per hub IoT abilitata.

• Un dispositivo O un simulatore IoT di cui è stato effettuato il provisioning per l'aggiornamento del dispositivo all'interno dell'hub IoT.

• L'agente di Aggiornamento dispositivi installato e avviato nel dispositivo come identità a livello di modulo o dispositivo.

• Aggiornamento importato per il dispositivo di cui è stato effettuato il provisioning.

• Ambiente Bash in Azure Cloud Shell per eseguire i comandi dell'interfaccia della riga di comando di Azure. Selezionare Avvia Cloud Shell per aprire Cloud Shell oppure selezionare l'icona Cloud Shell nella barra degli strumenti superiore del portale di Azure.

  

  Nota

  Se si preferisce, è possibile eseguire i comandi dell'interfaccia della riga di comando di Azure in locale:

  1. Installare l'interfaccia da riga di comando di Azure. Eseguire az version per visualizzare la versione dell'interfaccia della riga di comando di Azure installata e le librerie dipendenti ed eseguire az upgrade per installare la versione più recente.
  2. Accedere ad Azure eseguendo az login.
  3. Installare l'estensione azure-iot quando richiesto al primo utilizzo. Per assicurarsi di usare la versione più recente dell'estensione, eseguire az extension update --name azure-iot.

Aggiungere tag ai dispositivi

Per assegnare un gruppo di dispositivi Di aggiornamento dispositivi, aggiungere il ADUGroup tag a un set di destinazione di dispositivi connessi di Aggiornamento dispositivi 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 ADUGroup solo tag e appartenere a un solo gruppo di aggiornamento dispositivi 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 i processi per aggiungere o aggiornare i tag di Aggiornamento dispositivi in 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.

Nota

Questa operazione viene conteggiato rispetto alla quota di messaggi hub IoT. Se si modificano 50.000 o più tag del dispositivo o del modulo gemello alla volta, è possibile superare la quota giornaliera hub IoT messaggio e acquistare più unità di hub IoT. Per altre informazioni, vedere Quote e limitazione.

Aggiungere tag aggiornando i dispositivi gemelli

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

Azure portal

1. Nel portale di Azure passare all'hub IoT.

2. Selezionare Dispositivi in Gestione dei dispositivi nel riquadro di spostamento sinistro. Se si ha un dispositivo IoT Edge, selezionare invece IoT Edge .

3. Nella pagina Dispositivi selezionare il dispositivo.

4. Nella pagina del dispositivo selezionare Dispositivo gemello nel menu in alto oppure selezionare l'identità del modulo in Identità del modulo e quindi selezionare il modulo gemello.

5. Nel gemello aggiungere il ADUGroup tag con un valore definito dall'utente, come indicato di seguito. Per aggiornare un valore di tag esistente ADUGroup , sovrascriverlo con un valore definito dall'utente diverso.

       "tags": {
               "ADUGroup": "<CustomTagValue>"
               }
   

6. Seleziona Salva.

Interfaccia della riga di comando di Azure

Usare az iot hub device-twin update o az iot hub module-twin update per aggiungere il ADUGroup tag al dispositivo o al modulo gemello con un valore appropriato. Per entrambi update i comandi, l'argomento --tags accetta json inline o un percorso di un file JSON.

Ad esempio:

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

Azure portal

1. Nella portale di Azure passare all'hub IoT connesso all'istanza di Aggiornamento dispositivi.

2. Selezionare l'opzione Aggiornamenti in Gestione dispositivi nel riquadro di spostamento a sinistra.

3. Selezionare la scheda Gruppi e distribuzioni .

   

Dopo aver creato un gruppo, il grafico di conformità e l'aggiornamento dell'elenco di gruppi. Il grafico conformità aggiornamento dispositivi mostra il numero di dispositivi in vari stati di conformità: aggiornamento più recente, Nuovi aggiornamenti disponibili e Aggiornamenti in corso. Per altre informazioni, vedere Conformità degli aggiornamenti dei dispositivi.

I gruppi di Aggiornamento dispositivi esistenti e gli eventuali aggiornamenti disponibili per i dispositivi in tali gruppi vengono visualizzati nell'elenco di gruppi. Tutti i dispositivi che non soddisfano i requisiti della classe di dispositivo del gruppo vengono visualizzati in un gruppo non valido corrispondente. È possibile distribuire l'aggiornamento migliore disponibile in un gruppo da questa visualizzazione selezionando Distribuisci accanto al gruppo.

Interfaccia della riga di comando di Azure

Usare az iot du device group list per visualizzare tutti i gruppi di dispositivi in un'istanza di Aggiornamento dispositivi.

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

È possibile usare l'argomento --order-by per ordinare l'elenco restituito in base ad aspetti quali ID gruppo, numero di dispositivi o numero di sottogruppi con nuovi aggiornamenti disponibili.

Visualizzare i dettagli del dispositivo per un gruppo

Azure portal

1. Nella scheda Gruppi e distribuzioni selezionare il nome del gruppo.

   La pagina Dettagli gruppo mostra il grafico di conformità degli aggiornamenti con il numero di dispositivi membri del gruppo in vari stati di conformità e l'elenco dei dispositivi membri del gruppo con le relative proprietà di aggiornamento del dispositivo.

   

2. Selezionare un singolo dispositivo all'interno di un gruppo per passare alla relativa pagina dei dettagli del dispositivo in hub IoT.

   

   

Interfaccia della riga di comando di Azure

Usare az iot du device group show per visualizzare i dettagli di un gruppo di dispositivi specifico.

• Il flag facoltativo --best-updates restituisce un elenco dei migliori aggiornamenti disponibili per il gruppo di dispositivi, incluso un conteggio del numero di dispositivi necessari per ogni aggiornamento.

• Il flag facoltativo restituisce --update-compliance le informazioni di conformità per il gruppo di dispositivi, incluso il numero di dispositivi nell'aggiornamento più recente, la necessità di nuovi aggiornamenti o gli aggiornamenti in corso.

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 null del ADUGroup tag in nel dispositivo gemello 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

Aggiornamento dispositivi crea automaticamente gruppi di dispositivi e mantiene gruppi di dispositivi, classi di dispositivi e distribuzioni per record cronologici o altre esigenze utente, invece di pulirli 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 default gruppo.
• Non deve avere alcun dispositivo membro. Ovvero, nessun dispositivo di cui è stato effettuato il provisioning nell'istanza di Aggiornamento dispositivi può avere un ADUGroup tag con un valore corrispondente al nome del gruppo.
• Non devono essere associate distribuzioni attive o annullate.

Nota

Se non è possibile eliminare un gruppo che soddisfa i requisiti precedenti, verificare se sono presenti dispositivi non integri contrassegnati come parte del gruppo. I dispositivi non integri non possono ricevere una distribuzione, quindi non vengono visualizzati direttamente nell'elenco dei dispositivi membri in un gruppo.

Per verificare se sono presenti dispositivi non integri:

1. Nel portale di Azure passare all'hub IoT.
2. Selezionare Aggiornamenti nel riquadro di spostamento a sinistra e quindi selezionare la scheda Diagnostica .
3. Espandere la sezione Trova dispositivi mancanti.

Se sono presenti dispositivi non integri contrassegnati come parte del gruppo, è necessario modificare il valore del tag o eliminare il dispositivo prima di poter eliminare il gruppo.

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.

Contenuto correlato

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