Модуль community.windows.win_power_plan — Изменение плана электропитания системы Windows

Примечание

Этот модуль входит в коллекцию community.windows (версия 3.1.0).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.windows.

Чтобы использовать её в плейбуке, укажите: community.windows.win_power_plan.

Обзор
Параметры
Примеры
Возвращаемые значения

Обзор

Этот модуль изменяет план электропитания системы Windows на заданную строку.
По умолчанию Windows использует balanced, что приводит к троттлингу ЦП. В некоторых случаях для повышения производительности ЦП может быть предпочтительнее переключить режим на high performance.
Необходимо указать name или guid.

Параметры

Параметр	Комментарии
guid string добавлено в community.windows 1.9.0	Строковое значение, указывающее требуемый план электропитания по GUID. План электропитания уже должен присутствовать в системе. Список встроенных GUID см. по адресу https://docs.microsoft.com/en-us/windows/win32/power/power-policy-settings.
name string	Строковое значение, указывающее требуемый план электропитания по имени. План электропитания уже должен присутствовать в системе. Как правило, доступны варианты `balanced` и `high performance`.

Примеры

- name: Change power plan to high performance
  community.windows.win_power_plan:
    name: high performance

- name: Change power plan to high performance
  community.windows.win_power_plan:
    guid: 8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
all_available_plans dictionary	Имена и состояние включения всех планов электропитания. Возвращается: всегда Пример: `{"Balanced": true, "High performance": false, "Power saver": false}`
power_plan_enabled boolean	Состояние указанного плана электропитания. Возвращается: при успешном выполнении Пример: `true`
power_plan_name string	Значение указанного плана электропитания. Возвращается: всегда Пример: `"balanced"`

Авторы

Noah Sparks (@nwsparks)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/windows/win_power_plan_module.html