community.windows.win_wakeonlan 模块 – 发送一个魔术唤醒局域网 (WoL) 广播包

注意

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

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

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

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

概要

  • win_wakeonlan 模块发送魔术唤醒局域网 (WoL) 广播数据包。

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

参数

参数

注释

broadcast

字符串

用于广播魔术唤醒局域网数据包的网络广播地址。

默认值： "255.255.255.255"

mac

字符串 / 必需

要为其发送唤醒局域网广播数据包的 MAC 地址。

port

整数

用于魔术唤醒局域网数据包的 UDP 端口。

默认值： 7

注意

注意

  • 此模块发送一个魔术数据包，而不知道它是否有效。 它总是报告更改。

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

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

另请参阅

另请参阅

community.general.wakeonlan

发送魔术唤醒局域网 (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)