DnsServerADZone - dsccommunity/DnsServerDsc GitHub Wiki

Parameters

Parameter	Attribute	DataType	Description	Allowed Values
Name	Key	String	Name of the AD DNS zone
ReplicationScope	Required	String	AD zone replication scope option.	Custom, Domain, Forest, Legacy
ComputerName	Write	String	Specifies a DNS server. If you do not specify this parameter, the command runs on the local system.
Credential	Write	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.
DirectoryPartitionName	Write	String	Name of the directory partition on which to store the zone. Use this parameter when the ReplicationScope parameter has a value of Custom.
DynamicUpdate	Write	String	AD zone dynamic DNS update option. Defaults to 'Secure'.	None, NonSecureAndSecure, Secure
Ensure	Write	String	Whether the DNS zone should be available or removed	Present, Absent

Description

The DnsServerADZone DSC resource manages an AD integrated zone on a Domain Name System (DNS) server.

Examples

Example 1

This configuration will manage an AD integrated DNS forward lookup zone

Configuration DnsServerADZone_forward_config
{
    param
    (
        [System.Management.Automation.PSCredential]
        $Credential
    )

    Import-DscResource -ModuleName 'DnsServerDsc'

    Node localhost
    {

        DnsServerADZone 'AddForwardADZone'
        {
            Name             = 'MyDomainName.com'
            DynamicUpdate    = 'Secure'
            ReplicationScope = 'Forest'
            ComputerName     = 'MyDnsServer.MyDomain.com'
            Credential       = $Credential
            Ensure           = 'Present'
        }
    }
}

Example 2

This configuration will manage an AD integrated DNS reverse lookup zone

Configuration DnsServerADZone_reverse_config
{
    Import-DscResource -ModuleName 'DnsServerDsc'

    Node localhost
    {
        DnsServerADZone 'addReverseADZone'
        {
            Name             = '1.168.192.in-addr.arpa'
            DynamicUpdate    = 'Secure'
            ReplicationScope = 'Forest'
            Ensure           = 'Present'
        }
    }
}