DnsServerDsc

3.0.0-preview0001

en-US/about_DnsRecordAScoped.help.txt

.NAME
    DnsRecordAScoped
 
.SYNOPSIS
    The DnsRecordAScoped DSC resource manages A DNS records against a specific zone and zone scope on a Domain Name System (DNS) server.
 
.DESCRIPTION
    The DnsRecordAScoped DSC resource manages A DNS records against a specific zone and zone scope on a Domain Name System (DNS) server.
 
.PARAMETER ZoneScope
    Key - System.String
    Specifies the name of a zone scope. (Key Parameter)
 
.EXAMPLE 1
 
This configuration will ensure a DNS A record exists when only the mandatory properties are specified.
 
Configuration DnsRecordAScoped_Mandatory_config
{
    Import-DscResource -ModuleName 'DnsServerDsc'
 
    Node localhost
    {
        DnsRecordAScoped 'TestRecord'
        {
            ZoneName = 'contoso.com'
            ZoneScope = 'external'
            Name = 'www'
            IPv4Address = '192.168.50.10'
            Ensure = 'Present'
        }
    }
}
 
.EXAMPLE 2
 
This configuration will ensure a DNS A record exists when all properties are specified.
 
Configuration DnsRecordAScoped_Full_config
{
    Import-DscResource -ModuleName 'DnsServerDsc'
 
    Node localhost
    {
        DnsRecordAScoped 'TestRecord'
        {
            ZoneName = 'contoso.com'
            ZoneScope = 'external'
            Name = 'www'
            IPv4Address = '192.168.50.10'
            TimeToLive = '01:00:00'
            DnsServer = 'localhost'
            Ensure = 'Present'
        }
    }
}
 
.EXAMPLE 3
 
This configuration will ensure a DNS A record does not exist when mandatory properties are specified.
 
Note that not all mandatory properties are necessarily key properties. Non-key property values will be ignored when determining whether the record is to be removed.
 
Configuration DnsRecordAScoped_Remove_config
{
    Import-DscResource -ModuleName 'DnsServerDsc'
 
    Node localhost
    {
        DnsRecordAScoped 'TestRecord'
        {
            ZoneName = 'contoso.com'
            ZoneScope = 'external'
            Name = 'www'
            IPv4Address = '192.168.50.10'
            Ensure = 'Absent'
        }
    }
}