Skip to content

DnsServerAdZones.adoc

Latest commit

 

History

History
141 lines (111 loc) · 3.11 KB

DnsServerAdZones.adoc

File metadata and controls

141 lines (111 loc) · 3.11 KB
Raw

DSC Resource 'DnsServerAdZones'

DnsServerAdZones manages Active Directory-integrated DNS zones on a DNS server.

When to use 'DnsServerAdZones'

Use this resource when you need to create or configure AD-integrated DNS zones. AD-integrated zones store DNS data in Active Directory and benefit from AD replication, multi-master updates, and integrated security. This is the standard choice for DNS zones in an Active Directory environment.

Source

DSC Resource

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

AdZones

Hashtable[]

List of AD integrated zones

DomainCredential

PSCredential

Specifies the credential to use to create the AD zones on a remote computer.

This parameter can only be used when you also are passing a value for the ComputerName parameter of the AD zone.
Table 2. Attributes of category 'DnsServerAdZones/AdZones'
Parameter Attribute DataType Description Allowed Values

Name

Key

String

Name of the AD DNS zone

DynamicUpdate

String

AD zone dynamic DNS update option.

  • None

  • NonSecureAndSecure

  • Secure (default)

ReplicationScope

Mandatory

String

AD zone replication scope option.

  • Custom

  • Domain

  • Forest

  • Legacy

DirectoryPartitionName

String

Name of the directory partition on which to store the zone.

Use this parameter when the ReplicationScope parameter has a value of Custom.

ComputerName

String

Specifies a DNS server.

If you do not specify this parameter, the command runs on the local system.

Credential

PSCredential

Specifies the credential to use to create the AD zone on a remote computer.

This parameter can only be used when you also are passing a value for the ComputerName parameter.

Ensure

String

Whether the AD zone should be present or removed

  • Present (default)

  • Absent
Example
DnsServerAdZones:
  AdZones:
  - Name: cms.contoso.com
    DynamicUpdate: Secure
    ReplicationScope: Forest
  - Name: 30.168.192.in-addr.arpa
    DynamicUpdate: Secure
    ReplicationScope: Forest
  DomainCredential: '[ENC=PE9ianMgVmVyc2lvbj...=]'