Überwachen der Gerätekonnektivität per Azure CLI

  • Artikel

Verwenden Sie die Azure CLI IoT-Erweiterung für:

  • Sehen Sie sich die Nachrichten an, die Ihre Geräte an IoT Central senden.
  • Beobachten Sie Änderungen am Gerät Twin.
  • Diagnostizieren Sie Probleme, bei denen Gerätenachrichten die Cloud nicht erreichen.
  • Diagnostizieren Sie Probleme, bei denen Geräte nicht auf Zwillingsänderungen reagieren.

Weitere Einzelheiten erhalten Sie in der Referenz zu Azure CLI-Erweiterungen.

Voraussetzungen

Ein Geschäfts-, Schul- oder Unikonto in Azure, hinzugefügt als Benutzer in einer IoT Central-Anwendung.

Vorbereiten der Umgebung für die Azure CLI

  • Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.

  • Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.

    • Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.

    • Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.

    • Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.

Installieren der IoT Central-Erweiterung

Führen Sie den folgenden Befehl an der Befehlszeile zum Installieren aus:

az extension add --name azure-iot

Überprüfen Sie die Version der Erweiterung, indem Sie Folgendes ausführen:

az --version

Sie sollten sehen, dass die Azure-iot-Erweiterung 0.14.1 oder höher ist. Wenn dies nicht der Fehler ist, führen Sie Folgendes aus:

az extension update --name azure-iot

Verwenden der Erweiterung

Die folgenden Abschnitte beschreiben allgemeine Befehle und Optionen, die Sie beim Ausführen von az iot central verwenden können. Wenn Sie die vollständige Sammlung von Befehlen und Optionen anzeigen möchten, übergeben Sie --help an az iot central oder einen seiner Unterbefehle.

Anmelden

Beginnen Sie, indem Sie sich bei der Azure CLI anmelden:

az login

Abrufen der Anwendungs-ID Ihrer IoT Central-App

Kopieren Sie in Anwendung > Verwaltung die Anwendungs-ID. Sie verwenden diesen Wert in späteren Schritten.

Überwachen von Meldungen

Überwachen Sie die Nachrichten, die von ihren Geräten an die IoT Central-App gesendet werden. Zu der Ausgabe zählen auch alle Header und Anmerkungen.

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

Anzeigen von Geräteeigenschaften

Zeigen Sie die aktuellen Lesen- und Lesen/Schreiben-Geräteeigenschaften für ein bestimmtes Gerät an.

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

Nächste Schritte

Im nächsten Schritt wird empfohlen, die Problembehandlung zu erfahren , warum Daten von Ihren Geräten nicht in Azure IoT Central angezeigt werden.