Add-DnsServerResourceRecord

Module:

DnsServer

Adds a resource record of a specified type to a specified DNS zone.

Syntax

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-AllowUpdateAny]
   -InputObject <CimInstance>
   [-Force]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -PsdnAddress <String>
   [-X25]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -InternetAddress <IPAddress>
   -InternetProtocol <String>
   -Service <String[]>
   [-Wks]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Force]
   -LookupTimeout <TimeSpan>
   [-Replicate]
   -CacheTimeout <TimeSpan>
   -ResultDomain <String>
   [-WinsR]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Force]
   -LookupTimeout <TimeSpan>
   [-Replicate]
   -WinsServers <IPAddress[]>
   -CacheTimeout <TimeSpan>
   [-Wins]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   [-Type] <UInt16>
   [-RecordData] <String>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -DescriptiveText <String>
   [-Txt]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [[-Name] <String>]
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   [-TLSA]
   -CertificateUsage <String>
   -MatchingType <String>
   -Selector <String>
   -CertificateAssociationData <String>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -DomainName <String>
   -Priority <UInt16>
   -Weight <UInt16>
   -Port <UInt16>
   [-Srv]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -Preference <UInt16>
   -IntermediateHost <String>
   [-RT]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -ResponsiblePerson <String>
   -Description <String>
   [-RP]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -PtrDomainName <String>
   [-Ptr]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -NameServer <String>
   [-NS]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -MailExchange <String>
   -Preference <UInt16>
   [-MX]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -IsdnNumber <String>
   -IsdnSubAddress <String>
   [-Isdn]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -Cpu <String>
   -OperatingSystem <String>
   [-HInfo]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -DomainNameAlias <String>
   [-DName]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -DhcpIdentifier <String>
   [-DhcId]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -HostNameAlias <String>
   [-CName]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -Address <String>
   -AddressType <String>
   [-Atma]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -SubType <UInt16>
   -ServerName <String>
   [-Afsdb]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-CreatePtr]
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   -IPv6Address <IPAddress>
   [-AAAA]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-DnsServerResourceRecord
   [-ZoneName] <String>
   [-ComputerName <String>]
   [-PassThru]
   [-ZoneScope <String>]
   [-VirtualizationInstance <String>]
   [-CreatePtr]
   -IPv4Address <IPAddress>
   [-Name] <String>
   [-TimeToLive <TimeSpan>]
   [-AgeRecord]
   [-AllowUpdateAny]
   [-A]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Add-DnsServerResourceRecord cmdlet adds a resource record for a Domain Name System (DNS) zone on a DNS server. You can add different types of resource records. Use different switches for different record types. For more information about resource records, see Managing Resource Records.

By using this cmdlet, you can change a value for a record, configure whether a record has a time stamp, whether any authenticated user can update a record with the same owner name, and change lookup timeout values, Windows Internet Name Service (WINS) cache settings, and replication settings.

Examples

Example 1: Add an A record

PS C:\> Add-DnsServerResourceRecord -ZoneName "Contoso.com" -A -Name "Host34" -AllowUpdateAny -IPv4Address "10.17.1.34" -TimeToLive 01:00:00 -AgeRecord

This command adds an A record that is named Host34 in the zone contoso.com with the specified IP address. The command uses the AllowUpdateAny switch to allow any authenticated user to update the record. It specifies a TTL value and enables a time stamp for the record.

Example 2: Add an A resource record under the Admin node

PS C:\> Add-DnsServerResourceRecord -ZoneName "Contoso.com" -A -Name "Host21.admin" -IPv4Address "10.17.1.21"

VERBOSE: Adding DNS resource record host21.admin of type A in zone contoso.com on ROOT server.
HostName                  RecordType Timestamp            TimeToLive      RecordData
--------                  ---------- ---------            ----------      ----------
host21.admin              A          0                    01:00:00        10.17.1.74

This command adds an A record for Host21 under the Admin node of Contoso.com.

Example 3: Add an AAAA resource record

PS C:\> Add-DnsServerResourceRecord -AAAA -Name "Host73" -ZoneName "Contoso.com" -AllowUpdateAny -IPv6Address "3ffe::1" -TimeToLive 01:00:00 -AgeRecord

This command adds an AAAA record. The command specifies AllowUpdateAny, a TTL value, and enables a time stamp for the record.

Example 4: Add a CNAME resource record

PS C:\> Add-DnsServerResourceRecord -CName -Name "labhost34" -HostNameAlias "Host34.lab.contoso.com" -ZoneName "Contoso.com" -AllowUpdateAny  -TimeToLive 01:00:00

This command adds a CNAME resource record. The command specifies AllowUpdateAny and a TTL value.

Example 5: Add a PTR resource record

PS C:\> Add-DnsServerResourceRecord -Name "77" -Ptr -ZoneName "0.168.192.in-addr.arpa" -AllowUpdateAny -PtrDomainName "host77.contoso.com"

This command adds a pointer record named host77.contoso.com for the IP address 192.168.0.77 to the reverse lookup zone 0.168.192.in-addr.arpa..

Example 6: Add an MX resource record

PS C:\> Add-DnsServerResourceRecord -Name "." -MX -ZoneName "contoso.com" -MailExchange "mail.contoso.com" -Preference 10

This command adds an MX resource record for the contoso.com zone with a preference of 10.

Example 7: Add an SRV resource record

PS C:\> Add-DnsServerResourceRecord -Srv -Name "sip" -ZoneName "contoso.com" -DomainName "sipserver1.contoso.com" -Priority 0 -Weight 0 -Port 5060

This command adds a service locator (SRV) resource record for the _sip service on port 5060 with a weight and priority of 0 to the contoso.com domain. The host that offers the service is sipserver1.contoso.com.

Example 8: Add a multiline TXT resource record

$dkim2 = "v=DKIM1;k=rsa;p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAy6OAXCmjYT823gq+DXRjXdsypt7iepfl4pkvLRVN8wRwoND2Fk2aVlG+CitAeJ0nqWn7JAPjoTXpFtHnOWMN7ay/atQd+DcLLHfJkpRvsYSDQ1jkI2s7CkWF6G+nwLGJcNFndOdB8oawpppyESE7+DiZae8bDicaTK8oPU0J7iogeZ1fgvmutwNtNzZHiSgwF9euCiX6lTmGe+0oZ+gRUJnUmZevh//IZ+NyDkRV2kPxQBtM8brHUpRL1c11q/CA0kC6C3ku+Pqmf6A8CGT+qvlCeQ2lVqlBydQL5UjiixUEwkSrgUEKoKE2Hqw97WrDEJZqngtuqma9hWoAsKVbzwIDAQAB"
$dkim2_part1 = $dkim2.Substring(0,252)

$dkim2_part2 = $dkim2.Substring(252,$dkim2.Length - 252)

Add-DnsServerResourceRecord -DescriptiveText "$dkim2_part1`r`n$dkim_part2" -Name sea2048._domainkey -Txt -ZoneName $domain -TimeToLive 0:1:0:0

This command adds a multiline TXT resource record. The string is split into 252 character sets and the new line, which is two characters in Windows, is added at the end.

Parameters

-A

Indicates that the record that this cmdlet adds to the DNS server is a host address (A) resource record. An A resource record maps a host name to an IPv4 address.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-AAAA

Indicates that the record that this cmdlet adds to the DNS server is an AAAA resource record. An AAAA resource record maps a host name to an IPv6 address.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Address

Specifies a byte array that contains the asynchronous transfer mode (ATM) address of the owner to which this resource record object pertains. The AddressType parameter specifies the format of the byte array. The first 4 bytes of the array store the size of the octet string. The most significant byte is byte 0.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-AddressType

Specifies the format of an ATM address in an ATM address (ATMA) resource record. Valid values are: 0, for an ATM End System Address (AESA) format, and 1, for an E.164 address format.

Type:	String
Accepted values:	E164, AESA
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Afsdb

Indicates that the record that this cmdlet adds to the DNS server is an Andrew File System cell database server (AFSDB) resource record. An AFSDB resource record gives the location of the AFS cell database server and uses DNS to map a DNS domain name to the name of an AFS cell database server.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-AgeRecord

Indicates that the DNS server uses a time stamp for the resource record that this cmdlet adds. A DNS server can scavenge resource records that have become stale based on a time stamp.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowUpdateAny

Indicates that any authenticated user can update a resource record that has the same owner name.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.

The cmdlet immediately returns an object that represents the job and then displays the command prompt. You can continue to work in the session while the job completes. To manage the job, use the *-Job cmdlets. To get the job results, use the Receive-Job cmdlet.

For more information about Windows PowerShell background jobs, see about_Jobs.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Atma

Indicates that the record that this cmdlet adds to the DNS server is an ATM address resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CacheTimeout

Specifies how long, in seconds, that a DNS server caches a response from a WINS server.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CertificateAssociationData

Specifies the certificate association data for a Transport Layer Security (TLS) authentication record.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CertificateUsage

Specifies the certificate usage TLS authentication record.

Type:	String
Accepted values:	CAConstraint, ServiceCertificateConstraint, TrustAnchorAssertion, DomainIssuedCertificate
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CimSession

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.

Type:	CimSession[]
Aliases:	Session
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CName

Indicates that the record that this cmdlet adds to the DNS server is a canonical name (CNAME) resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

Specifies a DNS server. If you do not specify this parameter, the command runs on the local system. You can specify an IP address or any value that resolves to an IP address, such as a fully qualified domain name (FQDN), host name, or NETBIOS name.

Type:	String
Aliases:	Cn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Cpu

Specifies the CPU type of a DNS server. You can find the CPU type in a host information (HINFO) resource record.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CreatePtr

Indicates that the DNS server automatically creates an associated pointer (PTR) resource record for an A or AAAA record. A PTR resource record maps an IP address to a host name.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Specifies text to describe the person or people that are responsible for the domain.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DescriptiveText

Specifies additional text to describe a resource record on a DNS server. It is limited to 254 characters per line.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DhcId

Indicates that the record that this cmdlet adds to the DNS server is a Dynamic Host Configuration Protocol Information (DHCID) resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DhcpIdentifier

Specifies a public key that is associated with an FQDN, as described in section 3 of RFC 2535.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DName

Indicates that the record that this cmdlet adds to the DNS server is a domain alias (DNAME) resource record on a DNS server. A DNAME resource record renames the root and all descendants in a domain namespace subtree and provides nonterminal domain name redirection.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DomainName

Specifies the name of a domain.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DomainNameAlias

Specifies the alias for a domain name.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

Adds a resource record without prompting you for confirmation. By default, the cmdlet prompts you for confirmation before it proceeds.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HInfo

Indicates that the record that this cmdlet adds to the DNS server is a host information (HINFO) resource record on a DNS server.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-HostNameAlias

Specifies a canonical name target for a CNAME record. This must be a fully qualified domain name (FQDN).

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InputObject

Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet.

Type:	CimInstance
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IntermediateHost

Specifies the FQDN of a host that routes packets to a destination host.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InternetAddress

Specifies the IP address of the owner of a resource record.

Type:	IPAddress
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InternetProtocol

Specifies the Internet Protocol (IP) for a resource record. Valid values are: UDP or TCP.

Type:	String
Accepted values:	UDP, TCP
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IPv4Address

Specifies the IPv4 address of a host.

Type:	IPAddress
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IPv6Address

Specifies the IPv6 address of a host.

Type:	IPAddress
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Isdn

Indicates that the record that this cmdlet adds to the DNS server is an Integrated Services Digital Network (ISDN) resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-IsdnNumber

Specifies the number in the ISDN address that maps to the FQDN of a DNS server. An ISDN address, which consists of a phone number and an optional subaddress, is located in an ISDN resource record. The phone number can contain a country/region code, an area code, and a local phone number.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IsdnSubAddress

Specifies the number that is contained in an ISDN address that maps to the FQDN of a DNS server. An ISDN address consists of a phone number and an optional subaddress and is located in an ISDN resource record. The subaddress is an identifier that describes the ISDN subaddress encoding type.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-LookupTimeout

Specifies the lookup time-out value for a resource record.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MailExchange

Specifies the FQDN of the host that is acting as a mail exchanger for the owner.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MatchingType

Specifies the matching type for the record. The acceptable values for this parameter are:

• ExactMatch
• Sha256Hash
• Sha512Hash

Type:	String
Accepted values:	ExactMatch, Sha256Hash, Sha512Hash
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MX

Indicates that the record that this cmdlet adds to the DNS server is a mail exchanger (MX) resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Specifies the name of a DNS server resource record object.

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NameServer

Specifies the name server of a domain.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NS

Indicates that the record that this cmdlet adds to the DNS server is a Name Server (NS) resource record on a DNS server.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-OperatingSystem

Specifies the operating system identifier of a DNS server. You can find the operating system identifier in a HINFO resource record.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Port

Specifies the port where the server listens for the service.

Type:	UInt16
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Preference

Specifies the priority for this resource record among other resource records that belong to the same owner, where a lower value has a higher priority.

Type:	UInt16
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Priority

Specifies the priority of a DNS server. Clients try to contact the server that has the lowest priority.

Type:	UInt16
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PsdnAddress

Specifies the public switched data network (PSDN) address of the owner of a resource record.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Ptr

Indicates that the record that this cmdlet adds to the DNS server is a PTR resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PtrDomainName

Specifies the FQDN of the host when you add a PTR resource record.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-RecordData

Specifies the data contained in the resource record you want to add.

Type:	String
Position:	4
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Replicate

Indicates that the DNS server allows WINS replication.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResponsiblePerson

Specifies the FQDN for the domain mailbox name of the person who is responsible for the resource record.

When used together with the MR parameter set, this value specifies a mailbox that is the proper rename of the mailbox that is specified in the resource record's owner name.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResultDomain

Specifies the domain name to append to returned NetBIOS names.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-RP

Indicates that the record that this cmdlet adds to the DNS server is a Responsible Person (RP) resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RT

Indicates that the record that this cmdlet adds to the DNS server is a Route Through (RT) resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Selector

Specifies a selector.

Type:	String
Accepted values:	FullCertificate, SubjectPublicKeyInfo
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ServerName

Specifies the subtype of a host AFS server. For subtype 1 (value=1), the host has an AFS version 3.0 Volume Location Server for the named AFS cell. For subtype 2 (value=2), the host has an authenticated name server holding the cell-root directory node for the named DCE/NCA cell.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Service

Specifies the service or services that are available for the current rewrite path. It can also specify a particular protocol to use for a service. Available services include Well-known Service (WKS) and NAPTR.

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Srv

Indicates that the record that this cmdlet adds to the DNS server is a Service (SRV) resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SubType

Specifies whether the server is an AFS volume location server. Use a value of 1 indicate that the server is an AFS version 3.0 volume location server for the specified AFS cell. Use a value of 2 to indicate that the server is an authenticated name server that holds the cell-root directory node for the server that uses either Open Software Foundation's (OSF) DCE authenticated cell-naming system or HP/Apollo's Network Computing Architecture (NCA).

For more information about server subtypes, see RFC 1183.

Type:	UInt16
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ThrottleLimit

Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeToLive

Specifies the Time to Live (TTL) value, in seconds, for a resource record. Other DNS servers use this length of time to determine how long to cache a record.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-TLSA

Indicates that the record that this cmdlet adds is a TLS authentication resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Txt

Indicates that the record that this cmdlet adds to the DNS server is a TXT resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

Specifies the type of the resource record.

Type:	UInt16
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VirtualizationInstance

Specifies the virtualization instance in which the zone will be added. A virtualization instance is logical partition in a DNS Server, which is capable of independently hosting zones and zone scopes. Same name zones and zone scopes can be hosted in different virtualization instances. This parameter is optional and if not provided it will add the zone into the default virtualization instance which is functionally equivalent to a standard DNS server.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Weight

Specifies a value for the weight of the target host for a resource record. You can use this parameter when you have multiple hosts that have an identical priority. Use of the host is proportional to its weight.

Type:	UInt16
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Wins

Indicates that the record that this cmdlet adds to the DNS server is a WINS resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WinsR

Indicates that the record that this cmdlet adds to the DNS server is a WINS reverse (WinsR) resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WinsServers

Specifies one or more IP addresses of WINS servers that you want to use for a resource record.

Type:	IPAddress[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Wks

Indicates that the record that this cmdlet adds to the DNS server is WKS resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-X25

Indicates that the record that this cmdlet adds to the DNS server is an X25 resource record.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ZoneName

Specifies the name of a DNS zone.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ZoneScope

Specifies the name of a zone scope.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Outputs

CimInstance

Related Links

• RFC 2535
• RFC 1183
• Show-DnsServerCache
• Set-DnsServerZoneAging