get-support-data
重要
這是 Azure Sphere （舊版） 檔。 Azure Sphere（舊版）將於 2027 年 9 月 27 日淘汰，且使用者此時必須移轉至 Azure Sphere（整合式）。 使用位於 TOC 上方的版本選取器來檢視 Azure Sphere （整合式） 檔。
從您的電腦、雲端和連結的 Azure Sphere 裝置收集併產生包含診斷和組態信息的記錄檔。 這些記錄檔中的資訊可用來協助您或技術支援小組分析及疑難解答問題。 如需詳細資訊，請參閱 管理記錄檔。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --目的地 | File name | 指定要在其中儲存支持資料之.zip檔案的路徑和檔名。 您可以提供相對或絕對路徑。 |
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t、 --tenant | String | 指定要在中執行這項作業的租使用者。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
Azure Sphere CLI 提供下列全域參數：
| 參數 | 描述 |
|---|---|
| --debug | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，可在提交錯誤報告時提供使用 --debug 旗標產生的輸出。 |
| -h, --help | 列印 CLI 參考命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 只顯示錯誤，隱藏警告。 |
| -o, --output | 變更輸出格式。 可用的輸出格式為 json、jsonc（色彩化 JSON）、tsv （Tab-Separated Values）、數據表（人類可讀取的 ASCII 數據表），以及 yaml。 根據預設，CLI 會輸出 table。 若要深入瞭解可用的輸出格式，請參閱 Azure Sphere CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure Sphere 安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學 課程和 查詢 Azure CLI 命令輸出 。 |
| --verbose | 列印作業期間在 Azure Sphere 中建立之資源的相關信息和其他實用資訊。 使用 --debug 以取得完整的偵錯記錄。 |
注意
如果您使用 Azure Sphere 傳統 CLI，請參閱 全域參數 ，以取得可用選項的詳細資訊。
範例
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
注意
收集的數據可能包含您想要保留私人的資訊。 檢閱數據表，以判斷任何數據是否應該保持私人，再共用記錄檔。
下表列出所產生檔案的詳細數據，以及 azsphere get-support-data 命令嘗試收集的資訊：
| 記錄檔 | 描述 |
|---|---|
| AzureSphere_ComputerSetup.log | 記錄與電腦相關的活動： - Azure Sphere 內部組態設定。 - 所有區域網路卡的IP位址。 - Azure Sphere 網路適配器的所有詳細數據。 - Azure Sphere SLIP 服務的狀態。 |
| AzureSphere_Device_nnn.log | 記錄與連結裝置相關的活動： - 裝置詳細數據。 - 裝置上安裝的映像狀態。 - 裝置上安裝的裝置元件和功能。 - 儲存至裝置的Wi-Fi網路。 - 裝置目前的網路和介面狀態。 - 來自裝置的Wi-Fi掃描結果。 - 裝置上目前Wi-Fi 設定的狀態。 - 裝置的製造狀態。 - 為防火牆設定的規則。 |
| AzureSphere_DeviceLog_nnn.bin | 包含連接的裝置的診斷數據，包括連線能力和裝置狀態資訊。 Azure Sphere 範例資源庫中提供剖析數據的 Python 腳本，並以易於讀取的格式顯示。 |
| AzureSphere_DeviceTechSupportData_nnn.bin | 包含附加裝置的製造狀態資訊。 |
| AzureSphere_SecurityService_nnn.log | 記錄 Azure Sphere 安全性服務的相關信息： - 目前的設定，包括目前的 Azure Sphere 租使用者。 - Azure Sphere 租用戶的清單。 - 雲端部署設定，包括裝置群組和產品。 - 雲端設定狀態，包括目前裝置 OS 版本和可從雲端取得的目前作業系統版本。 |
| ActivityLogs_AzureSphere.txt | 包含命令執行相關信息的記錄檔。 |
| InstallerLogs_AzureSphere | 列出包含過去七天 Azure Sphere 安裝程式數據的記錄檔。 |
| InstallerLogs_VisualStudio | 列出包含過去七天 Visual Studio 安裝程式數據的記錄檔。 |