Skip to content

DnsServerConditionalForwarders.adoc

Latest commit

 

History

History
122 lines (95 loc) · 2.96 KB

DnsServerConditionalForwarders.adoc

File metadata and controls

122 lines (95 loc) · 2.96 KB

DSC Resource 'DnsServerConditionalForwarders'

DnsServerConditionalForwarders manages conditional forwarders on a DNS server.

When to use 'DnsServerConditionalForwarders'

Use this resource when you need to forward DNS queries for specific domains to designated DNS servers. Conditional forwarders are essential in environments with multiple DNS namespaces, domain trusts, or split-brain DNS configurations where queries for certain domains must go to specific servers.

You can manage the master servers, forwarder time-out, recursion, recursion scope, and directory partition name for a conditional forwarder zone.

Source

DSC Resource

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

ConditionalForwarders

Hashtable[]

List of conditional forwarders
Table 2. Attributes of category 'DnsServerConditionalForwarders/ConditionalForwarders'
Parameter Attribute DataType Description Allowed Values

Name

Key

String

The name of the zone to manage.

MasterServers

String[]

The IP addresses the forwarder should use.

Mandatory if Ensure is Present.

ReplicationScope

String

Whether the conditional forwarder should be replicated in AD, and the scope of that replication.

  • None (default)

  • Custom

  • Domain

  • Forest

  • Legacy

DirectoryPartitionName

String

The name of the directory partition to use when the ReplicationScope is Custom.

This value is ignored for all other replication scopes.

Ensure

String

Whether the primary zone should be present or removed

  • Present (default)

  • Absent
Example
DnsServerConditionalForwarders:
  ConditionalForwarders:
    - Name: SharedServices
      MasterServers:
        - 10.0.1.10
        - 10.0.2.10
      ReplicationScope: Forest
    - Name: Oxy
      MasterServers:
        - 10.0.3.10
      ReplicationScope: Forest