Win32_PowerPlan class

Represents a power plan on a system. A power plan or scheme consists of a group of power settings and preference information. Each power plan is identified through a unique GUID as well as by a friendly name. Windows power plans also have a personality attribute that indicates the overall power savings behavior of the plan. Multiple power plans can exist; however, each computer can have only a single active power plan in effect at any given time.

A WMI consumer can enumerate all instances of Win32_PowerPlan to get all the power schemes that currently exist on the system. The active Win32_PowerPlan can be obtained by examining the IsActive property on the instance. The Activate method will make the power plan the active plan on the system.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.

Syntax

[Provider("PowerWmiProvider"), Dynamic]
class Win32_PowerPlan : CIM_SettingData
{
  string  InstanceID;
  string  ElementName;
  string  Description;
  boolean IsActive;
};

Members

The Win32_PowerPlan class has these types of members:

• Methods
• Properties

Methods

The Win32_PowerPlan class has these methods.

Properties

The Win32_PowerPlan class has these properties.

Description

Data type: string

Access type: Read-only

Specifies the description of the power plan.

ElementName

Data type: string

Access type: Read-only

Specifies the friendly name of the power plan.

InstanceID

Data type: string

Access type: Read-only

Defines the unique identifier for the power plan instance.

The InstanceID string must be in the following format: "Microsoft:PowerPlan\{Plan_GUID}".

IsActive

Data type: boolean

Access type: Read-only

Indicates whether the power scheme is currently active on the system. This property is set to TRUE if the power scheme is active; otherwise, it is set to FALSE.

Examples

The following PowerShell code example displays the power settings of the local computer.

$powerplan=get-wmiobject -namespace "root\cimv2\power" -class Win32_powerplan | where {$_.IsActive}

$powerSettings = $powerplan.GetRelated("win32_powersettingdataindex") | foreach {
 $powersettingindex = $_;

 $powersettingindex.GetRelated("Win32_powersetting") | select @{Label="Power Setting";Expression={$_.instanceid}},
 @{Label="AC/DC";Expression={$powersettingindex.instanceid.split("\")[2]}},
 @{Label="Summary";Expression={$_.ElementName}},
 @{Label="Description";Expression={$_.description}},
 @{Label="Value";Expression={$powersettingindex.settingindexvalue}}
 }

$powerSettings | ft "AC/DC",Summary,Value -autosize

Requirements