community.windows.win_wakeonlan 模块 – 发送 Magic Wake-on-LAN (WoL) 广播数据包

注意

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

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

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

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

概要

  • win_wakeonlan 模块发送 Magic Wake-on-LAN (WoL) 广播数据包。

  • 对于非 Windows 目标，请改用 community.general.wakeonlan 模块。

参数

参数

注释

broadcast

字符串

用于广播 Magic Wake-on-LAN 数据包的网络广播地址。

默认值： "255.255.255.255"

mac

字符串 / 必需

要为其发送 Wake-on-LAN 广播数据包的 MAC 地址。

port

整数

用于 Magic Wake-on-LAN 数据包的 UDP 端口。

默认值： 7

备注

注意

  • 此模块发送一个 Magic 数据包，而不确定它是否成功。它始终报告更改。

  • 仅当目标系统已正确配置为 Wake-on-LAN（在 BIOS 和/或操作系统中）时才有效。

  • 某些 BIOS 具有不同的（可配置的）Wake-on-LAN 启动顺序（即，首先是 PXE）。

另请参见

另请参见

community.general.wakeonlan

发送 Magic Wake-on-LAN (WoL) 广播数据包。

示例

- name: Send a magic Wake-on-LAN packet to 00:00:5E:00:53:66
  community.windows.win_wakeonlan:
    mac: 00:00:5E:00:53:66
    broadcast: 192.0.2.23

- name: Send a magic Wake-On-LAN packet on port 9 to 00-00-5E-00-53-66
  community.windows.win_wakeonlan:
    mac: 00-00-5E-00-53-66
    port: 9
  delegate_to: remote_system

作者

  • Dag Wieers (@dagwieers)