az iot device registration

Préversion

Note

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

Ce groupe de commandes est en préversion et en cours de développement. Niveaux de référence et 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	Preview

az iot device registration create

Préversion

Le groupe de commandes « iot device registration » est en préversion et en cours de développement. Niveaux de référence et 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 --rid
                                  [--auth-type {key, login}]
                                  [--certificate-file-path --cp]
                                  [--ck --compute-key]
                                  [--dps-name]
                                  [--enrollment-group-id --gid --group-id]
                                  [--host --provisioning-host]
                                  [--id-scope --scope]
                                  [--key --symmetric-key]
                                  [--key-file-path --kp]
                                  [--login]
                                  [--pass --passphrase]
                                  [--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

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--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 .

Propriété	Valeur
Groupe de paramètres:	Access Control Arguments
Valeur par défaut:	key
Valeurs acceptées:	key, login

--certificate-file-path --cp

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

Propriété	Valeur
Groupe de paramètres:	x509 Authentication Arguments

--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.

Propriété	Valeur
Groupe de paramètres:	Symmetric Key Authentication Arguments
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.

Propriété	Valeur
Groupe de paramètres:	DPS Identifier Arguments

--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.

Propriété	Valeur
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.

Propriété	Valeur
Groupe de paramètres:	DPS Identifier Arguments

--key --symmetric-key

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

Propriété	Valeur
Groupe de paramètres:	Symmetric Key Authentication Arguments

--key-file-path --kp

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

Propriété	Valeur
Groupe de paramètres:	x509 Authentication Arguments

--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.

Propriété	Valeur
Groupe de paramètres:	DPS Identifier Arguments

--pass --passphrase

Phrase secrète pour le certificat.

Propriété	Valeur
Groupe de paramètres:	x509 Authentication Arguments

--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 à l’aide de az configure --defaults group=<name>.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

Commentaires

Cette page a-t-elle été utile ?