win_ping - A windows version of the classic ping module

New in version 1.7.


  • Checks management connectivity of a windows host.
  • This is NOT ICMP ping, this is just a trivial test module.
  • For non-Windows targets, use the ping module instead.


parameter required default choices comments
no pong
Alternate data to return instead of 'pong'.
If this parameter is set to crash, the module will cause an exception.


# Test connectivity to a windows host
# ansible winserver -m win_ping

# Example from an Ansible Playbook
- win_ping:

# Induce an exception to see what happens
- win_ping:
    data: crash

Return Values

Common return values are documented here Return Values, the following are the fields unique to this module:

name description returned type sample
value provided with the data parameter
success string pong



  • For non-Windows targets, use the ping module instead.


This module is flagged as stableinterface which means that the maintainers for this module guarantee that no backward incompatible interface changes will be made.

Maintenance Info

For more information about Red Hat’s this support of this module, please refer to this knowledge base article<>

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.