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)