az iot hub device-identity

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). L’extension installe automatiquement la première fois que vous exécutez une az iot hub device-identity commande. Learn more about extensions.

Gérer les appareils IoT.

Commandes

Nom	Description	Type	État
az iot hub device-identity children	Gérez les relations des appareils enfants pour les appareils IoT Edge.	Extension	GA
az iot hub device-identity children add	Ajoutez des appareils en tant qu’enfants à un appareil de périphérie cible.	Extension	GA
az iot hub device-identity children list	Génère la collection d’appareils enfants affectés.	Extension	GA
az iot hub device-identity children remove	Supprimez les appareils enfants d’un appareil de périphérie cible.	Extension	GA
az iot hub device-identity connection-string	Gérez les chaîne de connexion de l’appareil IoT.	Extension	GA
az iot hub device-identity connection-string show	Afficher un appareil IoT Hub donné chaîne de connexion.	Extension	GA
az iot hub device-identity create	Créez un appareil dans un hub IoT.	Extension	GA
az iot hub device-identity delete	Supprimez un appareil IoT Hub.	Extension	GA
az iot hub device-identity export	Exportez toutes les identités d’appareil à partir d’un Hub IoT vers un conteneur d’objets blob Stockage Azure.	Extension	GA
az iot hub device-identity import	Importez des identités d’appareil dans un hub IoT à partir d’un objet blob de conteneur de stockage.	Extension	GA
az iot hub device-identity list	Répertorier les appareils dans un IoT Hub.	Extension	GA
az iot hub device-identity parent	Gérer les relations des appareils parents pour les appareils IoT.	Extension	GA
az iot hub device-identity parent set	Définissez l’appareil parent d’un appareil cible.	Extension	GA
az iot hub device-identity parent show	Obtenir l’appareil parent d’un appareil cible.	Extension	GA
az iot hub device-identity renew-key	Renouvelez les clés cibles des appareils IoT Hub avec l’authentification sas.	Extension	GA
az iot hub device-identity show	Obtenez les détails d’un appareil IoT Hub.	Extension	GA
az iot hub device-identity update	Mettez à jour un appareil IoT Hub.	Extension	GA

az iot hub device-identity create

Créez un appareil dans un hub IoT.

Lorsque vous utilisez la méthode d’authentification de shared_private_key (également appelées clés symétriques), si aucune clé personnalisée n’est fournie, le service les génère pour l’appareil.

Si une étendue d’appareil est fournie pour un appareil de périphérie, la valeur est automatiquement convertie en étendue parente.

az iot hub device-identity create --device-id
                                  [--am --auth-method {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--device-scope]
                                  [--edge-enabled --ee {false, true}]
                                  [--hub-name]
                                  [--login]
                                  [--od --output-dir]
                                  [--pk --primary-key]
                                  [--primary-thumbprint --ptp]
                                  [--resource-group]
                                  [--secondary-key --sk]
                                  [--secondary-thumbprint --stp]
                                  [--sta --status {disabled, enabled}]
                                  [--star --status-reason]
                                  [--valid-days --vd]

Exemples

Créez un appareil IoT avec edge avec l’autorisation par défaut (clé privée partagée).

az iot hub device-identity create -n {iothub_name} -d {device_id} --ee

Créez un appareil IoT avec une autorisation de certificat auto-signé, générez un certificat valide pendant 10 jours, puis utilisez son empreinte numérique.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --valid-days 10

Créez un appareil IoT avec une autorisation de certificat auto-signé, générez un certificat d’expiration par défaut (365 jours) et une sortie vers le répertoire cible.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --output-dir /path/to/output

Créez un appareil IoT avec une autorisation de certificat auto-signé et fournissez explicitement des empreintes numériques primaires et secondaires.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --ptp {thumbprint_1} --stp {thumbprint_2}

Créez un appareil IoT avec une autorisation d’autorité de certification racine avec l’état et la raison désactivés.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_ca --status disabled --status-reason 'for reasons'

Créez un appareil IoT avec une étendue d’appareil.

az iot hub device-identity create -n {iothub_name} -d {device_id} --device-scope 'ms-azure-iot-edge://edge0-123456789123456789'

Paramètres obligatoires

--device-id -d

ID d’appareil cible.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--am --auth-method

La méthode d’autorisation avec qui une entité doit être créée.

Propriété	Valeur
Valeur par défaut:	shared_private_key
Valeurs acceptées:	shared_private_key, x509_ca, x509_thumbprint

--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
Parameter group:	Access Control Arguments
Valeur par défaut:	key
Valeurs acceptées:	key, login

--device-scope

Portée de l’appareil. Pour les appareils de périphérie, il s’agit d’une génération automatique et immuable. Pour les appareils feuilles, définissez cette option pour créer une relation enfant/parent.

Propriété	Valeur
Parameter group:	Device Scope Arguments

--edge-enabled --ee

Indicateur indiquant l’activation de périphérie.

Propriété	Valeur
Valeur par défaut:	False
Valeurs acceptées:	false, true

--hub-name -n

Nom ou nom d’hôte IoT Hub. Obligatoire si --login n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier 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 --hub-name n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier Arguments

--od --output-dir

Générez un certificat auto-signé et utilisez son empreinte numérique. Sortie vers le répertoire cible spécifié.

Propriété	Valeur
Parameter group:	X.509 Arguments

--pk --primary-key

Clé d’accès partagé symétrique primaire stockée au format base64.

Propriété	Valeur
Parameter group:	Symmetric Key Arguments

--primary-thumbprint --ptp

Empreinte numérique du certificat auto-signé à utiliser pour l’empreinte numérique principale.

Propriété	Valeur
Parameter group:	X.509 Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--secondary-key --sk

Clé d’accès partagé symétrique secondaire stockée au format base64.

Propriété	Valeur
Parameter group:	Symmetric Key Arguments

--secondary-thumbprint --stp

Empreinte numérique du certificat auto-signé à utiliser pour l’empreinte numérique secondaire.

Propriété	Valeur
Parameter group:	X.509 Arguments

--sta --status

Définissez l’état de l’appareil lors de la création.

Propriété	Valeur
Valeur par défaut:	enabled
Valeurs acceptées:	disabled, enabled

--star --status-reason

Description de l’état de l’appareil.

--valid-days --vd

Générez un certificat auto-signé et utilisez son empreinte numérique. Valide pour le nombre de jours spécifié. Default: 365.

Propriété	Valeur
Parameter group:	X.509 Arguments

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

Output format.

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

az iot hub device-identity delete

Supprimez un appareil IoT Hub.

az iot hub device-identity delete --device-id
                                  [--auth-type {key, login}]
                                  [--etag]
                                  [--hub-name]
                                  [--login]
                                  [--resource-group]

Paramètres obligatoires

--device-id -d

ID d’appareil cible.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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
Parameter group:	Access Control Arguments
Valeur par défaut:	key
Valeurs acceptées:	key, login

--etag -e

Étiquette d’entité ou etag correspondant au dernier état de la ressource. Si aucun etag n’est fourni, la valeur '*' est utilisée.

--hub-name -n

Nom ou nom d’hôte IoT Hub. Obligatoire si --login n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier 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 --hub-name n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier Arguments

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

Output format.

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

az iot hub device-identity export

Exportez toutes les identités d’appareil à partir d’un Hub IoT vers un conteneur d’objets blob Stockage Azure.

L’objet blob de sortie contenant des identités d’appareil est un fichier texte nommé « devices.txt ».

Autorisations requises : la stratégie d’accès partagé IoT Hub prenant en charge « Registre en lecture et écriture du Registre » ou un principal avec le rôle « Contributeur de données IoT Hub » sur IoT Hub.

Le nom du compte de stockage et les paramètres de nom de conteneur d’objets blob ne peuvent être utilisés que lorsque le compte de stockage se trouve dans le même abonnement que l’IoT Hub d’entrée. Pour obtenir une entrée d’URI SAP du conteneur d’objets blob inline, consultez les règles d’entrée de votre environnement.

Pour plus d’informations, consultez https://aka.ms/iothub-device-exportimport.

az iot hub device-identity export [--auth-type {key, login}]
                                  [--bc --blob-container]
                                  [--bcu --blob-container-uri]
                                  [--hub-name]
                                  [--identity]
                                  [--ik --include-keys {false, true}]
                                  [--login]
                                  [--resource-group]
                                  [--sa --storage-account]

Exemples

Exportez toutes les identités d’appareil vers un conteneur d’objets blob configuré et incluez des clés d’appareil. Le nom du conteneur d’objets blob et le nom du compte de stockage sont fournis en tant que paramètres de la commande.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name}

Exportez toutes les identités d’appareil vers un conteneur d’objets blob configuré et incluez des clés d’appareil. Utilise un exemple d’URI SAS inline.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices?sv=2019-02-02&st=2020-08-23T22%3A35%3A00Z&se=2020-08-24T22%3A35%3A00Z&sr=c&sp=rwd&sig=VrmJ5sQtW3kLzYg10VqmALGCp4vtYKSLNjZDDJBSh9s%3D'

Exportez toutes les identités d’appareil vers un conteneur d’objets blob configuré à l’aide d’un chemin d’accès de fichier qui contient l’URI SAP.

az iot hub device-identity export -n {iothub_name} --bcu {sas_uri_filepath}

Exportez toutes les identités d’appareil vers un conteneur d’objets blob configuré et incluez des clés d’appareil. Utilise l’identité affectée par le système qui a des rôles Contributeur aux données Blob de stockage pour le compte de stockage. Le nom du conteneur d’objets blob et le nom du compte de stockage sont fournis en tant que paramètres de la commande.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity [system]

Exportez toutes les identités d’appareil vers un conteneur d’objets blob configuré et incluez des clés d’appareil. Utilise l’identité affectée par le système qui a des rôles Contributeur aux données Blob de stockage pour le compte de stockage. L’URI du conteneur d’objets blob n’a pas besoin du jeton SAP d’objet blob.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --identity [system]

Exportez toutes les identités d’appareil vers un conteneur d’objets blob configuré et incluez des clés d’appareil. Utilise l’identité managée affectée par l’utilisateur qui a le rôle Contributeur aux données Blob de stockage pour le compte de stockage. Le nom du conteneur d’objets blob et le nom du compte de stockage sont fournis en tant que paramètres de la commande.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity {managed_identity_resource_id}

Exportez toutes les identités d’appareil vers un conteneur d’objets blob configuré et incluez des clés d’appareil. Utilise l’identité managée affectée par l’utilisateur qui a le rôle Contributeur aux données Blob de stockage pour le compte de stockage. L’URI du conteneur d’objets blob n’a pas besoin du jeton SAP d’objet blob.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --identity {managed_identity_resource_id}

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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
Parameter group:	Access Control Arguments
Valeur par défaut:	key
Valeurs acceptées:	key, login

--bc --blob-container

Ce conteneur d’objets blob est utilisé pour générer l’état du travail d’importation de l’identité de l’appareil et les résultats. Le paramètre est ignoré lorsque blob_container_uri est fourni. L’accès en écriture, lecture et suppression est requis pour ce conteneur d’objets blob.

--bcu --blob-container-uri

URI de signature d’accès partagé d’objet blob avec un accès en écriture, en lecture et suppression à un conteneur d’objets blob. Il est utilisé pour générer l’état du travail et les résultats. Remarque : lors de l’utilisation de l’authentification basée sur l’identité, un URI https:// est toujours nécessaire, mais aucun jeton SAP n’est nécessaire. L’entrée de cet argument peut être inline ou à partir d’un chemin d’accès au fichier.

--hub-name -n

Nom ou nom d’hôte IoT Hub. Obligatoire si --login n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier Arguments

--identity

Type d’identité managée pour déterminer si l’identité managée affectée par le système ou l’identité managée affectée par l’utilisateur est utilisée. Pour l’identité managée affectée par le système, utilisez [système]. Pour l’identité managée affectée par l’utilisateur, fournissez l’ID de ressource d’identité managée affectée par l’utilisateur. Cette identité nécessite des rôles Contributeur aux données Blob de stockage pour le compte de stockage.

--ik --include-keys

Si elles sont définies, les clés sont exportées normalement. Sinon, les clés sont définies sur Null dans la sortie d’exportation.

Propriété	Valeur
Valeur par défaut:	False
Valeurs acceptées:	false, true

--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 --hub-name n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--sa --storage-account

Nom du compte stockage Azure contenant le conteneur d’objets blob de sortie. Le paramètre est ignoré lorsque blob_container_uri est fourni. L’accès en écriture, lecture et suppression est requis.

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

Output format.

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

az iot hub device-identity import

Importez des identités d’appareil dans un hub IoT à partir d’un objet blob de conteneur de stockage.

Le fichier d’entrée attendu contenant des identités d’appareil doit être nommé « devices.txt ». Le fichier journal de sortie « importErrors.log » est vide lorsque l’importation réussit et contient des journaux d’erreurs en cas d’échec de l’importation.

Autorisations requises : la stratégie d’accès partagé IoT Hub prenant en charge « Registre en lecture et écriture du Registre » ou un principal avec le rôle « Contributeur de données IoT Hub » sur IoT Hub.

Le nom du compte de stockage et les paramètres de nom de conteneur d’objets blob ne peuvent être utilisés que lorsque le compte de stockage se trouve dans le même abonnement que l’IoT Hub d’entrée. Pour obtenir une entrée d’URI SAP du conteneur d’objets blob inline, consultez les règles d’entrée de votre environnement.

Pour plus d’informations, consultez https://aka.ms/iothub-device-exportimport.

az iot hub device-identity import [--auth-type {key, login}]
                                  [--hub-name]
                                  [--ibc --input-blob-container]
                                  [--ibcu --input-blob-container-uri]
                                  [--identity]
                                  [--input-storage-account --isa]
                                  [--login]
                                  [--obc --output-blob-container]
                                  [--obcu --output-blob-container-uri]
                                  [--osa --output-storage-account]
                                  [--resource-group]

Exemples

Importez toutes les identités d’appareil à partir d’un objet blob en fournissant des paramètres de commande pour le conteneur d’objets blob d’entrée et le compte de stockage, ainsi que le conteneur d’objets blob de sortie et le compte de stockage.

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name}

Importez toutes les identités d’appareil à partir d’un objet blob à l’aide d’un URI SAS inline.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri}

Importez toutes les identités d’appareil à partir d’un objet blob à l’aide d’un chemin d’accès de fichier qui contient l’URI SAP.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri_filepath} --obcu {output_sas_uri_filepath}

Importez toutes les identités d’appareil à partir d’un objet blob à l’aide d’une identité affectée par le système qui a des rôles Contributeur aux données Blob de stockage pour les deux comptes de stockage. Le conteneur d’objets blob d’entrée et le compte de stockage ainsi que le conteneur d’objets blob de sortie et le compte de stockage sont fournis en tant que paramètres pour la commande

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name} --identity [system]

Importez toutes les identités d’appareil à partir d’un objet blob à l’aide d’une identité affectée par le système qui a des rôles Contributeur aux données Blob de stockage pour les deux comptes de stockage. L’URI du conteneur d’objets blob n’a pas besoin du jeton SAP d’objet blob.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --identity [system]

Importez toutes les identités d’appareil à partir d’un objet blob à l’aide d’une identité managée affectée par l’utilisateur qui a des rôles Contributeur aux données Blob de stockage pour les deux comptes de stockage. Le conteneur d’objets blob d’entrée et le compte de stockage ainsi que le conteneur d’objets blob de sortie et le compte de stockage sont fournis en tant que paramètres pour la commande

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name} --identity {managed_identity_resource_id}

Importez toutes les identités d’appareil à partir d’un objet blob à l’aide d’une identité managée affectée par l’utilisateur qui a des rôles Contributeur aux données Blob de stockage pour les deux comptes de stockage. L’URI du conteneur d’objets blob n’a pas besoin du jeton SAP d’objet blob.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --identity {managed_identity_resource_id}

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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
Parameter group:	Access Control Arguments
Valeur par défaut:	key
Valeurs acceptées:	key, login

--hub-name -n

Nom ou nom d’hôte IoT Hub. Obligatoire si --login n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier Arguments

--ibc --input-blob-container

Ce conteneur d’objets blob stocke le fichier qui définit les opérations à effectuer sur le registre d’identités. Le paramètre est ignoré lorsque input_blob_container_uri est fourni. L’accès en lecture est requis pour ce conteneur d’objets blob.

--ibcu --input-blob-container-uri

URI de signature d’accès partagé d’objet blob avec accès en lecture à un conteneur d’objets blob. Cet objet blob contient les opérations à effectuer sur le registre d’identités. Remarque : lors de l’utilisation de l’authentification basée sur l’identité, un URI https:// est toujours nécessaire, mais aucun jeton SAP n’est nécessaire. L’entrée de cet argument peut être inline ou à partir d’un chemin d’accès au fichier.

--identity

Type d’identité managée pour déterminer si l’identité managée affectée par le système ou l’identité managée affectée par l’utilisateur est utilisée. Pour l’identité managée affectée par le système, utilisez [système]. Pour l’identité managée affectée par l’utilisateur, fournissez l’ID de ressource d’identité managée affectée par l’utilisateur. Cette identité nécessite un rôle Contributeur aux données Blob de stockage pour le compte de stockage cible et le rôle Contributeur pour IoT Hub.

--input-storage-account --isa

Nom du compte stockage Azure contenant le conteneur d’objets blob d’entrée. Obligatoire uniquement lorsque input_blob_container_uri n’est pas fourni. L’accès en lecture est requis.

--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 --hub-name n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier Arguments

--obc --output-blob-container

Ce conteneur d’objets blob est utilisé pour générer l’état du travail d’importation de l’identité de l’appareil et les résultats. Obligatoire uniquement lorsque input_blob_container_uri n’est pas fourni. L’accès en écriture est requis pour ce conteneur d’objets blob.

--obcu --output-blob-container-uri

URI de signature d’accès partagé d’objet blob avec accès en écriture à un conteneur d’objets blob. Il est utilisé pour générer l’état du travail et les résultats. Remarque : lors de l’utilisation de l’authentification basée sur l’identité, un URI https:// sans le jeton SAP est toujours requis. L’entrée de cet argument peut être inline ou à partir d’un chemin d’accès au fichier.

--osa --output-storage-account

Nom du compte stockage Azure contenant le conteneur d’objets blob de sortie. Le paramètre est ignoré lorsque output_blob_container_uri est fourni. L’accès en écriture est requis.

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

Output format.

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

az iot hub device-identity list

Répertorier les appareils dans un IoT Hub.

Cette commande est un alias pour az iot hub device-twin list, qui est fortement recommandé sur cette commande. À l’avenir, cette az iot hub device-identity list commande peut être modifiée ou déconseillée.

az iot hub device-identity list [--auth-type {key, login}]
                                [--edge-enabled --ee {false, true}]
                                [--hub-name]
                                [--login]
                                [--resource-group]
                                [--top]

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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
Parameter group:	Access Control Arguments
Valeur par défaut:	key
Valeurs acceptées:	key, login

--edge-enabled --ee

Indicateur indiquant l’activation de périphérie.

Propriété	Valeur
Valeur par défaut:	False
Valeurs acceptées:	false, true

--hub-name -n

Nom ou nom d’hôte IoT Hub. Obligatoire si --login n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier 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 --hub-name n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--top

Nombre maximal d’éléments à retourner. Utilisez -1 pour un nombre illimité.

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

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

Output format.

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

az iot hub device-identity renew-key

Renouvelez les clés cibles des appareils IoT Hub avec l’authentification sas.

Actuellement, les etags et le type swap de clé ne sont pas pris en charge pour la régénération des clés en bloc. La régénération de la clé en bloc aura un format de sortie différent de la régénération de clé d’appareil unique.

az iot hub device-identity renew-key --device-id
                                     --hub-name
                                     --key-type --kt {both, primary, secondary, swap}
                                     [--auth-type {key, login}]
                                     [--etag]
                                     [--im --include-modules {false, true}]
                                     [--login]
                                     [--no-progress {false, true}]
                                     [--resource-group]

Exemples

Renouvelez la clé primaire.

az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt primary

Échangez les clés primaires et secondaires.

az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt swap

Renouvelez la clé secondaire pour deux appareils et leurs modules.

az iot hub device-identity renew-key -d {device_id} {device_id} -n {iothub_name} --kt secondary --include-modules

Renouvelez les deux clés pour tous les appareils au sein du hub.

az iot hub device-identity renew-key -d * -n {iothub_name} --kt both

Paramètres obligatoires

--device-id -d

Liste d’id d’appareil cible séparée par espace. Utilisez * pour tous les appareils.

--hub-name -n

Nom ou nom d’hôte IoT Hub. Obligatoire si --login n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier Arguments

--key-type --kt

Type de clé cible à régénérer.

Propriété	Valeur
Valeurs acceptées:	both, primary, secondary, swap

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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
Parameter group:	Access Control Arguments
Valeur par défaut:	key
Valeurs acceptées:	key, login

--etag -e

Étiquette d’entité ou etag correspondant au dernier état de la ressource. Si aucun etag n’est fourni, la valeur '*' est utilisée. Cet argument s’applique uniquement à swap.

--im --include-modules

Indicateur pour inclure des modules d’appareil pendant la régénération des clés.

Propriété	Valeur
Valeur par défaut:	False
Valeurs acceptées:	false, true

--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 --hub-name n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier Arguments

--no-progress

Masquez la barre de progression pour la régénération des clés en bloc.

Propriété	Valeur
Valeur par défaut:	False
Valeurs acceptées:	false, true

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

Output format.

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

az iot hub device-identity show

Obtenez les détails d’un appareil IoT Hub.

az iot hub device-identity show --device-id
                                [--auth-type {key, login}]
                                [--hub-name]
                                [--login]
                                [--resource-group]

Paramètres obligatoires

--device-id -d

ID d’appareil cible.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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
Parameter group:	Access Control Arguments
Valeur par défaut:	key
Valeurs acceptées:	key, login

--hub-name -n

Nom ou nom d’hôte IoT Hub. Obligatoire si --login n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier 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 --hub-name n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier Arguments

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

Output format.

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

az iot hub device-identity update

Mettez à jour un appareil IoT Hub.

Utilisez --set suivi des affectations de propriétés pour la mise à jour d’un appareil. Tirez parti des paramètres retournés par « iot hub device-identity show ».

az iot hub device-identity update --device-id
                                  [--add]
                                  [--am --auth-method {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--edge-enabled --ee {false, true}]
                                  [--etag]
                                  [--force-string]
                                  [--hub-name]
                                  [--login]
                                  [--pk --primary-key]
                                  [--primary-thumbprint --ptp]
                                  [--remove]
                                  [--resource-group]
                                  [--secondary-key --sk]
                                  [--secondary-thumbprint --stp]
                                  [--set]
                                  [--sta --status {disabled, enabled}]
                                  [--star --status-reason]

Exemples

Activer les fonctionnalités de périphérie pour l’appareil

az iot hub device-identity update -d {device_id} -n {iothub_name} --set capabilities.iotEdge=true

Activez les fonctionnalités de périphérie pour l’appareil à l’aide d’un argument pratique.

az iot hub device-identity update -d {device_id} -n {iothub_name} --ee

Désactiver l’état de l’appareil

az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled

Désactivez l’état de l’appareil à l’aide de l’argument pratique.

az iot hub device-identity update -d {device_id} -n {iothub_name} --status disabled

Dans une commande

az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled capabilities.iotEdge=true

Paramètres obligatoires

--device-id -d

ID d’appareil cible.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

Propriété	Valeur
Parameter group:	Generic Update Arguments
Valeur par défaut:	[]

--am --auth-method

La méthode d’autorisation avec qui une entité doit être créée.

Propriété	Valeur
Valeurs acceptées:	shared_private_key, x509_ca, x509_thumbprint

--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
Parameter group:	Access Control Arguments
Valeur par défaut:	key
Valeurs acceptées:	key, login

--edge-enabled --ee

Indicateur indiquant l’activation de périphérie.

Propriété	Valeur
Valeurs acceptées:	false, true

--etag -e

Étiquette d’entité ou etag correspondant au dernier état de la ressource. Si aucun etag n’est fourni, la valeur '*' est utilisée.

--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

Propriété	Valeur
Parameter group:	Generic Update Arguments
Valeur par défaut:	False

--hub-name -n

Nom ou nom d’hôte IoT Hub. Obligatoire si --login n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier 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 --hub-name n’est pas fourni.

Propriété	Valeur
Parameter group:	IoT Hub Identifier Arguments

--pk --primary-key

Clé d’accès partagé symétrique primaire stockée au format base64.

Propriété	Valeur
Parameter group:	Symmetric Key Arguments

--primary-thumbprint --ptp

Empreinte numérique du certificat auto-signé à utiliser pour l’empreinte numérique principale.

Propriété	Valeur
Parameter group:	X.509 Arguments

--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriété	Valeur
Parameter group:	Generic Update Arguments
Valeur par défaut:	[]

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--secondary-key --sk

Clé d’accès partagé symétrique secondaire stockée au format base64.

Propriété	Valeur
Parameter group:	Symmetric Key Arguments

--secondary-thumbprint --stp

Empreinte numérique du certificat auto-signé à utiliser pour l’empreinte numérique secondaire.

Propriété	Valeur
Parameter group:	X.509 Arguments

--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

Propriété	Valeur
Parameter group:	Generic Update Arguments
Valeur par défaut:	[]

--sta --status

Définissez l’état de l’appareil lors de la création.

Propriété	Valeur
Valeurs acceptées:	disabled, enabled

--star --status-reason

Description de l’état de l’appareil.

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

Output format.

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