az iot hub device-identity

  • Riferimento

Nota

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

Gestire i dispositivi IoT.

Comandi

Nome Descrizione Tipo Status
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

--device-id -d

ID dispositivo di destinazione.

Parametri facoltativi

--am --auth-method

Il metodo di autorizzazione con cui creare un'entità.

Valori accettati: shared_private_key, x509_ca, x509_thumbprint
Valore predefinito: shared_private_key
--auth-type

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

Valori accettati: key, login
Valore predefinito: key
--device-scope

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.

--edge-enabled --ee

Flag che indica l'abilitazione dei bordi.

Valori accettati: false, true
Valore predefinito: False
--hub-name -n

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

--login -l

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

--od --output-dir

Generare un certificato autofirmato e usarne l'identificazione personale. Output nella directory di destinazione specificata.

--pk --primary-key

Chiave di accesso condiviso simmetrica primaria archiviata in formato Base64.

--primary-thumbprint --ptp

Identificazione personale del certificato autofirmato da usare per l'identificazione personale primaria.

--resource-group -g

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

--secondary-key --sk

Chiave di accesso condiviso simmetrica secondaria archiviata in formato Base64.

--secondary-thumbprint --stp

Identificazione personale del certificato autofirmato da usare per l'identificazione personale secondaria.

--sta --status

Impostare lo stato del dispositivo al momento della creazione.

Valori accettati: disabled, enabled
Valore predefinito: enabled
--star --status-reason

Descrizione per lo stato del dispositivo.

--valid-days --vd

Generare un certificato autofirmato e usarne l'identificazione personale. Valido per il numero specificato di giorni. Impostazione predefinita: 365.

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

--device-id -d

ID dispositivo di destinazione.

Parametri facoltativi

--auth-type

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

Valori accettati: key, login
Valore predefinito: key
--etag -e

Tag Etag o tag di entità corrispondente all'ultimo stato della risorsa. Se non viene specificato alcun etag, viene usato il valore '*'.

--hub-name -n

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

--login -l

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

--resource-group -g

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

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

--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
--bc --blob-container

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.

--bcu --blob-container-uri

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

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

--identity

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.

--ik --include-keys

Se impostata, le chiavi vengono esportate normalmente. In caso contrario, le chiavi sono impostate su Null nell'output di esportazione.

Valori accettati: false, true
Valore predefinito: False
--login -l

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

--resource-group -g

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

--sa --storage-account

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

--auth-type

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

Valori accettati: key, login
Valore predefinito: key
--hub-name -n

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

--ibc --input-blob-container

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.

--ibcu --input-blob-container-uri

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.

--identity

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.

--input-storage-account --isa

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.

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

--obc --output-blob-container

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.

--obcu --output-blob-container-uri

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.

--osa --output-storage-account

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.

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

--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
--edge-enabled --ee

Flag che indica l'abilitazione dei bordi.

Valori accettati: false, true
Valore predefinito: False
--hub-name -n

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

--login -l

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

--resource-group -g

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

--top

Numero massimo di elementi da restituire. Usare -1 per un numero illimitato.

Valore predefinito: 1000
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 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

--device-id -d

ID dispositivo di destinazione.

--hub-name -n

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

--key-type --kt

Tipo di chiave di destinazione da rigenerare.

Valori accettati: primary, secondary, swap

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

Tag Etag o tag di entità corrispondente all'ultimo stato della risorsa. Se non viene specificato alcun etag, viene usato il valore '*'.

--login -l

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

--resource-group -g

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

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

--device-id -d

ID dispositivo di destinazione.

Parametri facoltativi

--auth-type

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

Valori accettati: key, login
Valore predefinito: key
--hub-name -n

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

--login -l

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

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

--device-id -d

ID dispositivo di destinazione.

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: []
--am --auth-method

Il metodo di autorizzazione con cui creare un'entità.

Valori accettati: shared_private_key, x509_ca, x509_thumbprint
--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
--edge-enabled --ee

Flag che indica l'abilitazione dei bordi.

Valori accettati: false, true
--etag -e

Tag Etag o tag di entità corrispondente all'ultimo stato della risorsa. Se non viene specificato alcun etag, viene usato il valore '*'.

--force-string

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

Valore predefinito: False
--hub-name -n

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

--login -l

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

--pk --primary-key

Chiave di accesso condiviso simmetrica primaria archiviata in formato Base64.

--primary-thumbprint --ptp

Identificazione personale del certificato autofirmato da usare per l'identificazione personale primaria.

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

--secondary-key --sk

Chiave di accesso condiviso simmetrica secondaria archiviata in formato Base64.

--secondary-thumbprint --stp

Identificazione personale del certificato autofirmato da usare per l'identificazione personale secondaria.

--set

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

Valore predefinito: []
--sta --status

Impostare lo stato del dispositivo al momento della creazione.

Valori accettati: disabled, enabled
--star --status-reason

Descrizione per lo stato del dispositivo.

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.