Freigeben über

Anzeigen von Geräteinformationen

  • Artikel

Wichtig

Dies ist die Dokumentation zu Azure Sphere (Legacy). Azure Sphere (Legacy) wird am 27. September 2027 eingestellt, und Benutzer müssen bis zu diesem Zeitpunkt zu Azure Sphere (integriert) migrieren. Verwenden Sie die Versionsauswahl oberhalb des Inhaltsverzeichniss, um die Dokumentation zu Azure Sphere (Integriert) anzuzeigen.

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 detaillierten Überprüfung an eine Datei umleiten.

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

Umleitungs- oder Paginatenergebnisse

Die Befehlszeilenschnittstelle von Azure Sphere (CLI) stellt die folgenden Befehle bereit, um Informationen zu den Geräten, Produkten und Gerätegruppen in einem Mandanten auflisten zu können.

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 Methoden zum Umleiten oder Paginieren der Ausgabe von beiden CLIs beschrieben.

Azure Sphere-CLI

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

Zum Beispiel:

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

Hinweis

Dieser Vorgang kann möglicherweise langsam sein, je nachdem, wie viele Daten zurückgegeben werden.

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

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

Azure Sphere Classic CLI

Bei der Standardaktion dieser Befehle wird jeweils eine Seite mit Datensätzen zurückgegeben, wobei die Seitengröße normalerweise auf 100 Datensätze festgelegt ist. Unten auf jeder Ergebnisseite ist eine Meldung mit dem Hinweis angegeben, dass eine beliebige Taste betätigt werden kann, um die nächste Seite mit Ergebnissen anzuzeigen. Die Seitengröße wird basierend auf Faktoren wie Datenbankaktivität und verfügbarer Netzwerkbandbreite automatisch angepasst.

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

Anzeigen von Informationen zum Support

Die Befehle zum Abrufen von Supportinformationen hängen davon ab, ob Sie Kundensupportdaten für ein einzelnes Azure Sphere-Gerät beim Arbeiten mit dem Microsoft-Support sammeln oder Daten zu Fehlerbedingungen zurückgeben, die auf Geräten innerhalb eines Mandanten ausgeführt werden. In den meisten Szenarien fragen Sie beim Mandanten die Fehlerbedingungen aller Geräte ab, indem Sie den Befehl azsphere tenant download-error-report verwenden. Dieses Verfahren ist von der Kommunikation des Azure Sphere-Sicherheitsdiensts mit den Geräten per Internetverbindung abhängig, damit die übereinstimmenden Ereignisse erfasst werden können.

get-support-data

Der Azsphere get-support-data-Befehl sammelt und generiert Protokolldateien, die Diagnose- und Konfigurationsinformationen von Ihrem Computer, der Cloud und dem angefügten Azure Sphere-Gerät enthalten. 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 zu 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.