get-support-data

Erfasst und generiert Protokolldateien, die Diagnose- und Konfigurationsinformationen von Ihrem Computer, der Cloud und dem angeschlossenen 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. Weitere Informationen finden Sie unter Verwalten von Protokolldateien.

Erforderliche Parameter

Parameter	Typ	Beschreibung
--Ziel	Dateiname	Gibt den Pfad und Dateinamen der .zip Datei an, in der die Supportdaten gespeichert werden sollen. Sie können einen relativen oder absoluten Pfad angeben.

Optionale Parameter

Parameter	Typ	Beschreibung
-t, --tenant	Schnur	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem --debug Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus table. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie --debug für vollständige Debugprotokolle.

Hinweis

Wenn Sie die klassische Azure Sphere-CLI verwenden, finden Sie unter Globale Parameter weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere get-support-data --destination logs.zip
Gathering device data.
Gathering Azure Sphere Security Service data.
Gathering computer setup data.
Created the support log archive at 'logs.zip'.
Note: This archive contains information about your system including the list of Wi-Fi networks the device can see, installation logs, Azure Sphere command-line activity logs, attached USB devices, and Azure Sphere local and cloud configuration.
If you choose to provide this data to Microsoft, please send an email to AzCommunity@microsoft.com and attach the generated archive. All data will be handled according to the Microsoft Privacy Statement: go.microsoft.com/fwlink/?linkid=528096

Hinweis

Die gesammelten Daten können Informationen enthalten, die Sie privat halten möchten. Überprüfen Sie die Tabelle, um zu ermitteln, ob die Daten privat bleiben sollen, bevor Sie die Protokolldateien freigeben.

In der folgenden Tabelle sind die Details der generierten Dateien und Informationen aufgeführt, die der Befehl azsphere get-support-data zu sammeln versucht:

Protokolldatei	Beschreibung
AzureSphere_ComputerSetup.log	Zeichnet Aktivitäten im Zusammenhang mit dem Computer auf: – Interne Azure Sphere-Konfigurationseinstellungen. – IP-Adressen aller lokalen Netzwerkadapter. – Alle Details der Azure Sphere-Netzwerkadapter. : Die status des Azure Sphere SLIP-Diensts.
AzureSphere_Device_nnn.log	Zeichnet Aktivitäten im Zusammenhang mit dem angefügten Gerät auf: – Gerätedetails. – Status der auf dem Gerät installierten Images. – Gerätekomponenten und -funktionen, die auf dem Gerät installiert sind. – Wi-Fi auf dem Gerät gespeicherten Netzwerke. – Das aktuelle Netzwerk und die schnittstelle status des Geräts. – Wi-Fi Scanergebnisse vom Gerät aus. – Status der aktuellen Wi-Fi Einrichtung auf dem Gerät. – Herstellungsstatus des Geräts. – Regeln, die für die Firewall festgelegt sind.
AzureSphere_DeviceLog_nnn.bin	Enthält Diagnosedaten, einschließlich Konnektivitäts- und Gerätestatusinformationen, für das angeschlossene Gerät. Ein Python-Skript, das die Daten analysiert und in einem leicht lesbaren Format anzeigt, ist im Azure Sphere-Beispielkatalog verfügbar.
AzureSphere_DeviceTechSupportData_nnn.bin	Enthält Informationen zum Fertigungszustand für das angeschlossene Gerät.
AzureSphere_SecurityService_nnn.log	Zeichnet Informationen zum Azure Sphere-Sicherheitsdienst auf: – Die aktuelle Konfiguration, einschließlich des aktuellen Azure Sphere-Mandanten. – Liste der Azure Sphere-Mandanten. – Konfiguration der Cloudbereitstellung, einschließlich Gerätegruppe und Produkt. - Cloudkonfiguration status, einschließlich der aktuellen Version des Gerätebetriebssystems und der aktuellen Betriebssystemversion, die in der Cloud verfügbar ist.
ActivityLogs_AzureSphere.txt	Eine Protokolldatei mit Informationen zu den ausgeführten Befehlen.
InstallerLogs_AzureSphere	Listet Protokolldateien mit den Daten des Azure Sphere-Installationsprogramms der letzten sieben Tage auf.
InstallerLogs_VisualStudio	Listet Protokolldateien mit den Visual Studio-Installerdaten der letzten sieben Tage auf.