az iot hub device-identity

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot hub device-identity. Learn more about extensions.

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.	Extension	GA
az iot hub device-identity children add	Aggiungere dispositivi come elementi figlio a un dispositivo perimetrale di destinazione.	Extension	GA
az iot hub device-identity children list	Restituisce la raccolta di dispositivi figlio assegnati.	Extension	GA
az iot hub device-identity children remove	Rimuovere i dispositivi figlio da un dispositivo perimetrale di destinazione.	Extension	GA
az iot hub device-identity connection-string	Gestire le stringa di connessione del dispositivo IoT.	Extension	GA
az iot hub device-identity connection-string show	Mostra un determinato stringa di connessione dispositivo hub IoT.	Extension	GA
az iot hub device-identity create	Creare un dispositivo in un hub IoT.	Extension	GA
az iot hub device-identity delete	Eliminare un dispositivo hub IoT.	Extension	GA
az iot hub device-identity export	Esportare tutte le identità dei dispositivi da un hub IoT a un contenitore BLOB Archiviazione di Azure.	Extension	GA
az iot hub device-identity import	Importare le identità dei dispositivi in un hub IoT da un BLOB del contenitore di archiviazione.	Extension	GA
az iot hub device-identity list	Elencare i dispositivi in un hub IoT.	Extension	GA
az iot hub device-identity parent	Gestire le relazioni tra dispositivi padre per i dispositivi IoT.	Extension	GA
az iot hub device-identity parent set	Impostare il dispositivo padre di un dispositivo di destinazione.	Extension	GA
az iot hub device-identity parent show	Ottenere il dispositivo padre di un dispositivo di destinazione.	Extension	GA
az iot hub device-identity renew-key	Rinnovare le chiavi di destinazione dei dispositivi hub IoT con autenticazione sas.	Extension	GA
az iot hub device-identity show	Ottenere i dettagli di un dispositivo hub IoT.	Extension	GA
az iot hub device-identity update	Aggiornare un dispositivo hub IoT.	Extension	GA

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 --auth-method {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--device-scope]
                                  [--edge-enabled --ee {false, true}]
                                  [--hub-name]
                                  [--login]
                                  [--od --output-dir]
                                  [--pk --primary-key]
                                  [--primary-thumbprint --ptp]
                                  [--resource-group]
                                  [--secondary-key --sk]
                                  [--secondary-thumbprint --stp]
                                  [--sta --status {disabled, enabled}]
                                  [--star --status-reason]
                                  [--valid-days --vd]

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--am --auth-method

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

Proprietà	Valore
Valore predefinito:	shared_private_key
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}.

Proprietà	Valore
Parameter group:	Access Control Arguments
Valore predefinito:	key
Valori accettati:	key, login

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

Proprietà	Valore
Parameter group:	Device Scope Arguments

--edge-enabled --ee

Flag che indica l'abilitazione dei bordi.

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--hub-name -n

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

--od --output-dir

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

Proprietà	Valore
Parameter group:	X.509 Arguments

--pk --primary-key

Chiave di accesso condiviso simmetrica primaria archiviata in formato Base64.

Proprietà	Valore
Parameter group:	Symmetric Key Arguments

--primary-thumbprint --ptp

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

Proprietà	Valore
Parameter group:	X.509 Arguments

--resource-group -g

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

--secondary-key --sk

Chiave di accesso condiviso simmetrica secondaria archiviata in formato Base64.

Proprietà	Valore
Parameter group:	Symmetric Key Arguments

--secondary-thumbprint --stp

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

Proprietà	Valore
Parameter group:	X.509 Arguments

--sta --status

Impostare lo stato del dispositivo al momento della creazione.

Proprietà	Valore
Valore predefinito:	enabled
Valori accettati:	disabled, 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. Default: 365.

Proprietà	Valore
Parameter group:	X.509 Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Proprietà	Valore
Parameter group:	Access Control Arguments
Valore predefinito:	key
Valori accettati:	key, login

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

--resource-group -g

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

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

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 altre informazioni, vedere https://aka.ms/iothub-device-exportimport.

az iot hub device-identity export [--auth-type {key, login}]
                                  [--bc --blob-container]
                                  [--bcu --blob-container-uri]
                                  [--hub-name]
                                  [--identity]
                                  [--ik --include-keys {false, true}]
                                  [--login]
                                  [--resource-group]
                                  [--sa --storage-account]

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Proprietà	Valore
Parameter group:	Access Control Arguments
Valore predefinito:	key
Valori accettati:	key, login

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

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

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

--resource-group -g

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

--sa --storage-account

Nome dell'account di 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

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

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 altre informazioni, vedere https://aka.ms/iothub-device-exportimport.

az iot hub device-identity import [--auth-type {key, login}]
                                  [--hub-name]
                                  [--ibc --input-blob-container]
                                  [--ibcu --input-blob-container-uri]
                                  [--identity]
                                  [--input-storage-account --isa]
                                  [--login]
                                  [--obc --output-blob-container]
                                  [--obcu --output-blob-container-uri]
                                  [--osa --output-storage-account]
                                  [--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Proprietà	Valore
Parameter group:	Access Control Arguments
Valore predefinito:	key
Valori accettati:	key, login

--hub-name -n

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

--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 dati BLOB di archiviazione per l'account di archiviazione di destinazione e il ruolo Collaboratore per l'hub IoT.

--input-storage-account --isa

Nome dell'account di 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.

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

--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 di 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 usando az configure --defaults group=<name>.

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

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 --ee {false, true}]
                                [--hub-name]
                                [--login]
                                [--resource-group]
                                [--top]

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Proprietà	Valore
Parameter group:	Access Control Arguments
Valore predefinito:	key
Valori accettati:	key, login

--edge-enabled --ee

Flag che indica l'abilitazione dei bordi.

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--hub-name -n

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

--resource-group -g

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

--top

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

Proprietà	Valore
Valore predefinito:	1000

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az iot hub device-identity renew-key

Rinnovare le chiavi di destinazione dei dispositivi hub IoT con autenticazione sas.

Attualmente gli etag e il tipo di swap chiave non sono supportati per la rigenerazione delle chiavi in blocco. La rigenerazione delle chiavi in blocco è un formato di output diverso rispetto alla rigenerazione della chiave del dispositivo singolo.

az iot hub device-identity renew-key --device-id
                                     --hub-name
                                     --key-type --kt {both, primary, secondary, swap}
                                     [--auth-type {key, login}]
                                     [--etag]
                                     [--im --include-modules {false, true}]
                                     [--login]
                                     [--no-progress {false, true}]
                                     [--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

Rinnovare la chiave secondaria per due dispositivi e i relativi moduli.

az iot hub device-identity renew-key -d {device_id} {device_id} -n {iothub_name} --kt secondary --include-modules

Rinnovare entrambe le chiavi per tutti i dispositivi all'interno dell'hub.

az iot hub device-identity renew-key -d * -n {iothub_name} --kt both

Parametri necessari

--device-id -d

Elenco separato di spazio degli ID dispositivo di destinazione. Usare * per tutti i dispositivi.

--hub-name -n

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

--key-type --kt

Tipo di chiave di destinazione da rigenerare.

Proprietà	Valore
Valori accettati:	both, primary, secondary, swap

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Proprietà	Valore
Parameter group:	Access Control Arguments
Valore predefinito:	key
Valori accettati:	key, login

--etag -e

Tag Etag o tag di entità corrispondente all'ultimo stato della risorsa. Se non viene specificato alcun etag, viene usato il valore '*'. Questo argomento si applica solo a swap.

--im --include-modules

Flag per includere i moduli del dispositivo durante la rigenerazione delle chiavi.

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

--no-progress

Nascondere l'indicatore di stato per la rigenerazione delle chiavi bulk.

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--resource-group -g

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

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Proprietà	Valore
Parameter group:	Access Control Arguments
Valore predefinito:	key
Valori accettati:	key, login

--hub-name -n

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

--resource-group -g

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

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

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 --auth-method {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--edge-enabled --ee {false, true}]
                                  [--etag]
                                  [--force-string]
                                  [--hub-name]
                                  [--login]
                                  [--pk --primary-key]
                                  [--primary-thumbprint --ptp]
                                  [--remove]
                                  [--resource-group]
                                  [--secondary-key --sk]
                                  [--secondary-thumbprint --stp]
                                  [--set]
                                  [--sta --status {disabled, enabled}]
                                  [--star --status-reason]

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Proprietà	Valore
Parameter group:	Generic Update Arguments
Valore predefinito:	[]

--am --auth-method

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

Proprietà	Valore
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}.

Proprietà	Valore
Parameter group:	Access Control Arguments
Valore predefinito:	key
Valori accettati:	key, login

--edge-enabled --ee

Flag che indica l'abilitazione dei bordi.

Proprietà	Valore
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.

Proprietà	Valore
Parameter group:	Generic Update Arguments
Valore predefinito:	False

--hub-name -n

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

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

Proprietà	Valore
Parameter group:	IoT Hub Identifier Arguments

--pk --primary-key

Chiave di accesso condiviso simmetrica primaria archiviata in formato Base64.

Proprietà	Valore
Parameter group:	Symmetric Key Arguments

--primary-thumbprint --ptp

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

Proprietà	Valore
Parameter group:	X.509 Arguments

--remove

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

Proprietà	Valore
Parameter group:	Generic Update Arguments
Valore predefinito:	[]

--resource-group -g

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

--secondary-key --sk

Chiave di accesso condiviso simmetrica secondaria archiviata in formato Base64.

Proprietà	Valore
Parameter group:	Symmetric Key Arguments

--secondary-thumbprint --stp

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

Proprietà	Valore
Parameter group:	X.509 Arguments

--set

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

Proprietà	Valore
Parameter group:	Generic Update Arguments
Valore predefinito:	[]

--sta --status

Impostare lo stato del dispositivo al momento della creazione.

Proprietà	Valore
Valori accettati:	disabled, enabled

--star --status-reason

Descrizione per lo stato del dispositivo.

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False