az iot hub

Nota

Questo gruppo di comandi include comandi definiti sia nell'interfaccia della riga di comando di Azure che in almeno un'estensione. Installare ogni estensione per trarre vantaggio dalle funzionalità estese. Altre informazioni sulle estensioni.

Gestire gli hub IoT di Azure.

Comandi

Nome Descrizione Tipo Stato
az iot hub certificate

Gestire i certificati dell'hub IoT.

Core ed estensione Disponibilità generale
az iot hub certificate create

Creare/caricare un certificato hub IoT di Azure.

Memoria centrale Disponibilità generale
az iot hub certificate delete

Elimina un certificato hub IoT di Azure.

Memoria centrale Disponibilità generale
az iot hub certificate generate-verification-code

Genera un codice di verifica per un certificato hub IoT di Azure.

Memoria centrale Disponibilità generale
az iot hub certificate list

Elenca tutti i certificati contenuti in un hub IoT di Azure.

Memoria centrale Disponibilità generale
az iot hub certificate root-authority

Gestire l'autorità radice del certificato per un'istanza di hub IoT.

Estensione Deprecato
az iot hub certificate root-authority set

Impostare l'autorità radice del certificato per un'istanza di hub IoT su una versione specifica.

Estensione Deprecato
az iot hub certificate root-authority show

Visualizzare l'autorità radice del certificato corrente per un'istanza di hub IoT.

Estensione Deprecato
az iot hub certificate show

Visualizza informazioni su un determinato certificato hub IoT di Azure.

Memoria centrale Disponibilità generale
az iot hub certificate update

Aggiornare un certificato hub IoT di Azure.

Memoria centrale Disponibilità generale
az iot hub certificate verify

Verifica un certificato hub IoT di Azure.

Memoria centrale Disponibilità generale
az iot hub configuration

Gestione della configurazione della gestione automatica dei dispositivi IoT su larga scala.

Estensione Disponibilità generale
az iot hub configuration create

Creare una configurazione di gestione automatica dei dispositivi IoT in un hub IoT di destinazione.

Estensione Disponibilità generale
az iot hub configuration delete

Eliminare una configurazione del dispositivo IoT.

Estensione Disponibilità generale
az iot hub configuration list

Elencare le configurazioni di gestione automatica dei dispositivi IoT in un hub IoT.

Estensione Disponibilità generale
az iot hub configuration show

Ottenere i dettagli di una configurazione di gestione automatica dei dispositivi IoT.

Estensione Disponibilità generale
az iot hub configuration show-metric

Valutare un utente o una metrica di sistema di destinazione definita in una configurazione del dispositivo IoT.

Estensione Disponibilità generale
az iot hub configuration update

Aggiornare le proprietà specificate di una configurazione di gestione automatica dei dispositivi IoT.

Estensione Disponibilità generale
az iot hub connection-string

Gestire hub IoT stringa di connessione.

Estensione Disponibilità generale
az iot hub connection-string show

Visualizzare le stringa di connessione per le hub IoT specificate usando il nome e la chiave dei criteri specificati.

Estensione Disponibilità generale
az iot hub consumer-group

Gestire i gruppi di consumer dell'hub eventi di un hub IoT.

Memoria centrale Disponibilità generale
az iot hub consumer-group create

Creare un gruppo di consumer dell'hub eventi.

Memoria centrale Disponibilità generale
az iot hub consumer-group delete

Eliminare un gruppo di consumer dell'hub eventi.

Memoria centrale Disponibilità generale
az iot hub consumer-group list

Elencare i gruppi di consumer dell'hub eventi.

Memoria centrale Disponibilità generale
az iot hub consumer-group show

Ottenere i dettagli per un gruppo di consumer dell'hub eventi.

Memoria centrale Disponibilità generale
az iot hub create

Creare un hub IoT di Azure.

Memoria centrale Disponibilità generale
az iot hub delete

Eliminare un hub IoT.

Memoria centrale Disponibilità generale
az iot hub device-identity

Gestire i dispositivi IoT.

Estensione Disponibilità generale
az iot hub device-identity children

Gestire le relazioni dei dispositivi figlio per i dispositivi perimetrali IoT.

Estensione Disponibilità generale
az iot hub device-identity children add

Aggiungere dispositivi come elementi figlio a un dispositivo perimetrale di destinazione.

Estensione Disponibilità generale
az iot hub device-identity children list

Restituisce la raccolta di dispositivi figlio assegnati.

Estensione Disponibilità generale
az iot hub device-identity children remove

Rimuovere i dispositivi figlio da un dispositivo perimetrale di destinazione.

Estensione Disponibilità generale
az iot hub device-identity connection-string

Gestire le stringa di connessione del dispositivo IoT.

Estensione Disponibilità generale
az iot hub device-identity connection-string show

Mostra un determinato stringa di connessione dispositivo hub IoT.

Estensione Disponibilità generale
az iot hub device-identity create

Creare un dispositivo in un hub IoT.

Estensione Disponibilità generale
az iot hub device-identity delete

Eliminare un dispositivo hub IoT.

Estensione Disponibilità generale
az iot hub device-identity export

Esportare tutte le identità dei dispositivi da un hub IoT a un contenitore BLOB Archiviazione di Azure.

Estensione Disponibilità generale
az iot hub device-identity import

Importare le identità dei dispositivi in un hub IoT da un BLOB del contenitore di archiviazione.

Estensione Disponibilità generale
az iot hub device-identity list

Elencare i dispositivi in un hub IoT.

Estensione Disponibilità generale
az iot hub device-identity parent

Gestire le relazioni tra dispositivi padre per i dispositivi IoT.

Estensione Disponibilità generale
az iot hub device-identity parent set

Impostare il dispositivo padre di un dispositivo di destinazione.

Estensione Disponibilità generale
az iot hub device-identity parent show

Ottenere il dispositivo padre di un dispositivo di destinazione.

Estensione Disponibilità generale
az iot hub device-identity renew-key

Rinnovare le chiavi di destinazione di un dispositivo hub IoT con autenticazione sas.

Estensione Disponibilità generale
az iot hub device-identity show

Ottenere i dettagli di un dispositivo hub IoT.

Estensione Disponibilità generale
az iot hub device-identity update

Aggiornare un dispositivo hub IoT.

Estensione Disponibilità generale
az iot hub device-twin

Gestire la configurazione del dispositivo gemello IoT.

Estensione Disponibilità generale
az iot hub device-twin list

Elencare i dispositivi gemelli in un hub IoT.

Estensione Disponibilità generale
az iot hub device-twin replace

Sostituire la definizione del dispositivo gemello con json di destinazione.

Estensione Disponibilità generale
az iot hub device-twin show

Ottenere una definizione del dispositivo gemello.

Estensione Disponibilità generale
az iot hub device-twin update

Aggiornare le proprietà e i tag desiderati del dispositivo gemello.

Estensione Disponibilità generale
az iot hub devicestream

Gestire i flussi dei dispositivi di un hub IoT.

Memoria centrale Anteprima
az iot hub devicestream show

Ottenere gli endpoint dei flussi dei dispositivi di hub IoT.

Memoria centrale Anteprima
az iot hub digital-twin

Modificare e interagire con il gemello digitale di un dispositivo hub IoT.

Estensione Disponibilità generale
az iot hub digital-twin invoke-command

Richiamare un comando a livello di radice o componente di un dispositivo gemello digitale.

Estensione Disponibilità generale
az iot hub digital-twin show

Mostrare il gemello digitale di un dispositivo hub IoT.

Estensione Disponibilità generale
az iot hub digital-twin update

Aggiornare le proprietà di lettura/scrittura di un dispositivo gemello digitale tramite la specifica della patch JSON.

Estensione Disponibilità generale
az iot hub distributed-tracing

Gestire le impostazioni distribuite per dispositivo.

Estensione Anteprima
az iot hub distributed-tracing show

Ottenere le impostazioni di traccia distribuita per un dispositivo.

Estensione Anteprima
az iot hub distributed-tracing update

Aggiornare le opzioni di traccia distribuita per un dispositivo.

Estensione Anteprima
az iot hub generate-sas-token

Generare un token di firma di accesso condiviso per un hub IoT di destinazione, un dispositivo o un modulo.

Estensione Disponibilità generale
az iot hub identity

Gestire le identità di un hub IoT di Azure.

Memoria centrale Disponibilità generale
az iot hub identity assign

Assegnare identità gestite a un hub IoT.

Memoria centrale Disponibilità generale
az iot hub identity remove

Rimuovere le identità gestite da un hub IoT.

Memoria centrale Disponibilità generale
az iot hub identity show

Visualizzare le proprietà identity di un hub IoT.

Memoria centrale Disponibilità generale
az iot hub invoke-device-method

Richiamare un metodo per il dispositivo.

Estensione Disponibilità generale
az iot hub invoke-module-method

Richiamare un metodo module.

Estensione Disponibilità generale
az iot hub job

Gestire i processi di hub IoT (v2).

Estensione Disponibilità generale
az iot hub job cancel

Annullare un processo di hub IoT.

Estensione Disponibilità generale
az iot hub job create

Creare e pianificare un processo hub IoT per l'esecuzione.

Estensione Disponibilità generale
az iot hub job list

Elencare i processi cronologici di un hub IoT.

Estensione Disponibilità generale
az iot hub job show

Mostra i dettagli di un processo di hub IoT esistente.

Estensione Disponibilità generale
az iot hub list

Elencare gli hub IoT.

Memoria centrale Disponibilità generale
az iot hub list-skus

Elencare i piani tariffari disponibili.

Memoria centrale Disponibilità generale
az iot hub manual-failover

Avviare un failover manuale per l'hub IoT nell'area di ripristino di emergenza associata geograficamente.

Memoria centrale Disponibilità generale
az iot hub message-endpoint

Gestire gli endpoint personalizzati di un hub IoT.

Estensione Anteprima
az iot hub message-endpoint create

Aggiungere un endpoint a un hub IoT.

Estensione Anteprima
az iot hub message-endpoint create cosmosdb-container

Aggiungere un endpoint del contenitore Cosmos DB per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint create eventhub

Aggiungere un endpoint dell'hub eventi per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint create servicebus-queue

Aggiungere un endpoint della coda bus di servizio per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint create servicebus-topic

Aggiungere un endpoint argomento bus di servizio per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint create storage-container

Aggiungere un endpoint contenitore Archiviazione per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint delete

Eliminare tutti o un endpoint specifico per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint list

Ottenere informazioni su tutti gli endpoint per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint show

Ottenere informazioni sull'endpoint indicato per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint update

Aggiornare le proprietà di un endpoint esistente per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint update cosmosdb-container

Aggiornare le proprietà di un endpoint contenitore Cosmos DB esistente per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint update eventhub

Aggiornare le proprietà di un endpoint dell'hub eventi esistente per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint update servicebus-queue

Aggiornare le proprietà di un endpoint bus di servizio Queue esistente per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint update servicebus-topic

Aggiornare le proprietà di un endpoint argomento bus di servizio esistente per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint update storage-container

Aggiornare le proprietà di un endpoint contenitore Archiviazione esistente per un hub IoT.

Estensione Anteprima
az iot hub message-enrichment

Gestire gli arricchimenti dei messaggi per gli endpoint di un hub IoT.

Memoria centrale Disponibilità generale
az iot hub message-enrichment create

Creare un arricchimento dei messaggi per gli endpoint scelti nel hub IoT.

Memoria centrale Disponibilità generale
az iot hub message-enrichment delete

Eliminare un arricchimento dei messaggi nell'hub IoT (per chiave).

Memoria centrale Disponibilità generale
az iot hub message-enrichment list

Ottenere informazioni su tutti gli arricchimenti dei messaggi per il hub IoT.

Memoria centrale Disponibilità generale
az iot hub message-enrichment update

Aggiornare un arricchimento dei messaggi nell'hub IoT (per chiave).

Memoria centrale Disponibilità generale
az iot hub message-route

Gestire le route di un hub IoT.

Estensione Anteprima
az iot hub message-route create

Aggiungere una route per un hub IoT.

Estensione Anteprima
az iot hub message-route delete

Eliminare tutte le route o una route indicata in un hub IoT.

Estensione Anteprima
az iot hub message-route fallback

Gestire la route di fallback di un hub IoT.

Estensione Anteprima
az iot hub message-route fallback set

Abilitare o disabilitare la route di fallback in un hub IoT.

Estensione Anteprima
az iot hub message-route fallback show

Visualizzare la route di fallback di un hub IoT.

Estensione Anteprima
az iot hub message-route list

Ottenere tutte le route in un hub IoT.

Estensione Anteprima
az iot hub message-route show

Ottenere informazioni sulla route in un hub IoT.

Estensione Anteprima
az iot hub message-route test

Testare tutte le route o una route menzionata in un hub IoT.

Estensione Anteprima
az iot hub message-route update

Aggiornare una route per un hub IoT.

Estensione Anteprima
az iot hub module-identity

Gestire i moduli di dispositivo IoT.

Estensione Disponibilità generale
az iot hub module-identity connection-string

Gestire le stringa di connessione del modulo per dispositivi IoT.

Estensione Disponibilità generale
az iot hub module-identity connection-string show

Visualizzare un modulo dispositivo IoT di destinazione stringa di connessione.

Estensione Disponibilità generale
az iot hub module-identity create

Creare un modulo in un dispositivo IoT di destinazione in un hub IoT.

Estensione Disponibilità generale
az iot hub module-identity delete

Eliminare un dispositivo in un hub IoT.

Estensione Disponibilità generale
az iot hub module-identity list

Elencare i moduli che si trovano in un dispositivo IoT in un hub IoT.

Estensione Disponibilità generale
az iot hub module-identity renew-key

Rinnovare le chiavi di destinazione di un modulo del dispositivo hub IoT con l'autenticazione sas.

Estensione Disponibilità generale
az iot hub module-identity show

Ottenere i dettagli di un modulo dispositivo IoT in un hub IoT.

Estensione Disponibilità generale
az iot hub module-identity update

Aggiornare un modulo del dispositivo hub IoT.

Estensione Disponibilità generale
az iot hub module-twin

Gestire la configurazione del modulo gemello IoT.

Estensione Disponibilità generale
az iot hub module-twin replace

Sostituire una definizione del modulo gemello con json di destinazione.

Estensione Disponibilità generale
az iot hub module-twin show

Visualizzare una definizione del modulo gemello.

Estensione Disponibilità generale
az iot hub module-twin update

Aggiornare le proprietà e i tag desiderati del modulo gemello.

Estensione Disponibilità generale
az iot hub monitor-events

Monitorare i dati di telemetria e i messaggi inviati a un hub IoT.

Estensione Disponibilità generale
az iot hub monitor-feedback

Monitorare il feedback inviato dai dispositivi per riconoscere i messaggi da cloud a dispositivo (C2D).

Estensione Disponibilità generale
az iot hub policy

Gestire i criteri di accesso condiviso di un hub IoT.

Memoria centrale Disponibilità generale
az iot hub policy create

Creare un nuovo criterio di accesso condiviso in un hub IoT.

Memoria centrale Disponibilità generale
az iot hub policy delete

Eliminare un criterio di accesso condiviso da un hub IoT.

Memoria centrale Disponibilità generale
az iot hub policy list

Elencare i criteri di accesso condiviso di un hub IoT.

Memoria centrale Disponibilità generale
az iot hub policy renew-key

Rigenerare le chiavi di un criterio di accesso condiviso di un hub IoT.

Memoria centrale Disponibilità generale
az iot hub policy show

Ottenere i dettagli di un criterio di accesso condiviso di un hub IoT.

Memoria centrale Disponibilità generale
az iot hub query

Eseguire una query su un hub IoT usando un linguaggio di tipo SQL potente.

Estensione Disponibilità generale
az iot hub route

Gestire le route di un hub IoT.

Memoria centrale Deprecato
az iot hub route create

Creare una route in hub IoT.

Memoria centrale Deprecato
az iot hub route delete

Eliminare tutte le route o indicate per il hub IoT.

Memoria centrale Deprecato
az iot hub route list

Ottenere tutte le route in hub IoT.

Memoria centrale Deprecato
az iot hub route show

Ottenere informazioni sulla route in hub IoT.

Memoria centrale Deprecato
az iot hub route test

Testare tutte le route o la route menzionata in hub IoT.

Memoria centrale Deprecato
az iot hub route update

Aggiornare una route in hub IoT.

Memoria centrale Deprecato
az iot hub routing-endpoint

Gestire gli endpoint personalizzati di un hub IoT.

Memoria centrale Deprecato
az iot hub routing-endpoint create

Aggiungere un endpoint al hub IoT.

Memoria centrale Deprecato
az iot hub routing-endpoint delete

Eliminare tutti o menzionati endpoint per il hub IoT.

Memoria centrale Deprecato
az iot hub routing-endpoint list

Ottenere informazioni su tutti gli endpoint per il hub IoT.

Memoria centrale Deprecato
az iot hub routing-endpoint show

Ottenere informazioni sull'endpoint indicato per il hub IoT.

Memoria centrale Deprecato
az iot hub show

Ottenere i dettagli di un hub IoT.

Memoria centrale Disponibilità generale
az iot hub show-connection-string

Visualizzare le stringa di connessione per un hub IoT.

Memoria centrale Deprecato
az iot hub show-quota-metrics

Ottenere le metriche delle quote per un hub IoT.

Memoria centrale Disponibilità generale
az iot hub show-stats

Ottenere le statistiche per un hub IoT.

Memoria centrale Disponibilità generale
az iot hub state

Gestire lo stato di un hub IoT.

Estensione Sperimentale
az iot hub state export

Esportare lo stato di un hub IoT in un file.

Estensione Sperimentale
az iot hub state import

Importare uno stato hub da un file in un hub IoT.

Estensione Sperimentale
az iot hub state migrate

Eseguire la migrazione dello stato di un hub a un altro hub senza salvare in un file.

Estensione Sperimentale
az iot hub update

Aggiornare i metadati per un hub IoT.

Memoria centrale Disponibilità generale
az iot hub wait

Attendere il completamento di un'operazione in un'istanza di hub IoT.

Memoria centrale Disponibilità generale

az iot hub create

Creare un hub IoT di Azure.

Per un'introduzione alla hub IoT di Azure, vedere https://docs.microsoft.com/azure/iot-hub/.

az iot hub create --name
                  --resource-group
                  [--c2d-max-delivery-count]
                  [--c2d-ttl]
                  [--dds {false, true}]
                  [--disable-local-auth {false, true}]
                  [--disable-module-sas {false, true}]
                  [--edr {false, true}]
                  [--fc]
                  [--fcs]
                  [--fd]
                  [--feedback-lock-duration]
                  [--feedback-ttl]
                  [--fileupload-notification-lock-duration]
                  [--fileupload-notification-max-delivery-count]
                  [--fileupload-notification-ttl]
                  [--fileupload-notifications {false, true}]
                  [--fileupload-sas-ttl]
                  [--fileupload-storage-auth-type {identityBased, keyBased}]
                  [--fileupload-storage-identity]
                  [--location]
                  [--mi-system-assigned {false, true}]
                  [--mi-user-assigned]
                  [--min-tls-version]
                  [--no-wait]
                  [--partition-count]
                  [--rd]
                  [--role]
                  [--scopes]
                  [--sku {B1, B2, B3, F1, S1, S2, S3}]
                  [--tags]
                  [--unit]

Esempio

Creare un hub IoT con il piano tariffario gratuito F1, nell'area del gruppo di risorse.

az iot hub create --resource-group MyResourceGroup --name MyIotHub --sku F1 --partition-count 2

Creare un hub IoT con il piano tariffario standard S1 e 4 partizioni, nell'area "westus", con tag.

az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --tags a=b c=d

Creare un hub IoT con un'identità gestita assegnata dal sistema e assegnare un ruolo e un ambito a un account di archiviazione per l'identità creata.

az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --mi-system-assigned --role "Storage Blob Data Contributor" --scopes {resourceId}

Creare un hub IoT con autenticazione locale, chiavi di firma di accesso condiviso del dispositivo e chiavi sas del modulo tutte disabilitate

az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --disable-local-auth --disable-device-sas --disable-module-sas

Creare un hub IoT con la residenza dei dati applicata. In questo modo verrà disabilitato il ripristino di emergenza tra aree.

az iot hub create --resource-group MyResourceGroup --name MyIoTHub --edr

Parametri necessari

--name -n

hub IoT nome.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--c2d-max-delivery-count --cdd

Numero di tentativi di recapitare un messaggio da cloud a dispositivo a un dispositivo, compreso tra 1 e 100.

valore predefinito: 10
--c2d-ttl --ct

La quantità di tempo per cui un messaggio è disponibile per l'utilizzo del dispositivo prima che venga scaduto da hub IoT, tra 1 e 48 ore.

valore predefinito: 1
--dds --disable-device-sas

Valore booleano che indica se disabilitare o meno tutti i dispositivi (inclusi i dispositivi Edge ma esclusi i moduli) per l'autenticazione con ambito chiavi di firma di accesso condiviso.

valori accettati: false, true
--disable-local-auth --dla

Valore booleano che indica se disabilitare o meno le chiavi di firma di accesso condiviso con ambito dell'hub IoT per l'autenticazione.

valori accettati: false, true
--disable-module-sas --dms

Valore booleano che indica se disabilitare o meno le chiavi di firma di accesso condiviso con ambito modulo per l'autenticazione.

valori accettati: false, true
--edr --enforce-data-residency

Applicare la residenza dei dati per questo hub IoT disabilitando il ripristino di emergenza tra aree. Questa proprietà non è modificabile una volta impostata sulla risorsa. Disponibile solo nelle aree selezionate. Per ulteriori informazioni, vedi https://aka.ms/iothubdisabledr.

valori accettati: false, true
--fc --fileupload-storage-container-name

Nome del contenitore radice in cui si caricano i file. Il contenitore non deve esistere, ma deve essere creato usando connectionString specificato.

--fcs --fileupload-storage-connectionstring

Il stringa di connessione per l'account Archiviazione di Azure in cui vengono caricati i file.

--fd --feedback-max-delivery-count

Numero di tentativi dell'hub IoT di recapitare un messaggio nella coda di feedback, compreso tra 1 e 100.

valore predefinito: 10
--feedback-lock-duration --fld

Durata del blocco per la coda di feedback, compresa tra 5 e 300 secondi.

valore predefinito: 5
--feedback-ttl --ft

Periodo di tempo per cui l'hub IoT manterrà il feedback per la scadenza o il recapito dei messaggi da cloud a dispositivo, tra 1 e 48 ore.

valore predefinito: 1
--fileupload-notification-lock-duration --fnld

Durata del blocco per la coda di notifiche di caricamento file, compresa tra 5 e 300 secondi.

valore predefinito: 5
--fileupload-notification-max-delivery-count --fnd

Numero di tentativi di recapito dell'hub IoT, compreso tra 1 e 100.

valore predefinito: 10
--fileupload-notification-ttl --fnt

La quantità di tempo in cui una notifica di caricamento di file è disponibile per l'utilizzo del servizio prima che venga scaduta da hub IoT, tra 1 e 48 ore.

valore predefinito: 1
--fileupload-notifications --fn

Valore booleano che indica se registrare le informazioni sui file caricati nei messaggi/servicebound/filenotifications hub IoT endpoint.

valori accettati: false, true
valore predefinito: False
--fileupload-sas-ttl --fst

Il tempo di validità di un URI di firma di accesso condiviso generato da hub IoT prima della scadenza, compreso tra 1 e 24 ore.

valore predefinito: 1
--fileupload-storage-auth-type --fsa

Tipo di autenticazione per l'account Archiviazione di Azure in cui vengono caricati i file.

valori accettati: identityBased, keyBased
--fileupload-storage-identity --fsi

Identità gestita da usare per l'autenticazione di caricamento file. Usare '[system]' per fare riferimento all'identità gestita assegnata dal sistema o a un ID risorsa per fare riferimento a un'identità gestita assegnata dall'utente.

--location -l

Posizione del hub IoT. Il valore predefinito è il percorso del gruppo di risorse di destinazione.

--mi-system-assigned

Abilitare l'identità gestita assegnata dal sistema per questo hub.

valori accettati: false, true
--mi-user-assigned

Abilitare le identità gestite assegnate dall'utente per questo hub. Accettare un elenco separato da spazi di ID risorsa di identità.

--min-tls-version --mintls

Specificare la versione minima di TLS da supportare per questo hub. Può essere impostato su "1.2" per fare in modo che i client che usano una versione TLS precedente alla 1.2 vengano rifiutati.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valore predefinito: False
--partition-count

Numero di partizioni dell'hub eventi di backup per i messaggi da dispositivo a cloud.

valore predefinito: 4
--rd --retention-day

Specifica per quanto tempo l'hub IoT manterrà gli eventi da dispositivo a cloud, tra 1 e 7 giorni.

valore predefinito: 1
--role

Ruolo da assegnare all'identità gestita assegnata dal sistema dell'hub.

--scopes

Elenco di ambiti separati da spazi per assegnare il ruolo (--role) per l'identità gestita assegnata dal sistema.

--sku

Piano tariffario per hub IoT di Azure. Si noti che in ogni sottoscrizione è consentita una sola istanza gratuita dell'hub IoT (F1). Se le istanze gratuite superano una, verrà generata un'eccezione.

valori accettati: B1, B2, B3, F1, S1, S2, S3
valore predefinito: S1
--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--unit

Unità nella hub IoT.

valore predefinito: 1
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 hub delete

Eliminare un hub IoT.

az iot hub delete [--ids]
                  [--name]
                  [--no-wait]
                  [--resource-group]
                  [--subscription]

Esempio

Eliminare un hub IoT. (generato automaticamente)

az iot hub delete --name MyIoTHub --resource-group MyResourceGroup

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

hub IoT nome.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valore predefinito: False
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

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

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 hub generate-sas-token

Generare un token di firma di accesso condiviso per un hub IoT di destinazione, un dispositivo o un modulo.

Per i token di firma di accesso condiviso del dispositivo, il parametro dei criteri viene usato solo per accedere al Registro di sistema del dispositivo. Pertanto, i criteri devono avere accesso in lettura al Registro di sistema. Per hub IoT token, il criterio fa parte della firma di accesso condiviso.

az iot hub generate-sas-token [--auth-type {key, login}]
                              [--connection-string]
                              [--device-id]
                              [--du]
                              [--hub-name]
                              [--key-type {primary, secondary}]
                              [--login]
                              [--module-id]
                              [--pn]
                              [--resource-group]

Esempio

Generare un token di firma di accesso condiviso hub IoT usando i criteri iothubowner e la chiave primaria.

az iot hub generate-sas-token -n {iothub_name}

Generare un token di firma di accesso condiviso hub IoT usando il criterio RegistryRead e la chiave secondaria.

az iot hub generate-sas-token -n {iothub_name} --policy registryRead --key-type secondary

Generare un token di firma di accesso condiviso del dispositivo usando i criteri iothubowner per accedere al registro dei dispositivi {iothub_name}.

az iot hub generate-sas-token -d {device_id} -n {iothub_name}

Generare un token di firma di accesso condiviso del dispositivo usando un hub IoT stringa di connessione (con accesso al Registro di sistema)

az iot hub generate-sas-token -d {device_id} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Generare un token di firma di accesso condiviso dell'hub Iot usando un hub IoT stringa di connessione

az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Generare un token di firma di accesso condiviso del dispositivo usando un stringa di connessione del dispositivo

az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;DeviceId=mydevice;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Generare un token di firma di accesso condiviso del modulo usando un modulo stringa di connessione

az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;DeviceId=mydevice;ModuleId=mymodule;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Parametri facoltativi

--auth-type

Indica se l'operazione deve derivare automaticamente una chiave di criteri o usare la sessione di Azure AD corrente. Se il tipo di autenticazione è login e viene specificato il nome host della risorsa, la ricerca della risorsa verrà ignorata a meno che non sia necessario. È possibile configurare l'impostazione predefinita usando az configure --defaults iothub-data-auth-type=<auth-type-value>.

valori accettati: key, login
valore predefinito: key
--connection-string --cs

Stringa di connessione di destinazione. In questo modo viene ignorato il registro di hub IoT e viene generato il token di firma di accesso condiviso direttamente dalla chiave simmetrica fornita senza ulteriore convalida. Tutti gli altri parametri di comando a parte la durata verranno ignorati. Tipi di stringa di connessione supportati: hub Iot, dispositivo, modulo.

--device-id -d

ID dispositivo di destinazione.

--du --duration

Durata del token valida in secondi.

valore predefinito: 3600
--hub-name -n

hub IoT nome o nome host. Obbligatorio se non viene specificato --login.

--key-type --kt

Tipo di chiave dei criteri di accesso condiviso per l'autenticazione.

valori accettati: primary, secondary
valore predefinito: primary
--login -l

Questo comando supporta un'entità stringa di connessione con diritti per eseguire l'azione. Usare per evitare l'accesso di sessione tramite "az login". Se vengono forniti sia un stringa di connessione di entità che un nome, il stringa di connessione ha priorità. Obbligatorio se --hub-name non è specificato.

--module-id -m

ID modulo di destinazione.

--pn --policy-name

Criteri di accesso condiviso con autorizzazioni operative per l'entità hub IoT di destinazione.

valore predefinito: iothubowner
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults 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 hub invoke-device-method

Richiamare un metodo per il dispositivo.

az iot hub invoke-device-method --device-id
                                --method-name
                                [--auth-type {key, login}]
                                [--hub-name]
                                [--login]
                                [--method-payload]
                                [--resource-group]
                                [--timeout]

Esempio

Richiamare un metodo diretto in un dispositivo.

az iot hub invoke-device-method --hub-name {iothub_name} --device-id {device_id} --method-name Reboot --method-payload '{"version":"1.0"}'

Parametri necessari

--device-id -d

ID dispositivo di destinazione.

--method-name --mn

Metodo di destinazione per la chiamata.

Parametri facoltativi

--auth-type

Indica se l'operazione deve derivare automaticamente una chiave di criteri o usare la sessione di Azure AD corrente. Se il tipo di autenticazione è login e viene specificato il nome host della risorsa, la ricerca della risorsa verrà ignorata a meno che non sia necessario. È possibile configurare l'impostazione predefinita usando az configure --defaults iothub-data-auth-type=<auth-type-value>.

valori accettati: key, login
valore predefinito: key
--hub-name -n

hub IoT nome o nome host. Obbligatorio se non viene specificato --login.

--login -l

Questo comando supporta un'entità stringa di connessione con diritti per eseguire l'azione. Usare per evitare l'accesso di sessione tramite "az login". Se vengono forniti sia un stringa di connessione di entità che un nome, il stringa di connessione ha priorità. Obbligatorio se --hub-name non è specificato.

--method-payload --mp

Payload JSON da passare al metodo. Deve essere il percorso del file o il codice JSON non elaborato.

valore predefinito: {}
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--timeout --to

Numero massimo di secondi di attesa per il risultato del metodo del dispositivo.

valore predefinito: 30
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 hub invoke-module-method

Richiamare un metodo module.

Questo comando supporta moduli di dispositivi perimetrali e non perimetrali.

az iot hub invoke-module-method --device-id
                                --method-name
                                --module-id
                                [--auth-type {key, login}]
                                [--hub-name]
                                [--login]
                                [--method-payload]
                                [--resource-group]
                                [--timeout]

Esempio

Richiamare un metodo diretto in un modulo dispositivo perimetrale.

az iot hub invoke-module-method -n {iothub_name} -d {device_id} -m '$edgeAgent' --method-name 'RestartModule' --method-payload '{"schemaVersion": "1.0"}'

Parametri necessari

--device-id -d

ID dispositivo di destinazione.

--method-name --mn

Metodo di destinazione per la chiamata.

--module-id -m

ID modulo di destinazione.

Parametri facoltativi

--auth-type

Indica se l'operazione deve derivare automaticamente una chiave di criteri o usare la sessione di Azure AD corrente. Se il tipo di autenticazione è login e viene specificato il nome host della risorsa, la ricerca della risorsa verrà ignorata a meno che non sia necessario. È possibile configurare l'impostazione predefinita usando az configure --defaults iothub-data-auth-type=<auth-type-value>.

valori accettati: key, login
valore predefinito: key
--hub-name -n

hub IoT nome o nome host. Obbligatorio se non viene specificato --login.

--login -l

Questo comando supporta un'entità stringa di connessione con diritti per eseguire l'azione. Usare per evitare l'accesso di sessione tramite "az login". Se vengono forniti sia un stringa di connessione di entità che un nome, il stringa di connessione ha priorità. Obbligatorio se --hub-name non è specificato.

--method-payload --mp

Payload JSON da passare al metodo. Deve essere il percorso del file o il codice JSON non elaborato.

valore predefinito: {}
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--timeout --to

Numero massimo di secondi di attesa per il risultato del metodo del modulo.

valore predefinito: 30
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 hub list

Elencare gli hub IoT.

az iot hub list [--resource-group]

Esempio

Elencare tutti gli hub IoT in una sottoscrizione.

az iot hub list

Elencare tutti gli hub IoT nel gruppo di risorse "MyGroup"

az iot hub list --resource-group MyGroup

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults 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 hub list-skus

Elencare i piani tariffari disponibili.

az iot hub list-skus [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

Esempio

Elencare i piani tariffari disponibili. (generato automaticamente)

az iot hub list-skus --name MyIoTHub

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

hub IoT nome.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

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

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 hub manual-failover

Avviare un failover manuale per l'hub IoT nell'area di ripristino di emergenza associata geograficamente.

az iot hub manual-failover [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--subscription]

Esempio

Avviare il failover "myhub" dall'area primaria a quella secondaria.

az iot hub manual-failover -n myhub

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

hub IoT nome.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valore predefinito: False
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

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

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 hub monitor-events

Monitorare i dati di telemetria e i messaggi inviati a un hub IoT.

Questo comando si basa su e può installare il pacchetto Cython dipendente (uamqp) al primo esecuzione. https://github.com/Azure/azure-uamqp-python

Nota: l'evento verrà visualizzato anche se il corpo del messaggio non è decodificabile unicode, in questo caso la parte payload dell'evento verrà visualizzata come {{payload non decodificabile}} con le altre proprietà dell'evento disponibili.

az iot hub monitor-events [--cg]
                          [--content-type]
                          [--device-id]
                          [--device-query]
                          [--enqueued-time]
                          [--hub-name]
                          [--interface]
                          [--login]
                          [--mc]
                          [--module-id]
                          [--properties {all, anno, app, sys}]
                          [--repair {false, true}]
                          [--resource-group]
                          [--timeout]
                          [--yes {false, true}]

Esempio

Utilizzo di base

az iot hub monitor-events -n {iothub_name}

Utilizzo di base con un hub IoT stringa di connessione

az iot hub monitor-events -n {iothub_name} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Utilizzo di base durante il filtro sul dispositivo di destinazione

az iot hub monitor-events -n {iothub_name} -d {device_id}

Utilizzo di base quando si filtrano i dispositivi di destinazione con un carattere jolly nell'ID

az iot hub monitor-events -n {iothub_name} -d Device*

Filtrare i dispositivi usando hub IoT linguaggio di query

az iot hub monitor-events -n {iothub_name} -q "select * from devices where tags.location.region = 'US'"

Filtrare il dispositivo e specificare un gruppo di consumer dell'hub eventi a cui eseguire l'associazione.

az iot hub monitor-events -n {iothub_name} -d {device_id} --cg {consumer_group_name}

Ricevere annotazioni di messaggio (intestazioni di messaggio)

az iot hub monitor-events -n {iothub_name} -d {device_id} --properties anno

Ricevere annotazioni di messaggio e proprietà di sistema. Mai timeout.

az iot hub monitor-events -n {iothub_name} -d {device_id} --properties anno sys --timeout 0

Ricevere tutti gli attributi dei messaggi da tutti i messaggi del dispositivo

az iot hub monitor-events -n {iothub_name} --props all

Ricevere tutti i messaggi e analizzare il payload del messaggio come JSON

az iot hub monitor-events -n {iothub_name} --content-type application/json

Ricevere il numero specificato di messaggi dall'hub e quindi arrestarsi.

az iot hub monitor-events -n {iothub_name} --message-count {message_count}

Parametri facoltativi

--cg --consumer-group -c

Specificare il gruppo di consumer da usare per la connessione all'endpoint dell'hub eventi.

valore predefinito: $Default
--content-type --ct

Specificare il tipo di contenuto del payload del messaggio per formattare automaticamente l'output in tale tipo.

--device-id -d

ID dispositivo di destinazione.

--device-query -q

Specificare una query personalizzata per filtrare i dispositivi.

--enqueued-time --et -e

Indica l'ora che deve essere utilizzata come punto di partenza per leggere i messaggi dalle partizioni. Le unità sono millisecondi dall'epoca unix. Se non viene indicato "ora" viene usato .

--hub-name -n

hub IoT nome o nome host. Obbligatorio se non viene specificato --login.

--interface -i

Identificatore dell'interfaccia di destinazione su cui filtrare. Ad esempio: dtmi:com:example:TemperatureController;1.

--login -l

Questo comando supporta un'entità stringa di connessione con diritti per eseguire l'azione. Usare per evitare l'accesso di sessione tramite "az login". Se vengono forniti sia un stringa di connessione di entità che un nome, il stringa di connessione ha priorità. Obbligatorio se --hub-name non è specificato.

--mc --message-count

Numero di messaggi di telemetria da acquisire prima che il monitoraggio venga terminato. Se non specificato, il monitoraggio continua l'esecuzione fino a quando non soddisfa la soglia di timeout di non ricevere messaggi dall'hub.

--module-id -m

ID modulo di destinazione.

--properties --props -p

Indicare le proprietà del messaggio chiave per l'output. sys = proprietà di sistema, app = proprietà dell'applicazione, anno = annotazioni.

valori accettati: all, anno, app, sys
--repair -r

Reinstallare la dipendenza uamqp compatibile con la versione dell'estensione. Valore predefinito: false.

valori accettati: false, true
valore predefinito: False
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--timeout --to -t

Numero massimo di secondi per mantenere la connessione senza ricevere messaggi. Usare 0 per infinito.

valore predefinito: 300
--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
valore predefinito: False
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 hub monitor-feedback

Monitorare il feedback inviato dai dispositivi per riconoscere i messaggi da cloud a dispositivo (C2D).

Questo comando si basa su e può installare il pacchetto Cython dipendente (uamqp) al primo esecuzione. https://github.com/Azure/azure-uamqp-python.

az iot hub monitor-feedback [--auth-type {key, login}]
                            [--device-id]
                            [--hub-name]
                            [--login]
                            [--repair {false, true}]
                            [--resource-group]
                            [--wait-on-msg]
                            [--yes {false, true}]

Esempio

Utilizzo di base

az iot hub monitor-feedback -n {iothub_name}

Utilizzo di base con un hub IoT stringa di connessione

az iot hub monitor-feedback -n {iothub_name} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Utilizzo di base durante il filtro sul dispositivo di destinazione

az iot hub monitor-feedback -n {iothub_name} -d {device_id}

Exit feedback monitor on receiving a message with specific id (uuid) (Exit feedback monitor on receiving a message with specific id (uuid)

az iot hub monitor-feedback -n {iothub_name} -d {device_id} -w {message_id}

Parametri facoltativi

--auth-type

Indica se l'operazione deve derivare automaticamente una chiave di criteri o usare la sessione di Azure AD corrente. Se il tipo di autenticazione è login e viene specificato il nome host della risorsa, la ricerca della risorsa verrà ignorata a meno che non sia necessario. È possibile configurare l'impostazione predefinita usando az configure --defaults iothub-data-auth-type=<auth-type-value>.

valori accettati: key, login
valore predefinito: key
--device-id -d

ID dispositivo di destinazione.

--hub-name -n

hub IoT nome o nome host. Obbligatorio se non viene specificato --login.

--login -l

Questo comando supporta un'entità stringa di connessione con diritti per eseguire l'azione. Usare per evitare l'accesso di sessione tramite "az login". Se vengono forniti sia un stringa di connessione di entità che un nome, il stringa di connessione ha priorità. Obbligatorio se --hub-name non è specificato.

--repair -r

Reinstallare la dipendenza uamqp compatibile con la versione dell'estensione. Valore predefinito: false.

valori accettati: false, true
valore predefinito: False
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--wait-on-msg -w

Monitoraggio commenti e suggerimenti verrà bloccato fino a quando non viene ricevuto un messaggio con ID specifico (uuid).

--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
valore predefinito: False
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 hub query

Eseguire una query su un hub IoT usando un linguaggio di tipo SQL potente.

Recuperare informazioni relative a dispositivi e moduli gemelli, processi e routing dei messaggi. Per altre informazioni, vedere https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language.

az iot hub query --query-command
                 [--auth-type {key, login}]
                 [--hub-name]
                 [--login]
                 [--resource-group]
                 [--top]

Esempio

Eseguire query su tutti i dati del dispositivo gemello in un hub IoT di Azure.

az iot hub query -n {iothub_name} -q "select * from devices"

Eseguire query su tutti i dati del modulo gemello nel dispositivo di destinazione.

az iot hub query -n {iothub_name} -q "select * from devices.modules where devices.deviceId = '{device_id}'"

Parametri necessari

--query-command -q

Query utente da eseguire.

Parametri facoltativi

--auth-type

Indica se l'operazione deve derivare automaticamente una chiave di criteri o usare la sessione di Azure AD corrente. Se il tipo di autenticazione è login e viene specificato il nome host della risorsa, la ricerca della risorsa verrà ignorata a meno che non sia necessario. È possibile configurare l'impostazione predefinita usando az configure --defaults iothub-data-auth-type=<auth-type-value>.

valori accettati: key, login
valore predefinito: key
--hub-name -n

hub IoT nome o nome host. Obbligatorio se non viene specificato --login.

--login -l

Questo comando supporta un'entità stringa di connessione con diritti per eseguire l'azione. Usare per evitare l'accesso di sessione tramite "az login". Se vengono forniti sia un stringa di connessione di entità che un nome, il stringa di connessione ha priorità. Obbligatorio se --hub-name non è specificato.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--top

Numero massimo di elementi da restituire. Per impostazione predefinita, la query non ha limiti.

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 hub show

Ottenere i dettagli di un hub IoT.

az iot hub show [--ids]
                [--name]
                [--resource-group]
                [--subscription]

Esempio

Ottenere i dettagli di un hub IoT. (generato automaticamente)

az iot hub show --name MyIoTHub

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

hub IoT nome.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

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

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 hub show-connection-string

Deprecato

Questo comando è stato deprecato e verrà rimosso in una versione futura. Usare invece il comando 'IoT Extension (azure-iot) connection-string (az iot hub connection-string show)'.

Visualizzare le stringa di connessione per un hub IoT.

az iot hub show-connection-string [--all]
                                  [--hub-name]
                                  [--ids]
                                  [--key {primary, secondary}]
                                  [--policy-name]
                                  [--resource-group]
                                  [--subscription]

Esempio

Visualizzare la stringa di connessione di un hub IoT usando i criteri predefiniti e la chiave primaria.

az iot hub show-connection-string --name MyIotHub

Visualizzare il stringa di connessione di un hub IoT usando i criteri 'servizio' e la chiave secondaria.

az iot hub show-connection-string --name MyIotHub --policy-name service --key secondary

Visualizzare i stringa di connessione per tutti gli hub IoT in un gruppo di risorse.

az iot hub show-connection-string --resource-group MyResourceGroup

Visualizzare le stringa di connessione per tutti gli hub IoT in una sottoscrizione.

az iot hub show-connection-string

Visualizzare le stringa di connessione per un hub IoT. (generato automaticamente)

az iot hub show-connection-string --key primary --policy-name MyPolicy

Parametri facoltativi

--all

Consenti di visualizzare tutti i criteri di accesso condiviso.

valore predefinito: False
--hub-name --name -n

hub IoT nome.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--key

Chiave da usare.

valori accettati: primary, secondary
valore predefinito: primary
--policy-name

Criteri di accesso condiviso da usare.

valore predefinito: iothubowner
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

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

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 hub show-quota-metrics

Ottenere le metriche delle quote per un hub IoT.

az iot hub show-quota-metrics [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]

Esempio

Ottenere le metriche delle quote per un hub IoT. (generato automaticamente)

az iot hub show-quota-metrics --ids {ids}

Ottenere le metriche delle quote per un hub IoT. (generato automaticamente)

az iot hub show-quota-metrics --name MyIoTHub

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

hub IoT nome.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

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

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 hub show-stats

Ottenere le statistiche per un hub IoT.

az iot hub show-stats [--ids]
                      [--name]
                      [--resource-group]
                      [--subscription]

Esempio

Ottenere le statistiche per un hub IoT. (generato automaticamente)

az iot hub show-stats --name MyIoTHub

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

hub IoT nome.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

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

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 hub update

Aggiornare i metadati per un hub IoT.

az iot hub update [--add]
                  [--c2d-max-delivery-count]
                  [--c2d-ttl]
                  [--dds {false, true}]
                  [--disable-local-auth {false, true}]
                  [--disable-module-sas {false, true}]
                  [--fc]
                  [--fcs]
                  [--fd]
                  [--feedback-lock-duration]
                  [--feedback-ttl]
                  [--fileupload-notification-lock-duration]
                  [--fileupload-notification-max-delivery-count]
                  [--fileupload-notification-ttl]
                  [--fileupload-notifications {false, true}]
                  [--fileupload-sas-ttl]
                  [--fileupload-storage-auth-type {identityBased, keyBased}]
                  [--fileupload-storage-identity]
                  [--force-string]
                  [--ids]
                  [--name]
                  [--rd]
                  [--remove]
                  [--resource-group]
                  [--set]
                  [--sku {B1, B2, B3, F1, S1, S2, S3}]
                  [--subscription]
                  [--tags]
                  [--unit]

Esempio

Aggiungere le impostazioni del contenitore di archiviazione al caricamento di file

az iot hub update --name MyIotHub --fileupload-storage-connectionstring "connection-string" \ --fileupload-storage-container-name "container_name"

Aggiungere una regola di filtro del firewall per accettare il traffico dalla maschera IP 127.0.0.0/31.

az iot hub update --name MyIotHub --add properties.ipFilterRules filter_name=test-rule action=Accept ip_mask=127.0.0.0/31

Aggiornare i metadati per un hub IoT. (generato automaticamente)

az iot hub update --name MyIotHub --set properties.allocationPolicy="GeoLatency"

Aggiornare le unità di un hub IoT a 2 e aggiungere tag

az iot hub update -n MyIotHub --unit 2 --tags a=b c=d

Aggiornare il piano tariffario per un hub IoT come S2

az iot hub update -n MyIotHub --sku S2

Aggiornare i giorni di conservazione dei hub IoT eventi da dispositivo a cloud come 3 giorni

az iot hub update -n MyIotHub --retention-day 3

Aggiornare le impostazioni di messaggistica da cloud a dispositivo hub IoT

az iot hub update --name MyIotHub --c2d-max-delivery-count 30 --c2d-ttl 5

Aggiornare le impostazioni della coda di commenti e suggerimenti hub IoT

az iot hub update --name MyIoTHub --feedback-max-delivery-count 20 --feedback-lock-duration 100 --feedback-ttl 4

Aggiornare le impostazioni di caricamento dei file hub IoT e assegnare un'identità gestita all'utente per il caricamento di file

az iot hub update -n MyIoTHub --fileupload-sas-ttl 5 --fileupload-storage-auth-type identityBased --fileupload-storage-identity [system]

Aggiornare le impostazioni di notifica di caricamento dei file hub IoT e la durata del blocco della coda

az iot hub update -n MyIoTHub --fileupload-notification-max-delivery-count 50 --fileupload-notification-ttl 48 --fileupload-notifications --fileupload-notification-lock-duration 10

Aggiornare le impostazioni di autenticazione locale hub IoT, firma di accesso condiviso del dispositivo e firma di accesso condiviso del modulo

az iot hub update -n MyIoTHub --disable-local-auth --disable-device-sas false --disable-module-sas true

Parametri facoltativi

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

valore predefinito: []
--c2d-max-delivery-count --cdd

Numero di tentativi di recapitare un messaggio da cloud a dispositivo a un dispositivo, compreso tra 1 e 100.

--c2d-ttl --ct

La quantità di tempo per cui un messaggio è disponibile per l'utilizzo del dispositivo prima che venga scaduto da hub IoT, tra 1 e 48 ore.

--dds --disable-device-sas

Valore booleano che indica se disabilitare o meno tutti i dispositivi (inclusi i dispositivi Edge ma esclusi i moduli) per l'autenticazione con ambito chiavi di firma di accesso condiviso.

valori accettati: false, true
--disable-local-auth --dla

Valore booleano che indica se disabilitare o meno le chiavi di firma di accesso condiviso con ambito dell'hub IoT per l'autenticazione.

valori accettati: false, true
--disable-module-sas --dms

Valore booleano che indica se disabilitare o meno le chiavi di firma di accesso condiviso con ambito modulo per l'autenticazione.

valori accettati: false, true
--fc --fileupload-storage-container-name

Nome del contenitore radice in cui si caricano i file. Il contenitore non deve esistere, ma deve essere creato usando connectionString specificato.

--fcs --fileupload-storage-connectionstring

Il stringa di connessione per l'account Archiviazione di Azure in cui vengono caricati i file.

--fd --feedback-max-delivery-count

Numero di tentativi dell'hub IoT di recapitare un messaggio nella coda di feedback, compreso tra 1 e 100.

--feedback-lock-duration --fld

Durata del blocco per la coda di feedback, compresa tra 5 e 300 secondi.

--feedback-ttl --ft

Periodo di tempo per cui l'hub IoT manterrà il feedback per la scadenza o il recapito dei messaggi da cloud a dispositivo, tra 1 e 48 ore.

--fileupload-notification-lock-duration --fnld

Durata del blocco per la coda di notifiche di caricamento file, compresa tra 5 e 300 secondi.

--fileupload-notification-max-delivery-count --fnd

Numero di tentativi di recapito dell'hub IoT, compreso tra 1 e 100.

--fileupload-notification-ttl --fnt

La quantità di tempo in cui una notifica di caricamento di file è disponibile per l'utilizzo del servizio prima che venga scaduta da hub IoT, tra 1 e 48 ore.

--fileupload-notifications --fn

Valore booleano che indica se registrare le informazioni sui file caricati nei messaggi/servicebound/filenotifications hub IoT endpoint.

valori accettati: false, true
--fileupload-sas-ttl --fst

Il tempo di validità di un URI di firma di accesso condiviso generato da hub IoT prima della scadenza, compreso tra 1 e 24 ore.

--fileupload-storage-auth-type --fsa

Tipo di autenticazione per l'account Archiviazione di Azure in cui vengono caricati i file.

valori accettati: identityBased, keyBased
--fileupload-storage-identity --fsi

Identità gestita da usare per l'autenticazione di caricamento file. Usare '[system]' per fare riferimento all'identità gestita assegnata dal sistema o a un ID risorsa per fare riferimento a un'identità gestita assegnata dall'utente.

--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

valore predefinito: False
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

hub IoT nome.

--rd --retention-day

Specifica per quanto tempo l'hub IoT manterrà gli eventi da dispositivo a cloud, tra 1 e 7 giorni.

--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

valore predefinito: []
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

valore predefinito: []
--sku

Piano tariffario per hub IoT di Azure. Si noti che in ogni sottoscrizione è consentita una sola istanza gratuita dell'hub IoT (F1). Se le istanze gratuite superano una, verrà generata un'eccezione.

valori accettati: B1, B2, B3, F1, S1, S2, S3
--subscription

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

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--unit

Unità nella hub IoT.

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 hub wait

Attendere il completamento di un'operazione in un'istanza di hub IoT.

az iot hub wait [--created]
                [--custom]
                [--deleted]
                [--exists]
                [--ids]
                [--interval]
                [--name]
                [--resource-group]
                [--subscription]
                [--timeout]
                [--updated]

Esempio

Attendere che venga creata un'istanza di hub IoT esistente

az iot hub wait -n MyIoTHub --created

Attendere l'eliminazione di un'istanza di hub IoT

az iot hub wait -n MyIoTHub --deleted

Attendere che un'istanza di hub IoT esistente abbia uno stato Attivo

az iot hub wait -n MyIoTHub --custom "properties.state=='Active'"

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

valore predefinito: False
--exists

Attendere che la risorsa esista.

valore predefinito: False
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--interval

Intervallo di polling in secondi.

valore predefinito: 30
--name -n

hub IoT nome.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

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

--timeout

Attesa massima in secondi.

valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

valore predefinito: False
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.