community.windows.win_dns_zone – Manage Windows Server DNS Zones

Note

This plugin is part of the community.windows collection (version 1.6.0).

To install it use: ansible-galaxy collection install community.windows.

To use it in a playbook, specify: community.windows.win_dns_zone.

Synopsis

  • Manage Windows Server DNS Zones

  • Adds, Removes and Modifies DNS Zones - Primary, Secondary, Forwarder & Stub

  • Task should be delegated to a Windows DNS Server

Requirements

The below requirements are needed on the host that executes this module.

  • This module requires Windows Server 2012R2 or Newer

Parameters

Parameter Choices/Defaults Comments
dns_servers
list / elements=string
Specifies an list of IP addresses of the primary servers of the zone.
DNS queries for a forwarded zone are sent to primary servers.
Required if l(type=secondary), l(type=forwarder) or l(type=stub), otherwise ignored.
At least one server is required.
dynamic_update
string
    Choices:
  • secure
  • none
  • nonsecureandsecure
Specifies how a zone handles dynamic updates.
Secure DNS updates are available only for Active Directory-integrated zones.
When not specified during new zone creation, Windows will default this to l(none).
forwarder_timeout
integer
Specifies a length of time, in seconds, that a DNS server waits for a remote DNS server to resolve a query.
Accepts integer values between 0 and 15.
If the provided value is not valid, it will be omitted and a warning will be issued.
name
string / required
Fully qualified name of the DNS zone.
replication
string
    Choices:
  • forest
  • domain
  • legacy
  • none
Specifies the replication scope for the DNS zone.
l(replication=forest) will replicate the DNS zone to all domain controllers in the Active Directory forest.
l(replication=domain) will replicate the DNS zone to all domain controllers in the Active Directory domain.
l(replication=none) disables Active Directory integration and creates a local file with the name of the zone.
This is the equivalent of selecting l(store the zone in Active Directory) in the GUI.
state
string
    Choices:
  • present ←
  • absent
Specifies the desired state of the DNS zone.
When l(state=present) the module will attempt to create the specified DNS zone if it does not already exist.
When l(state=absent), the module will remove the specified DNS zone and all subsequent DNS records.
type
string
    Choices:
  • primary
  • secondary
  • stub
  • forwarder
Specifies the type of DNS zone.
When l(type=secondary), the DNS server will immediately attempt to perform a zone transfer from the servers in this list. If this initial transfer fails, then the zone will be left in an unworkable state. This module does not verify the initial transfer.

Examples

- name: Ensure primary zone is present
  community.windows.win_dns_zone:
    name: wpinner.euc.vmware.com
    replication: domain
    type: primary
    state: present

- name: Ensure DNS zone is absent
  community.windows.win_dns_zone:
    name: jamals.euc.vmware.com
    state: absent

- name: Ensure forwarder has specific DNS servers
  community.windows.win_dns_zone:
    name: jamals.euc.vmware.com
    type: forwarder
    dns_servers:
      - 10.245.51.100
      - 10.245.51.101
      - 10.245.51.102

- name: Ensure stub zone has specific DNS servers
  community.windows.win_dns_zone:
    name: virajp.euc.vmware.com
    type: stub
    dns_servers:
      - 10.58.2.100
      - 10.58.2.101

- name: Ensure stub zone is converted to a secondary zone
  community.windows.win_dns_zone:
    name: virajp.euc.vmware.com
    type: secondary

- name: Ensure secondary zone is present with no replication
  community.windows.win_dns_zone:
    name: dgemzer.euc.vmware.com
    type: secondary
    replication: none
    dns_servers:
      - 10.19.20.1

- name: Ensure secondary zone is converted to a primary zone
  community.windows.win_dns_zone:
    name: dgemzer.euc.vmware.com
    type: primary
    replication: none
    dns_servers:
      - 10.19.20.1

- name: Ensure primary DNS zone is present without replication
  community.windows.win_dns_zone:
    name: basavaraju.euc.vmware.com
    replication: none
    type: primary

- name: Ensure primary DNS zone has nonsecureandsecure dynamic updates enabled
  community.windows.win_dns_zone:
    name: basavaraju.euc.vmware.com
    replication: none
    dynamic_update: nonsecureandsecure
    type: primary

- name: Ensure DNS zone is absent
  community.windows.win_dns_zone:
    name: marshallb.euc.vmware.com
    state: absent

- name: Ensure DNS zones are absent
  community.windows.win_dns_zone:
    name: "{{ item }}"
    state: absent
  loop:
    - jamals.euc.vmware.com
    - dgemzer.euc.vmware.com
    - wpinner.euc.vmware.com
    - marshallb.euc.vmware.com
    - basavaraju.euc.vmware.com

Return Values

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

Key Returned Description
zone
dictionary
When l(state=present)
New/Updated DNS zone parameters

Sample:
{'dns_servers': None, 'dynamic_update': None, 'forwarder_timeout': None, 'name': None, 'paused': None, 'replication': None, 'reverse_lookup': None, 'shutdown': None, 'type': None, 'zone_file': None}


Authors

  • Joe Zollo (@joezollo)