Enforce upgrade component rules

Policy ID
MSI_EnforceUpgradeComponentRules
Scope
Computer Configuration
Supported on
Windows Installer v3.0
Source
Administrative Templates (.admx) for Windows 11 2026 Update (26H2) (version 1.0)
Category
Windows Components › Windows Installer

Description

This policy setting causes the Windows Installer to enforce strict rules for component upgrades.

If you enable this policy setting, strict upgrade rules will be enforced by the Windows Installer which may cause some upgrades to fail. Upgrades can fail if they attempt to do one of the following:

(1) Remove a component from a feature.
This can also occur if you change the GUID of a component. The component identified by the original GUID appears to be removed and the component as identified by the new GUID appears as a new component.

(2) Add a new feature to the top or middle of an existing feature tree.
The new feature must be added as a new leaf feature to an existing feature tree.

If you disable or do not configure this policy setting, the Windows Installer will use less restrictive rules for component upgrades.

Registry

ComputerHKEY_LOCAL_MACHINE
  • EnforceUpgradeComponentRulesREG_DWORD

Other policies in the same category

View all policies in this category (23)