az iot hub certificate

  • Référence

Remarque

Ce groupe de commandes a des commandes définies dans Azure CLI et au moins une extension. Installez chaque extension pour bénéficier de ses fonctionnalités étendues. En savoir plus sur les extensions.

Gérer les certificats d’IoT Hub.

Commandes

Nom Description Type Statut
az iot hub certificate create

Créez/chargez un certificat Azure IoT Hub.

 Core GA
az iot hub certificate delete

Supprime un certificat Azure IoT Hub.

 Core GA
az iot hub certificate generate-verification-code

Génère un code de vérification pour un certificat Azure IoT Hub.

 Core GA
az iot hub certificate list

Répertorie tous les certificats contenus dans un hub Azure IoT.

 Core GA
az iot hub certificate root-authority

Gérez l’autorité racine du certificat pour une instance IoT Hub.

 Extension Déprécié
az iot hub certificate root-authority set

Définissez l’autorité racine du certificat pour une instance IoT Hub sur une version spécifique.

 Extension Déprécié
az iot hub certificate root-authority show

Afficher l’autorité racine de certificat actuelle pour une instance IoT Hub.

 Extension Déprécié
az iot hub certificate show

Affiche des informations sur un certificat Azure IoT Hub particulier.

 Core GA
az iot hub certificate update

Mettez à jour un certificat Azure IoT Hub.

 Core GA
az iot hub certificate verify

Vérifie un certificat Azure IoT Hub.

 Core GA

az iot hub certificate create

Modifier

Créez/chargez un certificat Azure IoT Hub.

Pour obtenir une explication détaillée des certificats d’autorité de certification dans Azure IoT Hub, consultez 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}]

Exemples

Charge un fichier PEM de certificat d’autorité de certification vérifié sur un hub IoT.

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

Charge un fichier CER de certificat d’autorité de certification dans un hub IoT.

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

Créer/charger un certificat Azure IoT Hub (généré automatiquement)

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

Paramètres obligatoires

--hub-name

Nom d’IoT Hub.

--name -n

Nom convivial du certificat.

--path -p

Chemin d’accès au fichier contenant le certificat.

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--verified -v

Valeur booléenne indiquant si le certificat est vérifié ou non.

valeurs acceptées: false, true
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot hub certificate delete

Modifier

Supprime un certificat Azure IoT Hub.

Pour obtenir une explication détaillée des certificats d’autorité de certification dans Azure IoT Hub, consultez https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Exemples

Supprime MyCertificate

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

Paramètres obligatoires

--etag -e

Entity Tag (etag) de l’objet.

--name -n

Nom convivial du certificat.

Paramètres facultatifs

--hub-name

Nom d’IoT Hub.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot hub certificate generate-verification-code

Modifier

Génère un code de vérification pour un certificat Azure IoT Hub.

Ce code de vérification est utilisé pour effectuer la preuve de possession d’un certificat. Utilisez ce code de vérification comme CN d’un nouveau certificat signé avec la clé privée des certificats racines. Pour obtenir une explication détaillée des certificats d’autorité de certification dans Azure IoT Hub, consultez 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]

Exemples

Génère un code de vérification pour MyCertificate

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

Génère un code de vérification pour un certificat Azure IoT Hub (généré automatiquement)

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

Paramètres obligatoires

--etag -e

Entity Tag (etag) de l’objet.

--name -n

Nom convivial du certificat.

Paramètres facultatifs

--hub-name

Nom d’IoT Hub.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot hub certificate list

Modifier

Répertorie tous les certificats contenus dans un hub Azure IoT.

Pour obtenir une explication détaillée des certificats d’autorité de certification dans Azure IoT Hub, consultez https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Exemples

Répertorier tous les certificats dans MyIotHub

az iot hub certificate list --hub-name MyIotHub

Paramètres facultatifs

--hub-name

Nom d’IoT Hub.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot hub certificate show

Modifier

Affiche des informations sur un certificat Azure IoT Hub particulier.

Pour obtenir une explication détaillée des certificats d’autorité de certification dans Azure IoT Hub, consultez https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Exemples

Afficher des détails sur MyCertificate

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

Affiche des informations sur un certificat Azure IoT Hub particulier (généré automatiquement)

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

Paramètres obligatoires

--name -n

Nom convivial du certificat.

Paramètres facultatifs

--hub-name

Nom d’IoT Hub.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot hub certificate update

Modifier

Mettez à jour un certificat Azure IoT Hub.

Charge un nouveau certificat pour remplacer le certificat existant par le même nom. Pour obtenir une explication détaillée des certificats d’autorité de certification dans Azure IoT Hub, consultez 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}]

Exemples

Mises à jour un certificat d’autorité de certification dans un hub IoT en chargeant un nouveau fichier PEM.

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

Mises à jour un certificat d’autorité de certification dans un hub IoT en chargeant un nouveau fichier CER.

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

Paramètres obligatoires

--etag -e

Entity Tag (etag) de l’objet.

--name -n

Nom convivial du certificat.

--path -p

Chemin d’accès au fichier contenant le certificat.

Paramètres facultatifs

--hub-name

Nom d’IoT Hub.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verified -v

Valeur booléenne indiquant si le certificat est vérifié ou non.

valeurs acceptées: false, true
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot hub certificate verify

Modifier

Vérifie un certificat Azure IoT Hub.

Vérifie un certificat en chargeant un certificat de vérification contenant le code de vérification obtenu en appelant generate-verification-code. Il s’agit de la dernière étape du processus de preuve de possession. Pour obtenir une explication détaillée des certificats d’autorité de certification dans Azure IoT Hub, consultez 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]

Exemples

Vérifie la propriété de la clé privée MyCertificate.

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

Vérifie un certificat Azure IoT Hub (généré automatiquement)

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

Paramètres obligatoires

--etag -e

Entity Tag (etag) de l’objet.

--name -n

Nom convivial du certificat.

--path -p

Chemin d’accès au fichier contenant le certificat.

Paramètres facultatifs

--hub-name

Nom d’IoT Hub.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.