az iot hub

Riferimento

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	Status
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

Modifica

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

Modifica

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

Valori accettati: key, login

Valore predefinito: key

--hub-name -n

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

--login -l

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

Valori accettati: key, login

Valore predefinito: key

--hub-name -n

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

--login -l

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

Modifica

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

Modifica

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

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

Modifica

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

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

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

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

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

Valori accettati: key, login

Valore predefinito: key

--hub-name -n

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

--login -l

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

Modifica

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

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

Modifica

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

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

Modifica

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

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

Modifica

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

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

Modifica

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

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

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

Modifica

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

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

Condividi tramite

az iot hub

Comandi

az iot hub create

Esempio

Parametri necessari

Parametri facoltativi

az iot hub delete

Esempio

Parametri facoltativi

az iot hub generate-sas-token

Esempio

Parametri facoltativi

az iot hub invoke-device-method

Esempio

Parametri necessari

Parametri facoltativi

az iot hub invoke-module-method

Esempio

Parametri necessari

Parametri facoltativi

az iot hub list

Esempio

Parametri facoltativi

az iot hub list-skus

Esempio

Parametri facoltativi

az iot hub manual-failover

Esempio

Parametri facoltativi

az iot hub monitor-events

Esempio

Parametri facoltativi

az iot hub monitor-feedback

Esempio

Parametri facoltativi

az iot hub query

Esempio

Parametri necessari

Parametri facoltativi

az iot hub show

Esempio

Parametri facoltativi

az iot hub show-connection-string

Esempio

Parametri facoltativi

az iot hub show-quota-metrics

Esempio

Parametri facoltativi

az iot hub show-stats

Esempio

Parametri facoltativi

az iot hub update

Esempio

Parametri facoltativi

az iot hub wait

Esempio

Parametri facoltativi

Risorse aggiuntive