az iot central device-group
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 central device-group . Altre informazioni sulle estensioni.
Gestire e configurare i gruppi di dispositivi IoT Central.
Comandi
| Nome | Descrizione | Tipo | Status |
|---|---|---|---|
| az iot central device-group create |
Creare un gruppo di dispositivi. |
Estensione | Disponibilità generale |
| az iot central device-group delete |
Eliminare un gruppo di dispositivi. |
Estensione | Disponibilità generale |
| az iot central device-group list |
Ottenere l'elenco dei gruppi di dispositivi per un'applicazione IoT Central. |
Estensione | Disponibilità generale |
| az iot central device-group show |
Ottenere il gruppo di dispositivi in base all'ID. |
Estensione | Disponibilità generale |
| az iot central device-group update |
Aggiornare un gruppo di dispositivi esistente. |
Estensione | Disponibilità generale |
az iot central device-group create
Creare un gruppo di dispositivi.
Nota: attualmente è supportata solo un'organizzazione, più organizzazioni saranno supportate a breve.
az iot central device-group create --app-id
--device-group-id
--display-name
--filter
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--description]
[--organizations]
[--token]Esempio
Creare un gruppo di dispositivi.
az iot central device-group create --app-id {appid} --device-group-id {devicegroupid} --display-name "DeviceGroup1" --filter "SELECT * FROM devices WHERE $provisioned = true" --description "This is a default device group." --organizations {organization}Parametri necessari
ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.
ID univoco del gruppo di dispositivi.
Nome visualizzato del gruppo di dispositivi.
Query che definisce quali dispositivi devono trovarsi in questo gruppo. [Esempio di filtro query: SELECT * FROM devices WHERE $template = "dtmi:modelDefinition:dtdlv2"].
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.
Suffisso DNS di IoT Central associato all'applicazione.
Breve riepilogo del gruppo di dispositivi.
Elenco degli ID organizzazione del gruppo di dispositivi.
Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot central device-group delete
Eliminare un gruppo di dispositivi.
az iot central device-group delete --app-id
--device-group-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--token]Esempio
Eliminare un gruppo di dispositivi
az iot central device-group delete --app-id {appid} --device-group-id {devicegroupid}Parametri necessari
ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.
ID univoco del gruppo di dispositivi.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.
Suffisso DNS di IoT Central associato all'applicazione.
Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot central device-group list
Ottenere l'elenco dei gruppi di dispositivi per un'applicazione IoT Central.
az iot central device-group list --app-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--token]Esempio
Elencare i gruppi di dispositivi in un'applicazione
az iot central device-group list --app-id {appid}Parametri necessari
ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.
Suffisso DNS di IoT Central associato all'applicazione.
Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot central device-group show
Ottenere il gruppo di dispositivi in base all'ID.
az iot central device-group show --app-id
--device-group-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--token]Esempio
Ottenere il gruppo di dispositivi in base all'ID.
az iot central device-group show --app-id {appid} --device-group-id {devicegroupid}Parametri necessari
ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.
ID univoco del gruppo di dispositivi.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.
Suffisso DNS di IoT Central associato all'applicazione.
Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot central device-group update
Aggiornare un gruppo di dispositivi esistente.
Nota: attualmente è supportata solo un'organizzazione, più organizzazioni saranno supportate a breve.
az iot central device-group update --app-id
--device-group-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--description]
[--display-name]
[--filter]
[--organizations]
[--token]Esempio
Aggiornare un gruppo di dispositivi tramite patch
az iot central device-group update --app-id {appid} --device-group-id {devicegroupid} --display-name {displayname} --filter {filter} --description {description} --organizations {organization}Parametri necessari
ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.
ID univoco del gruppo di dispositivi.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.
Suffisso DNS di IoT Central associato all'applicazione.
Breve riepilogo del gruppo di dispositivi.
Nome visualizzato del gruppo di dispositivi.
Query che definisce quali dispositivi devono trovarsi in questo gruppo. [Esempio di filtro query: SELECT * FROM devices WHERE $template = "dtmi:modelDefinition:dtdlv2"].
Elenco degli ID organizzazione del gruppo di dispositivi.
Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
