ansible.builtin.win_power_plan (v2.6.2) — module

Changes the power plan of a Windows system

| "added in version" 2.4 of ansible.builtin"

Authors: Noah Sparks (@nwsparks)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.6.2

Description

This module will change the power plan of a Windows system to the defined string.

Windows defaults to C(balanced) which will cause CPU throttling. In some cases it can be preferable to change the mode to C(high performance) to increase CPU performance.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Change power plan to high performance
  win_power_plan:
    name: high performance

Inputs

    
name:
    description:
    - String value that indicates the desired power plan. The power plan must already
      be present on the system. Commonly there will be options for C(balanced) and C(high
      performance).
    required: true

Outputs

all_available_plans:
  description: The name and enabled state of all power plans
  returned: always
  sample: "{\n    \"High performance\":  false,\n    \"Balanced\":  true,\n    \"\
    Power saver\":  false\n}\n"
  type: dictionary
power_plan_enabled:
  description: State of the intended power plan
  returned: success
  sample: true
  type: boolean
power_plan_name:
  description: Value of the intended power plan
  returned: always
  sample: balanced
  type: string