ansible.builtin.wakeonlan (v2.9.27) — module

Send a magic Wake-on-LAN (WoL) broadcast packet

| "added in version" 2.2 of ansible.builtin"

Authors: Dag Wieers (@dagwieers)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.9.27

Description

The C(wakeonlan) module sends magic Wake-on-LAN (WoL) broadcast packets.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Send a magic Wake-on-LAN packet to 00:00:5E:00:53:66
  wakeonlan:
    mac: '00:00:5E:00:53:66'
    broadcast: 192.0.2.23
  delegate_to: localhost
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- wakeonlan:
    mac: 00:00:5E:00:53:66
    port: 9
  delegate_to: localhost

Inputs

    
mac:
    description:
    - MAC address to send Wake-on-LAN broadcast packet for.
    required: true

port:
    default: 7
    description:
    - UDP port to use for magic Wake-on-LAN packet.

broadcast:
    default: 255.255.255.255
    description:
    - Network broadcast address to use for broadcasting magic Wake-on-LAN packet.

See also