管理日志文件
重要
这是 Azure Sphere（旧版）文档。 Azure Sphere（旧版）将于 2027 年 9 月 27 日停用，用户此时必须迁移到 Azure Sphere（集成）。 使用位于 TOC 上方的版本选择器查看 Azure Sphere（集成）文档。
Azure Sphere CLI 允许你决定是否要将计算机、云和附加的 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。