Edit

Share via

Add-DnsServerResourceRecord

Module:
DnsServer Module

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

Syntax

InputObject (Default) 

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

X25 

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

WKS 

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

WINSR 

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

WINS 

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

Unknown 

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

TXT 

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

TLSA 

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

SRV 

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

RT 

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

RP 

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

PTR 

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

NS 

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

MX 

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

ISDN 

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

HINFO 

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

DNAME 

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

DHCID 

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

CNAME 

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

ATMA 

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

AFSDB 

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

AAAA 

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

A 

Add-DnsServerResourceRecord
    [-ZoneName] <String>
    [-Name] <String>
    -IPv4Address <IPAddress>
    [-ComputerName <String>]
    [-PassThru]
    [-ZoneScope <String>]
    [-VirtualizationInstance <String>]
    [-CreatePtr]
    [-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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

A
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AAAA
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ATMA
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:String
Default value:None
Accepted values:E164, AESA
Supports wildcards:False
DontShow:False

Parameter sets

ATMA
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AFSDB
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

X25
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
TLSA
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AllowUpdateAny

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

InputObject
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
TLSA
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Atma

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ATMA
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CacheTimeout

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

Parameter properties

Type:TimeSpan
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

WINSR
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
WINS
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CertificateAssociationData

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

TLSA
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CertificateUsage

Specifies the certificate usage TLS authentication record.

Parameter properties

Type:String
Default value:None
Accepted values:CAConstraint, ServiceCertificateConstraint, TrustAnchorAssertion, DomainIssuedCertificate
Supports wildcards:False
DontShow:False

Parameter sets

TLSA
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:

CimSession[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:Session

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CName

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CNAME
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Cn

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Cpu

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

HINFO
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AAAA
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Description

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

RP
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-DescriptiveText

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

TXT
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-DhcId

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

DHCID
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DhcpIdentifier

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

DHCID
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

DNAME
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DomainName

Specifies the name of a domain.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SRV
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-DomainNameAlias

Specifies the alias for a domain name.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

DNAME
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Force

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

InputObject
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
WINSR
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
WINS
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

HINFO
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-HostNameAlias

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CNAME
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-InputObject

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

Parameter properties

Type:CimInstance
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

InputObject
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-IntermediateHost

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

RT
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-InternetAddress

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

Parameter properties

Type:IPAddress
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

WKS
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-InternetProtocol

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

Parameter properties

Type:String
Default value:None
Accepted values:UDP, TCP
Supports wildcards:False
DontShow:False

Parameter sets

WKS
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-IPv4Address

Specifies the IPv4 address of a host.

Parameter properties

Type:IPAddress
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

A
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-IPv6Address

Specifies the IPv6 address of a host.

Parameter properties

Type:IPAddress
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AAAA
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Isdn

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ISDN
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ISDN
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ISDN
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-LookupTimeout

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

Parameter properties

Type:TimeSpan
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

WINSR
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
WINS
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-MailExchange

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

MX
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-MatchingType

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

  • ExactMatch
  • Sha256Hash
  • Sha512Hash

Parameter properties

Type:String
Default value:None
Accepted values:ExactMatch, Sha256Hash, Sha512Hash
Supports wildcards:False
DontShow:False

Parameter sets

TLSA
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-MX

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

MX
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies the name of a DNS server resource record object.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

X25
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
WKS
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
Unknown
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
TXT
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
SRV
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
RT
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
RP
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
PTR
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
NS
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
MX
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
ISDN
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
HINFO
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
DNAME
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
DHCID
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
CNAME
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
ATMA
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
AFSDB
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
AAAA
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
A
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-NameServer

Specifies the name server of a domain.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NS
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NS
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-OperatingSystem

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

HINFO
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-PassThru

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Port

Specifies the port where the server listens for the service.

Parameter properties

Type:UInt16
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SRV
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:UInt16
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

RT
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
MX
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Priority

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

Parameter properties

Type:UInt16
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SRV
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-PsdnAddress

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

X25
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Ptr

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

PTR
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PtrDomainName

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

PTR
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-RecordData

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Unknown
Position:4
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Replicate

Indicates that the DNS server allows WINS replication.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

WINSR
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
WINS
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

RP
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-ResultDomain

Specifies the domain name to append to returned NetBIOS names.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

WINSR
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-RP

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

RP
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RT

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

RT
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Selector

Specifies a selector.

Parameter properties

Type:String
Default value:None
Accepted values:FullCertificate, SubjectPublicKeyInfo
Supports wildcards:False
DontShow:False

Parameter sets

TLSA
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AFSDB
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

WKS
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Srv

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SRV
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:UInt16
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AFSDB
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:TimeSpan
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

X25
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
WKS
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
Unknown
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
TXT
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
SRV
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
RT
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
RP
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
PTR
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
NS
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
MX
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
ISDN
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
HINFO
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
DNAME
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
DHCID
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
CNAME
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
ATMA
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
AFSDB
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
AAAA
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
A
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-TLSA

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

TLSA
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Txt

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

TXT
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Type

Specifies the type of the resource record.

Parameter properties

Type:UInt16
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Unknown
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:UInt16
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SRV
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-WhatIf

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

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Wins

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

WINS
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WinsR

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

WINSR
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WinsServers

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

Parameter properties

Type:

IPAddress[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

WINS
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Wks

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

WKS
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-X25

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

X25
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ZoneName

Specifies the name of a DNS zone.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-ZoneScope

Specifies the name of a zone scope.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Outputs

CimInstance