部署故障排除和日志文件
以下部分介绍常见部署方案与其关联日志文件之间的关系。 Windows 部署是一个高度可自定义的过程，可能会有很多故障点。 若要确定所遇到的特定故障点，首先需要了解基础技术的工作原理。
Windows 安装程序方案
此方案首先在新计算机上完成 Windows 安装程序，以便你进入桌面。 它是创建参考映像时最常见的方案。 此过程也称为“第一次用户体验”。
如下图所示，解决故障的关键在于确定你在安装过程中的位置以及发生故障的时间。 由于正在创建新的安装，硬盘驱动器最初不可用，因此 Windows 安装程序将日志写入内存。 格式化硬盘驱动器后，安装程序继续将日志直接记录到新硬盘驱动器 (C:\Windows) 上。 Windows PE 阶段创建的日志文件是临时的。
Windows 安装程序中发生故障时，请先查看 setuperr.log 文件中的条目，再查看 setupact.log 文件中的条目，然后根据需要查看其他日志文件。
Windows 安装程序相关的日志文件
| 日志文件 | 说明 | 位置 |
|---|---|---|
Setupact.log |
在 Windows 安装过程中发生的大多数错误的主日志文件。 Setupact.log 文件有多个实例，具体取决于安装过程中发生故障的位置。 请务必了解根据所处阶段要查看的 Setupact.log 文件的版本。 |
安装程序（专用化）：X:\Windows\panther 安装程序 (OOBE)，LogonUI，OEM 首次运行：%windir%\panther 全新体验 (OOBE)：%windir%\panther\unattendGC |
Setuperr.log |
安装程序“专用化”阶段发生的错误的概要列表。 Setuperr.log 文件不提供任何特定的详细信息。 |
安装程序（专用化）：%windir%\panther 安装程序（专用化）：%windir%\panther 安装程序 (OOBE)，LogonUI，OEM 首次运行：%windir%\panther |
Setupapi.offline.log |
安装程序“专用化”阶段的组件专用化子阶段发生的驱动程序故障。 |
%windir%\inf |
Cbs_unattend.log |
无人参与安装服务失败。 |
%windir%\panther |
Setupapi.dev.log |
安装程序“OOBE”阶段发生的驱动程序故障。 |
%windir%\inf |
Sessions.xml |
基于 XML 的事务日志文件，用于根据会话 ID、客户端、状态、任务和操作跟踪所有服务活动。 如有必要，Sessions.log 文件将指向 DISM.log 和 CBS.log 文件以提供更多详细信息。 |
%windir%\servicing\sessions |
CBS.log |
服务日志文件，用于提供有关脱机服务故障的更多详细信息。 |
%windir%\panther |
脱机服务方案
脱机服务方案包括在不启动 Windows 的情况下添加和删除更新、驱动程序和语言包以及配置其他设置。 由于脱机服务无需重新创建更新的映像，因此能够有效地管理存储在服务器上的现有映像。 可以对装载或应用到驱动器或目录的映像执行脱机服务。
DISM 是用于所有脱机服务任务的主要工具。 DISM 从 Windows PE 或运行 Windows 的操作系统中的命令提示符运行。 如果执行 DISM 命令时出现故障，该工具将立即响应，并在 DISM.log 文件中记录问题。 Session.xml 文件是事务日志文件，用于捕获目标操作系统上的所有服务活动。 Session.xml 文件可与 DISM.log 文件一起使用，以确定故障点和所需的服务活动。
脱机服务中出现故障时，首先在 DISM.log 文件中查看特定错误。 如果 DISM.log 文件不包含任何错误，则查看 Sessions.xml 日志文件，然后查看 CBS.log 文件。
脱机服务相关的日志文件
| 日志文件 | 说明 | 位置 |
|---|---|---|
DISM.log |
使用 DISM 的所有脱机操作的主日志文件。 |
%windir%\logs\dism 还可以通过使用 /LogPath 选项在其他位置创建 DISM 日志文件。 也可以通过使用 /LogLevel 选项控制写入日志文件的数据的级别。 |
Sessions.xml |
基于 XML 的事务日志，用于根据会话 ID、客户端、状态、任务和操作跟踪所有服务活动。 如有必要，Sessions.log 文件将指向 DISM.log 和 CBS.log 文件以提供更多详细信息。 |
%windir%\servicing\sessions |
若要详细了解脱机服务，请参阅了解服务策略。
联机服务方案
此方案为正在运行的操作系统提供服务。 此方案涉及将计算机启动到审核模式，以添加驱动程序、应用程序和其他包。 如果驱动程序包具有辅助安装程序或应用程序依赖关系，则联机服务非常适合这些驱动程序。 如果多数服务包具有安装程序，且更新为 .msi 或 KB.exe 文件格式，或者应用程序依赖 Windows 安装的服务和技术（如 .NET Framework 或完全即插即用支持），则联机服务也是一种有效方式。
与脱机服务一样，所有日志记录都捕获在 DISM.log、CBS.log, 和 Sessions.xml 文件中。 如果执行 DISM 命令时出现故障，该工具将立即响应，并在 DISM.log 文件中记录问题。 Session.xml 文件是事务日志文件，用于捕获目标操作系统上的所有服务活动。 Session.xml 文件可与 DISM.log 文件一起使用，以确定故障点和所需的服务活动。
脱机服务中出现故障时，在 DISM.log 文件中查看特定错误。 如果 DISM.log 文件不包含任何错误，则查看 Sessions.xml 日志文件，然后查看 CBS.log 文件。
联机服务相关的日志文件
| 日志文件 | 说明 | 位置 |
|---|---|---|
DISM.log |
使用 DISM 的所有联机操作的主日志文件。 如有必要，DISM.log 将指向 CBS.log 以提供更多详细信息。 |
%windir%\logs\dism 还可以通过使用 /LogPath 命令选项将 DISM 日志文件指向其他位置。 也可以通过使用 /LogLevel 命令选项来控制日志数据。 |
CBS.log |
辅助日志文件，用于提供有关联机服务故障的更多详细信息。 DISM.log 将引用 CBS.log 以提供更多详细信息。 |
%windir%\logs\cbs |
Sessions.xml |
基于 XML 的事务日志，用于根据会话 ID、客户端、状态、任务和操作跟踪所有服务活动。 如有必要，Sessions.log 将指向 DISM.log 和 CBS.log，以提供更多详细信息。 |
%windir%\servicing\sessions |
若要详细了解脱机服务，请参阅了解服务策略。
诊断联机服务相关的日志文件
SetupDiag 是一个独立的诊断工具，可用于获取有关升级失败原因的详细信息。 SetupDiag 通过检查 Windows 安装程序日志文件工作。 它尝试分析这些日志文件，以确定无法将计算机更新或升级到 Windows 新版本的根本原因。 从 Windows 10 版本 2004 开始，Windows 安装程序包括并运行 SetupDiag。 Windows 安装程序使用 /ZipLogs:False /Format:xml /Output:%windir%\logs\SetupDiag\SetupDiagResults.xml /RegPath:HKEY_LOCAL_MACHINE\SYSTEM\Setup\SetupDiag\Results 参数启动 setupdiag.exe。
若要详细了解 SetupDiag，请参阅 SetupDiag。