本文介绍如何在 Windows Server 中启用 Windows 部署服务(WDS)中的日志记录。
原始 KB 数: 936625
重要
本文包含有关如何修改注册表的信息。 修改注册表之前,一定要先对其进行备份。 并且一定要知道在发生问题时如何还原注册表。 有关如何备份、还原和修改注册表的详细信息,请参阅 高级用户的 Windows 注册表信息。
简介
本文介绍如何在 Windows Server 中启用 WDS 中的日志记录。 此外,本文介绍如何在 WDS 中收集数据。
可以使用此信息来帮助排查 WDS 中可能会遇到的问题。
概述
警告
如果使用注册表编辑器或使用其他方法错误地修改了注册表,则可能会发生严重问题。 这些问题可能需要重新安装操作系统才能解决。 Microsoft 不能保证可以解决这些问题。 您应自行承担修改注册表的风险。
每个 WDS 组件都有一种机制,可用于日志记录和跟踪。 然后,可以分析结果以进行故障排除。 使用以下部分中的信息为 WDS 组件启用日志记录和跟踪。
常规 WDS 服务器运行状况
键入以下命令以生成常规服务器运行状况信息:
WDSUTIL /get-server /show:all /detailed
此命令会导致常规服务器运行状况信息记录在应用程序日志和系统日志中。
WDS 服务器组件
键入以下命令以生成有关 WDS 服务器组件的运行状况信息:
WDSUTIL /get-server /show:all /detailed
此命令会导致 WDS 信息记录在应用程序日志和系统日志中。
获取 Windows Server 的跟踪日志
若要获取 Windows Server 的跟踪信息,请执行以下操作:
- 打开事件查看器(eventvwr)。
- 浏览到 Windows Logs\应用程序和服务日志\Microsoft\Windows\Deployment-Services-Diagnostics。
- 右键单击通道,然后选择“ 启用日志”。
然后,通过将以下一个或多个注册表项设置为 0 值来配置要记录的组件。
WDS 多播
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\WDSServer\Providers\WDSMC\TraceDisabled
WDS PXE
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\WDSServer\Providers\WDSPXE\TraceDisabled
WDS TFTP
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\WDSServer\Providers\WDSTFTP\TraceDisabled
WDS 服务器还支持以下附加跟踪:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\WDSServer\Providers\WDSTFTP\TraceFlags
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\WDSServer\Providers\WDSMC\TraceFlags
可以将这些注册表项设置为以下值,以控制包含的内容:
- 7F0000:此值包括数据包跟踪和协议跟踪。
- 3F0000:此值不包括数据包跟踪。
- 3E0000:此值不包括数据包跟踪和协议跟踪。 默认情况下,使用此值。
注意
跟踪过程可能会影响性能。 因此,建议在无需生成日志时禁用跟踪功能。
设置此注册表项后,WDS 服务器组件的跟踪信息将记录在以下文件中:%windir%\Tracing\wdsserver.log
WDS 管理组件
键入以下命令以生成管理组件运行状况信息:
WDSUTIL /get-server /show:all /detailed
此命令会导致 WDS 组件运行状况信息记录在应用程序日志和系统日志中。
启用跟踪
若要获取跟踪信息,必须在 WDS 管理组件和 WDS Microsoft管理控制台(MMC)组件中启用跟踪。 为此,请设置以下注册表项:
对于管理组件
- 路径:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Tracing\WDSMGMT
- 名称:EnableFileTracing
- 值类型:REG_DWORD
- 值数据:1
对于 MMC 组件
- 路径:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Tracing\WDSMMC
- 名称:EnableFileTracing
- 值类型:REG_DWORD
- 值数据:1
设置这些注册表项后,WDS 管理组件的跟踪信息将记录在 %windir%\Tracing\wdsmgmt.log 文件中。
此外,WDS MMC 组件的跟踪信息记录在 %windir%\Tracing\wdsmmc.log 文件中。
注意
尽管 WDS MMC 组件和 WDSUTIL 组件共享相同的 API 层,但 MMC 有时会添加处理和功能。 如果发生错误,则经常需要使用 WDSUTIL 尝试重现失败。 WDSUTIL 可能有助于确定错误是 MMC 的本地错误还是错误是否为常规管理 API 故障。 通常,如果未启用跟踪,WDSUTIL 组件会提供更详细的错误输出。 如果适用,请使用以下选项获取额外信息:
- /detailed
- /verbose
- /进展
WDS 旧组件
如果执行旧版管理功能,请设置以下注册表项以在 RISetup 组件中启用跟踪:
- 路径:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Tracing\RISetup
- 名称:EnableFileTracing
- 值类型:REG_DWORD
- 值数据:1
若要在 WDSCapture 操作中获取跟踪日志,请执行以下步骤:
启动捕获 Windows PE 启动映像。
捕获向导启动时,按 Shift+F10 打开命令提示符。
在 WDSCapture 组件中启用跟踪。 为此,请按照下列步骤进行操作:
- 启动“注册表编辑器”。
- 设置以下注册表项以在 WDSCapture 组件中启用跟踪:
- 路径:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Tracing\WDSCapture
- 名称:EnableFileTracing
- 值类型:REG_DWORD
- 值数据:1
启动 WDSCapture 组件的第二个实例。 然后,使用 WDSCapture 的第二个实例重现问题。
注意
不要关闭 WDSCapture 的原始实例。 如果关闭 WDSCapture 的原始实例,Windows PE 将重启。 相反,按 Alt+TAB 在 WDSCapture 的实例之间切换。将生成以下跟踪日志文件:X:\Windows\Tracing\WDSCapture.log。
WDS 客户端组件
若要启用客户端日志记录功能,请在 WDS 服务器上运行以下命令:
WDSUTIL /Set-Server /WDSClientLogging /Enabled:Yes
然后,在 WDS 服务器上运行以下命令以更改记录的事件:
WDSUTIL /Set-Server /WDSClientLogging /LoggingLevel:{None|Errors|Warnings|Info}
注意
每个类别包括上一个类别中的所有事件。
以下是日志记录级别的定义:
- NONE 日志记录级别禁用日志记录功能。 默认情况下,使用此日志记录级别。
- ERRORS 日志记录级别仅记录错误。
- WARNINGS 日志记录级别记录警告和错误。
- INFO 日志记录级别记录错误、警告和信息性事件。 此日志记录级别是最高的日志记录级别。
若要查看事件日志,请执行以下步骤:
- 打开服务器管理器,然后单击“诊断”。
- 单击 “事件查看器”。
- 单击“ 应用程序和服务日志”。
- 单击Microsoft,单击“Windows”,然后单击“Deployment-Services-Diagnostics”。
在事件日志的树结构中 ,管理 日志包含所有错误, 操作 日志包含信息消息。 以下是针对这些日志中某些错误列出的体系结构的定义:
- 体系结构 0 是 x86 处理器体系结构。
- 体系结构 6 是 IA-64 处理器体系结构。
- 体系结构 9 是 x64 处理器体系结构。
从客户端计算机设置日志
安装日志的位置取决于故障发生的时间。
如果在 WDS 客户端的磁盘配置页完成之前在 Windows PE 中发生故障,可以在 X:\Windows\Panther 文件夹中找到日志。 使用 Shift+F10 打开命令提示符,然后将目录更改为位置。
如果在 WDS 客户端的磁盘配置页完成后 Windows PE 中发生故障,可以在 $Windows.~BT\Sources\Panther 文件夹中找到本地磁盘卷上的日志。 本地磁盘卷通常是驱动器 C。使用 Shift+F10 打开命令提示符,然后将目录更改为位置。
如果在应用映像后第一次启动时发生故障,可以在本地磁盘卷的 \Windows\Panther 文件夹中找到日志。 本地磁盘卷通常是驱动器 C。
数据收集
如果需要 Microsoft 支持方面的帮助,建议按照使用 TSS 针对与部署相关的问题收集信息中所述的步骤收集信息。