az iot hub certificate

  • Referentie

Notitie

Deze opdrachtgroep bevat opdrachten die zijn gedefinieerd in zowel Azure CLI als ten minste één extensie. Installeer elke extensie om te profiteren van de uitgebreide mogelijkheden. Meer informatie over extensies.

IoT Hub-certificaten beheren.

Opdracht

Name Description Type Status
az iot hub certificate create

Een Azure IoT Hub-certificaat maken/uploaden.

 Basis GA
az iot hub certificate delete

Hiermee verwijdert u een Azure IoT Hub-certificaat.

 Basis GA
az iot hub certificate generate-verification-code

Hiermee wordt een verificatiecode gegenereerd voor een Azure IoT Hub-certificaat.

 Basis GA
az iot hub certificate list

Geeft een lijst weer van alle certificaten die zijn opgenomen in een Azure IoT Hub.

 Basis GA
az iot hub certificate root-authority

Beheer de basisinstantie van het certificaat voor een IoT Hub-exemplaar.

 Toestel Afgeschaft
az iot hub certificate root-authority set

Stel de basisinstantie van het certificaat voor een IoT Hub-exemplaar in op een specifieke versie.

 Toestel Afgeschaft
az iot hub certificate root-authority show

De huidige basisinstantie van het certificaat voor een IoT Hub-exemplaar weergeven.

 Toestel Afgeschaft
az iot hub certificate show

Toont informatie over een bepaald Azure IoT Hub-certificaat.

 Basis GA
az iot hub certificate update

Een Azure IoT Hub-certificaat bijwerken.

 Basis GA
az iot hub certificate verify

Controleert een Azure IoT Hub-certificaat.

 Basis GA

az iot hub certificate create

Bewerken

Een Azure IoT Hub-certificaat maken/uploaden.

Zie voor een gedetailleerde uitleg van CA-certificaten in Azure IoT Hub 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}]

Voorbeelden

Hiermee uploadt u een geverifieerd PEM-CA-certificaatbestand naar een IoT-hub.

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

Uploadt een CER-bestand met CA-certificaten naar een IoT-hub.

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

Een Azure IoT Hub-certificaat maken/uploaden (automatisch gegenereerd)

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

Vereiste parameters

--hub-name

Naam van IoT Hub.

--name -n

Een beschrijvende naam voor het certificaat.

--path -p

Het pad naar het bestand met het certificaat.

Optionele parameters

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--verified -v

Een Booleaanse waarde die aangeeft of het certificaat al dan niet is geverifieerd.

geaccepteerde waarden: false, true
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az iot hub certificate delete

Bewerken

Hiermee verwijdert u een Azure IoT Hub-certificaat.

Zie voor een gedetailleerde uitleg van CA-certificaten in Azure IoT Hub https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Voorbeelden

MyCertificate verwijderen

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

Vereiste parameters

--etag -e

Entiteitstag (etag) van het object.

--name -n

Een beschrijvende naam voor het certificaat.

Optionele parameters

--hub-name

Naam van IoT Hub.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az iot hub certificate generate-verification-code

Bewerken

Hiermee wordt een verificatiecode gegenereerd voor een Azure IoT Hub-certificaat.

Deze verificatiecode wordt gebruikt om het bewijs van bezit voor een certificaat te voltooien. Gebruik deze verificatiecode als de CN van een nieuw certificaat dat is ondertekend met de persoonlijke sleutel van de basiscertificaten. Zie voor een gedetailleerde uitleg van CA-certificaten in Azure IoT Hub 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]

Voorbeelden

Hiermee wordt een verificatiecode voor MyCertificate gegenereerd

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

Hiermee wordt een verificatiecode gegenereerd voor een Azure IoT Hub-certificaat (automatisch gegenereerd)

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

Vereiste parameters

--etag -e

Entiteitstag (etag) van het object.

--name -n

Een beschrijvende naam voor het certificaat.

Optionele parameters

--hub-name

Naam van IoT Hub.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az iot hub certificate list

Bewerken

Geeft een lijst weer van alle certificaten die zijn opgenomen in een Azure IoT Hub.

Zie voor een gedetailleerde uitleg van CA-certificaten in Azure IoT Hub https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Voorbeelden

Alle certificaten weergeven in MyIotHub

az iot hub certificate list --hub-name MyIotHub

Optionele parameters

--hub-name

Naam van IoT Hub.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az iot hub certificate show

Bewerken

Toont informatie over een bepaald Azure IoT Hub-certificaat.

Zie voor een gedetailleerde uitleg van CA-certificaten in Azure IoT Hub https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Voorbeelden

Details over MyCertificate weergeven

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

Toont informatie over een bepaald Azure IoT Hub-certificaat (automatisch gegenereerd)

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

Vereiste parameters

--name -n

Een beschrijvende naam voor het certificaat.

Optionele parameters

--hub-name

Naam van IoT Hub.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az iot hub certificate update

Bewerken

Een Azure IoT Hub-certificaat bijwerken.

Uploadt een nieuw certificaat om het bestaande certificaat te vervangen door dezelfde naam. Zie voor een gedetailleerde uitleg van CA-certificaten in Azure IoT Hub 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}]

Voorbeelden

Hiermee werkt u een CA-certificaat in een IoT-hub bij door een nieuw PEM-bestand te uploaden.

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

Hiermee werkt u een CA-certificaat in een IoT-hub bij door een nieuw CER-bestand te uploaden.

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

Vereiste parameters

--etag -e

Entiteitstag (etag) van het object.

--name -n

Een beschrijvende naam voor het certificaat.

--path -p

Het pad naar het bestand met het certificaat.

Optionele parameters

--hub-name

Naam van IoT Hub.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verified -v

Een Booleaanse waarde die aangeeft of het certificaat al dan niet is geverifieerd.

geaccepteerde waarden: false, true
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az iot hub certificate verify

Bewerken

Controleert een Azure IoT Hub-certificaat.

Verifieert een certificaat door een verificatiecertificaat te uploaden dat de verificatiecode bevat die is verkregen door het aanroepen van generate-verification-code. Dit is de laatste stap in het bewijs van bezit. Zie voor een gedetailleerde uitleg van CA-certificaten in Azure IoT Hub 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]

Voorbeelden

Controleert het eigendom van de persoonlijke sleutel MyCertificate.

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

Verifieert een Azure IoT Hub-certificaat (automatisch gegenereerd)

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

Vereiste parameters

--etag -e

Entiteitstag (etag) van het object.

--name -n

Een beschrijvende naam voor het certificaat.

--path -p

Het pad naar het bestand met het certificaat.

Optionele parameters

--hub-name

Naam van IoT Hub.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.