大网数据广告活动
启动与系统组件

Use the Windows Setup Compatibility Scan Logs to Identify Blocking Issues

· 52CE 我爱测

Discusses how to locate and interpret Windows Setup compatibility scans to resolve compatibility issues.

During a feature update or in-place upgrade, Windows Setup runs a compatibility scan. If Setup detects incompatible applications or drivers, it records the findings in XML reports in the Panther logging folder. This guide explains:

  • What result codes mean (for example, 0xC1900208 - incompatible app).
  • Where to find log files.
  • How to interpret CompatData*.xml and *_APPRAISER_HumanReadable.xml.
  • How to remediate compatibility issues, either manually or at scale, by using Setup's /compat scanonly mode and the SetupDiag tool.

Symptoms

You run a Windows feature update or an in-place upgrade on a Windows computer. The Windows Setup process fails and returns a 0xC1900208 error code. This code indicates a compatibility issue. The computer has an application or driver that's not compatible with the new version or feature update. You might encounter this issue even if the incompatible application or driver was already uninstalled.

Note:
If Windows Setup returns the 0xC1900210 code instead, no compatibility issues exist.

Resolution

Note:
If you want to test compatibility before you deploy a feature update or in-place upgrade at scale (by using Microsoft Intune or Microsoft Endpoint Manager), review How to test compatibility at scale. That section describes special considerations and techniques to supplement the following procedure.

  1. Use the compatibility scan logs (CompatData*.xml or *_APPRAISER_HumanReadable.xml) to identify the blocking issue. For more information, see How to use the compatibility scan logs to identify the blocking issue.

  2. Fix the problematic application or driver. For example, uninstall it or upgrade it to a compatible version. If the human-readable log points to a specific file, and the related application or driver was already uninstalled, remove the indicated file.

  3. If you intend to use the same media for the next setup attempt, clear the setup-related caches:

    • Empty the C:\Windows\SoftwareDistribution\Download folder.
    • If you don't need the files in the hidden C:$WINDOWS.~BT folder, empty the folder.
  4. To make sure that Setup has the latest compatibility information, use Dynamic Update. For more information, see Update Windows installation media with Dynamic Update.

  5. To test compatibility without running the full setup, run the following command at a Windows command prompt:

    ```setup.exe /auto upgrade /noreboot /eula accept /compat scanonly /compat ignorewarning 
    

    For more information, see Windows Setup Command-Line Options: /Compat.

  6. Recheck the logs to make sure that the issue doesn't recur, and that Setup generated the 0xC1900210 code. If it generated the 0xC1900208 code, review the logs for other compatibility issues.

  7. After the compatibility checks pass, retry the upgrade.

How to use the compatibility scan logs to identify the blocking issue

During the setup process, Windows Setup stores logs in different locations. Look for the log files in the following locations.

[!TIP]
These folders are hidden. To make sure that you can search the folders, open File Explorer, select the View menu, select Show, and then make sure that Hidden items is selected.

  • Logs that Setup stores during the Downlevel, OOBE, or Rollback stages of the Setup process: C:\$WINDOWS.~BT\Sources\Panther\CompatData<date-time>.xml.

    [!NOTE]
    In this file path, <date-time> represents the date and time when the file was created. The latest timestamp is the most relevant to the troubleshooting process.

    :::image type="content" source="./media/use-windows-setup-compatibility-scan-logs-to-identify-blocking-issues/list-of-compatdata-log-files.png" alt-text="A directory listing of the compatibility log files.":::

  • Logs that Setup stores after the OOBE stage of the Setup process: C:\Windows\Panther.

  • Human-readable log that the compatibility appraiser stores: Search the operating system drive for *_APPRAISER_HumanReadable.xml.

For more information about Setup log files, see Windows upgrade log files.

Using the CompatData<date-time>.xml file

Open the most recent CompatData<date-time>.xml, and search for the following strings:

  • In the <Programs> section, search for BlockingType="Hard". This string identifies programs that you have to remove or mitigate in order to upgrade Windows. The following excerpt shows an application that's identified in this manner:

        <DriverPackage Inf="oem471.inf: BlockMigration="False" HasSignedBinaries="True"/>
      </DriverPackages>
      <Programs>
        <Program Name="Some Wallpaper Apps may be incompatible" Id="{3eb4353f-e9c5-44b4-97c6-a07df49c5803}" DefaultIcon="True">
          <CompatibilityInfo BlockingType="Hard" StatusDetail="WarnUpgrade" Message="Your PC has an app that changes the Window Desktop or Wallpaper and it may be incompatible with this version of Windows. This app may...
          <Link Target="https://go.microsoft.com/fwlink/?LinkId=2311650" Value="Learn More"/>
          <Action Name="Dismiss" Link="wsc:wica:_{3eb4353f-e9c5-44b4-97c6-a07df49c5803}" DisplayStyle="Link" ResolveState="NotRun"/>
        </Program>
      </Programs>
    </CompatReport>
    
  • Search the file for //DriverPackages/DriverPackage[@BlockMigration="True"]. This string identifies a driver that won't migrate. You have to upgrade or remove this driver in order to upgrade Windows.

Using the *_APPRAISER_HumanReadable.xml file

The human-readable log file uses a flattened, easier-to-scan XML file than the CompatData logs. You can use this log to find exact file paths to files that block Setup, including .exe or .dll files that are left behind after you uninstall an application. To find this information, follow these steps:

  1. Open the most recent *_APPRAISER_HumanReadable.xml file, and then search for the DT_ANY_FMC_BlockingApplication=True string.

  2. After you find the string, search for a nearby occurrence of the LowerCaseLongPathUnexpanded property. This property records the exact file path to the blocking artifact.

    :::image type="content" source="./media/use-windows-setup-compatibility-scan-logs-to-identify-blocking-issues/human-readable-compatibility-properties.png" alt-text="The human-readable XML file. This image highlights the property elements of applications that have compatibility issues.":::

How to test compatibility at scale

Before you try to run an update or upgrade operation at scale, run setup.exe together with the /compat scanonly switch to generate logs that you can use to inventory blocking applications and drivers.

To help resolve compatibility issues, use the SetupDiag tool. SetupDiag parses Windows Setup logs and maps the log data to known rules (for example, CompatBlockedApplication) that pinpoint the causes of setup issues. To start SetupDiag, open a Windows Command Prompt window, and then run a command that resembles the following command:

SetupDiag.exe /LogsPath "C:\Temp\WindowsSetupLogs" /Output "C:\Temp\SetupDiag-Results.txt"

You can combine SetupDiag outputs into your reporting pipeline.

More information

Microsoft Compatibility Appraiser creates registry entries in the HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AppCompatFlags subkey. This process runs as the \Microsoft\Windows\Application Experience\Microsoft Compatibility Appraiser scheduled task.

Windows inbox and appraiser processes and Dynamic update processes write and refresh compatibility intelligence when they run scans. Windows Setup, Windows Update, and enterprise tools then use this information to decide whether a device is ready for a target release without running a full upgrade.

References

Source: Microsoft Learn / IT Pro troubleshooting by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / IT Pro troubleshooting
适用范围
- Supported versions of Windows Client · Source date 02/12/2026
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。