az iot central device-group
Remarque
Cette référence fait partie de l’extension azure-iot pour Azure CLI (version 2.37.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az iot central device-group . En savoir plus sur les extensions.
Gérer et configurer des groupes d’appareils IoT Central.
Commandes
| Nom | Description | Type | Statut |
|---|---|---|---|
| az iot central device-group create |
Créer un groupe d'appareils |
Extension | GA |
| az iot central device-group delete |
Supprimez un groupe d’appareils. |
Extension | GA |
| az iot central device-group list |
Obtenez la liste des groupes d’appareils pour une application IoT Central. |
Extension | GA |
| az iot central device-group show |
Obtenez le groupe d’appareils par ID. |
Extension | GA |
| az iot central device-group update |
Mettez à jour un groupe d’appareils existant. |
Extension | GA |
az iot central device-group create
Créer un groupe d'appareils
Remarque : une seule organisation est prise en charge aujourd’hui, plusieurs organisations seront bientôt prises en charge.
az iot central device-group create --app-id
--device-group-id
--display-name
--filter
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--description]
[--organizations]
[--token]Exemples
Créer un groupe d'appareils
az iot central device-group create --app-id {appid} --device-group-id {devicegroupid} --display-name "DeviceGroup1" --filter "SELECT * FROM devices WHERE $provisioned = true" --description "This is a default device group." --organizations {organization}Paramètres obligatoires
ID d’application de l’application IoT Central que vous souhaitez gérer. Vous trouverez l’ID d’application dans la page « À propos » de votre application sous le menu d’aide.
ID unique du groupe d’appareils.
Nom complet du groupe d’appareils.
Interrogez la définition des appareils qui doivent se trouver dans ce groupe. [Exemple de filtre de requête : SELECT * APPAREILS WHERE $template = « dtmi :modelDefinition :dtdlv2"].
Paramètres facultatifs
L’argument 'api_version' a été déconseillé et sera supprimé dans une prochaine version.
Ce paramètre de commande a été déconseillé et sera ignoré. Dans la prochaine version, nous allons uniquement prendre en charge les API IoT Central à partir de la dernière version en disponibilité générale. Si une API n’est pas encore en disponibilité générale, nous appelons la dernière version préliminaire.
Suffixe DNS IoT Central associé à votre application.
Résumé court du groupe d’appareils.
Liste des ID d’organisation du groupe d’appareils.
Si vous préférez envoyer votre demande sans vous authentifier auprès d’Azure CLI, vous pouvez spécifier un jeton d’utilisateur valide pour authentifier votre demande. Vous devez spécifier le type de clé dans le cadre de la requête. Pour en savoir plus, rendez-vous sur https://aka.ms/iotcentraldocsapi.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az iot central device-group delete
Supprimez un groupe d’appareils.
az iot central device-group delete --app-id
--device-group-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--token]Exemples
Supprimer un groupe d’appareils
az iot central device-group delete --app-id {appid} --device-group-id {devicegroupid}Paramètres obligatoires
ID d’application de l’application IoT Central que vous souhaitez gérer. Vous trouverez l’ID d’application dans la page « À propos » de votre application sous le menu d’aide.
ID unique du groupe d’appareils.
Paramètres facultatifs
L’argument 'api_version' a été déconseillé et sera supprimé dans une prochaine version.
Ce paramètre de commande a été déconseillé et sera ignoré. Dans la prochaine version, nous allons uniquement prendre en charge les API IoT Central à partir de la dernière version en disponibilité générale. Si une API n’est pas encore en disponibilité générale, nous appelons la dernière version préliminaire.
Suffixe DNS IoT Central associé à votre application.
Si vous préférez envoyer votre demande sans vous authentifier auprès d’Azure CLI, vous pouvez spécifier un jeton d’utilisateur valide pour authentifier votre demande. Vous devez spécifier le type de clé dans le cadre de la requête. Pour en savoir plus, rendez-vous sur https://aka.ms/iotcentraldocsapi.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az iot central device-group list
Obtenez la liste des groupes d’appareils pour une application IoT Central.
az iot central device-group list --app-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--token]Exemples
Répertorier les groupes d’appareils dans une application
az iot central device-group list --app-id {appid}Paramètres obligatoires
ID d’application de l’application IoT Central que vous souhaitez gérer. Vous trouverez l’ID d’application dans la page « À propos » de votre application sous le menu d’aide.
Paramètres facultatifs
L’argument 'api_version' a été déconseillé et sera supprimé dans une prochaine version.
Ce paramètre de commande a été déconseillé et sera ignoré. Dans la prochaine version, nous allons uniquement prendre en charge les API IoT Central à partir de la dernière version en disponibilité générale. Si une API n’est pas encore en disponibilité générale, nous appelons la dernière version préliminaire.
Suffixe DNS IoT Central associé à votre application.
Si vous préférez envoyer votre demande sans vous authentifier auprès d’Azure CLI, vous pouvez spécifier un jeton d’utilisateur valide pour authentifier votre demande. Vous devez spécifier le type de clé dans le cadre de la requête. Pour en savoir plus, rendez-vous sur https://aka.ms/iotcentraldocsapi.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az iot central device-group show
Obtenez le groupe d’appareils par ID.
az iot central device-group show --app-id
--device-group-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--token]Exemples
Obtenez le groupe d’appareils par ID.
az iot central device-group show --app-id {appid} --device-group-id {devicegroupid}Paramètres obligatoires
ID d’application de l’application IoT Central que vous souhaitez gérer. Vous trouverez l’ID d’application dans la page « À propos » de votre application sous le menu d’aide.
ID unique du groupe d’appareils.
Paramètres facultatifs
L’argument 'api_version' a été déconseillé et sera supprimé dans une prochaine version.
Ce paramètre de commande a été déconseillé et sera ignoré. Dans la prochaine version, nous allons uniquement prendre en charge les API IoT Central à partir de la dernière version en disponibilité générale. Si une API n’est pas encore en disponibilité générale, nous appelons la dernière version préliminaire.
Suffixe DNS IoT Central associé à votre application.
Si vous préférez envoyer votre demande sans vous authentifier auprès d’Azure CLI, vous pouvez spécifier un jeton d’utilisateur valide pour authentifier votre demande. Vous devez spécifier le type de clé dans le cadre de la requête. Pour en savoir plus, rendez-vous sur https://aka.ms/iotcentraldocsapi.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az iot central device-group update
Mettez à jour un groupe d’appareils existant.
Remarque : une seule organisation est prise en charge aujourd’hui, plusieurs organisations seront bientôt prises en charge.
az iot central device-group update --app-id
--device-group-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--description]
[--display-name]
[--filter]
[--organizations]
[--token]Exemples
Mettre à jour un groupe d’appareils via un correctif
az iot central device-group update --app-id {appid} --device-group-id {devicegroupid} --display-name {displayname} --filter {filter} --description {description} --organizations {organization}Paramètres obligatoires
ID d’application de l’application IoT Central que vous souhaitez gérer. Vous trouverez l’ID d’application dans la page « À propos » de votre application sous le menu d’aide.
ID unique du groupe d’appareils.
Paramètres facultatifs
L’argument 'api_version' a été déconseillé et sera supprimé dans une prochaine version.
Ce paramètre de commande a été déconseillé et sera ignoré. Dans la prochaine version, nous allons uniquement prendre en charge les API IoT Central à partir de la dernière version en disponibilité générale. Si une API n’est pas encore en disponibilité générale, nous appelons la dernière version préliminaire.
Suffixe DNS IoT Central associé à votre application.
Résumé court du groupe d’appareils.
Nom complet du groupe d’appareils.
Interrogez la définition des appareils qui doivent se trouver dans ce groupe. [Exemple de filtre de requête : SELECT * APPAREILS WHERE $template = « dtmi :modelDefinition :dtdlv2"].
Liste des ID d’organisation du groupe d’appareils.
Si vous préférez envoyer votre demande sans vous authentifier auprès d’Azure CLI, vous pouvez spécifier un jeton d’utilisateur valide pour authentifier votre demande. Vous devez spécifier le type de clé dans le cadre de la requête. Pour en savoir plus, rendez-vous sur https://aka.ms/iotcentraldocsapi.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour