Export (0) Print
Expand All
Expand Minimize

Add-DnsServerResourceRecord

Updated: January 17, 2013

Applies To: Windows Server 2012

Add-DnsServerResourceRecord

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

Syntax

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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




Detailed 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 (http://technet.microsoft.com/en-us/library/cc754308.aspx).

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.

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.


Aliases

none

Required?

true

Position?

4

Default Value

none

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.


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Address<String>

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.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AddressType<String>

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.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

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.


Aliases

none

Required?

true

Position?

4

Default Value

none

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AllowUpdateAny

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


Aliases

none

Required?

false

Position?

named

Default Value

FALSE

Accept Pipeline Input?

True (ByPropertyName)

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

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.


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CacheTimeout<TimeSpan>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CimSession<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.


Aliases

none

Required?

false

Position?

named

Default Value

none

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.


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ComputerName<String>

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Cpu<String>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

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.


Aliases

none

Required?

false

Position?

named

Default Value

False

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Description<String>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DescriptiveText<String>

Specifies additional text to describe a resource record on a DNS server.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

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.


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DhcpIdentifier<String>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

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.


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DomainName<String>

Specifies the name of a domain.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DomainNameAlias<String>

Specifies the alias for a domain name.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

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.


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-HostNameAlias<String>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InputObject<CimInstance>

Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet. This parameter takes an object of type DnsServerResourceRecord.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-IntermediateHost<String>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InternetAddress<IPAddress>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InternetProtocol<String>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-IPv4Address<IPAddress>

Specifies the IPv4 address of a host.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-IPv6Address<IPAddress>

Specifies the IPv6 address of a host.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

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.


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-IsdnNumber<String>

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.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-IsdnSubAddress<String>

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.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-LookupTimeout<TimeSpan>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MailExchange<String>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MX

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


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of a DNS server resource record object.


Aliases

none

Required?

true

Position?

3

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-NameServer<String>

Specifies the name server of a domain.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

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.


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-OperatingSystem<String>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Port<UInt16>

Specifies the port where the server listens for the service.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Preference<UInt16>

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.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Priority<UInt16>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PsdnAddress<String>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Ptr

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


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PtrDomainName<String>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Replicate

Indicates that the DNS server allows WINS replication.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ResponsiblePerson<String>

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.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ResultDomain<String>

Specifies the domain name to append to returned NetBIOS names.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-RP

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


Aliases

none

Required?

true

Position?

4

Default Value

none

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.


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ServerName<String>

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.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Service<String[]>

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.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Srv

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


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SubType<UInt16>

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 (www.ietf.org/rfc/rfc1183.txt).


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ThrottleLimit<Int32>

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TimeToLive<TimeSpan>

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Txt

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


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Weight<UInt16>

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.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Wins

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


Aliases

none

Required?

true

Position?

4

Default Value

none

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.


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WinsServers<IPAddress[]>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Wks

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


Aliases

none

Required?

true

Position?

4

Default Value

none

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.


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ZoneName<String>

Specifies the name of a DNS zone.


Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

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


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.Management.Infrastructure.CimInstance#DnsServerResourceRecord

Examples

Example 1: Add an A record

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.


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

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

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


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. 
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
HostName RecordType Timestamp TimeToLive RecordData

-------- ---------- --------- ---------- ----------

host21.admin A 0 01:00:00 10.17.1.74

Example 3: Add an AAAA resource record

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


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

Example 4: Add a CNAME resource record

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


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

Example 5: Add a PTR resource record

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..


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

Example 6: Add an MX resource record

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


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

Example 7: Add an SRV resource record

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.


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

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft