如何在 Windows 的 WDS 中启用日志记录

  • 项目

本文介绍如何在 Windows Server 中启用 Windows 部署服务 (WDS) 中的日志记录。

适用于： Windows Server 2012 R2
原始 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 的跟踪信息，请执行以下操作：

  1. 打开事件查看器 (eventvwr) 。
  2. 浏览到 Windows 日志\应用程序和服务日志\Microsoft\Windows\部署-服务-诊断。
  3. 右键单击通道并选择 “启用日志”。

然后，通过将以下一个或多个注册表项设置为 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 组件会提供更详细的错误输出。 如果适用，请使用以下选项获取额外信息：

  • /详细
  • /详细
  • /进展

WDS 旧组件

如果执行旧式管理功能，请设置以下注册表项以在 RISetup 组件中启用跟踪：

  • 路径： HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Tracing\RISetup
  • 名称：EnableFileTracing
  • 值类型：REG_DWORD
  • 值数据：1

若要获取 WDSCapture 操作中的跟踪日志，请执行以下步骤：

  1. 启动捕获 Windows PE 启动映像。

  2. 捕获向导启动时，按 SHIFT+F10 打开命令提示符。

  3. 在 WDSCapture 组件中启用跟踪。 为此，请按照下列步骤操作：

    1. 启动注册表编辑器。
    2. 设置以下注册表项以在 WDSCapture 组件中启用跟踪：
    • 路径： HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Tracing\WDSCapture
    • 名称：EnableFileTracing
    • 值类型：REG_DWORD
    • 值数据：1

  4. 启动 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 日志记录级别记录错误、警告和信息性事件。 此日志记录级别是最高日志记录级别。

若要查看事件日志，请执行以下步骤：

  1. 打开服务器管理器，然后单击“诊断”。
  2. 单击“事件查看器”。
  3. 单击“ 应用程序和服务日志”。
  4. 依次单击“ 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 针对与部署相关的问题收集信息中所述的步骤收集信息。