az iot hub device-identity
Nota
Questo riferimento fa parte dell'estensione azure-iot per l'interfaccia della riga di comando di Azure (versione 2.46.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot hub device-identity . Altre informazioni sulle estensioni.
Gestire i dispositivi IoT.
Comandi
Nome | Descrizione | Tipo | Stato |
---|---|---|---|
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-identity create
Creare un dispositivo in un hub IoT.
Quando si usa il metodo di autenticazione di shared_private_key (noto anche come chiavi simmetriche), se non vengono fornite chiavi personalizzate, il servizio li genererà per il dispositivo.
Se viene fornito un ambito di dispositivo per un dispositivo perimetrale, il valore verrà convertito automaticamente in un ambito padre.
az iot hub device-identity create --device-id
[--am {shared_private_key, x509_ca, x509_thumbprint}]
[--auth-type {key, login}]
[--device-scope]
[--edge-enabled {false, true}]
[--hub-name]
[--login]
[--od]
[--pk]
[--primary-thumbprint]
[--resource-group]
[--secondary-key]
[--secondary-thumbprint]
[--sta {disabled, enabled}]
[--star]
[--valid-days]
Esempio
Creare un dispositivo IoT abilitato per Edge con autorizzazione predefinita (chiave privata condivisa).
az iot hub device-identity create -n {iothub_name} -d {device_id} --ee
Creare un dispositivo IoT con autorizzazione del certificato autofirmato, generare un certificato valido per 10 giorni e quindi usarne l'identificazione personale.
az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --valid-days 10
Creare un dispositivo IoT con autorizzazione del certificato autofirmato, generare un certificato di scadenza predefinito (365 giorni) e l'output nella directory di destinazione.
az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --output-dir /path/to/output
Creare un dispositivo IoT con autorizzazione del certificato autofirmato e fornire in modo esplicito identificazioni personali primarie e secondarie.
az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --ptp {thumbprint_1} --stp {thumbprint_2}
Creare un dispositivo IoT con autorizzazione CA radice con stato disabilitato e motivo.
az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_ca --status disabled --status-reason 'for reasons'
Creare un dispositivo IoT con un ambito di dispositivo.
az iot hub device-identity create -n {iothub_name} -d {device_id} --device-scope 'ms-azure-iot-edge://edge0-123456789123456789'
Parametri necessari
ID dispositivo di destinazione.
Parametri facoltativi
Il metodo di autorizzazione con cui creare un'entità.
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>
.
Ambito del dispositivo. Per i dispositivi perimetrali, questo è generato automaticamente e non modificabile. Per i dispositivi foglia, impostare questa opzione per creare una relazione figlio/padre.
Flag che indica l'abilitazione dei bordi.
hub IoT nome o nome host. Obbligatorio se non viene specificato --login.
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.
Generare un certificato autofirmato e usarne l'identificazione personale. Output nella directory di destinazione specificata.
Chiave di accesso condiviso simmetrica primaria archiviata in formato Base64.
Identificazione personale del certificato autofirmato da usare per l'identificazione personale primaria.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Chiave di accesso condiviso simmetrica secondaria archiviata in formato Base64.
Identificazione personale del certificato autofirmato da usare per l'identificazione personale secondaria.
Impostare lo stato del dispositivo al momento della creazione.
Descrizione per lo stato del dispositivo.
Generare un certificato autofirmato e usarne l'identificazione personale. Valido per il numero specificato di giorni. Impostazione predefinita: 365.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot hub device-identity delete
Eliminare un dispositivo hub IoT.
az iot hub device-identity delete --device-id
[--auth-type {key, login}]
[--etag]
[--hub-name]
[--login]
[--resource-group]
Parametri necessari
ID dispositivo di destinazione.
Parametri facoltativi
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>
.
Tag Etag o tag di entità corrispondente all'ultimo stato della risorsa. Se non viene specificato alcun etag, viene usato il valore '*'.
hub IoT nome o nome host. Obbligatorio se non viene specificato --login.
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.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot hub device-identity export
Esportare tutte le identità dei dispositivi da un hub IoT a un contenitore BLOB Archiviazione di Azure.
Il BLOB di output contenente le identità dei dispositivi è un file di testo denominato "devices.txt".
Autorizzazioni necessarie: hub IoT criteri di accesso condiviso che supportano "Lettura registro e scrittura registro" oppure un'entità con ruolo "collaboratore dati hub IoT" nel hub IoT.
I parametri del nome dell'account di archiviazione e del nome del contenitore BLOB possono essere usati solo quando l'account di archiviazione si trova nella stessa sottoscrizione del hub IoT di input. Per l'input dell'URI di firma di accesso condiviso del contenitore BLOB inline, vedere le regole di input dell'ambiente.
Per ulteriori informazioni, vedere https://aka.ms/iothub-device-exportimport.
az iot hub device-identity export [--auth-type {key, login}]
[--bc]
[--bcu]
[--hub-name]
[--identity]
[--ik {false, true}]
[--login]
[--resource-group]
[--sa]
Esempio
Esportare tutte le identità del dispositivo in un contenitore BLOB configurato e includere le chiavi del dispositivo. Il nome del contenitore BLOB e il nome dell'account di archiviazione vengono forniti come parametri al comando.
az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name}
Esportare tutte le identità del dispositivo in un contenitore BLOB configurato e includere le chiavi del dispositivo. Usa un esempio di URI di firma di accesso condiviso inline.
az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices?sv=2019-02-02&st=2020-08-23T22%3A35%3A00Z&se=2020-08-24T22%3A35%3A00Z&sr=c&sp=rwd&sig=VrmJ5sQtW3kLzYg10VqmALGCp4vtYKSLNjZDDJBSh9s%3D'
Esportare tutte le identità del dispositivo in un contenitore BLOB configurato usando un percorso di file che contiene l'URI di firma di accesso condiviso.
az iot hub device-identity export -n {iothub_name} --bcu {sas_uri_filepath}
Esportare tutte le identità del dispositivo in un contenitore BLOB configurato e includere le chiavi del dispositivo. Usa l'identità assegnata dal sistema con ruoli collaboratore ai dati dei BLOB di archiviazione per l'account di archiviazione. Il nome del contenitore BLOB e il nome dell'account di archiviazione vengono forniti come parametri al comando.
az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity [system]
Esportare tutte le identità del dispositivo in un contenitore BLOB configurato e includere le chiavi del dispositivo. Usa l'identità assegnata dal sistema con ruoli collaboratore ai dati dei BLOB di archiviazione per l'account di archiviazione. L'URI del contenitore BLOB non richiede il token di firma di accesso condiviso DEL BLOB.
az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --identity [system]
Esportare tutte le identità del dispositivo in un contenitore BLOB configurato e includere le chiavi del dispositivo. Usa l'identità gestita assegnata dall'utente con ruolo Collaboratore dati BLOB di archiviazione per l'account di archiviazione. Il nome del contenitore BLOB e il nome dell'account di archiviazione vengono forniti come parametri al comando.
az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity {managed_identity_resource_id}
Esportare tutte le identità del dispositivo in un contenitore BLOB configurato e includere le chiavi del dispositivo. Usa l'identità gestita assegnata dall'utente con ruolo Collaboratore dati BLOB di archiviazione per l'account di archiviazione. L'URI del contenitore BLOB non richiede il token di firma di accesso condiviso DEL BLOB.
az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --identity {managed_identity_resource_id}
Parametri facoltativi
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>
.
Questo contenitore BLOB viene usato per restituire lo stato del processo di importazione dell'identità del dispositivo e dei risultati. Il parametro viene ignorato quando viene fornito blob_container_uri. L'accesso in scrittura, lettura ed eliminazione è necessario per questo contenitore BLOB.
URI della firma di accesso condiviso BLOB con accesso in scrittura, lettura ed eliminazione dell'accesso a un contenitore BLOB. Viene usato per restituire lo stato del processo e i risultati. Nota: quando si usa l'autenticazione basata su identità è ancora necessario un URI https://, ma non è necessario alcun token di firma di accesso condiviso. L'input per questo argomento può essere inline o da un percorso di file.
hub IoT nome o nome host. Obbligatorio se non viene specificato --login.
Tipo di identità gestita per determinare se viene usata l'identità gestita assegnata dal sistema o l'identità gestita assegnata dall'utente. Per l'identità gestita assegnata dal sistema, usare [system]. Per l'identità gestita assegnata dall'utente, specificare l'ID risorsa identità gestita assegnata dall'utente. Questa identità richiede i ruoli collaboratore ai dati dei BLOB di archiviazione per l'account di archiviazione.
Se impostata, le chiavi vengono esportate normalmente. In caso contrario, le chiavi sono impostate su Null nell'output di esportazione.
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.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Nome dell'account Archiviazione di Azure contenente il contenitore BLOB di output. Il parametro viene ignorato quando viene fornito blob_container_uri. È necessario l'accesso in scrittura, lettura ed eliminazione.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot hub device-identity import
Importare le identità dei dispositivi in un hub IoT da un BLOB del contenitore di archiviazione.
Il file di input previsto contenente le identità dei dispositivi deve essere denominato "devices.txt". Il file di log di output 'importErrors.log' è vuoto quando l'importazione ha esito positivo e contiene i log degli errori in caso di errore di importazione.
Autorizzazioni necessarie: hub IoT criteri di accesso condiviso che supportano "Lettura registro e scrittura registro" oppure un'entità con ruolo "collaboratore dati hub IoT" nel hub IoT.
I parametri del nome dell'account di archiviazione e del nome del contenitore BLOB possono essere usati solo quando l'account di archiviazione si trova nella stessa sottoscrizione del hub IoT di input. Per l'input dell'URI di firma di accesso condiviso del contenitore BLOB inline, vedere le regole di input dell'ambiente.
Per ulteriori informazioni, vedere https://aka.ms/iothub-device-exportimport.
az iot hub device-identity import [--auth-type {key, login}]
[--hub-name]
[--ibc]
[--ibcu]
[--identity]
[--input-storage-account]
[--login]
[--obc]
[--obcu]
[--osa]
[--resource-group]
Esempio
Importare tutte le identità dei dispositivi da un BLOB fornendo parametri di comando per il contenitore BLOB di input e l'account di archiviazione, nonché il contenitore BLOB di output e l'account di archiviazione.
az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name}
Importare tutte le identità dei dispositivi da un BLOB usando un URI di firma di accesso condiviso inline.
az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri}
Importare tutte le identità del dispositivo da un BLOB usando un percorso di file che contiene l'URI di firma di accesso condiviso.
az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri_filepath} --obcu {output_sas_uri_filepath}
Importare tutte le identità dei dispositivi da un BLOB usando l'identità assegnata dal sistema con ruoli collaboratore ai dati dei BLOB di archiviazione per entrambi gli account di archiviazione. Il contenitore BLOB di input e l'account di archiviazione, nonché il contenitore BLOB di output e l'account di archiviazione vengono forniti come parametri al comando
az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name} --identity [system]
Importare tutte le identità dei dispositivi da un BLOB usando l'identità assegnata dal sistema con ruoli collaboratore ai dati dei BLOB di archiviazione per entrambi gli account di archiviazione. L'URI del contenitore BLOB non richiede il token di firma di accesso condiviso DEL BLOB.
az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --identity [system]
Importare tutte le identità dei dispositivi da un BLOB usando l'identità gestita assegnata dall'utente con ruoli Collaboratore dati BLOB di archiviazione per entrambi gli account di archiviazione. Il contenitore BLOB di input e l'account di archiviazione, nonché il contenitore BLOB di output e l'account di archiviazione vengono forniti come parametri al comando
az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name} --identity {managed_identity_resource_id}
Importare tutte le identità dei dispositivi da un BLOB usando l'identità gestita assegnata dall'utente con ruoli Collaboratore dati BLOB di archiviazione per entrambi gli account di archiviazione. L'URI del contenitore BLOB non richiede il token di firma di accesso condiviso DEL BLOB.
az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --identity {managed_identity_resource_id}
Parametri facoltativi
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>
.
hub IoT nome o nome host. Obbligatorio se non viene specificato --login.
Questo contenitore BLOB archivia il file che definisce le operazioni da eseguire nel registro delle identità. Il parametro viene ignorato quando viene fornito input_blob_container_uri. L'accesso in lettura è necessario per questo contenitore BLOB.
URI della firma di accesso condiviso BLOB con accesso in lettura a un contenitore BLOB. Questo BLOB contiene le operazioni da eseguire nel registro delle identità. Nota: quando si usa l'autenticazione basata su identità è ancora necessario un URI https://, ma non è necessario alcun token di firma di accesso condiviso. L'input per questo argomento può essere inline o da un percorso di file.
Tipo di identità gestita per determinare se viene usata l'identità gestita assegnata dal sistema o l'identità gestita assegnata dall'utente. Per l'identità gestita assegnata dal sistema, usare [system]. Per l'identità gestita assegnata dall'utente, specificare l'ID risorsa identità gestita assegnata dall'utente. Questa identità richiede un ruolo collaboratore ai dati del BLOB di archiviazione per l'account di archiviazione di destinazione e il ruolo Collaboratore per il hub IoT.
Nome dell'account Archiviazione di Azure contenente il contenitore BLOB di input. Obbligatorio solo quando non viene fornito input_blob_container_uri. L'accesso in lettura è obbligatorio.
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.
Questo contenitore BLOB viene usato per restituire lo stato del processo di importazione dell'identità del dispositivo e dei risultati. Obbligatorio solo quando non viene fornito input_blob_container_uri. L'accesso in scrittura è necessario per questo contenitore BLOB.
URI della firma di accesso condiviso BLOB con accesso in scrittura a un contenitore BLOB. Viene usato per restituire lo stato del processo e i risultati. Nota: quando si usa l'autenticazione basata su identità, è ancora necessario un URI https:// senza il token di firma di accesso condiviso. L'input per questo argomento può essere inline o da un percorso di file.
Nome dell'account Archiviazione di Azure contenente il contenitore BLOB di output. Il parametro viene ignorato quando viene fornito output_blob_container_uri. L'accesso in scrittura è obbligatorio.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot hub device-identity list
Elencare i dispositivi in un hub IoT.
Questo comando è un alias per az iot hub device-twin list
, che è altamente consigliato su questo comando. In futuro, questo az iot hub device-identity list
comando potrebbe essere modificato o deprecato.
az iot hub device-identity list [--auth-type {key, login}]
[--edge-enabled {false, true}]
[--hub-name]
[--login]
[--resource-group]
[--top]
Parametri facoltativi
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>
.
Flag che indica l'abilitazione dei bordi.
hub IoT nome o nome host. Obbligatorio se non viene specificato --login.
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.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Numero massimo di elementi da restituire. Usare -1 per un numero illimitato.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot hub device-identity renew-key
Rinnovare le chiavi di destinazione di un dispositivo hub IoT con autenticazione sas.
az iot hub device-identity renew-key --device-id
--hub-name
--key-type {primary, secondary, swap}
[--auth-type {key, login}]
[--etag]
[--login]
[--resource-group]
Esempio
Rinnovare la chiave primaria.
az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt primary
Scambiare le chiavi primarie e secondarie.
az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt swap
Parametri necessari
ID dispositivo di destinazione.
hub IoT nome o nome host. Obbligatorio se non viene specificato --login.
Tipo di chiave di destinazione da rigenerare.
Parametri facoltativi
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>
.
Tag Etag o tag di entità corrispondente all'ultimo stato della risorsa. Se non viene specificato alcun etag, viene usato il valore '*'.
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.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot hub device-identity show
Ottenere i dettagli di un dispositivo hub IoT.
az iot hub device-identity show --device-id
[--auth-type {key, login}]
[--hub-name]
[--login]
[--resource-group]
Parametri necessari
ID dispositivo di destinazione.
Parametri facoltativi
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>
.
hub IoT nome o nome host. Obbligatorio se non viene specificato --login.
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.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot hub device-identity update
Aggiornare un dispositivo hub IoT.
Usare --set seguito dalle assegnazioni di proprietà per l'aggiornamento di un dispositivo. Sfruttare i parametri restituiti da 'iot hub device-identity show'.
az iot hub device-identity update --device-id
[--add]
[--am {shared_private_key, x509_ca, x509_thumbprint}]
[--auth-type {key, login}]
[--edge-enabled {false, true}]
[--etag]
[--force-string]
[--hub-name]
[--login]
[--pk]
[--primary-thumbprint]
[--remove]
[--resource-group]
[--secondary-key]
[--secondary-thumbprint]
[--set]
[--sta {disabled, enabled}]
[--star]
Esempio
Attivare le funzionalità perimetrali per il dispositivo
az iot hub device-identity update -d {device_id} -n {iothub_name} --set capabilities.iotEdge=true
Attivare le funzionalità perimetrali per il dispositivo usando l'argomento praticità.
az iot hub device-identity update -d {device_id} -n {iothub_name} --ee
Disabilitare lo stato del dispositivo
az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled
Disabilitare lo stato del dispositivo usando l'argomento praticità.
az iot hub device-identity update -d {device_id} -n {iothub_name} --status disabled
In un comando
az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled capabilities.iotEdge=true
Parametri necessari
ID dispositivo di destinazione.
Parametri facoltativi
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>
.
Il metodo di autorizzazione con cui creare un'entità.
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>
.
Flag che indica l'abilitazione dei bordi.
Tag Etag o tag di entità corrispondente all'ultimo stato della risorsa. Se non viene specificato alcun etag, viene usato il valore '*'.
Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.
hub IoT nome o nome host. Obbligatorio se non viene specificato --login.
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.
Chiave di accesso condiviso simmetrica primaria archiviata in formato Base64.
Identificazione personale del certificato autofirmato da usare per l'identificazione personale primaria.
Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Chiave di accesso condiviso simmetrica secondaria archiviata in formato Base64.
Identificazione personale del certificato autofirmato da usare per l'identificazione personale secondaria.
Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>
.
Impostare lo stato del dispositivo al momento della creazione.
Descrizione per lo stato del dispositivo.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.