az iot hub certificate

Verwalten von IoT Hub-Zertifikaten.

Befehle

az iot hub certificate create	Erstellen/Hochladen eines Azure IoT Hub Zertifikats.
az iot hub certificate delete	Löscht ein Azure IoT Hub Zertifikat.
az iot hub certificate generate-verification-code	Generiert einen Überprüfungscode für ein Azure IoT Hub Zertifikat.
az iot hub certificate list	Listet alle Zertifikate auf, die in einem Azure IoT Hub enthalten sind.
az iot hub certificate show	Zeigt Informationen zu einem bestimmten Azure IoT Hub Zertifikat an.
az iot hub certificate update	Aktualisieren eines Azure IoT Hub Zertifikats.
az iot hub certificate verify	Überprüft ein Azure IoT Hub Zertifikat.

az iot hub certificate create

Erstellen/Hochladen eines Azure IoT Hub Zertifikats.

Ausführliche Erläuterungen zu CA-Zertifikaten in Azure IoT Hub finden Sie unter 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}]

Beispiele

Lädt eine überprüfte Ca-Zertifikat-PEM-Datei in einen IoT-Hub hoch.

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

Lädt eine CA-Zertifikat-CER-Datei in einen IoT-Hub hoch.

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

Erstellen/Hochladen eines Azure IoT Hub Zertifikats (automatisch generiert)

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

Erforderliche Parameter

--hub-name

IoT Hub Name.

--name -n

Ein Anzeigename für das Zertifikat.

--path -p

Der Pfad zur Datei, die das Zertifikat enthält.

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--verified -v

Ein boolescher Wert, der angibt, ob das Zertifikat überprüft wird.

Zulässige Werte: false, true

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot hub certificate delete

Löscht ein Azure IoT Hub Zertifikat.

Ausführliche Erläuterungen zu CA-Zertifikaten in Azure IoT Hub finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Beispiele

Löscht MyCertificate

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

Erforderliche Parameter

--etag -e

Entity Tag (etag) des Objekts.

--name -n

Ein Anzeigename für das Zertifikat.

Optionale Parameter

--hub-name

IoT Hub Name.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot hub certificate generate-verification-code

Generiert einen Überprüfungscode für ein Azure IoT Hub Zertifikat.

Dieser Überprüfungscode wird verwendet, um den Nachweis des Besitzes für ein Zertifikat abzuschließen. Verwenden Sie diesen Überprüfungscode als CN eines neuen Zertifikats, das mit dem privaten Stammzertifikat signiert ist. Ausführliche Erläuterungen zu CA-Zertifikaten in Azure IoT Hub finden Sie unter 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]

Beispiele

Generiert einen Überprüfungscode für MyCertificate

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

Generiert einen Überprüfungscode für ein Azure IoT Hub-Zertifikat (automatisch generiert)

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

Erforderliche Parameter

--etag -e

Entity Tag (etag) des Objekts.

--name -n

Ein Anzeigename für das Zertifikat.

Optionale Parameter

--hub-name

IoT Hub Name.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot hub certificate list

Listet alle Zertifikate auf, die in einem Azure IoT Hub enthalten sind.

Ausführliche Erläuterungen zu CA-Zertifikaten in Azure IoT Hub finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Beispiele

Liste aller Zertifikate in MyIotHub

az iot hub certificate list --hub-name MyIotHub

Optionale Parameter

--hub-name

IoT Hub Name.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot hub certificate show

Zeigt Informationen zu einem bestimmten Azure IoT Hub Zertifikat an.

Ausführliche Erläuterungen zu CA-Zertifikaten in Azure IoT Hub finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Beispiele

Details zu MyCertificate anzeigen

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

Zeigt Informationen zu einem bestimmten Azure IoT Hub Zertifikat (automatisch generiert) an.

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

Erforderliche Parameter

--name -n

Ein Anzeigename für das Zertifikat.

Optionale Parameter

--hub-name

IoT Hub Name.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot hub certificate update

Aktualisieren eines Azure IoT Hub Zertifikats.

Lädt ein neues Zertifikat hoch, um das vorhandene Zertifikat durch denselben Namen zu ersetzen. Ausführliche Erläuterungen zu CA-Zertifikaten in Azure IoT Hub finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Beispiele

Aktualisierungen ein CA-Zertifikat in einem IoT-Hub durch Hochladen einer neuen PEM-Datei.

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

Aktualisierungen ein CA-Zertifikat in einem IoT-Hub durch Hochladen einer neuen CER-Datei.

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

Erforderliche Parameter

--etag -e

Entity Tag (etag) des Objekts.

--name -n

Ein Anzeigename für das Zertifikat.

--path -p

Der Pfad zur Datei, die das Zertifikat enthält.

Optionale Parameter

--hub-name

IoT Hub Name.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--verified -v

Ein boolescher Wert, der angibt, ob das Zertifikat überprüft wird.

Zulässige Werte: false, true

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot hub certificate verify

Überprüft ein Azure IoT Hub Zertifikat.

Überprüft ein Zertifikat, indem ein Überprüfungszertifikat hochgeladen wird, das den überprüfungscode enthält, der durch Aufrufen von Generieren-Überprüfungscode abgerufen wird. Dies ist der letzte Schritt im Nachweis des Besitzprozesses. Ausführliche Erläuterungen zu CA-Zertifikaten in Azure IoT Hub finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Beispiele

Überprüft den Besitz des privaten Schlüssels MyCertificate.

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

Überprüft ein Azure IoT Hub Zertifikat (automatisch generiert)

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

Erforderliche Parameter

--etag -e

Entity Tag (etag) des Objekts.

--name -n

Ein Anzeigename für das Zertifikat.

--path -p

Der Pfad zur Datei, die das Zertifikat enthält.

Optionale Parameter

--hub-name

IoT Hub Name.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.