<!– –>
Noter
Cette référence fait partie du azur-iot extension pour Azure CLI (version 2.30.0 ou supérieure). L’extension s’installera automatiquement la première fois que vous exécuterez un az iot device-update classe d’appareils commande. En savoir plus sur les extensions.
Gestion des classes d’appareils et des sous-groupes de classes d’appareils.
Une classe d’appareils décrit un ensemble d’appareils qui partagent un ensemble commun d’attributs entre les groupes, tandis qu’un sous-groupe de classe d’appareils est un sous-ensemble d’appareils d’un groupe qui partagent le même ID de classe d’appareils. Les classes d’appareils sont créées automatiquement lorsque des appareils compatibles avec la mise à jour des appareils sont connectés au concentrateur.
Commandes
suppression de la classe d’appareils az iot device-update
Supprimer une classe d’appareils ou un sous-groupe de classes d’appareils.
Les classes de périphériques sont créées automatiquement lorsque les périphériques activés pour la mise à jour des périphériques sont connectés au concentrateur, mais ne sont pas automatiquement nettoyés car ils sont référencés par des sous-groupes de classes de périphériques. Si tous les sous-groupes de classe d’appareils pour une classe d’appareils cible sont supprimés, la classe d’appareils elle-même peut également être supprimée pour supprimer les enregistrements du système et pour arrêter de vérifier la compatibilité de la classe d’appareils avec les nouvelles mises à jour. Si un périphérique est reconnecté, sa classe de périphérique sera recréée si elle n’existe pas.
az iot device-update device class delete --account
--cid
--instance
[--gid]
[--resource-group]
[--yes {false, true}]
Exemples
Supprimer une classe d’appareils.
az iot device-update device class delete -n {account_name} -i {instance_name} --class-id {device_class_id}
Supprimez une classe d’appareils et ignorez l’invite de confirmation.
az iot device-update device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} -y
Supprimer un sous-groupe de classe d’appareils.
az iot device-update device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id}
Paramètres requis
–Compte n
Nom du compte de mise à jour de l’appareil.
–cid –class-id
–instance -i
Nom de l’instance de mise à jour de l’appareil.
Paramètres facultatifs
–gid –group-id
–resource-group -g
Nom du groupe de ressources du compte de mise à jour de l’appareil. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=
.
–oui -y
Ignorer les invites de l’utilisateur. Indique l’acceptation de l’action. Utilisé principalement pour les scénarios d’automatisation. Par défaut : faux.
valeurs acceptées : faux vrai
–déboguer
Augmentez la verbosité de la journalisation pour afficher tous les journaux de débogage.
–help -h
Affichez ce message d’aide et quittez.
–only-show-errors
Afficher uniquement les erreurs, en supprimant les avertissements.
–sortie -o
–requête
–abonnement
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID
.
–verbeux
Augmentez la verbosité de la journalisation. Utilisez –debug pour les journaux de débogage complets.
az iot device-update liste des classes d’appareils
Répertorier les classes d’appareils ou les sous-groupes de classes d’appareils.
az iot device-update device class list --account
--instance
[--filter]
[--gid]
[--resource-group]
Exemples
Répertorier les classes d’appareils au sein d’une instance.
az iot device-update device class list -n {account_name} -i {instance_name}
Répertorier les sous-groupes de classe d’appareils pour le groupe.
az iot device-update device class list -n {account_name} -i {instance_name} --group-id {device_group_id}
Répertorier les sous-groupes de classe d’appareils pour le groupe, filtrés par compatProperties/fabricant
az iot device-update device class list -n {account_name} -i {instance_name} --group-id {device_group_id} --filter "compatProperties/manufacturer eq 'Contoso'"
Paramètres requis
–Compte n
Nom du compte de mise à jour de l’appareil.
–instance -i
Nom de l’instance de mise à jour de l’appareil.
Paramètres facultatifs
–filtre
Filtre les sous-groupes de classes d’appareils en fonction des noms et des valeurs des propriétés de compatibilité des classes d’appareils. Par exemple “compatProperties/manufacturer eq ‘Contoso'”. –group-id est requis pour utiliser –filter.
–gid –group-id
–resource-group -g
Nom du groupe de ressources du compte de mise à jour de l’appareil. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=
.
–déboguer
Augmentez la verbosité de la journalisation pour afficher tous les journaux de débogage.
–help -h
Affichez ce message d’aide et quittez.
–only-show-errors
Afficher uniquement les erreurs, en supprimant les avertissements.
–sortie -o
–requête
–abonnement
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID
.
–verbeux
Augmentez la verbosité de la journalisation. Utilisez –debug pour les journaux de débogage complets.
émission de classe d’appareils de mise à jour d’appareil az iot
Affichez les détails d’une classe d’appareils ou d’un sous-groupe de classes d’appareils, y compris les mises à jour installables, la meilleure mise à jour et la conformité des mises à jour.
az iot device-update device class show --account
--cid
--instance
[--best-update {false, true}]
[--gid]
[--installable-updates {false, true}]
[--resource-group]
[--update-compliance {false, true}]
Exemples
Afficher une classe d’appareils.
az iot device-update device class show -n {account_name} -i {instance_name} --class-id {device_class_id}
Afficher les mises à jour installables pour la classe d’appareils. Ce drapeau modifie la commande pour retourner une liste.
az iot device-update device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --installable-updates
Afficher un sous-groupe de classe d’appareils.
az iot device-update device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id}
Afficher la meilleure mise à jour disponible pour un sous-groupe de classe d’appareils.
az iot device-update device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id} --best-update
Afficher la conformité des mises à jour pour un sous-groupe de classe d’appareils.
az iot device-update device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id} --update-compliance
Paramètres requis
–Compte n
Nom du compte de mise à jour de l’appareil.
–cid –class-id
–instance -i
Nom de l’instance de mise à jour de l’appareil.
Paramètres facultatifs
–best-update
Indicateur indiquant que la commande doit récupérer la meilleure mise à jour disponible pour le sous-groupe de classe d’appareils, y compris le nombre d’appareils nécessitant la mise à jour. L’ID de groupe est requis pour cet indicateur. Une meilleure mise à jour est la dernière mise à jour qui répond à toutes les spécifications de compatibilité d’une classe d’appareils.
valeurs acceptées : faux vrai
–gid –group-id
–mises à jour installables
Indicateur indiquant que la commande doit récupérer les mises à jour installables pour la classe d’appareils.
valeurs acceptées : faux vrai
–resource-group -g
Nom du groupe de ressources du compte de mise à jour de l’appareil. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=
.
–mise à jour-conformité
Indicateur indiquant que la commande doit récupérer les informations de conformité de mise à jour du sous-groupe de classe d’appareils, telles que le nombre d’appareils sur leur dernière mise à jour, le nombre d’appareils nécessitant de nouvelles mises à jour et le nombre d’appareils en cours de réception d’une nouvelle mise à jour. L’ID de groupe est requis pour cet indicateur.
valeurs acceptées : faux vrai
–déboguer
Augmentez la verbosité de la journalisation pour afficher tous les journaux de débogage.
–help -h
Affichez ce message d’aide et quittez.
–only-show-errors
Afficher uniquement les erreurs, en supprimant les avertissements.
–sortie -o
–requête
–abonnement
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID
.
–verbeux
Augmentez la verbosité de la journalisation. Utilisez –debug pour les journaux de débogage complets.
az iot device-update mise à jour de la classe d’appareils
Mettre à jour une classe d’appareils.
az iot device-update device class update --account
--cid
--instance
[--friendly-name]
[--resource-group]
Exemples
Mettez à jour le nom convivial de la classe d’appareils.
az iot device-update device class update -n {account_name} -i {instance_name} --class-id {device_class_id} --friendly-name "EU-region"
Paramètres requis
–Compte n
Nom du compte de mise à jour de l’appareil.
–cid –class-id
–instance -i
Nom de l’instance de mise à jour de l’appareil.
Paramètres facultatifs
–nom familier
Nom convivial associé à la classe d’appareils.
–resource-group -g
Nom du groupe de ressources du compte de mise à jour de l’appareil. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=
.
–déboguer
Augmentez la verbosité de la journalisation pour afficher tous les journaux de débogage.
–help -h
Affichez ce message d’aide et quittez.
–only-show-errors
Afficher uniquement les erreurs, en supprimant les avertissements.
–sortie -o
–requête
–abonnement
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID
.
–verbeux
Augmentez la verbosité de la journalisation. Utilisez –debug pour les journaux de débogage complets.