get-support-data

Importante

Questa è la documentazione di Azure Sphere (legacy). Azure Sphere (legacy) viene ritirato il 27 settembre 2027 e gli utenti devono eseguire la migrazione ad Azure Sphere (integrato) entro questo periodo. Usare il selettore di versione posizionato sopra il sommario per visualizzare la documentazione di Azure Sphere (integrata).

Raccoglie e genera file di log contenenti informazioni di diagnostica e configurazione dal computer, dal cloud e dal dispositivo Azure Sphere collegato. Le informazioni contenute in questi file di log possono essere usate per aiutare l'utente o il team di supporto tecnico a analizzare e risolvere i problemi. Per altre informazioni, vedere Gestire i file di log.

Parametri obbligatori

Parametro	Tipo	Descrizione
--destinazione	File name	Specifica il percorso e il nome file del file .zip in cui salvare i dati di supporto. È possibile specificare un percorso relativo o assoluto.

Parametri facoltativi

Parametro	Tipo	Descrizione
-t, --tenant	String	Specifica il tenant in cui eseguire questa operazione. Esegue l'override del tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant.

Parametri globali

Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:

Parametro	Descrizione
--debug	Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione.
-h, --help	Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili.
--only-show-errors	Visualizza solo gli errori, eliminando gli avvisi.
-o, --output	Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere.
--query	Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure.
--verbose	Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi.

Esempio

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 azsppgsup@microsoft.com and attach the generated archive. All data will be handled according to the Microsoft Privacy Statement: go.microsoft.com/fwlink/?linkid=528096

Nota

I dati raccolti possono contenere informazioni che si desidera mantenere private. Esaminare la tabella per determinare se uno dei dati deve rimanere privato prima di condividere i file di log.

La tabella seguente elenca i dettagli dei file generati e le informazioni che il comando azsphere get-support-data tenta di raccogliere:

File di log	Descrizione
AzureSphere_ComputerSetup.log	Registra le attività correlate al computer: - Impostazioni di configurazione interna di Azure Sphere. - Indirizzi IP di tutte le schede di rete locali. - Tutti i dettagli delle schede di rete di Azure Sphere. - Stato del servizio SLIP di Azure Sphere.
AzureSphere_Device_nnn.log	Registra le attività correlate al dispositivo collegato: - Dettagli dispositivo. - Stato delle immagini installate nel dispositivo. - Componenti e funzionalità del dispositivo installati nel dispositivo. - Reti Wi-Fi salvate nel dispositivo. - Stato corrente della rete e dell'interfaccia del dispositivo. - Risultati dell'analisi Wi-Fi dal dispositivo. - Stato della configurazione Wi-Fi corrente nel dispositivo. - Stato di produzione del dispositivo. - Regole impostate per il firewall.
AzureSphere_DeviceLog_nnn.bin	Contiene dati di diagnostica, incluse le informazioni sulla connettività e sullo stato del dispositivo, per il dispositivo collegato. Uno script Python che analizza i dati e lo visualizza in un formato facile da leggere è disponibile nella raccolta di esempi di Azure Sphere.
AzureSphere_DeviceTechSupportData_nnn.bin	Contiene informazioni sullo stato di produzione per il dispositivo collegato.
AzureSphere_SecurityService_nnn.log	Registra informazioni sul servizio di sicurezza di Azure Sphere: - Configurazione corrente, incluso il tenant di Azure Sphere corrente. - Elenco dei tenant di Azure Sphere. - Configurazione della distribuzione cloud, inclusi il gruppo di dispositivi e il prodotto. - Stato della configurazione cloud, inclusa la versione corrente del sistema operativo del dispositivo e la versione corrente del sistema operativo disponibile dal cloud.
ActivityLogs_AzureSphere.txt	File di log contenente informazioni sui comandi eseguiti.
InstallerLogs_AzureSphere	Elenca i file di log contenenti i dati del programma di installazione di Azure Sphere degli ultimi sette giorni.
InstallerLogs_VisualStudio	Elenca i file di log contenenti i dati del programma di installazione di Visual Studio degli ultimi sette giorni.