win_net_adapter

win_net_adapter - Sets one or more interface specific DNS client configurations on a Windows host

Synopsis

This Ansible module allows to set one or more the interface specific DNS client configurations.
Uses the connection specific suffix as filter to select network card to update.

Parameters

Parameter	Choices/Defaults	Comments
suffix_filter string / required		Specifies the DNS suffixes or the network profile names which will be used to filter the network adapter to configure.
new_name string		Specifies the new name and interface alias of the network adapter. The module adds index as '_I(index)' to the name when more netcard are using the same DNS suffixe. For example, if new_name = `OOB` then netcard1 will be named `OOB`, netcard2 will be named `OOB_1` and netcard3 will be name `OOB_2`.
register_ip_address boolean	Choices: no yes	Indicates whether the IP address for this connection is to be registered. Updates the option 'Register this connection's addresses in DNS' in DNS client tab properties.
reset_server_addresses boolean	Choices: no yes	Resets the DNS server IP addresses to the default value.
server_addresses string		Specifies a list of DNS server IP addresses to set for the interface.
tcpip6 boolean	Choices: no yes	Specifies to enable or to disable the IPv6 binding to the network adapter.

Examples

---
- name: Should renames a netcard
  win_net_adapter:
    suffix_filter: oob*
    new_Name: OOB

- name: Should disable the tcp ipv6 protocole
  win_net_adapter:
    suffix_filter: oob*
    tcpip6: false

- name: Should return the register_ip_address state
  win_net_adapter:
    suffix_filter: oob*
    register_ip_address: false

- name: Should reset the server addresses
  win_net_adapter:
    suffix_filter: consoto.com
    reset_server_addresses: true

- name: Should change the server addresses
  win_net_adapter:
    suffix_filter: consoto.com
    server_addresses: 8.8.8.8,8.8.8.4

- name: Should renames and configure multiple netcards
  win_net_adapter:
    suffix_filter: consoto.local,*.consoto.local
    new_name: OOB
    reset_server_addresses: true
    register_ip_address: false

- name: Should disable the tcp ipv6 protocole on all cards
  win_net_adapter:
    suffix_filter: '*'
    tcpip6: false