PreferredPlan

PreferredPlan enables you to specify a plan for the power settings of the computer. You can specify the power plan, by using a Globally Unique Identifier (GUID) for an existing power plan. The specified power plan determines the following default setting values: power button; sleep button; lid switch; and password on resume. The power plan also specifies icons on the Global Settings Task page for the power button, the sleep button, and the lid switch used to retrieve global settings information, including icons for buttons and the lid switch.

Note

For the power button, the sleep button, the lid switch, and the password-on-resume setting values, the preferred plan values are in effect only until the first time the setting is changed. After that, all the power plans use the setting specified by the end user.

Use the powercfg -list option to view the GUIDs for the different power plans available on your Windows installation. For example,

C:\>powercfg -LIST

Existing Power Schemes (* Active)
-----------------------------------
Power Scheme GUID: 381b4222-f694-41f0-9685-ff5bb260df2e  (Balanced)
Power Scheme GUID: 8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c  (High performance)
Power Scheme GUID: a1841308-3541-4fab-bc81-f71556f20b4a  (Power saver) *

For more information, see the powercfg command-line help.

Values

GUID

Specifies a valid power plan GUID. For example, 381b4222-f694-41f0-9685-ff5bb260df2e. The default GUID is the Windows Automatic power plan.

This string type does not support empty elements. Do not create an empty value for this setting.

Parent Hierarchy

Microsoft-Windows-powercpl | PreferredPlan

Valid Passes

generalize

specialize

Applies To

For the list of the supported Windows editions and architectures that this component supports, see Microsoft-Windows-powercpl.

XML Example

The following XML output shows how to configure a GUID for the PreferredPlan.

<PreferredPlan>381b4222-f694-41f0-9685-ff5bb260df2e</PreferredPlan>

See Also

Concepts

Microsoft-Windows-powercpl