什么是 SetupDiag 文件？如何使用它来分析更新失败？

当 Windows 更新卡住、失败或回滚更改通常情况下，系统不会提供太多关于故障原因的明确线索。对于普通用户而言，只会显示一个晦涩难懂的错误代码，但实际上，系统会在后台生成大量日志和技术跟踪信息，其中包含着问题的真正原因。

为了深入查看这些日志并了解更新失败的原因，微软提供了 设置诊断一个小型诊断可执行文件 最初是为管理员和高级用户设计的，但如果您知道如何使用它以及如何解释其结果，您也可以在家庭环境中使用它。

SetupDiag是什么？SetupDiag文件是用来做什么的？

SetupDiag.exe 是微软的独立工具。 专为分析 Windows 10 或 Windows 11 更新失败的原因而设计。它不会安装任何软件；它以管理员身份在控制台运行，并跟踪系统安装和更新日志。

公用事业的作用是 检查 Windows 安装或升级过程中生成的日志文件 （例如，当您打算从一个版本升级到另一个版本或安装大型累积更新时）并查找已知的错误模式。根据查找结果，它会在输出文件中生成一份非常详细的报告，该文件通常以类似于以下内容的名称命名： SetupDiag_Datum.log位于运行 SetupDiag 的同一文件夹中。

在更新过程中，Windows 安装程序本身（setup.exe将必要的文件提取到目录中 %SystemDrive%\$Windows.~bt\Sources在这个过程中，如果更新失败，已经积累了相当数量的记录。 SetupDiag 依靠这些日志来定位错误原因。比手动浏览要系统得多。

需要注意的是， SetupDiag 被设计成一个命令行工具。它并非一款用户友好的应用程序，因此微软主要面向IT管理员和技术人员。即便如此，只要有清晰的指导，即使在家庭环境下也能轻松使用。

 

先决条件和安装诊断下载

在开始运行任何程序之前，这一点很重要。 请确认您的系统满足最低要求SetupDiag 需要以下组件： .NET Framework 4.6 或更高版本虽然实际上在当前系统中安装 4.8 版本的情况很常见。

要快速检查计算机上安装的 .NET 版本，您可以…… 以管理员权限打开命令提示符窗口 并执行以下命令（注意引号和路径）：

reg query "HKLM\SOFTWARE\Microsoft\Net Framework Setup\NDP\v4" /s

该命令遍历注册表分支，其中 Windows 会记录有关不同版本 .NET Framework 的信息。在输出结果中，您将看到已安装的版本号；只要它等于或高于 4.6，您就可以毫无问题地使用 SetupDiag。

确认满足 .NET 要求后，就可以下载该工具了。 SetupDiag 可以从微软官方网站获取。通常是通过类似“下载安装诊断文件”的链接。您将收到的文件是一个单独的可执行文件，例如 SetupDiag.exe您可以将其保存到您选择的任何文件夹中。

如何运行 SetupDiag 并生成 SetUpDiag.log 文件

可执行文件下载完成后，下一步是…… 以管理员权限重新打开控制台。 打开命令提示符或 PowerShell，并导航到保存 SetupDiag 的文件夹。更便捷的方法是使用文件资源管理器：右键单击 SetupDiag.exe，然后按 Enter 键。 转移 然后选择“复制为路径”选项。

回到游戏主机上，你可以 使用 cd 命令切换到文件目录如果您已复制完整路径，只需输入：

cd RUTA_QUE_HAS_COPIADO

从那里，您可以启动该工具。最常见的使用方法是： 指定诊断报告的输出文件例如，要将结果保存到指定路径并使用指定名称：

SetupDiag.exe /Output:Letra:\Ruta\Archivo.log

运行该命令后，您将看到控制台显示 所有安装日志路径的分析进展 与之前的更新和升级有关。根据失败尝试次数和计算机性能的不同，所需时间可能会略有增减，但通常不会特别慢。

完成后，您将在目标文件夹中找到以下几个文件： 包含主要报告的文本文件可能包含压缩日志，在某些情况下还包含其他附加日志。主 .log 文件顶部总结了 SetupDiag 是否已安装。 它是否检测到Windows更新中的错误？ 团队进行了分析。

除了文本格式设置外，SetupDiag 还允许 将结果导出为 XML 格式，以便与其他工具集成 或者进行更结构化的分析。为此，可以使用与上一个命令类似的命令，并添加 format 参数：

SetupDiag.exe /Output:Letra:\Ruta\Archivo.log /Format:xml

生成的 XML 文件将包含与文本报告相同的信息，但按层次结构组织。 更便于自动化分析或编写脚本 支持。

SetupDiag 如何帮助解决 Windows 异常更新问题

在许多家用电器中， 当 Windows 更新拒绝安装时用户多次尝试下载和安装，结果都一样。Windows 内置的疑难解答程序有时能有所帮助，但并非总能找出问题的根本原因。

SetupDiag 提供了一种不同的方法： 查看关键机器日志、配置和更新尝试历史记录它将调查结果与微软认可的一套非常广泛的规则和模式进行比较。这些规则涵盖了从未满足的硬件要求到不兼容的驱动程序或磁盘空间问题等各种情况。

该程序在类似于 PowerShell 或命令提示符的控制台窗口中运行。程序运行完毕后， 它会分析安装日志，并生成一份或多份报告，指出最可能导致错误的原因。这些报告除了在计算机本身中使用外，还可以复制到另一台出现类似症状的计算机上进行分析。

总而言之，SetupDiag 并不能“神奇地”解决所有问题，但它确实可以。 它会准确地告诉你是什么情况阻止了更新完成。这样你就可以进行适当的修正，而不会盲目行事。

兼容性和配置错误的主要 SetupDiag 规则

SetupDiag 的核心是其诊断规则： 每条规则都会在安装日志中查找特定类型的问题。如果找到匹配项，该工具会将该规则标记出来，并在报告中包含解释该块所需的数据。

• CompatScanOnly (ID FFDAFD37-DB75-498A-A893-472D49A1311D)此规则检测到 setup.exe 该命令执行时使用了“仅兼容性检查”的命令行参数，而没有尝试进行完整更新。在这种情况下，并非真正意义上的更新失败，而是…… 分析模式下的刻意执行.
• PlugInComplianceBlock (ID D912150B-1302-4860-91B5-527907D08960)负责定位 与合规性插件相关的兼容性块此规则专门用于 Windows Server 更新，并生成有关阻止操作和所需修复的信息。
• BitLockerHardblock (ID C30152E2-938E-44B8-915B-D1181BA635AE) 表示更新块 目标操作系统不支持 BitLocker然而，当前系统已启用此功能。在这种情况下，更新将被阻止，直到调整 BitLocker 设置或使用兼容版本为止。
• VHDHardblock (ID D9ED1B82-4ED8-4DFD-8EC0-BE69048978CC) 它检测到系统是从 VHD 映像启动的，这种情况 它与就地升级过程不兼容.
• PortableWorkspaceHardblock (ID 5B0D3AB4-212A-4CE4-BDB9-37CA404BB280) 报告显示，系统正在 Windows To Go 环境（USB 驱动器）中运行，该环境也不支持标准更新。
• AuditModeHardblock (ID A03BD71B-487B-4ACA-83A0-735B0F3F1A90) 这反映出Windows处于 审计模式一种特殊的准备和配置状态，不允许升级。
• SafeModeHardblock (ID 404D9523-B7A8-4203-90AF-5FBB05B6579B) 表明比赛开始于 安全模式更新过程也是不允许的。
• InsufficientSystemPartitionDiskSpaceHardblock (ID 3789FBF8-E177-437D-B1E3-D38B4C4269D1) 跳跃时 系统分区没有足够的空间来存放所需的最新启动文件。 更新期间，该分区通常保留给引导加载程序（EFI 或系统保留分区），并且它并不总是显示为传统的驱动器号，这使得管理变得复杂。

阻止更新的应用和功能

多条规则侧重于 已安装的软件阻止了更新进程我们来看其中的一些例子：

• CompatBlockedApplicationAutoUninstall (ID BEBA5BC6-6150-413E-8ACE-5E1EC8D34DD5) 这表明在继续操作之前必须删除某个应用程序，但可以在操作过程中相对自动地完成此操作。
• CompatBlockedApplicationDismissable (ID EA52620B-E6A0-4BBC-882E-0686605736D9) 这涵盖了以该模式运行安装程序的情况。 /安静在这种静默模式下，如果未添加修饰符，一些关于应用程序的“可忽略的”警告消息就会变成崩溃。 /兼容性忽略警告这条规则明确规定： 静默执行已将警告转化为有效的阻断.
• CompatBlockedFODDismissable (ID 7B693C42-793E-4E9E-A10B-ED0F33D45E2A)面向 按需功能如果以 /quiet 模式启动安装，并且存在与这些功能相关的警告，除非忽略命令行兼容性警告，否则仍然会导致崩溃。SetupDiag 报告通常会指出目标映像存在问题。 当前系统中缺少按需功能。通常情况下，消除现有系统中的外来物损伤就足以解决问题。
• CompatBlockedApplicationManualUninstall (ID 9E912E5F-25A5-4FC0-BEC1-CA0EA5432FF4)情况变得稍微复杂一些：它表明系统中存在某个应用程序，但没有 “添加或删除程序”中的标准条目它阻止了更新。这里没有引导式卸载：通常的步骤是…… 可能需要手动删除相关文件 （有时还需要清除注册表项）以释放锁定。
• OptionalComponentFailedToGetOCsFromPackage (ID D012E2A2-99D8-4A8C-BBB2-088B92083D78) 表明 无法列出给定软件包的可选组件。 迁移过程中，该工具会报告包名称和错误代码，取代之前较为通用的规则。
• OptionalComponentOpenPackageFailed (ID 22952520-EC89-4FBD-94E0-B67DF88347F6) 当执行可选组件迁移操作时，此操作会被触发。 它无法打开特定的 OC 包再次指出软件包名称和发现的错误代码。
• OptionalComponentInitCBSSessionFailed (ID 63340812-9252-45F3-A0F2-B2A4CA5E9317) 这指向一个更严重的潜在问题： 高级安装程序服务或维护堆栈组件无法正常运行。在这些情况下，底层维护堆栈被认为存在损坏或损坏，该规则包括在现有操作系统中尝试初始化所述组件时出现的错误代码。

硬件要求、驱动程序和临时锁

有些规则直接规定了这一点。 该设备不符合硬件要求 适用于您尝试安装的 Windows 版本。例如：

• GenericCompatBlock (ID 511B9D95-C945-4F9B-BD63-98F1465E1CF6)例如，当它缺失时，就会触发该事件。 TPM 2.0 模块 强制性更新，或者为了规避硬件限制而强制更新。
• GatedCompatBlock (ID 34A9F145-3842-4A68-987F-4622EE0FC162) 指 微软设置的临时兼容性块 当检测到软件组件或硬件驱动程序存在大范围问题时，会在可能受影响的计算机上阻止更新，直到相关修复程序广泛发布；一旦修复程序可用，就会解除阻止。
• HardblockDeviceOrDriver (ID ED3AEFA1-F3E2-4F33-8A21-184ADF215B1B) 表明 某些当前已加载的设备驱动程序与新版 Windows 不兼容。该报告通常会指出是哪个驱动程序导致了问题，解决方法包括卸载该驱动程序或将其更新到兼容版本，然后再尝试更新，或者采用其他方法…… 隔离 Windows 中的渲染问题.
• HardblockMismatchedLanguage (ID 60BA8449-CF23-4D92-A108-D6FCEFB95B45) 警告说 源系统和目标系统的语言和操作系统版本不匹配。当尝试安装与当前系统语言不同的镜像文件，而又不满足兼容性要求时，这种情况很常见。
• HardblockFlightSigning (ID 598F2802-3E7F-4697-BD18-7A6371C8B2F8) 检测到 目标操作系统是预览体验成员版本（已签名为预发布版）。 并且目标机器已启用安全启动。如果未调整安全设置就安装了该预览体验成员版本，则此规则会阻止其启动。

磁盘空间不足和启动错误

除了系统分区之外，SetupDiag 还会考虑其他相关故障。 一般磁盘空间和启动.

• DiskSpaceBlockInDownLevel (ID 6080AFAC-892E-4903-94EA-7A17E69E549E) 表明 系统在降级操作期间空间不足。 更新。
• DiskSpaceFailure (ID 981DCBA5-B8D0-4BA7-A8AB-4030F7A10191) 它表明 系统单元已无可用空间 首次更新后不久，系统重启。换句话说，更新过程进行到需要重启的阶段，但由于空间不足而未能完成。
• BootFailureDetected (ID 4FB446C2-D4EC-40B4-97E2-67EB19D1CFB7) 通知已发生 更新过程中特定阶段出现启动错误它包含错误代码和阶段信息，从而更容易确定问题是出在引导加载程序、内核还是其他引导组件中。
• UnsignedDriverBootFailure (ID CD270AA4-C044-4A22-886A-F34EF2E79469) 明确指出 未签名的驱动程序导致了启动错误在这种情况下，通常需要将驱动程序替换为已签名的版本或与系统安全启动策略兼容的版本。
• WinSetupBootFilterFailure (ID C073BFC8-5810-4E19-B53B-4280B79E096C)当有以下情况时，该功能将被激活： 内核模式文件操作中的错误 在与安装相关的启动上下文中。

WimMount 驱动程序、WIM 文件和 DISM 错误

在任何 Windows 安装或更新过程中，这些文件 WIM（Windows映像格式） 它们发挥着关键作用。SetupDiag 有几条规则。 安装或应用这些图像时，请控制错误。.

• PreReleaseWimMountDriverFound (ID 31EC76CC-27EC-4ADC-9869-66AABEDB56F0) 捕获错误时 系统上注册了一个未识别或初步类型的 wimmount.sys 驱动程序。。 还 WimMountDriverIssue (ID 565B60DD-5403-4797-AE3E-BC5CB972FBAE) 它主要关注 WimMount.sys 的注册问题，WimMount.sys 是负责挂载 WIM 映像的组件。
• WimMountFailure (ID BE6DF2F1-19A6-48C6-AEF8-D3B0CE3D4549)它会识别受影响图像的名称和相关的错误代码。
• WimApplyExtractFailure (ID 746879E9-C9C5-488C-8D4B-0C811FF3A9A8) 当这种情况发生时，它会触发。 配置提取操作期间出现 WIM 应用程序错误其中，分别标明文件扩展名、文件路径和错误代码。
• DISMAddPackageFailed (ID 6196FF5B-E69E-4117-9EC6-9C1EAB20A3B9) 表示尝试时出现严重故障 使用 DISM 添加软件包提供软件包名称、具体的 DISM 错误以及相关代码。
• DISMImageSessionFailure (ID 61B7886B-10CD-4C98-A299-B987CB24A11C) 捕捉了以下情况： DISM 无法正确启动映像会话。尽管 DISMproviderFailure (ID D76EF86F-B3F8-433F-9EBF-B4411F8141F4) 当 DISM 提供程序（插件）在关键操作中失败时，将触发此消息，其中包括插件名称、调用的函数、错误代码和提供程序消息。

控制器、配置文件和插件的迁移

在原地升级过程中，会尝试…… 迁移配置、驱动程序和用户配置文件 迁移到新系统。SetupDiag 集成了众多规则，旨在检测这些流程中的故障。

• DriverMigrationFailure (ID 9378D9E2-256E-448C-B02F-137F611F5CE3) 反映 迁移驱动程序时出现无法恢复的错误.
• UnknownDriverMigrationFailure (ID D7541B80-5071-42CE-AD14-FBE8C0C4F7FD) 通常表示 系统中存在错误的驱动程序包。在后一种情况下，报告通常会提到冲突软件包的名称，典型的解决方法是将其删除，重新启动，如果可能的话，在重试更新之前从 OEM 安装更新版本。
• UserProvidedDriverInjectionFailure (ID 2247C48A-7EE3-4037-AFAB-95B92DE1D980)，当 明确提供给安装程序的驱动程序失败 （例如，使用命令行参数）。该报告会具体说明受影响的安装功能和错误代码。
• UserProfileSuffixMismatch (ID B4BBCCCE-F99D-43EB-9090-078213397FD8) 指向 迁移或配置文件创建失败 由与该配置文件关联的某些文件或对象引起。
• DuplicateUserProfileFailure (ID BD7B3109-80F1-4421-8F0A-B34CD25F4B51) 当出现以下情况时，表示存在严重错误： 多个 SID 与同一用户配置文件关联这通常发生在某些软件创建了从未被使用或登录过的本地帐户时。报告中包含 SID 和用户名；建议的解决方法是备份数据，以可控的方式删除该帐户，确保该帐户未被使用，然后重启计算机，之后再尝试更新。
• FindMigGatherApplyFailure (ID A9964E6C-A2A8-45FF-B6B5-25E0BD71428E) 它会在收集或应用程序操作期间收集迁移引擎的错误，并提供有关以下方面的数据： 受影响的迁移对象（文件路径或注册表项） 以及由此引发的移民问题。
• MigrationAbortedDueToPluginFailure (ID D07A24F6-5B25-474E-B516-A730085940C9) 表明安装程序已被强制执行 由于插件中存在严重错误，中止迁移该报告详细列出了正在进行的安装操作、插件名称、正在执行的操作以及错误代码。

调试和内存转储中的错误检测

在高级场景中，更新失败可能伴随以下情况： 错误检查（蓝屏）或 内存转储SetupDiag 具有旨在查找和分析这些案例的规则。

• DebugSetupMemoryDump (ID C7C63D8A-C5F6-4255-8031-74597773C3C6) 这是一条规则 仅限离线模式 这表明安装过程中发生了错误检查。如果系统上安装了调试工具，SetupDiag 将尝试调试内存转储并提供详细信息。
• DebugSetupCrash (ID CEEBA202-6F04-4BC3-84B8-7B99AED924B1) 这是一条规则 仅连接 这表明安装程序本身出现了内部错误，生成了进程的内存转储文件。借助合适的调试工具，该实用程序可以提取更多关于崩溃的信息。
• DebugMemoryDump (ID 505ED489-329A-43F5-B467-FCAAF6A1264C) 适用于 安装或升级过程中生成的任何 memory.dmp 文件当有调试支持时，也会尝试对其进行分析。
• FindDebugInfoFromRollbackLog (ID 9600EB68-1120-4A87-9FE9-3A4A70ACFC37) 允许 获取错误检查和内存转储的详细信息 在安装或升级过程中，利用回滚日志信息，而无需调试器二进制文件。

升级过程的一般诊断规则

最后，SetupDiag 还包含一组更全局的规则，旨在 总结更新状态以及可能出现错误的关键点。.

• FindSuccessfulUpgrade (ID 8A0824C8-A56D-4C55-95A0-22751AB62F3E) 根据记录确定 指定的更新已成功完成。 也可能不是。这是一种快速验证特定尝试结果的方法。
• FindSetupHostReportedFailure (ID 6253C04F-2E4E-4F7A-B88E-95A69702F7EC) 提供数据 更新过程开始时出现的错误与……相关 setuphost.exe。 除了， FindDownlevelFailure (ID 716334B7-F46A-4BAA-94F2-3E31BC9EFA55) 它收集 SetupPlatform 在更高级、更底层阶段公开的错误信息。
• FindAbruptDownlevelFailure (ID 55882B1A-DA3E-408A-9076-23B22A0472BD) 尝试 确定故障发生时正在进行的最后一个操作反过来， FindEarlyDownlevelError (ID A4CE4FC9-5E10-4BB1-8ECE-3B29EB9D7C52) 它专注于在主安装平台启动之前检测到的错误。
• FindSPFatalError (ID A4028172-1B09-48F8-AD3B-86CDD7D55852) 捕获 安装平台遇到无法恢复的故障时的错误信息尽管 FindSetupPlatformFailedOperationInfo (ID 307A0133-F06B-4B75-AEA8-116C3B53C2D1) 它提供了最后阶段和失败操作的详细信息，包括相关的错误。
• FindRollbackFailure (ID 3A43C9B5-05B3-4F7C-A955-88F991BB5A48) 总结最后一次执行的操作，以及发生故障和错误的阶段。 这引发了逆转。
• FindFatalPluginFailure (ID E48E3F1C-26F6-4AFB-859B-BF637DA49636) 它先于 安装平台认为无法恢复的任何插件错误生成插件名称、插件执行的操作以及错误代码。

综合所有这些规则，构成了 SetupDiag。 一款功能强大的工具，可用于微调 Windows 更新错误虽然它的许多消息都是为专业人士准备的，但即使是好奇的用户也可以依靠它们来确定更新永远无法完成的原因，了解问题是否是由于空间不足、特定驱动程序、未满足的硬件要求或干扰该过程的已安装软件造成的。