COMMAND EVERYTHING.

Set-WheaMemoryPolicy

Sets the WHEA memory policy for a computer.

PowerShell · Risk: High · Documentation Verified

Last verified: 2026-10-26

Microsoft Whea reference: Sets the WHEA memory policy for a computer. The syntax and selected example below are adapted from the pinned Windows Server 2025 reference. Module availability, target configuration and delegated permissions determine whether it can run in your environment. Documentation and parameter text: Microsoft, CC BY 4.0; formatting adapted by Cmdlet World. No execution testing is claimed.

Set-WheaMemoryPolicy [-ComputerName <String>] [-DisableOffline <Boolean>] [-DisablePFA <Boolean>]
 [-PersistMemoryOffline <Boolean>] [-PFAPageCount <UInt32>] [-PFAErrorThreshold <UInt32>]
 [-PFATimeout <UInt32>] [<CommonParameters>]

Copied 0 times

Required permissions

Use an account with the target resource permissions documented for Set-WheaMemoryPolicy. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.

Supported environments

Windows / Whea · Windows Server 2025 documentation; feature/module prerequisites apply

Parameters

-ComputerName: Specifies the name of the remote computer from which to retrieve policy information. If you do not specify a computer name, the command returns the policy of the local computer. The alias for *ComputerName* is cn.
-DisableOffline: Disables WHEA from taking memory pages offline in response to corrected or uncorrected memory errors.
-DisablePFA: Disables the predictive failure analysis algorithm and stops WHEA from monitoring memory pages that have corrected errors.
-PFAErrorThreshold: Specifies the number of corrected errors that must occur before a memory page in the PFA monitoring list is considered bad and is taken offline.
-PFAPageCount: Specifies the maximum size of the PFA monitoring list for pages that experience corrected memory errors.
-PFATimeout: Specifies the number of seconds that WHEA monitors a memory page using PFA. WHEA starts monitoring a memory page when the page has its first corrected error. WHEA stops monitoring a memory page when one of the following events occurs: - The monitoring interval exceeds the *PfaTimeout* value. or - The number of detected errors exceeds the *PfaErrorThreshold* value.
-PersistMemoryOffline: Indicates whether to persist memory-offline decisions across computer reboots.

Prerequisites

Windows with the Whea module and the Windows feature or management tools that provide it. Confirm target connectivity and version compatibility using the linked Microsoft reference.

Security considerations

This cmdlet changes system state. Review every target and parameter in the official reference, test outside production, and prepare an appropriate backup or rollback. Do not execute the example automatically.

Examples

Example 1: Enable WHEA predictive failure analysis

Set-WheaMemoryPolicy -DisablePFA $False

This command enables predictive failure analysis on the local computer. Source: Microsoft, CC BY 4.0; transcript prompt/output removed. This example was not executed.

Sources

https://github.com/MicrosoftDocs/windows-powershell-docs/blob/b7645dd8c687139b28e845119da30ec670526507/docset/winserver2025-ps/Whea/Set-WheaMemoryPolicy.md

https://learn.microsoft.com/powershell/module/whea/set-wheamemorypolicy?view=windowsserver2025-ps

Personal collections

Explain or customize this command with AI

Related commands