Skip to content

xDnsServerADZone

Johan Ljunggren edited this page Jul 9, 2021 · 3 revisions

xDnsServerADZone

⚠️ DEPRECATED! The resource has been replaced by DnsServerADZone in the DSC resource module DnsServerDsc.

Parameters

Parameter Attribute DataType Description Allowed Values
Name Key String Name of the AD DNS zone
DynamicUpdate Write String AD zone dynamic DNS update option. Defaults to 'Secure'. None, NonSecureAndSecure, Secure
ReplicationScope Required String AD zone replication scope option. Custom, Domain, Forest, Legacy
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.
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.
Ensure Write String Whether the DNS zone should be available or removed Present, Absent

Description

The xDnsServerADZone 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 xDnsServerADZone_forward_config
{
    param
    (
        [System.Management.Automation.PSCredential]
        $Credential
    )

    Import-DscResource -ModuleName 'xDnsServer'

    Node localhost
    {

        xDnsServerADZone '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 xDnsServerADZone_reverse_config
{
    Import-DscResource -ModuleName 'xDnsServer'

    Node localhost
    {
        xDnsServerADZone 'addReverseADZone'
        {
            Name             = '1.168.192.in-addr.arpa'
            DynamicUpdate    = 'Secure'
            ReplicationScope = 'Forest'
            Ensure           = 'Present'
        }
    }
}
Clone this wiki locally