Anzeigen von Geräteinformationen

Ein Azure Sphere-Mandant kann Tausende von Geräten enthalten, und die Verwaltung der Geräte erfordert eine Methode, um detaillierte Informationen zu jedem dieser Geräte zu erhalten. Mithilfe der CLI-Befehle können Sie Informationen zu Geräten, Produkten und Gerätegruppen in einem Mandanten auflisten. Sie können auch die Standardausgabe eines Befehls zur ausführlichen Überprüfung in eine Datei umleiten.

Sie können auch die CLI-Befehle verwenden, um Diagnose- und Konfigurationsinformationen, Daten zu den Fehlern und andere Ereignisse herunterzuladen, die sich auf Ihre Geräte auswirken.

Ergebnisse umleiten oder paginieren

Die Azure Sphere-Befehlszeilenschnittstelle (CLI) stellt die folgenden Befehle bereit, um Informationen zu den Geräten, Produkten und Gerätegruppen in einem Mandanten aufzulisten.

• azsphere device-group device list zeigt alle Geräte innerhalb einer bestimmten Gerätegruppe an.
• azsphere device list zeigt alle Geräte innerhalb eines Mandanten an.
• azsphere product device list zeigt alle Geräte in einem Produkt an.

Diese Befehle können eine große Liste von Elementen zurückgeben, die umgeleitet oder paginiert werden können. In diesem Abschnitt werden die verschiedenen Möglichkeiten zum Umleiten oder Paginieren der Ausgabe von beiden CLIs beschrieben.

Azure Sphere CLI

Die Azure Sphere-CLI unterstützt keine interaktive Paginierung. Sie können die Ausgabe jedoch auf dem Bildschirm paginieren, indem Sie an vorhandene Paginierungstools weiterleiten.

Zum Beispiel:

• In PowerShell (Windows): azsphere device list | Out-Host –Paging
• An einer Eingabeaufforderung (Windows): azsphere device list | more
• In der Bash-Shell (Linux): azsphere device list | less

Hinweis

Dieser Vorgang kann abhängig davon, wie viele Daten zurückgegeben werden, möglicherweise langsam sein.

Sie können auch die Standardausgabe eines Befehls an eine Datei umleiten. Im folgenden Beispiel wird die Standardausgabe an output.txt und der Standardfehler an logs.txt gesendet.

azsphere device list --verbose > output.txt 2> logs.txt

Klassische Azure Sphere-CLI

Die Standardaktion dieser Befehle besteht darin, gleichzeitig eine Seite mit Datensätzen zurückzugeben, wobei die Seitengröße in der Regel auf 100 Datensätze festgelegt ist. Am unteren Rand jeder Ergebnisseite befindet sich eine Meldung zum Drücken einer beliebigen Taste, um die Anzeige mit der nächsten Ergebnisseite fortzusetzen. Die Seitengröße wird automatisch basierend auf Faktoren wie Datenbankaktivität und verfügbarer Netzwerkbandbreite angepasst.

Sie können die Ergebnisse eines Listenbefehls zur eingehenden Überprüfung in eine CSV-Datei (Durch Trennzeichen getrennte Werte) umleiten, indem Sie einen Pfad und Dateinamen für --output den Parameter angeben und dem Befehl den --noninteractive Parameter hinzufügen. Der --noninteractive Parameter entfernt die Paginierung aus den Ergebnissen, sodass die gesamte Liste in der CSV-Datei erfasst wird, ohne dass am Ende jeder Seite manuell fortgesetzt werden muss.

Anzeigen von Informationen für den Support

Welche Befehle zum Abrufen von Supportinformationen verwendet werden, hängt davon ab, ob Sie bei der Arbeit mit dem Microsoft-Support Kundensupportdaten für ein einzelnes Azure Sphere-Gerät sammeln oder Daten zu Fehlerbedingungen zurückgeben, die die Anwendungen betreffen, die auf Geräten innerhalb eines Mandanten ausgeführt werden. In den meisten Szenarien fragen Sie den Mandanten mit dem Befehl azsphere tenant download-error-report auf allen Geräten nach Fehlerbedingungen ab. Diese Methode hängt von der Kommunikation des Azure Sphere-Sicherheitsdiensts mit den Geräten über eine Internetverbindung ab, um die übereinstimmenden Ereignisse zu erfassen.

get-support-data

Der Befehl azsphere get-support-data sammelt und generiert Protokolldateien mit Diagnose- und Konfigurationsinformationen von Ihrem Computer, der Cloud und dem angeschlossenen Azure Sphere-Gerät. Die Informationen in diesen Protokolldateien können verwendet werden, um Ihnen oder dem technischen Supportteam zu helfen, Probleme zu analysieren und zu beheben. Verwenden Sie den --destination -Parameter, um den Pfad und Dateinamen der .zip Datei anzugeben, in der die Supportdaten gespeichert werden sollen. Sie können einen relativen oder absoluten Pfad angeben.

download-error-report

Der Befehl azsphere tenant download-error-report gibt Informationen zu Fehlern zurück, die von Geräten innerhalb eines Mandanten gemeldet werden. Ereignisdaten werden aus der Azure Sphere Security Service-Cloud abgerufen und erfordern keine physische Verbindung mit einem bestimmten Gerät. Der Befehl funktioniert im Kontext des aktuellen Mandanten und gibt Fehlerberichte für alle Geräte innerhalb dieses Mandanten zurück.

Verwenden Sie den --destination -Parameter, um den Pfad und Dateinamen der .csv Datei anzugeben, in der die Supportdaten gespeichert werden sollen. Sie können einen relativen oder absoluten Pfad angeben.