az iot central diagnostics
Hinweis
Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.37.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az iot central Diagnose-Befehl ausführen. Weitere Informationen zu Erweiterungen
Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Führen Sie Diagnose auf Anwendungs- und Geräteebene aus.
Befehle
| Name | Beschreibung | Typ | Status |
|---|---|---|---|
| az iot central diagnostics monitor-events |
Anzeigen von Telemetriemeldungen des Geräts, die an die IoT Central-App gesendet werden. |
Durchwahl | Vorschau |
| az iot central diagnostics monitor-properties |
Zeigen Sie die gewünschten und gemeldeten Eigenschaften an/von der IoT Central-App an.View desired and reported properties sent to/from the IoT Central app. |
Durchwahl | Vorschau |
| az iot central diagnostics registration-summary |
Zeigen Sie die Registrierungszusammenfassung aller Geräte in einer App an. |
Durchwahl | Vorschau |
| az iot central diagnostics validate-messages |
Überprüfen Sie nachrichten, die an den IoT Hub für eine IoT Central-App gesendet wurden. |
Durchwahl | Vorschau |
| az iot central diagnostics validate-properties |
Überprüfen sie gemeldete Eigenschaften, die an die IoT Central-Anwendung gesendet wurden. |
Durchwahl | Vorschau |
az iot central diagnostics monitor-events
Die Befehlsgruppe "iot central Diagnose" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Anzeigen von Telemetriemeldungen des Geräts, die an die IoT Central-App gesendet werden.
Zeigt die Telemetriedaten an, die an die IoT Central-Anwendung gesendet werden. Standardmäßig werden alle von allen Geräten gesendeten Daten angezeigt. Verwenden Sie den Parameter "-device-id", um nach einem bestimmten 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 dem Zielgerät
az iot central diagnostics monitor-events --app-id {app_id} -d {device_id}Grundlegende Verwendung beim Filtern von Zielgeräten mit einem Wild Karte in der ID
az iot central diagnostics monitor-events --app-id {app_id} -d Device*dGrundlegende Verwendung beim Filtern nach Modul.
az iot central diagnostics monitor-events --app-id {app_id} -m {module_id}Grundlegende Verwendung beim Filtern gezielter Module mit einem Wild Karte in der ID
az iot central diagnostics monitor-events --app-id {app_id} -m Module*Filtern Sie das Gerät, und geben Sie eine Event Hub-Consumergruppe an, an die eine Bindung erfolgen 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 annoEmpfangen von Nachrichtenanmerkungen + Systemeigenschaften. Kein Timeout.
az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --properties anno sys --timeout 0Empfangen aller Nachrichtenattribute von allen Gerätenachrichten
az iot central diagnostics monitor-events --app-id {app_id} --props allEmpfangen aller Nachrichten und Analysieren der Nachrichtennutzlast als JSON
az iot central diagnostics monitor-events --app-id {app_id} --output jsonErforderliche Parameter
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
Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.
Geben Sie die Consumergruppe an, die beim Herstellen einer Verbindung mit dem Event Hub-Endpunkt verwendet werden soll.
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.
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 Uhrzeit angegeben ist, wird "jetzt" verwendet.
Die IoT Edge-Modul-ID, wenn der Gerätetyp IoT Edge ist.
Geben Sie wichtige Nachrichteneigenschaften an, die ausgegeben werden sollen. sys = Systemeigenschaften, App = Anwendungseigenschaften, anno = Anmerkungen.
Installieren Sie uamqp-Abhängigkeit neu, die mit der Erweiterungsversion kompatibel ist. Standardwert: false.
Maximale Sekunden bis Standard verbindung ohne Empfang einer Nachricht. Verwenden Sie 0 für Unendlichkeit.
Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich für 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.
Benutzeraufforderungen überspringen. Gibt die Annahme der Aktion an. Wird hauptsächlich für Automatisierungsszenarien verwendet. Standardwert: false.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az iot central diagnostics monitor-properties
Die Befehlsgruppe "iot central Diagnose" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Zeigen Sie die gewünschten und gemeldeten Eigenschaften an/von der IoT Central-App an.View desired and reported properties sent to/from the IoT Central app.
Fragt geräte-twin von zentral ab und vergleicht es mit den letzten Geräte-Twin Pars out-Eigenschaften von "device-twin", und erkennt, ob Änderungen vorgenommen wurden Prints Teilmenge der Eigenschaften, die innerhalb des Abrufintervalls 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
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ü.
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
Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.
Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich für 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.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az iot central diagnostics registration-summary
Die Befehlsgruppe "iot central Diagnose" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Zeigen Sie die Registrierungszusammenfassung aller Geräte in einer App an.
Hinweis: Dieser Befehl kann viel Zeit in Anspruch nehmen, um zurückzugeben, wenn Ihre App viele Geräte enthält.
az iot central diagnostics registration-summary --app-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--token]Beispiele
Registrierungszusammenfassung
az iot central diagnostics registration-summary --app-id {appid}Erforderliche Parameter
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
Das Argument "api_version" ist veraltet und wird in einer zukünftigen Version entfernt.
Dieser Befehlsparameter ist veraltet und wird ignoriert. In der zukünftigen Version werden wir nur IoT Central APIs von der neuesten GA-Version unterstützen. Wenn eine API noch nicht GA ist, rufen wir die neueste Vorschauversion auf.
Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.
Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich für 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.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az iot central diagnostics validate-messages
Die Befehlsgruppe "iot central Diagnose" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Überprüfen Sie nachrichten, die an den IoT Hub für eine IoT Central-App gesendet wurden.
Führt Überprüfungen für Telemetriemeldungen aus und meldet Daten zurück, die nicht in der Gerätevorlage oder den Daten modelliert werden, bei denen der Datentyp nicht mit den in der Gerätevorlage definierten Daten ü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, während sie erkannt werden
az iot central diagnostics validate-messages --app-id {app_id} --style scrollGrundlegende Verwendung beim Filtern auf dem Zielgerät
az iot central diagnostics validate-messages --app-id {app_id} -d {device_id}Grundlegende Verwendung beim Filtern von Zielgeräten mit einem Wild Karte in der ID
az iot central diagnostics validate-messages --app-id {app_id} -d Device*Grundlegende Verwendung beim Filtern nach Modul.
az iot central diagnostics validate-messages --app-id {app_id} -m {module_id}Grundlegende Verwendung beim Filtern gezielter Module mit einem Wild Karte in der ID
az iot central diagnostics validate-messages --app-id {app_id} -m Module*Filtern Sie das Gerät, und geben Sie eine Event Hub-Consumergruppe an, an die eine Bindung erfolgen soll.
az iot central diagnostics validate-messages --app-id {app_id} -d {device_id} --cg {consumer_group_name}Erforderliche Parameter
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
Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.
Geben Sie die Consumergruppe an, die beim Herstellen einer Verbindung mit dem Event Hub-Endpunkt verwendet werden soll.
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.
Maximale Dauer für den Empfang von Nachrichten vom Zielgerät vor dem Beenden der Verbindung. Verwenden Sie 0 für Unendlichkeit.
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 Uhrzeit angegeben ist, wird "jetzt" verwendet.
Maximale Anzahl von Nachrichten, die vom Zielgerät empfangen werden sollen, bevor die Verbindung beendet wird. Verwenden Sie 0 für Unendlichkeit.
Mindestschwere des Problems, das für die Berichterstellung erforderlich ist.
Die IoT Edge-Modul-ID, wenn der Gerätetyp IoT Edge ist.
Geben Sie wichtige Nachrichteneigenschaften an, die ausgegeben werden sollen. sys = Systemeigenschaften, App = Anwendungseigenschaften, anno = Anmerkungen.
Installieren Sie uamqp-Abhängigkeit neu, die mit der Erweiterungsversion kompatibel ist. Standardwert: false.
Angeben von Ausgabestilencroll = Fehler beim Eintreffen, json = Ergebnisse als json zusammenfassen, csv = Ergebnisse als CSV zusammenfassen.
Maximale Sekunden bis Standard verbindung ohne Empfang einer Nachricht. Verwenden Sie 0 für Unendlichkeit.
Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich für 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.
Benutzeraufforderungen überspringen. Gibt die Annahme der Aktion an. Wird hauptsächlich für Automatisierungsszenarien verwendet. Standardwert: false.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az iot central diagnostics validate-properties
Die Befehlsgruppe "iot central Diagnose" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Überprüfen sie gemeldete Eigenschaften, die an die IoT Central-Anwendung gesendet wurden.
Führt Überprüfungen für gemeldete Eigenschaftenaktualisierungen durch:
- Warnung : Vom Gerät gesendete Eigenschaften, die nicht zentral modelliert sind.
- Warnung : Eigenschaften mit demselben Namen, die in mehreren Schnittstellen deklariert sind, sollten im Rahmen der Eigenschaftenaktualisierung 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
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ü.
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
Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.
Mindestschwere des Problems, das für die Berichterstellung erforderlich ist.
Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich für 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.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für