Freigeben über

az iot hub certificate

  • Referenz

Anmerkung

Diese Befehlsgruppe verfügt über Befehle, die sowohl in Azure CLI als auch in mindestens einer Erweiterung definiert sind. Installieren Sie jede Erweiterung, um von ihren erweiterten Funktionen zu profitieren. Erfahren Sie mehr über Erweiterungen.

Verwalten von IoT Hub-Zertifikaten.

Befehle

Name Beschreibung Typ Status
az iot hub certificate create

Erstellen/Hochladen eines Azure IoT Hub-Zertifikats.

 Kern GA
az iot hub certificate delete

Löscht ein Azure IoT Hub-Zertifikat.

 Kern GA
az iot hub certificate generate-verification-code

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

 Kern GA
az iot hub certificate list

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

 Kern GA
az iot hub certificate root-authority

Verwalten Sie die Zertifikatstammzertifizierungsstelle für eine IoT Hub-Instanz.

 Erweiterung Veraltet
az iot hub certificate root-authority set

Legen Sie die Zertifikatstammzertifizierungsstelle für eine IoT Hub-Instanz auf eine bestimmte Version fest.

 Erweiterung Veraltet
az iot hub certificate root-authority show

Zeigen Sie die aktuelle Zertifikatstammzertifizierungsstelle für eine IoT Hub-Instanz an.

 Erweiterung Veraltet
az iot hub certificate show

Zeigt Informationen zu einem bestimmten Azure IoT Hub-Zertifikat an.

 Kern GA
az iot hub certificate update

Aktualisieren Sie ein Azure IoT Hub-Zertifikat.

 Kern GA
az iot hub certificate verify

Überprüft ein Azure IoT Hub-Zertifikat.

 Kern GA

az iot hub certificate create

Bearbeiten

Erstellen/Hochladen eines Azure IoT Hub-Zertifikats.

Eine ausführliche Erläuterung der Zertifizierungsstellenzertifikate in Azure IoT Hub finden Sie unter https://learn.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 PEM-Zertifikatdatei für zertifizierungsstellen in einen IoT-Hub hoch.

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

Lädt eine CER-Zertifikatdatei einer Zertifizierungsstelle 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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub certificate delete

Bearbeiten

Löscht ein Azure IoT Hub-Zertifikat.

Eine ausführliche Erläuterung der Zertifizierungsstellenzertifikate in Azure IoT Hub finden Sie unter https://learn.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

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

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub certificate generate-verification-code

Bearbeiten

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

Dieser Überprüfungscode wird verwendet, um den Besitznachweis für ein Zertifikat abzuschließen. Verwenden Sie diesen Überprüfungscode als CN eines neuen Zertifikats, das mit dem privaten Stammzertifikat signiert ist. Eine ausführliche Erläuterung der Zertifizierungsstellenzertifikate in Azure IoT Hub finden Sie unter https://learn.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

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

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub certificate list

Bearbeiten

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

Eine ausführliche Erläuterung der Zertifizierungsstellenzertifikate in Azure IoT Hub finden Sie unter https://learn.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Beispiele

Auflisten aller Zertifikate in MyIotHub

az iot hub certificate list --hub-name MyIotHub

Optionale Parameter

--hub-name

IoT Hub-Name.

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub certificate show

Bearbeiten

Zeigt Informationen zu einem bestimmten Azure IoT Hub-Zertifikat an.

Eine ausführliche Erläuterung der Zertifizierungsstellenzertifikate in Azure IoT Hub finden Sie unter https://learn.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

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

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub certificate update

Bearbeiten

Aktualisieren Sie ein Azure IoT Hub-Zertifikat.

Lädt ein neues Zertifikat hoch, um das vorhandene Zertifikat durch denselben Namen zu ersetzen. Eine ausführliche Erläuterung der Zertifizierungsstellenzertifikate in Azure IoT Hub finden Sie unter https://learn.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}]

Beispiele

Aktualisiert ein Zertifizierungsstellenzertifikat in einem IoT-Hub, indem eine neue PEM-Datei hochgeladen wird.

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

Aktualisiert ein Zertifizierungsstellenzertifikat in einem IoT-Hub, indem eine neue CER-Datei hochgeladen wird.

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

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verified -v

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

Zulässige Werte: false, true
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub certificate verify

Bearbeiten

Ü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 generate-verification-code abgerufen wird. Dies ist der letzte Schritt im Beweis des Besitzprozesses. Eine ausführliche Erläuterung der Zertifizierungsstellenzertifikate in Azure IoT Hub finden Sie unter https://learn.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

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

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.