win_power_plan - Changes the power plan of a Windows system

New in version 2.4.

Synopsis

Requirements

The below requirements are needed on the host that executes this module.

  • Windows Server 2008R2 (6.1)/Windows 7 or higher

Parameters

Parameter Choices/Defaults Comments
name
required
String value that indicates the desired power plan. The power plan must already be present on the system. Commonly there will be options for balanced and high performance.

Examples

- name: Change power plan to high performance
  win_power_plan:
    name: high performance

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
all_available_plans
dictionary
always
The name and enabled state of all power plans

Sample:
{ "High performance": false, "Balanced": true, "Power saver": false }
power_plan_enabled
boolean
success
State of the intended power plan

Sample:
True
power_plan_name
string
always
Value of the intended power plan

Sample:
balanced


Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Maintenance

This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Community, see here.

Author

  • Noah Sparks (@nwsparks)

Hint

If you notice any issues in this documentation you can edit this document to improve it.