Condividi tramite

az iot du device group

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione azure-iot per l'interfaccia della riga di comando di Azure (versione 2.46.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot du device group . Altre informazioni sulle estensioni.

Gestione del gruppo di dispositivi.

Un gruppo di dispositivi è una raccolta di dispositivi. I gruppi di dispositivi consentono di ridimensionare le distribuzioni in molti dispositivi. Ogni dispositivo appartiene esattamente a un gruppo di dispositivi alla volta. Un gruppo di dispositivi viene creato automaticamente quando un dispositivo abilitato per l'aggiornamento del dispositivo è connesso all'hub e ne segnala le proprietà.

Comandi

Nome Descrizione Tipo Status
az iot du device group delete

Eliminare un gruppo di dispositivi.

 Estensione Disponibilità generale
az iot du device group list

Elencare i gruppi di dispositivi all'interno di un'istanza di .

 Estensione Disponibilità generale
az iot du device group show

Mostra informazioni dettagliate su un gruppo di dispositivi, inclusi i migliori aggiornamenti e la conformità degli aggiornamenti.

 Estensione Disponibilità generale

az iot du device group delete

Eliminare un gruppo di dispositivi.

I gruppi di dispositivi non vengono puliti automaticamente, ma vengono conservati a scopo di cronologia. Questa operazione può essere usata se non è necessario per il gruppo o se è necessario conservarne la cronologia. Se un dispositivo viene connesso di nuovo per un gruppo dopo l'eliminazione del gruppo, verrà ricreato automaticamente senza cronologia.

az iot du device group delete --account
                              --gid
                              --instance
                              [--resource-group]
                              [--yes {false, true}]

Esempio

Eliminare un gruppo di dispositivi.

az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id}

Eliminare un gruppo di dispositivi ignorando la richiesta di conferma.

az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id} -y

Parametri necessari

--account -n

Nome dell'account di Aggiornamento dispositivi. È possibile configurare il nome dell'account predefinito usando az config set defaults.adu_account=<name>.

--gid --group-id

ID gruppo di dispositivi. Questo viene creato dal valore del tag ADUGroup nel dispositivo gemello del modulo o del modulo gemello di hub IoT connesso o $default per i dispositivi senza tag.

--instance -i

Nome dell'istanza di Aggiornamento dispositivi. È possibile configurare il nome predefinito dell'istanza usando az config set defaults.adu_instance=<name>.

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse dell'account di Aggiornamento dispositivi. È possibile configurare il gruppo predefinito con az config set defaults.adu_group=<name>.

--yes -y

Ignorare le richieste dell'utente. Indica l'accettazione dell'azione. Usato principalmente per gli scenari di automazione. Valore predefinito: false.

Valori accettati: false, true
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot du device group list

Elencare i gruppi di dispositivi all'interno di un'istanza di .

az iot du device group list --account
                            --instance
                            [--order-by]
                            [--resource-group]

Esempio

Elencare i gruppi di dispositivi.

az iot du device group list -n {account_name} -i {instance_name}

Elencare i gruppi di dispositivi in un ordine desiderato, in questo caso in base a deviceCount.

az iot du device group list -n {account_name} -i {instance_name} --order-by deviceCount

Parametri necessari

--account -n

Nome dell'account di Aggiornamento dispositivi. È possibile configurare il nome dell'account predefinito usando az config set defaults.adu_account=<name>.

--instance -i

Nome dell'istanza di Aggiornamento dispositivi. È possibile configurare il nome predefinito dell'istanza usando az config set defaults.adu_instance=<name>.

Parametri facoltativi

--order-by

Ordina il set di gruppi restituiti. È possibile ordinare in base a groupId, deviceCount, createdDateTime, subgroupsWithNewUpdatesAvailableCount, subgroupsWithUpdatesInProgressCount o subgroupsWithOnLatestUpdateCount.

--resource-group -g

Nome del gruppo di risorse dell'account di Aggiornamento dispositivi. È possibile configurare il gruppo predefinito con az config set defaults.adu_group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot du device group show

Mostra informazioni dettagliate su un gruppo di dispositivi, inclusi i migliori aggiornamenti e la conformità degli aggiornamenti.

az iot du device group show --account
                            --gid
                            --instance
                            [--best-updates {false, true}]
                            [--resource-group]
                            [--update-compliance {false, true}]

Esempio

Mostra un gruppo di dispositivi.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id}

Mostra gli aggiornamenti migliori disponibili per un gruppo di dispositivi. Questo flag modifica il comando in modo che restituisca un elenco.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --best-updates

Mostra la conformità degli aggiornamenti per un gruppo di dispositivi.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --update-compliance

Parametri necessari

--account -n

Nome dell'account di Aggiornamento dispositivi. È possibile configurare il nome dell'account predefinito usando az config set defaults.adu_account=<name>.

--gid --group-id

ID gruppo di dispositivi. Questo viene creato dal valore del tag ADUGroup nel dispositivo gemello del modulo o del modulo gemello di hub IoT connesso o $default per i dispositivi senza tag.

--instance -i

Nome dell'istanza di Aggiornamento dispositivi. È possibile configurare il nome predefinito dell'istanza usando az config set defaults.adu_instance=<name>.

Parametri facoltativi

--best-updates

Flag che indica che il comando deve recuperare i migliori aggiornamenti disponibili per il gruppo di dispositivi, incluso un conteggio del numero di dispositivi necessari per ogni aggiornamento. Un aggiornamento migliore è l'aggiornamento più recente che soddisfa tutte le specifiche di compatibilità di una classe di dispositivo.

Valori accettati: false, true
--resource-group -g

Nome del gruppo di risorse dell'account di Aggiornamento dispositivi. È possibile configurare il gruppo predefinito con az config set defaults.adu_group=<name>.

--update-compliance

Flag che indica che il comando deve recuperare le informazioni di conformità degli aggiornamenti del gruppo di dispositivi, ad esempio il numero di dispositivi nell'aggiornamento più recente, il numero di nuovi aggiornamenti necessari e il numero di aggiornamenti in corso durante la ricezione di un nuovo aggiornamento.

Valori accettati: false, true
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.