az iot du device deployment
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 du device deployment commande. Apprenez-en davantage sur les extensions.
Gestion du déploiement d’appareils.
Les déploiements appliquent une mise à jour compatible souhaitée sur un groupe d’appareils cible distribuant la mise à jour entre les classes d’appareils au sein du groupe. La stratégie de restauration initiée par le cloud peut éventuellement être configurée.
Commandes
| Nom | Description | Type | État |
|---|---|---|---|
| az iot du device deployment cancel |
Annulez un déploiement d’un sous-groupe de classes d’appareils. |
Extension | GA |
| az iot du device deployment create |
Créez un déploiement pour un groupe d’appareils. Le déploiement sera multi-cast sur chaque sous-groupe de classes d’appareils au sein du groupe cible. |
Extension | GA |
| az iot du device deployment delete |
Supprimez un déploiement par groupe d’appareils ou sous-groupe de classes d’appareils. |
Extension | GA |
| az iot du device deployment list |
Répertorier les déploiements d’un groupe d’appareils ou d’un sous-groupe de classes d’appareils. |
Extension | GA |
| az iot du device deployment list-devices |
Répertorier les appareils d’un déploiement de sous-groupes de classes d’appareils, ainsi que leur état. Utile pour obtenir la liste des appareils ayant échoué. |
Extension | GA |
| az iot du device deployment retry |
Réessayez un déploiement de sous-groupe de classes d’appareils. |
Extension | GA |
| az iot du device deployment show |
Afficher un déploiement pour un groupe d’appareils ou un sous-groupe de classes d’appareils, y compris l’état qui détaille le nombre d’appareils dans le déploiement en cours, terminés ou ayant échoué. |
Extension | GA |
az iot du device deployment cancel
Annulez un déploiement d’un sous-groupe de classes d’appareils.
az iot du device deployment cancel --account
--cid --class-id
--deployment-id --did
--gid --group-id
--instance
[--resource-group]
Exemples
Annulez le déploiement du sous-groupe de classes d’appareils cible.
az iot du device deployment cancel -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}
Paramètres obligatoires
Nom du compte Device Update. Vous pouvez configurer le nom du compte par défaut à l’aide de az config set defaults.adu_account={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
ID de classe d’appareil. Cela est généré à partir de l’ID de modèle et des propriétés de compatibilité signalées par l’agent de mise à jour d’appareil dans l’interface PnP device Update dans IoT Hub. Il s’agit d’un hachage SHA1 codé en hexadécimal.
ID de déploiement fourni par l’appelant. Cela ne peut pas dépasser 73 caractères, doit être tout en minuscules et ne peut pas contenir &, , ^[], , {, , }, , |<>, barre oblique, barre oblique, barre oblique inverse ou guillemet double.
ID du groupe d’appareils. Cette opération est créée à partir de la valeur de la balise ADUGroup dans le jumeau d’appareil/module d’IoT Hub connecté ou $default pour les appareils sans balise.
Nom de l’instance Device Update. Vous pouvez configurer le nom d’instance par défaut à l’aide de az config set defaults.adu_instance={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
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.
Nom du groupe de ressources du compte Device Update. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.adu_group={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 du device deployment create
Créez un déploiement pour un groupe d’appareils. Le déploiement sera multi-cast sur chaque sous-groupe de classes d’appareils au sein du groupe cible.
az iot du device deployment create --account
--deployment-id --did
--gid --group-id
--instance
--un --update-name
--up --update-provider
--update-version --uv
[--failed-count --fc]
[--failed-percentage --fp]
[--rbun --rollback-update-name]
[--rbup --rollback-update-provider]
[--rbuv --rollback-update-version]
[--resource-group]
[--start-time]
Exemples
Créez un déploiement de groupe d’appareils planifié pour démarrer immédiatement (par rapport à l’heure UTC).
az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version}
Créez un déploiement de groupe d’appareils planifié pour démarrer sur une datetime conforme iso-8601 souhaitée.
az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --start-time "2022-12-20T01:00:00"
Créez un déploiement de groupe d’appareils planifié pour démarrer immédiatement avec une stratégie de restauration initiée par le cloud définie. La restauration cloud est lancée lorsque le nombre d’échecs ou les cibles de pourcentage ayant échoué sont remplies.
az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --failed-count 10 --failed-percentage 5 --rollback-update-name {rollback_update_name} --rollback-update-provider {rollback_update_provider} --rollback-update-version {rollback_update_version}
Paramètres obligatoires
Nom du compte Device Update. Vous pouvez configurer le nom du compte par défaut à l’aide de az config set defaults.adu_account={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
ID de déploiement fourni par l’appelant. Cela ne peut pas dépasser 73 caractères, doit être tout en minuscules et ne peut pas contenir &, , ^[], , {, , }, , |<>, barre oblique, barre oblique, barre oblique inverse ou guillemet double.
ID du groupe d’appareils. Cette opération est créée à partir de la valeur de la balise ADUGroup dans le jumeau d’appareil/module d’IoT Hub connecté ou $default pour les appareils sans balise.
Nom de l’instance Device Update. Vous pouvez configurer le nom d’instance par défaut à l’aide de az config set defaults.adu_instance={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
Nom de la mise à jour.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Update Id Arguments |
Fournisseur de mise à jour.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Update Id Arguments |
Version de mise à jour.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Update Id Arguments |
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.
Entier représentant le nombre d’appareils ayant échoué dans un déploiement avant qu’une restauration initée dans le cloud ne se produise. Obligatoire lors de la définition de la stratégie de restauration.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Update Rollback Policy Arguments |
Entier représentant le pourcentage d’appareils ayant échoué dans un déploiement avant qu’une restauration initée dans le cloud ne se produise. Obligatoire lors de la définition de la stratégie de restauration.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Update Rollback Policy Arguments |
Nom de la mise à jour de restauration.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Update Rollback Policy Arguments |
Fournisseur de mise à jour de restauration.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Update Rollback Policy Arguments |
Version de mise à jour de restauration.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Update Rollback Policy Arguments |
Nom du groupe de ressources du compte Device Update. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.adu_group={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
Heure de début conforme iso-8601 pour le déploiement. Si aucune valeur n’est fournie, la valeur correspondante pour UTC 'now' est utilisée.
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 du device deployment delete
Supprimez un déploiement par groupe d’appareils ou sous-groupe de classes d’appareils.
az iot du device deployment delete --account
--deployment-id --did
--gid --group-id
--instance
[--cid --class-id]
[--resource-group]
[--yes {false, true}]
Exemples
Supprimez le déploiement du groupe d’appareils cible.
az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id}
Supprimez le déploiement du sous-groupe de classes d’appareils cible.
az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}
Paramètres obligatoires
Nom du compte Device Update. Vous pouvez configurer le nom du compte par défaut à l’aide de az config set defaults.adu_account={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
ID de déploiement fourni par l’appelant. Cela ne peut pas dépasser 73 caractères, doit être tout en minuscules et ne peut pas contenir &, , ^[], , {, , }, , |<>, barre oblique, barre oblique, barre oblique inverse ou guillemet double.
ID du groupe d’appareils. Cette opération est créée à partir de la valeur de la balise ADUGroup dans le jumeau d’appareil/module d’IoT Hub connecté ou $default pour les appareils sans balise.
Nom de l’instance Device Update. Vous pouvez configurer le nom d’instance par défaut à l’aide de az config set defaults.adu_instance={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
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.
ID de classe d’appareil. Cela est généré à partir de l’ID de modèle et des propriétés de compatibilité signalées par l’agent de mise à jour d’appareil dans l’interface PnP device Update dans IoT Hub. Il s’agit d’un hachage SHA1 codé en hexadécimal.
Nom du groupe de ressources du compte Device Update. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.adu_group={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
Ignorez les invites de l’utilisateur. Indique l’acceptation de l’action. Utilisé principalement pour les scénarios d’automatisation. Valeur par défaut : false.
| Propriété | Valeur |
|---|---|
| Valeurs acceptées: | false, true |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 du device deployment list
Répertorier les déploiements d’un groupe d’appareils ou d’un sous-groupe de classes d’appareils.
az iot du device deployment list --account
--gid --group-id
--instance
[--cid --class-id]
[--order-by]
[--resource-group]
Exemples
Répertorier les déploiements d’un groupe d’appareils.
az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id}
Répertorier les déploiements d’un groupe d’appareils triant les résultats en décroissant startDateTime.
az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --order-by "startDateTime desc"
Répertorier les déploiements pour un sous-groupe de classes d’appareils.
az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id}
Paramètres obligatoires
Nom du compte Device Update. Vous pouvez configurer le nom du compte par défaut à l’aide de az config set defaults.adu_account={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
ID du groupe d’appareils. Cette opération est créée à partir de la valeur de la balise ADUGroup dans le jumeau d’appareil/module d’IoT Hub connecté ou $default pour les appareils sans balise.
Nom de l’instance Device Update. Vous pouvez configurer le nom d’instance par défaut à l’aide de az config set defaults.adu_instance={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
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.
ID de classe d’appareil. Cela est généré à partir de l’ID de modèle et des propriétés de compatibilité signalées par l’agent de mise à jour d’appareil dans l’interface PnP device Update dans IoT Hub. Il s’agit d’un hachage SHA1 codé en hexadécimal.
Commande l’ensemble des déploiements retournés. Vous pouvez commander par startDateTime [desc/asc].
Nom du groupe de ressources du compte Device Update. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.adu_group={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 du device deployment list-devices
Répertorier les appareils d’un déploiement de sous-groupes de classes d’appareils, ainsi que leur état. Utile pour obtenir la liste des appareils ayant échoué.
az iot du device deployment list-devices --account
--cid --class-id
--deployment-id --did
--gid --group-id
--instance
[--filter]
[--resource-group]
Exemples
Répertorier les appareils dans un déploiement de sous-groupes de classes d’appareils.
az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id}
Répertorier les appareils d’un sous-groupe de classe d’appareil filtrant le filtrage par deviceId et deviceState.
az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --filter "deviceId eq 'd0' and deviceState eq 'InProgress'"
Paramètres obligatoires
Nom du compte Device Update. Vous pouvez configurer le nom du compte par défaut à l’aide de az config set defaults.adu_account={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
ID de classe d’appareil. Cela est généré à partir de l’ID de modèle et des propriétés de compatibilité signalées par l’agent de mise à jour d’appareil dans l’interface PnP device Update dans IoT Hub. Il s’agit d’un hachage SHA1 codé en hexadécimal.
ID de déploiement fourni par l’appelant. Cela ne peut pas dépasser 73 caractères, doit être tout en minuscules et ne peut pas contenir &, , ^[], , {, , }, , |<>, barre oblique, barre oblique, barre oblique inverse ou guillemet double.
ID du groupe d’appareils. Cette opération est créée à partir de la valeur de la balise ADUGroup dans le jumeau d’appareil/module d’IoT Hub connecté ou $default pour les appareils sans balise.
Nom de l’instance Device Update. Vous pouvez configurer le nom d’instance par défaut à l’aide de az config set defaults.adu_instance={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
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.
Limite l’ensemble des états d’appareil de déploiement retournés. Vous pouvez filtrer sur deviceId et moduleId et/ou deviceState.
Nom du groupe de ressources du compte Device Update. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.adu_group={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 du device deployment retry
Réessayez un déploiement de sous-groupe de classes d’appareils.
az iot du device deployment retry --account
--cid --class-id
--deployment-id --did
--gid --group-id
--instance
[--resource-group]
Exemples
Réessayez le déploiement du sous-groupe de classes d’appareils cibles.
az iot du device deployment retry -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}
Paramètres obligatoires
Nom du compte Device Update. Vous pouvez configurer le nom du compte par défaut à l’aide de az config set defaults.adu_account={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
ID de classe d’appareil. Cela est généré à partir de l’ID de modèle et des propriétés de compatibilité signalées par l’agent de mise à jour d’appareil dans l’interface PnP device Update dans IoT Hub. Il s’agit d’un hachage SHA1 codé en hexadécimal.
ID de déploiement fourni par l’appelant. Cela ne peut pas dépasser 73 caractères, doit être tout en minuscules et ne peut pas contenir &, , ^[], , {, , }, , |<>, barre oblique, barre oblique, barre oblique inverse ou guillemet double.
ID du groupe d’appareils. Cette opération est créée à partir de la valeur de la balise ADUGroup dans le jumeau d’appareil/module d’IoT Hub connecté ou $default pour les appareils sans balise.
Nom de l’instance Device Update. Vous pouvez configurer le nom d’instance par défaut à l’aide de az config set defaults.adu_instance={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
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.
Nom du groupe de ressources du compte Device Update. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.adu_group={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 du device deployment show
Afficher un déploiement pour un groupe d’appareils ou un sous-groupe de classes d’appareils, y compris l’état qui détaille le nombre d’appareils dans le déploiement en cours, terminés ou ayant échoué.
az iot du device deployment show --account
--deployment-id --did
--gid --group-id
--instance
[--cid --class-id]
[--resource-group]
[--status {false, true}]
Exemples
Afficher un déploiement pour un groupe d’appareils.
az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id}
Afficher l’état d’un déploiement de groupe d’appareils.
az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --status
Afficher un déploiement pour un sous-groupe de classes d’appareils.
az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id}
Afficher l’état d’un déploiement de sous-groupes de classes d’appareils.
az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --status
Paramètres obligatoires
Nom du compte Device Update. Vous pouvez configurer le nom du compte par défaut à l’aide de az config set defaults.adu_account={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
ID de déploiement fourni par l’appelant. Cela ne peut pas dépasser 73 caractères, doit être tout en minuscules et ne peut pas contenir &, , ^[], , {, , }, , |<>, barre oblique, barre oblique, barre oblique inverse ou guillemet double.
ID du groupe d’appareils. Cette opération est créée à partir de la valeur de la balise ADUGroup dans le jumeau d’appareil/module d’IoT Hub connecté ou $default pour les appareils sans balise.
Nom de l’instance Device Update. Vous pouvez configurer le nom d’instance par défaut à l’aide de az config set defaults.adu_instance={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
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.
ID de classe d’appareil. Cela est généré à partir de l’ID de modèle et des propriétés de compatibilité signalées par l’agent de mise à jour d’appareil dans l’interface PnP device Update dans IoT Hub. Il s’agit d’un hachage SHA1 codé en hexadécimal.
Nom du groupe de ressources du compte Device Update. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.adu_group={name}.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Account Identifier Arguments |
Obtient l’état d’un déploiement, y compris la répartition du nombre d’appareils dans le déploiement en cours, terminés ou ayant échoué.
| Propriété | Valeur |
|---|---|
| Valeurs acceptées: | false, true |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 |