az iot central diagnostics

Referenz

Hinweis

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.30.0 oder höher). Die Erweiterung installiert automatisch beim ersten Ausführen eines zentralen Az iot-Diagnosebefehls . Weitere Informationen zu Erweiterungen

Führen Sie die Diagnose auf Anwendung und Geräteebene aus.

Befehle

az iot central diagnostics monitor-events	Anzeigen von Geräte-Telemetrienachrichten, die an die IoT Central-App gesendet werden.
az iot central diagnostics monitor-properties	Anzeigen von gewünschten und gemeldeten Eigenschaften, die an/aus der IoT Central-App gesendet werden.
az iot central diagnostics registration-summary	Anzeigen der Registrierungszusammenfassung aller Geräte in einer App.
az iot central diagnostics validate-messages	Überprüfen Sie nachrichten, die an die IoT Hub für eine IoT Central-App gesendet wurden.
az iot central diagnostics validate-properties	Überprüfen Sie gemeldete Eigenschaften, die an die IoT Central-Anwendung gesendet wurden.

az iot central diagnostics monitor-events

Anzeigen von Geräte-Telemetrienachrichten, die an die IoT Central-App gesendet werden.

Zeigt die Telemetriedaten an die IoT Central-Anwendung gesendet. Standardmäßig werden alle von allen Geräten gesendeten Daten angezeigt. Verwenden Sie den Parameter --device-id, um auf ein bestimmtes Gerät zu filtern.

az iot central diagnostics monitor-events --app-id
                                          [--central-api-uri]
                                          [--cg]
                                          [--device-id]
                                          [--enqueued-time]
                                          [--module-id]
                                          [--properties {all, anno, app, sys}]
                                          [--repair {false, true}]
                                          [--timeout]
                                          [--token]
                                          [--yes {false, true}]

Beispiele

Grundlegende Verwendung

az iot central diagnostics monitor-events --app-id {app_id}

Grundlegende Verwendung beim Filtern auf Zielgerät

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id}

Grundlegende Verwendung beim Filtern von Zielgeräten mit einem Wildcard in der ID

az iot central diagnostics monitor-events --app-id {app_id} -d Device*d

Grundlegende Verwendung beim Filtern auf Modul.

az iot central diagnostics monitor-events --app-id {app_id} -m {module_id}

Grundlegende Verwendung beim Filtern von gezielten Modulen mit einem Wildcard in der ID

az iot central diagnostics monitor-events --app-id {app_id} -m Module*

Filtern Sie das Gerät, und geben Sie eine Ereignishub-Verbrauchergruppe an, an die die Bindung gebunden werden soll.

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --cg {consumer_group_name}

Empfangen von Nachrichtenanmerkungen (Nachrichtenkopfzeilen)

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --properties anno

Empfangen von Nachrichtenanmerkungen + Systemeigenschaften. Nie Zeitüberschreitung.

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --properties anno sys --timeout 0

Empfangen aller Nachrichtenattribute aus allen Gerätenachrichten

az iot central diagnostics monitor-events --app-id {app_id} --props all

Empfangen aller Nachrichten und Analysieren der Nachrichtennutzlast als JSON

az iot central diagnostics monitor-events --app-id {app_id} --output json

Erforderliche Parameter

--app-id -n

Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Informationen" für Ihre Anwendung im Hilfemenü.

Optionale Parameter

--central-api-uri --central-dns-suffix

Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.

Standardwert: azureiotcentral.com

--cg --consumer-group -c

Geben Sie die Verbrauchergruppe an, die beim Herstellen einer Verbindung mit ereignishubendpunkt verwendet werden soll.

Standardwert: $Default

--device-id -d

Die Geräte-ID des Zielgeräts. Sie können die Geräte-ID finden, indem Sie auf der Seite "Gerätedetails" auf die Schaltfläche "Verbinden" klicken.

--enqueued-time --et -e

Gibt die Zeit an, die als Ausgangspunkt zum Lesen von Nachrichten aus den Partitionen verwendet werden soll. Einheiten sind Millisekunden seit unix-Epoche. Wenn keine Zeit "jetzt" angegeben wird.

--module-id -m

Die IoT Edge Modul-ID, wenn der Gerätetyp IoT Edge ist.

--properties --props -p

Geben Sie wichtige Nachrichteneigenschaften für die Ausgabe an. sys = Systemeigenschaften, App = Anwendungseigenschaften, anno = Anmerkungen.

Zulässige Werte: all, anno, app, sys

--repair -r

Installieren Sie Uamqp-Abhängigkeiten neu, die mit der Erweiterungsversion kompatibel sind. Standardwert: false.

Zulässige Werte: false, true

--timeout --to -t

Maximale Sekunden zum Verwalten der Verbindung ohne Empfangen der Nachricht. Verwenden Sie 0 für unendlich.

Standardwert: 300

--token

Wenn Sie Ihre Anforderung ohne Authentifizierung für die Azure CLI übermitteln möchten, können Sie ein gültiges Benutzertoken angeben, um Ihre Anforderung zu authentifizieren. Sie müssen den Schlüsseltyp als Teil der Anforderung angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentraldocsapi.

--yes -y

Überspringen Sie Benutzeraufforderungen. Gibt die Akzeptanz der Abhängigkeitsinstallation (falls erforderlich) an. Wird in erster Linie für Automatisierungsszenarien verwendet. Standardwert: false.

Zulässige Werte: false, true

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot central diagnostics monitor-properties

Anzeigen von gewünschten und gemeldeten Eigenschaften, die an/aus der IoT Central-App gesendet werden.

Fragt geräte-twin von zentral ab und vergleicht sie mit den letzten Geräte-Twin Parses-Eigenschaften von Geräte-Twin, und erkennt, ob Änderungen vorgenommen wurden Untermenge von Eigenschaften, die innerhalb des Abfrageintervalls geändert wurden.

az iot central diagnostics monitor-properties --app-id
                                              --device-id
                                              [--central-api-uri]
                                              [--token]

Beispiele

Grundlegende Verwendung

az iot central diagnostics monitor-properties --app-id {app_id} -d {device_id}

Erforderliche Parameter

--app-id -n

Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Informationen" für Ihre Anwendung im Hilfemenü.

--device-id -d

Die Geräte-ID des Zielgeräts. Sie können die Geräte-ID finden, indem Sie auf der Seite "Gerätedetails" auf die Schaltfläche "Verbinden" klicken.

Optionale Parameter

--central-api-uri --central-dns-suffix

Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.

Standardwert: azureiotcentral.com

--token

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot central diagnostics registration-summary

Anzeigen der Registrierungszusammenfassung aller Geräte in einer App.

Hinweis: Dieser Befehl kann eine erhebliche Zeit dauern, um zurückzugeben, wenn Ihre App viele Geräte enthält.

az iot central diagnostics registration-summary --app-id
                                                [--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
                                                [--central-api-uri]
                                                [--token]

Beispiele

Registrierungszusammenfassung

az iot central diagnostics registration-summary --app-id {appid}

Erforderliche Parameter

--app-id -n

Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Informationen" für Ihre Anwendung im Hilfemenü.

Optionale Parameter

--api-version --av

Die API-Version für den angeforderten Vorgang.

Zulässige Werte: 1.0, 1.1-preview, 2022-05-31, preview

Standardwert: 2022-05-31

--central-api-uri --central-dns-suffix

Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.

Standardwert: azureiotcentral.com

--token

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot central diagnostics validate-messages

Überprüfen Sie nachrichten, die an die IoT Hub für eine IoT Central-App gesendet wurden.

Führt Überprüfungen für Telemetrienachrichten und Berichte zurück, die nicht in der Gerätevorlage oder Daten modelliert werden, in denen der Datentyp nicht mit dem definierten Gerätevorlagen übereinstimmt.

az iot central diagnostics validate-messages --app-id
                                             [--central-api-uri]
                                             [--cg]
                                             [--device-id]
                                             [--dr]
                                             [--enqueued-time]
                                             [--max-messages]
                                             [--minimum-severity {error, info, warning}]
                                             [--module-id]
                                             [--properties {all, anno, app, sys}]
                                             [--repair {false, true}]
                                             [--style {csv, json, scroll}]
                                             [--timeout]
                                             [--token]
                                             [--yes {false, true}]

Beispiele

Grundlegende Verwendung

az iot central diagnostics validate-messages --app-id {app_id}

Ausgabefehler, da sie erkannt werden

az iot central diagnostics validate-messages --app-id {app_id} --style scroll

Grundlegende Verwendung beim Filtern auf Zielgerät

az iot central diagnostics validate-messages --app-id {app_id} -d {device_id}

Grundlegende Verwendung beim Filtern von Zielgeräten mit einem Wildcard in der ID

az iot central diagnostics validate-messages --app-id {app_id} -d Device*

Grundlegende Verwendung beim Filtern auf Modul.

az iot central diagnostics validate-messages --app-id {app_id} -m {module_id}

Grundlegende Verwendung beim Filtern von gezielten Modulen mit einem Wildcard in der ID

az iot central diagnostics validate-messages --app-id {app_id} -m Module*

Filtern Sie das Gerät, und geben Sie eine Ereignishub-Verbrauchergruppe an, an die die Bindung gebunden werden soll.

az iot central diagnostics validate-messages --app-id {app_id} -d {device_id} --cg {consumer_group_name}

Erforderliche Parameter

--app-id -n

Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Info" für Ihre Anwendung im Hilfemenü.

Optionale Parameter

--central-api-uri --central-dns-suffix

Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.

Standardwert: azureiotcentral.com

--cg --consumer-group -c

Geben Sie die Verbrauchergruppe an, die beim Herstellen einer Verbindung mit ereignishubendpunkt verwendet werden soll.

Standardwert: $Default

--device-id -d

Die Geräte-ID des Zielgeräts. Sie können die Geräte-ID finden, indem Sie auf der Seite "Gerätedetails" auf die Schaltfläche "Verbinden" klicken.

--dr --duration

Maximale Dauer für den Empfang von Nachrichten vom Zielgerät vor dem Beenden der Verbindung. Verwenden Sie 0 für Unendlichkeit.

Standardwert: 300

--enqueued-time --et -e

Gibt die Uhrzeit an, die als Ausgangspunkt zum Lesen von Nachrichten aus den Partitionen verwendet werden soll. Einheiten sind Millisekunden seit der Unix-Epoche. Wenn keine Uhrzeit angegeben ist, wird "jetzt" verwendet.

--max-messages --mm

Maximale Anzahl von Nachrichten, die vom Zielgerät empfangen werden sollen, bevor die Verbindung beendet wird. Verwenden Sie 0 für Unendlichkeit.

Standardwert: 10

--minimum-severity

Mindestschwere des Problems, das für die Berichterstellung erforderlich ist.

Zulässige Werte: error, info, warning

Standardwert: warning

--module-id -m

Die IoT Edge Modul-ID, wenn der Gerätetyp IoT Edge ist.

--properties --props -p

Geben Sie wichtige Nachrichteneigenschaften an, die ausgegeben werden sollen. sys = Systemeigenschaften, App = Anwendungseigenschaften, anno = Anmerkungen.

Zulässige Werte: all, anno, app, sys

--repair -r

Installieren Sie uamqp-Abhängigkeit neu, die mit der Erweiterungsversion kompatibel ist. Standardwert: false.

Zulässige Werte: false, true

--style

Geben Sie ausgabeformatvorlagencroll = Fehler beim Eintreffen an, json = zusammenfassungsergebnisse als json, csv = zusammenfassungsergebnisse als csv.

Zulässige Werte: csv, json, scroll

Standardwert: scroll

--timeout --to -t

Maximale Sekunden zum Verwalten der Verbindung ohne Empfang von Nachrichten. Verwenden Sie 0 für Unendlichkeit.

Standardwert: 300

--token

Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich gegen die Azure CLI zu authentifizieren, können Sie ein gültiges Benutzertoken angeben, um Ihre Anforderung zu authentifizieren. Sie müssen den Schlüsseltyp als Teil der Anforderung angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentraldocsapi.

--yes -y

Benutzeraufforderungen überspringen. Gibt die Akzeptanz der Abhängigkeitsinstallation an (sofern erforderlich). Wird hauptsächlich für Automatisierungsszenarien verwendet. Standardwert: false.

Zulässige Werte: false, true

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot central diagnostics validate-properties

Überprüfen der gemeldeten Eigenschaften, die an die IoT Central-Anwendung gesendet werden.

Führt Überprüfungen für gemeldete Eigenschaftenupdates durch:

Warnung – Eigenschaften, die vom Gerät gesendet werden, die nicht zentral modelliert sind.
Warnung – Eigenschaften mit demselben Namen, der in mehreren Schnittstellen deklariert ist, sollten im Rahmen der Eigenschaftsaktualisierung enthalten sein.

az iot central diagnostics validate-properties --app-id
                                               --device-id
                                               [--central-api-uri]
                                               [--minimum-severity {error, info, warning}]
                                               [--token]

Beispiele

Grundlegende Verwendung

az iot central diagnostics validate-properties --app-id {app_id} -d {device_id}

Erforderliche Parameter

--app-id -n

Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Info" für Ihre Anwendung im Hilfemenü.

--device-id -d

Die Geräte-ID des Zielgeräts. Sie finden die Geräte-ID, indem Sie auf der Seite "Gerätedetails" auf die Schaltfläche "Verbinden" klicken.

Optionale Parameter

--central-api-uri --central-dns-suffix

Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.

Standardwert: azureiotcentral.com

--minimum-severity

Mindestschwere des Problems, das für die Berichterstellung erforderlich ist.

Zulässige Werte: error, info, warning

Standardwert: warning

--token

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot central diagnostics

Befehle

az iot central diagnostics monitor-events

Beispiele

Erforderliche Parameter

Optionale Parameter

az iot central diagnostics monitor-properties

Beispiele

Erforderliche Parameter

Optionale Parameter

az iot central diagnostics registration-summary

Beispiele

Erforderliche Parameter

Optionale Parameter

az iot central diagnostics validate-messages

Beispiele

Erforderliche Parameter

Optionale Parameter

az iot central diagnostics validate-properties

Beispiele

Erforderliche Parameter

Optionale Parameter

Feedback