win_dns_client - Configures DNS lookup on Windows hosts

New in version 2.3.

Synopsis

  • The win_dns_client module configures the DNS client on Windows network adapters.

Parameters

Parameter Choices/Defaults Comments
adapter_names
required
Adapter name or list of adapter names for which to manage DNS settings ('*' is supported as a wildcard value). The adapter name used is the connection caption in the Network Control Panel or via Get-NetAdapter, eg Local Area Connection.
ipv4_addresses
required
Single or ordered list of DNS server IPv4 addresses to configure for lookup. An empty list will configure the adapter to use the DHCP-assigned values on connections where DHCP is enabled, or disable DNS lookup on statically-configured connections.

Notes

Note

  • When setting an empty list of DNS server addresses on an adapter with DHCP enabled, a change will always be registered, since it is not possible to detect the difference between a DHCP-sourced server value and one that is statically set.

Examples

# set a single address on the adapter named Ethernet
- win_dns_client:
    adapter_names: Ethernet
    ipv4_addresses: 192.168.34.5

# set multiple lookup addresses on all visible adapters (usually physical adapters that are in the Up state), with debug logging to a file
- win_dns_client:
    adapter_names: "*"
    ipv4_addresses:
    - 192.168.34.5
    - 192.168.34.6
    log_path: c:\dns_log.txt

# configure all adapters whose names begin with Ethernet to use DHCP-assigned DNS values
- win_dns_client:
    adapter_names: "Ethernet*"
    ipv4_addresses: []

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Support

For more information about Red Hat’s support of this module, please refer to this Knowledge Base article

Author

  • Matt Davis (@nitzmahone)

Hint

If you notice any issues in this documentation you can edit this document to improve it.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/win_dns_client_module.html