顯示裝置資訊

重要

這是 Azure Sphere （舊版） 檔。 Azure Sphere（舊版）將於 2027 年 9 月 27 日淘汰，且使用者此時必須移轉至 Azure Sphere（整合式）。 使用位於 TOC 上方的版本選取器來檢視 Azure Sphere （整合式） 檔。

Azure Sphere 租使用者可以包含數千個裝置，並管理裝置需要一種方法來取得每個裝置的詳細資訊。 您可以使用 CLI 命令，列出租使用者中裝置、產品和裝置群組的相關信息。 您也可以將命令的標準輸出重新導向至檔案，以取得詳細檢閱。

您也可以使用 CLI 命令來下載診斷和設定資訊、錯誤的相關數據，以及其他影響您裝置的事件。

重新導向或分頁結果

Azure Sphere 命令行介面 （CLI） 提供下列命令，列出租用戶中裝置、產品和裝置群組的相關信息。

• azsphere device-group device list 會顯示特定裝置群組內的所有裝置。
• azsphere device list 會顯示租使用者中的所有裝置。
• azsphere product device list 會顯示產品中的所有裝置。

這些命令可以傳回可重新導向或分頁的大型項目清單。 本節說明從這兩個 CLIS 重新導向或分頁輸出的不同方式。

Azure Sphere CLI

Azure Sphere CLI 不支援互動式分頁。 不過，您可以將管線傳送至現有的分頁工具，以分頁畫面上的輸出。

例如：

• 在 PowerShell 中（Windows）： azsphere device list | Out-Host –Paging
• 在命令提示字元中（Windows）： azsphere device list | more
• 在Bash殼層中（Linux）： azsphere device list | less

注意

視傳回的數據量而定，此作業可能會變慢。

您也可以將命令的標準輸出重新導向至檔案。 在下列範例中，標準輸出會傳送至output.txt，並將標準錯誤傳送至logs.txt。

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

Azure Sphere 傳統 CLI

這些命令的默認動作是一次傳回記錄頁面，其中頁面大小通常會設定為100筆記錄。 每個結果頁面底部都有一則訊息，可按任意鍵繼續顯示結果的下一頁。 頁面大小會根據資料庫活動和可用的網路頻寬等因素自動調整。

您可以將清單命令的結果重新導向至逗號分隔值 （CSV） 檔案，以便深入檢閱，方法是指定參數的路徑和檔名 --output ，並將參數新增 --noninteractive 至命令。 參數 --noninteractive 會從結果中移除分頁，以便在 CSV 檔案中擷取整個清單，而不需要在每個頁面結尾手動繼續。

顯示支援的資訊

用來取得支援資訊的命令取決於您在使用Microsoft支援時收集單一 Azure Sphere 裝置的客戶支持數據，或傳回有關租用戶內裝置上執行之應用程式之錯誤狀況的數據。 在大部分情況下，您將使用 azsphere tenant download-error-report 命令查詢租使用者，以取得所有裝置上的錯誤狀況。 此方法將取決於透過因特網連線與裝置的 Azure Sphere 安全性服務通訊，以收集相符的事件。

get-support-data

azsphere get-support-data 命令會收集併產生記錄檔，其中包含來自您的計算機、雲端和連結 Azure Sphere 裝置的診斷和組態資訊。 這些記錄檔中的資訊可用來協助您或技術支援小組分析及疑難解答問題。 --destination使用 參數來指定用來儲存支持資料之.zip檔案的路徑和檔名。 您可以提供相對或絕對路徑。

download-error-report

azsphere tenant download-error-report 命令會傳回租用戶內裝置所報告錯誤的相關信息。 事件數據會從 Azure Sphere 安全性服務雲端提取，且不需要特定裝置的實體連線。 此命令可在目前租使用者的內容中運作，並傳回該租使用者內所有裝置的錯誤報告。

--destination使用 參數來指定用來儲存支持資料之.csv檔案的路徑和檔名。 您可以提供相對或絕對路徑。