en-US/about_DnsRecordNs.help.txt
|
.NAME
DnsRecordNs .SYNOPSIS The DnsRecordNs DSC resource manages NS DNS records against a specific zone on a Domain Name System (DNS) server. .DESCRIPTION The DnsRecordNs DSC resource manages NS DNS records against a specific zone on a Domain Name System (DNS) server. .PARAMETER DomainName Key - System.String Specifies the fully qualified DNS domain name for which the NameServer is authoritative. It must be a subdomain the zone or the zone itself. To specify all subdomains, use the '' character (i.e.: .contoso.com). (Key Parameter) .PARAMETER NameServer Key - System.String Specifies the name server of a domain. This should be a fully qualified domain name, not an IP address (Key Parameter) .EXAMPLE 1 This configuration will ensure a DNS NS record exists when only the mandatory properties are specified. Configuration DnsRecordNs_Mandatory_config { Import-DscResource -ModuleName 'DnsServerDsc' Node localhost { DnsRecordNs 'TestRecord' { ZoneName = 'contoso.com' DomainName = 'contoso.com' NameServer = 'ns.contoso.com' Ensure = 'Present' } } } .EXAMPLE 2 This configuration will ensure a DNS NS record exists when all properties are specified. Configuration DnsRecordNs_Full_config { Import-DscResource -ModuleName 'DnsServerDsc' Node localhost { DnsRecordNs 'TestRecord' { ZoneName = 'contoso.com' DomainName = 'contoso.com' NameServer = 'ns.contoso.com' TimeToLive = '01:00:00' DnsServer = 'localhost' Ensure = 'Present' } } } .EXAMPLE 3 This configuration will ensure a DNS NS 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 DnsRecordNs_Remove_config { Import-DscResource -ModuleName 'DnsServerDsc' Node localhost { DnsRecordNs 'TestRecord' { ZoneName = 'contoso.com' DomainName = 'contoso.com' NameServer = 'ns.contoso.com' Ensure = 'Absent' } } } |