community.general.wakeonlan 模块 – 发送唤醒网络 (WoL) 魔术包

注意

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

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

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

要在剧本中使用它，请指定： community.general.wakeonlan。

概要

  • wakeonlan 模块发送唤醒网络 (WoL) 魔术包。

参数

参数

注释

broadcast

字符串

用于广播唤醒网络魔术包的网络广播地址。

默认值： "255.255.255.255"

mac

字符串 / 必需

发送唤醒网络广播包的目标 MAC 地址。

port

整数

唤醒网络魔术包使用的 UDP 端口。

默认值： 7

属性

属性

支持

描述

check_mode

支持：完全支持

可以在 check_mode 下运行，并在不修改目标的情况下返回更改状态预测。

diff_mode

支持：不支持

处于 diff 模式时，将返回有关已更改内容（或可能需要在 check_mode 中更改的内容）的详细信息。

备注

注意

  • 此模块发送一个魔术包，但不确定它是否成功。

  • 仅当目标系统已正确配置为唤醒网络 (在 BIOS 和/或操作系统中) 时才有效。

  • 某些 BIOS 具有不同的（可配置的）唤醒网络启动顺序（即，首先是 PXE）。

另请参阅

另请参阅

community.windows.win_wakeonlan

发送唤醒网络 (WoL) 魔术包。

示例

- name: Send a magic Wake-on-LAN packet to 00:00:5E:00:53:66
  community.general.wakeonlan:
    mac: '00:00:5E:00:53:66'
    broadcast: 192.0.2.23
  delegate_to: localhost

- community.general.wakeonlan:
    mac: 00:00:5E:00:53:66
    port: 9
  delegate_to: localhost

作者

  • Dag Wieers (@dagwieers)