az iot device registration

Préversion
Référence

Remarque

Cette référence fait partie de l’extension azure-iot pour Azure CLI (version 2.46.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az iot device registration . En savoir plus sur les extensions.

Ce groupe de commandes est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Gérez les inscriptions d’appareils IoT pour le service IoT Device Provisioning.

Utilisez az iot dps enrollment registration ou az iot dps enrollment-group registration supprimez des inscriptions.

Commandes

Nom	Description	Type	État
az iot device registration create	Inscrivez un appareil IoT auprès du service IoT Device Provisioning.	Extension	Aperçu

az iot device registration create

Préversion

Le groupe de commandes « iot device registration » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Inscrivez un appareil IoT auprès du service IoT Device Provisioning.

Les mécanismes d’attestation suivants sont pris en charge :

Clé symétrique
Certificat x509 Si vous utilisez des méthodes d’authentification x509, les fichiers de certificat et de clé (et phrase secrète si nécessaire) doivent être fournis.

az iot device registration create --registration-id
                                  [--auth-type {key, login}]
                                  [--certificate-file-path]
                                  [--ck]
                                  [--dps-name]
                                  [--enrollment-group-id]
                                  [--host]
                                  [--id-scope]
                                  [--key]
                                  [--key-file-path]
                                  [--login]
                                  [--pass]
                                  [--payload]
                                  [--resource-group]

Exemples

Inscrivez un appareil IoT à l’aide d’une inscription individuelle.

az iot device registration create -n {dps_name} --rid {registration_id}

Inscrivez un appareil IoT à l’aide d’une inscription de groupe.

az iot device registration create -n {dps_name} --rid {registration_id} --gid {group_enrollment_id}

Inscrivez un appareil IoT à l’aide d’une inscription individuelle, de l’étendue de l’ID de service Device Provisioning et d’une clé symétrique donnée. Cela contournera la récupération de l’étendue d’ID et de la clé symétrique d’inscription individal.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --key {symmetric_key}

Inscrivez un appareil IoT à l’aide d’une inscription de groupe, de l’étendue de l’ID de service Device Provisioning et d’une clé symétrique de groupe d’inscription donnée. Cela contournera la récupération de l’étendue d’ID et de la clé symétrique du groupe d’inscriptions. La clé symétrique utilisée pour l’inscription de l’appareil sera calculée à partir de la clé symétrique donnée.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --gid {group_enrollment_id} --key {symmetric_key} --ck

Inscrivez un appareil IoT à l’aide d’une inscription de groupe, de l’étendue de l’ID de service Device Provisioning et d’une clé symétrique donnée. Cela contournera la récupération de l’étendue d’ID. Notez que, étant donné que la clé symétrique doit être la clé d’appareil calculée, l’ID de groupe d’inscription n’est pas nécessaire.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --key {symmetric_key}

Inscrivez un appareil IoT à l’aide d’une inscription individuelle, de l’étendue de l’ID de service Device Provisioning et des fichiers de certificat et de clé donnés. Cela contournera la récupération de l’étendue d’ID.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file}

Inscrivez un appareil IoT à l’aide d’une inscription individuelle, de l’étendue de l’ID de service Device Provisioning, ainsi que des fichiers de certificat et de clé et d’une phrase secrète pour le fichier de clé. Cela contournera la récupération de l’étendue d’ID.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file} --pass {passphrase}

Inscrivez un appareil IoT à l’aide d’une inscription de groupe, de l’étendue de l’ID de service Device Provisioning et des fichiers de certificat et de clé donnés. Cela contournera la récupération de l’étendue d’ID. Notez que l’ID d’inscription de groupe n’est pas nécessaire pour les attestations x509 et que l’objet du fichier de certificat est l’ID d’inscription.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file}

Paramètres obligatoires

--registration-id --rid

ID d’inscription d’appareil ou ID d’inscription individuel.

Paramètres facultatifs

--auth-type

Indique si l’opération doit dériver automatiquement une clé de stratégie ou utiliser la session Azure AD actuelle. Si le type d’authentification est login et que le nom d’hôte de ressource est fourni, la recherche de ressources est ignorée, sauf si nécessaire. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults iothub-data-auth-type=<auth-type-value>de .

Valeurs acceptées: key, login

Valeur par défaut: key

--certificate-file-path --cp

Chemin d’accès au fichier PEM de certificat. Obligatoire pour les inscriptions x509.

--ck --compute-key

Indicateur indiquant que la clé symétrique pour l’inscription de l’appareil doit être calculée à partir de la clé donnée avec --symmetric-key.

Valeur par défaut: False

--dps-name -n

Nom du service Azure IoT Hub Device Provisioning. Obligatoire si --login n’est pas fourni ou si les arguments authenticaton et --id-scope ne sont pas fournis.

--enrollment-group-id --gid --group-id

ID de groupe d’inscription. Nécessaire uniquement pour récupérer les arguments d’authentification.

--host --provisioning-host

Point de terminaison pointant vers l’hôte d’approvisionnement à utiliser.

Valeur par défaut: global.azure-devices-provisioning.net

--id-scope --scope

Étendue d’ID du service Azure IoT Hub Device Provisioning. Si vous avez fourni des arguments d’authentification, évitez la connexion de session.

--key --symmetric-key

Clé d’accès partagé symétrique pour l’inscription de l’appareil.

--key-file-path --kp

Chemin d’accès au fichier PEM de clé. Obligatoire pour les inscriptions x509.

--login -l

Cette commande prend en charge une entité chaîne de connexion avec des droits d’exécution d’action. Permet d’éviter la connexion de session via « az login ». Si une entité chaîne de connexion et un nom sont fournis, le chaîne de connexion a la priorité. Obligatoire si --dps-name n’est pas fourni ou si les arguments authenticaton et --id-scope ne sont pas fournis.

--pass --passphrase

Phrase secrète pour le certificat.

--payload

Charge utile d’allocation personnalisée en tant que JSON. Spécifiquement pour une utilisation avec des stratégies d’allocation personnalisées à l’aide d’Azure Functions.

--resource-group -g

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

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.

Partager via