共用方式為

管理記錄檔

  • 發行項

重要

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

Azure Sphere CLI 可讓您決定是否要在記錄檔中包含來自計算機、雲端和連結 Azure Sphere 裝置的診斷和組態資訊。 您可以針對特定會話使用 CLI 來啟用或停用記錄，或藉由設定環境變數來永久啟用或停用記錄。

注意

根據預設，如果未設定環境變數，則會停用記錄。

在 CLI 中設定記錄

記錄是藉由設定環境變數 AZSPHERE_FILE_LOGGING_DISABLED來設定。 啟用記錄時，會在 Windows 上的 C：\Users<user.azsphere>\logs 目錄中建立記錄檔，並在 Linux 上建立 ~/.azsphere/logs。 此外，資訊也會包含在您執行 azsphere get-support-data 命令時所建立的.zip檔案中。

範例

以下是使用 CLI 設定記錄的範例：

注意

您設定的喜好設定只會套用至您目前位於的 CLI 工作階段，而且不會持續跨工作階段。 若要永久設定您的喜好設定，請參閱為操作系統提供的檔。

支援的 值為：

  • 0 以啟用記錄
  • 1 以停用記錄
  • 如果未設定，則會停用記錄

Windows 命令提示字元

若要啟用記錄：

set AZSPHERE_FILE_LOGGING_DISABLED=0

若要停用記錄：

set AZSPHERE_FILE_LOGGING_DISABLED=1

若要清除設定：

set AZSPHERE_FILE_LOGGING_DISABLED=

若要檢視環境變數的值，請在命令提示字元中輸入 set AZSPHERE_FILE_LOGGING_DISABLED 。

Windows PowerShell

您可以從 Windows 命令提示字元和 Windows PowerShell 執行命令：

若要啟用記錄：

$env:AZSPHERE_FILE_LOGGING_DISABLED=0

若要停用記錄：

$env:AZSPHERE_FILE_LOGGING_DISABLED=1

若要清除設定：

Remove-Item -Path Env:AZSPHERE_FILE_LOGGING_DISABLED

若要檢視環境變數的值，請在PowerShell中輸入 dir env: ，然後在清單中尋找AZSPHERE_FILE_LOGGING_DISABLED。