Skip to main content

Update Windows 11 24H2 To 25H2 [Enablement Package]

Summary​

Upgrades Windows 11 version 24H2 devices to version 25H2 with a single restart. Apps, files, and settings stay in place.

The upgrade uses Microsoft's enablement package (KB5054156), a small update that switches on 25H2 features already delivered to the device by monthly updates. To learn how it works, see KB5054156: Feature update to Windows 11, version 25H2 by using an enablement package.

It works by running the Update-Windows11To25H2 script. Devices that do not qualify are left unchanged and reported as failures.

warning

NoReboot does not guarantee that the device stays up. It only stops this script from restarting the device. Windows Update can still restart it on its own schedule, for example to finish installing other updates, and patch policies or users can restart it too. Any restart completes the upgrade, so run this script inside a maintenance window if restart timing matters.

note

Devices need Windows 11 version 24H2 with the August 29, 2025 update (KB5064081) or any later monthly update.

Sample Run​

Image1

Dependencies​

Global Variables​

NameValueAccepted ValuesDescription
DebugFalseFalse, TrueWhen True, enables informational logging; when False (default), informational logs are suppressed to avoid adding entries to the h_scripts table. Set to True to assist with troubleshooting.
ScriptEngineEnableLoggerFalseFalse, TrueWhen True, enables final (success/failure) logging; when False (default), these logs are suppressed to avoid adding entries to the h_scripts table. Set to True to assist with troubleshooting.

User Parameters​

NameExampleRequiredDescription
NoReboot1FalseSet to 1 to install the upgrade without restarting the device. The upgrade completes on the next restart from any source. See the warning in the Summary.
RebootDelaySeconds900FalseSeconds to wait before restarting, from 60 to 86400. Signed-in users see a restart warning during this time. Any other value stops the script before it makes changes. Ignored when NoReboot is set. Default: 300.
IgnoreSafeguardHold1FalseSet to 1 to install the upgrade even when Microsoft has placed a safeguard hold on the device. Use only on tested devices.

Results by Device​

DeviceResult
Windows 11 24H2, all requirements metUpgraded to 25H2. Restarts after the delay unless NoReboot is set.
Windows 11 25H2 or newerSuccess. No changes.
Windows 11 24H2 without the required updateFailure. No changes. Install the latest monthly update and run again.
Windows 11 23H2 or earlier, or Windows 10Failure. No changes. These versions need a full feature update instead.
Windows 11 LTSC edition or Windows ServerFailure. No changes. Not eligible for this upgrade.
Device under a safeguard holdFailure. No changes, unless IgnoreSafeguardHold is set.
note

A safeguard hold is Microsoft blocking an update on devices with a known problem, such as an incompatible driver. The failure message includes the safeguard ID, which you can look up on the Windows 11, version 25H2 known issues page.

Output​

  • Script log
  • Script logs on the device:
    • C:\ProgramData\_Automation\Script\Update-Windows11To25H2\Update-Windows11To25H2-log.txt
    • C:\ProgramData\_Automation\Script\Update-Windows11To25H2\Update-Windows11To25H2-error.txt

Changelog​

2026-10-06​

  • Initial version of the document.