Skip to content

Latest commit

 

History

History
135 lines (105 loc) · 2.81 KB

DnsServerARecords.adoc

File metadata and controls

135 lines (105 loc) · 2.81 KB

DSC Resource 'DnsServerARecords'

DnsServerARecords manages A (host) DNS records on a DNS server.

When to use 'DnsServerARecords'

Use this resource when you need to create or manage DNS A records that map hostnames to IPv4 addresses. This is used for registering server names, service endpoints, or any hostname-to-IP mappings in your DNS infrastructure.

Source

DSC Resource

Documentation
Table 1. Attributes of category 'DnsServerARecords'
Parameter Attribute DataType Description Allowed Values

Records

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

String

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