Superviser la connectivité des appareils avec Azure CLI

Utilisez l’extension Azure CLI IoT pour :

• Consultez les messages que vos appareils envoient à IoT Central.
• Observez les modifications apportées au jumeau d’appareil.
• Diagnostiquer les problèmes où les messages d’appareil n’atteignent pas le cloud.
• Diagnostiquer les problèmes où les appareils ne répondent pas aux modifications de jumeau.

Pour plus d’informations, consultez la référence sur les extensions d’Azure CLI

Prérequis

Un compte professionnel ou scolaire dans Azure, ajouté en tant qu’utilisateur dans une application IoT Central.

Préparation de votre environnement pour Azure CLI

• Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.

  

• Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.

  • Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.

  • Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.

  • Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Installer l’extension IoT Central

Exécutez la commande suivante dans la console de ligne de commande pour installer :

az extension add --name azure-iot

Vérifiez la version de l’extension en exécutant :

az --version

L’extension azure-iot doit être 0.14.1 ou ultérieure. Si ce n’est pas le cas, exécutez :

az extension update --name azure-iot

En utilisant l’extension

Les sections suivantes décrivent les commandes et les options courantes que vous pouvez utiliser quand vous exécutez az iot central. Pour voir l’ensemble complet des commandes et des options, passez --help à az iot central ou à une de ses sous-commandes.

Connexion

Commencez par vous connecter à Azure CLI :

az login

Obtenez l’ID d’application de votre application IoT Central

Dans Application > Gestion, copiez l’ID d’application. Vous utiliserez cette valeur ultérieurement.

Surveiller les messages

Surveillez les messages envoyés à votre application IoT Central à partir de vos appareils. La sortie inclut l’ensemble des en-têtes et annotations.

az iot central diagnostics monitor-events --app-id <app-id> --properties all

Voir les propriétés de l’appareil

Affichez les propriétés actuelles de lecture et de lecture/écriture pour un appareil donné.

az iot central device twin show --app-id <app-id> --device-id <device-id>

Étapes suivantes

Une étape suivante suggérée consiste à découvrir pourquoi les données de vos appareils ne s’affichent pas dans Azure IoT Central.