az iot du device group

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 groupe d’appareils commande. Apprenez-en davantage sur les extensions.

Gestion des groupes d’appareils.

Un groupe d’appareils est une collection d’appareils. Les groupes d’appareils permettent de mettre à l’échelle des déploiements sur de nombreux appareils. Chaque appareil appartient à un seul groupe d’appareils à la fois. Un groupe d’appareils est créé automatiquement lorsqu’un appareil avec Device Update est connecté au hub et signale ses propriétés.

Commandes

Nom	Description	Type	État
az iot du device group delete	Supprimez un groupe d’appareils.	Extension	GA
az iot du device group list	Répertorier les groupes d’appareils au sein d’une instance.	Extension	GA
az iot du device group show	Affichez des détails sur un groupe d’appareils, y compris la meilleure mise à jour et la conformité des mises à jour.	Extension	GA

az iot du device group delete

Supprimez un groupe d’appareils.

Les groupes d’appareils ne sont pas automatiquement nettoyés, mais sont conservés à des fins d’historique. Cette opération peut être utilisée s’il n’est pas nécessaire pour le groupe ou de conserver l’historique pour celui-ci. Si un appareil est connecté à nouveau pour un groupe après la suppression du groupe, il est automatiquement recréé sans historique.

az iot du device group delete --account
                              --gid --group-id
                              --instance
                              [--resource-group]
                              [--yes {false, true}]

Exemples

Supprimez un groupe d’appareils.

az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id}

Supprimez un groupe d’appareils en ignorant l’invite de confirmation.

az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id} -y

Paramètres obligatoires

--account -n

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

--gid --group-id

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.

--instance -i

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.

--resource-group -g

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

--yes -y

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

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

az iot du device group list

Répertorier les groupes d’appareils au sein d’une instance.

az iot du device group list --account
                            --instance
                            [--order-by]
                            [--resource-group]

Exemples

Répertorier les groupes d’appareils.

az iot du device group list -n {account_name} -i {instance_name}

Répertoriez les groupes d’appareils dans un ordre souhaité, dans ce cas par deviceCount.

az iot du device group list -n {account_name} -i {instance_name} --order-by deviceCount

Paramètres obligatoires

--account -n

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

--instance -i

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.

--order-by

Commande l’ensemble de groupes retournés. Vous pouvez commander par groupId, deviceCount, createdDateTime, sous-groupesWithNewUpdatesAvailableCount, sous-groupesWithUpdatesInProgressCount ou sous-groupesWithOnLatestUpdateCount.

--resource-group -g

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

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

az iot du device group show

Affichez des détails sur un groupe d’appareils, y compris la meilleure mise à jour et la conformité des mises à jour.

az iot du device group show --account
                            --gid --group-id
                            --instance
                            [--best-updates {false, true}]
                            [--resource-group]
                            [--update-compliance {false, true}]

Exemples

Afficher un groupe d’appareils.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id}

Affichez les meilleures mises à jour disponibles pour un groupe d’appareils. Cet indicateur modifie la commande pour renvoyer une liste.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --best-updates

Afficher la conformité des mises à jour pour un groupe d’appareils.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --update-compliance

Paramètres obligatoires

--account -n

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

--gid --group-id

--instance -i

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.

--best-updates

Indicateur indiquant que la commande doit récupérer les meilleures mises à jour disponibles pour le groupe d’appareils, y compris le nombre d’appareils dont chaque mise à jour a besoin. Une mise à jour optimale est la dernière mise à jour qui répond à toutes les spécifications de compatibilité d’une classe d’appareil.

Propriété	Valeur
Groupe de paramètres:	Update Arguments
Valeurs acceptées:	false, true

--resource-group -g

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

--update-compliance

Indicateur indiquant que la commande doit récupérer les informations de conformité de mise à jour du groupe d’appareils, telles que le nombre d’appareils sur leur dernière mise à jour, le nombre de nouvelles mises à jour et le nombre en cours de réception d’une nouvelle mise à jour.

Propriété	Valeur
Groupe de paramètres:	Update Arguments
Valeurs acceptées:	false, true

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 ?

Partager via

az iot du device group

Commandes

az iot du device group delete

Exemples

Paramètres obligatoires

Paramètres facultatifs

az iot du device group list

Exemples

Paramètres obligatoires

Paramètres facultatifs

az iot du device group show

Exemples

Paramètres obligatoires

Paramètres facultatifs

Commentaires