DnsServerARecords.adoc

DSC Resource 'DnsServerARecords'

DnsServerARecords manages A DNS records against a specific zone on a Domain Name System (DNS) server.

Source	https://github.com/dsccommunity/CommonTasks/tree/main/source/DSCResources/DnsServerARecords
DSC Resource	DnsServerDsc
Documentation	DnsRecordA

Table 1. Attributes of category 'DnsServerARecords'

Parameter	Attribute	DataType	Description	Allowed Values
Records	Mandatory	Hashtable[]	List of A DNS records

Table 2. Attributes of category 'DnsServerARecords/Records'

Parameter	Attribute	DataType	Description	Allowed Values
Name	Key	String	Specifies the name of a DNS server resource record object.
ZoneName	Key	String	Specifies the name of a DNS zone.
IPv4Address	Key		Specifies the IPv4 address of a host.
TimeToLive		String	Specifies the TimeToLive value of the SRV record. Value must be in valid TimeSpan string format (i.e.: Days.Hours:Minutes:Seconds.Miliseconds or 30.23:59:59.999).
Ensure		String	Whether the host record should be present or removed	Present (default) Absent

Example

DnsServerARecords:
  Records:
    - Name:        mailserver1
      ZoneName:    contoso.com
      IPv4Address: 192.168.1.10
      Ensure:      Present

    - Name:        server2
      ZoneName:    PrimaryZone2
      IPv4Address: 192.168.2.11
      TimeToLive:  '01:00:00'

Recommended Lookup Options in Datum.yml (Excerpt)

default_lookup_options: MostSpecific

lookup_options:

  DnsServerARecords:
    merge_hash: deep
  DnsServerARecords\Records:
    merge_hash_array: UniqueKeyValTuples
    merge_options:
      tuple_keys:
        - Name
        - ZoneName
        - IPv4Address