Condividi tramite

az iot hub certificate

  • Riferimento

Nota

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

Gestire i certificati dell'hub IoT.

Comandi

Nome Descrizione Tipo Status
az iot hub certificate create

Creare/caricare un certificato hub IoT di Azure.

 Core Disponibilità generale
az iot hub certificate delete

Elimina un certificato hub IoT di Azure.

 Core Disponibilità generale
az iot hub certificate generate-verification-code

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

 Core Disponibilità generale
az iot hub certificate list

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

 Core Disponibilità generale
az iot hub certificate root-authority

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

 Estensione Deprecato
az iot hub certificate root-authority set

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

 Estensione Deprecato
az iot hub certificate root-authority show

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

 Estensione Deprecato
az iot hub certificate show

Visualizza informazioni su un determinato certificato hub IoT di Azure.

 Core Disponibilità generale
az iot hub certificate update

Aggiornare un certificato hub IoT di Azure.

 Core Disponibilità generale
az iot hub certificate verify

Verifica un certificato hub IoT di Azure.

 Core Disponibilità generale

az iot hub certificate create

Modifica

Creare/caricare un certificato hub IoT di Azure.

Per una spiegazione dettagliata dei certificati CA in hub IoT di Azure, vedere https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

az iot hub certificate create --hub-name
                              --name
                              --path
                              [--resource-group]
                              [--verified {false, true}]

Esempio

Carica un file PEM certificato CA verificato in un hub IoT.

az iot hub certificate create --hub-name MyIotHub --name MyCertificate --path /certificates/Certificate.pem --verified

Carica un file CER del certificato CA in un hub IoT.

az iot hub certificate create --hub-name MyIotHub --name MyCertificate --path /certificates/Certificate.cer

Creare/caricare un certificato hub IoT di Azure (generato automaticamente)

az iot hub certificate create --hub-name MyIotHub --name MyCertificate --path /certificates/Certificate.cer --resource-group MyResourceGroup --subscription MySubscription

Parametri necessari

--hub-name

hub IoT nome.

--name -n

Nome descrittivo del certificato.

--path -p

Percorso del file contenente il certificato.

Parametri facoltativi

--resource-group -g

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

--verified -v

Valore booleano che indica se il certificato è verificato o meno.

Valori accettati: false, true
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 certificate delete

Modifica

Elimina un certificato hub IoT di Azure.

Per una spiegazione dettagliata dei certificati CA in hub IoT di Azure, vedere https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

az iot hub certificate delete --etag
                              --name
                              [--hub-name]
                              [--ids]
                              [--resource-group]
                              [--subscription]

Esempio

Elimina MyCertificate

az iot hub certificate delete --hub-name MyIotHub --name MyCertificate --etag AAAAAAAAAAA=

Parametri necessari

--etag -e

Tag di entità (etag) dell'oggetto.

--name -n

Nome descrittivo del certificato.

Parametri facoltativi

--hub-name

hub IoT nome.

--ids

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

--resource-group -g

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

--subscription

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

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

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

--subscription

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

--verbose

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

az iot hub certificate generate-verification-code

Modifica

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

Questo codice di verifica viene usato per completare il passaggio di prova del possesso per un certificato. Usare questo codice di verifica come cn di un nuovo certificato firmato con la chiave privata dei certificati radice. Per una spiegazione dettagliata dei certificati CA in hub IoT di Azure, vedere https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

az iot hub certificate generate-verification-code --etag
                                                  --name
                                                  [--hub-name]
                                                  [--ids]
                                                  [--resource-group]
                                                  [--subscription]

Esempio

Genera un codice di verifica per MyCertificate

az iot hub certificate generate-verification-code --hub-name MyIotHub --name MyCertificate --etag AAAAAAAAAAA=

Genera un codice di verifica per un certificato hub IoT di Azure (generato automaticamente)

az iot hub certificate generate-verification-code --etag AAAAAAAAAAA= --hub-name MyIotHub --name MyCertificate --resource-group MyResourceGroup --subscription MySubscription

Parametri necessari

--etag -e

Tag di entità (etag) dell'oggetto.

--name -n

Nome descrittivo del certificato.

Parametri facoltativi

--hub-name

hub IoT nome.

--ids

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

--resource-group -g

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

--subscription

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

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

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

--subscription

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

--verbose

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

az iot hub certificate list

Modifica

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

Per una spiegazione dettagliata dei certificati CA in hub IoT di Azure, vedere https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Esempio

Elencare tutti i certificati in MyIotHub

az iot hub certificate list --hub-name MyIotHub

Parametri facoltativi

--hub-name

hub IoT nome.

--ids

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

--resource-group -g

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

--subscription

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

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

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

--subscription

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

--verbose

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

az iot hub certificate show

Modifica

Visualizza informazioni su un determinato certificato hub IoT di Azure.

Per una spiegazione dettagliata dei certificati CA in hub IoT di Azure, vedere https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Esempio

Mostra dettagli su MyCertificate

az iot hub certificate show --hub-name MyIotHub --name MyCertificate

Mostra informazioni su un determinato certificato di hub IoT di Azure (generato automaticamente)

az iot hub certificate show --hub-name MyIotHub --name MyCertificate --resource-group MyResourceGroup --subscription MySubscription

Parametri necessari

--name -n

Nome descrittivo del certificato.

Parametri facoltativi

--hub-name

hub IoT nome.

--ids

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

--resource-group -g

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

--subscription

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

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

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

--subscription

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

--verbose

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

az iot hub certificate update

Modifica

Aggiornare un certificato hub IoT di Azure.

Carica un nuovo certificato per sostituire il certificato esistente con lo stesso nome. Per una spiegazione dettagliata dei certificati CA in hub IoT di Azure, vedere https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

az iot hub certificate update --etag
                              --name
                              --path
                              [--hub-name]
                              [--ids]
                              [--resource-group]
                              [--subscription]
                              [--verified {false, true}]

Esempio

Aggiornamenti un certificato ca in un hub IoT caricando un nuovo file PEM.

az iot hub certificate update --hub-name MyIotHub --name MyCertificate --path /certificates/NewCertificate.pem --etag AAAAAAAAAAA=

Aggiornamenti un certificato ca in un hub IoT caricando un nuovo file CER.

az iot hub certificate update --hub-name MyIotHub --name MyCertificate --path /certificates/NewCertificate.cer --etag AAAAAAAAAAA=

Parametri necessari

--etag -e

Tag di entità (etag) dell'oggetto.

--name -n

Nome descrittivo del certificato.

--path -p

Percorso del file contenente il certificato.

Parametri facoltativi

--hub-name

hub IoT nome.

--ids

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

--resource-group -g

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

--subscription

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

--verified -v

Valore booleano che indica se il certificato è verificato o meno.

Valori accettati: false, true
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 certificate verify

Modifica

Verifica un certificato hub IoT di Azure.

Verifica un certificato caricando un certificato di verifica contenente il codice di verifica ottenuto chiamando generate-verification-code. Questo è l'ultimo passaggio del processo di prova del possesso. Per una spiegazione dettagliata dei certificati CA in hub IoT di Azure, vedere https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

az iot hub certificate verify --etag
                              --name
                              --path
                              [--hub-name]
                              [--ids]
                              [--resource-group]
                              [--subscription]

Esempio

Verifica la proprietà della chiave privata MyCertificate.

az iot hub certificate verify --hub-name MyIotHub --name MyCertificate --path /certificates/Verification.pem --etag AAAAAAAAAAA=

Verifica un certificato hub IoT di Azure (generato automaticamente)

az iot hub certificate verify --etag AAAAAAAAAAA= --hub-name MyIotHub --name MyCertificate --path /certificates/Verification.pem --resource-group MyResourceGroup --subscription MySubscription

Parametri necessari

--etag -e

Tag di entità (etag) dell'oggetto.

--name -n

Nome descrittivo del certificato.

--path -p

Percorso del file contenente il certificato.

Parametri facoltativi

--hub-name

hub IoT nome.

--ids

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

--resource-group -g

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

--subscription

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

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

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

--subscription

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

--verbose

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