community.windows.win_power_plan 模块 – 更改 Windows 系统的电源计划

注意

此模块是 community.windows 集合 (版本 2.3.0) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.windows。

要在 playbook 中使用它，请指定： community.windows.win_power_plan。

概要

  • 此模块会将 Windows 系统的电源计划更改为定义的字符串。

  • Windows 默认设置为 balanced，这会导致 CPU 节流。在某些情况下，最好将模式更改为 high performance 以提高 CPU 性能。

  • 必须提供 _name_ 或 _guid_ 之一。

参数

参数

注释

guid

字符串

在 community.windows 1.9.0 中添加

指示所需电源计划的 GUID 字符串值。

电源计划必须已存在于系统中。

有关开箱即用的 GUID，请参阅 https://docs.microsoft.com/en-us/windows/win32/power/power-policy-settings。

name

字符串

指示所需电源计划名称的字符串值。

电源计划必须已存在于系统中。

通常会有 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

字典

所有电源计划的名称和启用状态。

返回：始终

示例： {"Balanced": true, "High performance": false, "Power saver": false}

power_plan_enabled

布尔值

预期电源计划的状态。

返回：成功

示例： true

power_plan_name

字符串

预期电源计划的值。

返回：始终

示例： "balanced"

作者

  • Noah Sparks (@nwsparks)