diff --git a/docset/winserver2012-ps/dnsserver/Add-DnsServerResourceRecord.md b/docset/winserver2012-ps/dnsserver/Add-DnsServerResourceRecord.md index e41a7036e0..388e115f9a 100644 --- a/docset/winserver2012-ps/dnsserver/Add-DnsServerResourceRecord.md +++ b/docset/winserver2012-ps/dnsserver/Add-DnsServerResourceRecord.md @@ -164,7 +164,7 @@ Add-DnsServerResourceRecord [-ZoneName] [-Wins] [-AsJob] [-CimSession < ## 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. +Use different switches for different record types. For more information about resource records, see Managing Resource Recordshttp://technet.microsoft.com/en-us/library/cc754308.aspx (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. @@ -182,9 +182,9 @@ It specifies a TTL value and enables a time stamp for the record. ### Example 2: Add an A resource record under the Admin noderesource ``` -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. +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 -------- ---------- --------- ---------- ---------- @@ -237,6 +237,18 @@ PS C:\>Add-DnsServerResourceRecord -Srv -Name "sip" -ZoneName "contoso.com" -Dom 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 +```powershell +$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 @@ -246,7 +258,7 @@ An A resource record maps a host name to an IPv4 address. ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_2 -Aliases: +Aliases: Required: True Position: 4 @@ -262,7 +274,7 @@ An AAAA resource record maps a host name to an IPv6 address. ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_3 -Aliases: +Aliases: Required: True Position: 4 @@ -280,7 +292,7 @@ The most significant byte is byte 0. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_4 -Aliases: +Aliases: Required: True Position: Named @@ -296,7 +308,7 @@ Valid values are: 0, for an ATM End System Address (AESA) format, and 1, for an ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_4 -Aliases: +Aliases: Required: True Position: Named @@ -312,7 +324,7 @@ An AFSDB resource record gives the location of the AFS cell database server and ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_5 -Aliases: +Aliases: Required: True Position: 4 @@ -328,7 +340,7 @@ A DNS server can scavenge resource records that have become stale based on a tim ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_2, UNNAMED_PARAMETER_SET_3, UNNAMED_PARAMETER_SET_4, UNNAMED_PARAMETER_SET_5, UNNAMED_PARAMETER_SET_6, UNNAMED_PARAMETER_SET_7, UNNAMED_PARAMETER_SET_8, UNNAMED_PARAMETER_SET_9, UNNAMED_PARAMETER_SET_10, UNNAMED_PARAMETER_SET_11, UNNAMED_PARAMETER_SET_12, UNNAMED_PARAMETER_SET_13, UNNAMED_PARAMETER_SET_14, UNNAMED_PARAMETER_SET_15, UNNAMED_PARAMETER_SET_16, UNNAMED_PARAMETER_SET_17, UNNAMED_PARAMETER_SET_19 -Aliases: +Aliases: Required: False Position: Named @@ -340,7 +352,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_18 -Aliases: +Aliases: Required: False Position: Named @@ -355,7 +367,7 @@ Indicates that any authenticated user can update a resource record that has the ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_1 -Aliases: +Aliases: Required: False Position: Named @@ -367,7 +379,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_2, UNNAMED_PARAMETER_SET_3, UNNAMED_PARAMETER_SET_4, UNNAMED_PARAMETER_SET_5, UNNAMED_PARAMETER_SET_6, UNNAMED_PARAMETER_SET_7, UNNAMED_PARAMETER_SET_8, UNNAMED_PARAMETER_SET_9, UNNAMED_PARAMETER_SET_10, UNNAMED_PARAMETER_SET_11, UNNAMED_PARAMETER_SET_12, UNNAMED_PARAMETER_SET_13, UNNAMED_PARAMETER_SET_14, UNNAMED_PARAMETER_SET_15, UNNAMED_PARAMETER_SET_16, UNNAMED_PARAMETER_SET_17, UNNAMED_PARAMETER_SET_18, UNNAMED_PARAMETER_SET_19 -Aliases: +Aliases: Required: False Position: Named @@ -382,7 +394,7 @@ ps_cimcommon_asjob ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -397,7 +409,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an ATM addr ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_4 -Aliases: +Aliases: Required: True Position: 4 @@ -412,7 +424,7 @@ Specifies how long, in seconds, that a DNS server caches a response from a WINS ```yaml Type: TimeSpan Parameter Sets: UNNAMED_PARAMETER_SET_20, UNNAMED_PARAMETER_SET_21 -Aliases: +Aliases: Required: True Position: Named @@ -429,7 +441,7 @@ The default is the current session on the local computer. ```yaml Type: CimSession[] Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -444,7 +456,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a canonical ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_16 -Aliases: +Aliases: Required: True Position: 4 @@ -461,7 +473,7 @@ You can specify an IP address or any value that resolves to an IP address, such ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -477,7 +489,7 @@ You can find the CPU type in a host information (HINFO) resource record. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_13 -Aliases: +Aliases: Required: True Position: Named @@ -493,7 +505,7 @@ A PTR resource record maps an IP address to a host name. ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_2 -Aliases: +Aliases: Required: False Position: Named @@ -505,7 +517,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_3 -Aliases: +Aliases: Required: False Position: Named @@ -520,7 +532,7 @@ Specifies text to describe the person or people that are responsible for the dom ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_19 -Aliases: +Aliases: Required: True Position: Named @@ -530,12 +542,12 @@ Accept wildcard characters: False ``` ### -DescriptiveText -Specifies additional text to describe a resource record on a DNS server. +Specifies additional text to describe a resource record on a DNS server. It is limited to 254 characters per line. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_7 -Aliases: +Aliases: Required: True Position: Named @@ -550,7 +562,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Dynamic H ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_15 -Aliases: +Aliases: Required: True Position: 4 @@ -565,7 +577,7 @@ Specifies a public key that is associated with an FQDN, as described in section ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_15 -Aliases: +Aliases: Required: True Position: Named @@ -581,7 +593,7 @@ A DNAME resource record renames the root and all descendants in a domain namespa ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_14 -Aliases: +Aliases: Required: True Position: 4 @@ -596,7 +608,7 @@ Specifies the name of a domain. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_8 -Aliases: +Aliases: Required: True Position: Named @@ -611,7 +623,7 @@ Specifies the alias for a domain name. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_14 -Aliases: +Aliases: Required: True Position: Named @@ -627,7 +639,7 @@ By default, the cmdlet prompts you for confirmation before it proceeds. ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_1, UNNAMED_PARAMETER_SET_20, UNNAMED_PARAMETER_SET_21 -Aliases: +Aliases: Required: False Position: Named @@ -642,7 +654,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a host info ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_13 -Aliases: +Aliases: Required: True Position: 4 @@ -658,7 +670,7 @@ This must be a fully qualified domain name (FQDN). ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_16 -Aliases: +Aliases: Required: True Position: Named @@ -675,7 +687,7 @@ This parameter takes an object of type **DnsServerResourceRecord**. ```yaml Type: CimInstance Parameter Sets: UNNAMED_PARAMETER_SET_1 -Aliases: +Aliases: Required: True Position: Named @@ -690,7 +702,7 @@ Specifies the FQDN of a host that routes packets to a destination host. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_9 -Aliases: +Aliases: Required: True Position: Named @@ -705,7 +717,7 @@ Specifies the IP address of the owner of a resource record. ```yaml Type: IPAddress Parameter Sets: UNNAMED_PARAMETER_SET_10 -Aliases: +Aliases: Required: True Position: Named @@ -721,7 +733,7 @@ Valid values are: UDP or TCP. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_10 -Aliases: +Aliases: Required: True Position: Named @@ -736,7 +748,7 @@ Specifies the IPv4 address of a host. ```yaml Type: IPAddress Parameter Sets: UNNAMED_PARAMETER_SET_2 -Aliases: +Aliases: Required: True Position: Named @@ -751,7 +763,7 @@ Specifies the IPv6 address of a host. ```yaml Type: IPAddress Parameter Sets: UNNAMED_PARAMETER_SET_3 -Aliases: +Aliases: Required: True Position: Named @@ -766,7 +778,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an Integrat ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_12 -Aliases: +Aliases: Required: True Position: 4 @@ -783,7 +795,7 @@ The phone number can contain a country/region code, an area code, and a local ph ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_12 -Aliases: +Aliases: Required: True Position: Named @@ -800,7 +812,7 @@ The subaddress is an identifier that describes the ISDN subaddress encoding type ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_12 -Aliases: +Aliases: Required: True Position: Named @@ -815,7 +827,7 @@ Specifies the lookup time-out value for a resource record. ```yaml Type: TimeSpan Parameter Sets: UNNAMED_PARAMETER_SET_20, UNNAMED_PARAMETER_SET_21 -Aliases: +Aliases: Required: True Position: Named @@ -830,7 +842,7 @@ Specifies the FQDN of the host that is acting as a mail exchanger for the owner. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_11 -Aliases: +Aliases: Required: True Position: Named @@ -845,7 +857,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a mail exch ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_11 -Aliases: +Aliases: Required: True Position: 4 @@ -860,7 +872,7 @@ Specifies the name of a DNS server resource record object. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_2, UNNAMED_PARAMETER_SET_3, UNNAMED_PARAMETER_SET_4, UNNAMED_PARAMETER_SET_5, UNNAMED_PARAMETER_SET_6, UNNAMED_PARAMETER_SET_7, UNNAMED_PARAMETER_SET_8, UNNAMED_PARAMETER_SET_9, UNNAMED_PARAMETER_SET_10, UNNAMED_PARAMETER_SET_11, UNNAMED_PARAMETER_SET_12, UNNAMED_PARAMETER_SET_13, UNNAMED_PARAMETER_SET_14, UNNAMED_PARAMETER_SET_15, UNNAMED_PARAMETER_SET_16, UNNAMED_PARAMETER_SET_17, UNNAMED_PARAMETER_SET_18, UNNAMED_PARAMETER_SET_19 -Aliases: +Aliases: Required: True Position: 3 @@ -875,7 +887,7 @@ Specifies the name server of a domain. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_17 -Aliases: +Aliases: Required: True Position: Named @@ -890,7 +902,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Name Serv ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_17 -Aliases: +Aliases: Required: True Position: 4 @@ -906,7 +918,7 @@ You can find the operating system identifier in a HINFO resource record. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_13 -Aliases: +Aliases: Required: True Position: Named @@ -922,7 +934,7 @@ By default, this cmdlet does not generate any output. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -937,7 +949,7 @@ Specifies the port where the server listens for the service. ```yaml Type: UInt16 Parameter Sets: UNNAMED_PARAMETER_SET_8 -Aliases: +Aliases: Required: True Position: Named @@ -952,7 +964,7 @@ Specifies the priority for this resource record among other resource records tha ```yaml Type: UInt16 Parameter Sets: UNNAMED_PARAMETER_SET_9, UNNAMED_PARAMETER_SET_11 -Aliases: +Aliases: Required: True Position: Named @@ -968,7 +980,7 @@ Clients try to contact the server that has the lowest priority. ```yaml Type: UInt16 Parameter Sets: UNNAMED_PARAMETER_SET_8 -Aliases: +Aliases: Required: True Position: Named @@ -983,7 +995,7 @@ Specifies the public switched data network (PSDN) address of the owner of a reso ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_18 -Aliases: +Aliases: Required: True Position: Named @@ -998,7 +1010,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a PTR resou ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_6 -Aliases: +Aliases: Required: True Position: 4 @@ -1013,7 +1025,7 @@ Specifies the FQDN of the host when you add a PTR resource record. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_6 -Aliases: +Aliases: Required: True Position: Named @@ -1028,7 +1040,7 @@ Indicates that the DNS server allows WINS replication. ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_20, UNNAMED_PARAMETER_SET_21 -Aliases: +Aliases: Required: False Position: Named @@ -1045,7 +1057,7 @@ When used together with the MR parameter set, this value specifies a mailbox tha ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_19 -Aliases: +Aliases: Required: True Position: Named @@ -1060,7 +1072,7 @@ Specifies the domain name to append to returned NetBIOS names. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_20 -Aliases: +Aliases: Required: True Position: Named @@ -1075,7 +1087,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Responsib ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_19 -Aliases: +Aliases: Required: True Position: 4 @@ -1090,7 +1102,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Route Thr ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_9 -Aliases: +Aliases: Required: True Position: 4 @@ -1107,7 +1119,7 @@ For subtype 2 (value=2), the host has an authenticated name server holding the c ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_5 -Aliases: +Aliases: Required: True Position: Named @@ -1124,7 +1136,7 @@ Available services include Well-known Service (WKS) and NAPTR. ```yaml Type: String[] Parameter Sets: UNNAMED_PARAMETER_SET_10 -Aliases: +Aliases: Required: True Position: Named @@ -1139,7 +1151,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Service ( ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_8 -Aliases: +Aliases: Required: True Position: 4 @@ -1158,7 +1170,7 @@ For more information about server subtypes, see [RFC 1183](https://www.ietf.org/ ```yaml Type: UInt16 Parameter Sets: UNNAMED_PARAMETER_SET_5 -Aliases: +Aliases: Required: True Position: Named @@ -1175,7 +1187,7 @@ The throttle limit applies only to the current cmdlet, not to the session or to ```yaml Type: Int32 Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1191,7 +1203,7 @@ Other DNS servers use this length of time to determine how long to cache a recor ```yaml Type: TimeSpan Parameter Sets: UNNAMED_PARAMETER_SET_2, UNNAMED_PARAMETER_SET_3, UNNAMED_PARAMETER_SET_4, UNNAMED_PARAMETER_SET_5, UNNAMED_PARAMETER_SET_6, UNNAMED_PARAMETER_SET_7, UNNAMED_PARAMETER_SET_8, UNNAMED_PARAMETER_SET_9, UNNAMED_PARAMETER_SET_10, UNNAMED_PARAMETER_SET_11, UNNAMED_PARAMETER_SET_12, UNNAMED_PARAMETER_SET_13, UNNAMED_PARAMETER_SET_14, UNNAMED_PARAMETER_SET_15, UNNAMED_PARAMETER_SET_16, UNNAMED_PARAMETER_SET_17, UNNAMED_PARAMETER_SET_18, UNNAMED_PARAMETER_SET_19 -Aliases: +Aliases: Required: False Position: Named @@ -1206,7 +1218,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a TXT resou ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_7 -Aliases: +Aliases: Required: True Position: 4 @@ -1223,7 +1235,7 @@ Use of the host is proportional to its weight. ```yaml Type: UInt16 Parameter Sets: UNNAMED_PARAMETER_SET_8 -Aliases: +Aliases: Required: True Position: Named @@ -1238,7 +1250,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a WINS reso ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_21 -Aliases: +Aliases: Required: True Position: 4 @@ -1253,7 +1265,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a WINS reve ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_20 -Aliases: +Aliases: Required: True Position: 4 @@ -1268,7 +1280,7 @@ Specifies one or more IP addresses of WINS servers that you want to use for a re ```yaml Type: IPAddress[] Parameter Sets: UNNAMED_PARAMETER_SET_21 -Aliases: +Aliases: Required: True Position: Named @@ -1283,7 +1295,7 @@ Indicates that the record that this cmdlet adds to the DNS server is WKS resourc ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_10 -Aliases: +Aliases: Required: True Position: 4 @@ -1298,7 +1310,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an X25 reso ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_18 -Aliases: +Aliases: Required: True Position: 4 @@ -1313,7 +1325,7 @@ Specifies the name of a DNS zone. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: True Position: 2 @@ -1328,7 +1340,7 @@ Prompts you for confirmation before running the cmdlet. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1344,7 +1356,7 @@ The cmdlet is not run. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1370,4 +1382,3 @@ Accept wildcard characters: False [Show-DnsServerCache](./Show-DnsServerCache.md) [Set-DnsServerZoneAging](./Set-DnsServerZoneAging.md) - diff --git a/docset/winserver2012r2-ps/dnsserver/Add-DnsServerResourceRecord.md b/docset/winserver2012r2-ps/dnsserver/Add-DnsServerResourceRecord.md index c0b6cd326c..f9728339ae 100644 --- a/docset/winserver2012r2-ps/dnsserver/Add-DnsServerResourceRecord.md +++ b/docset/winserver2012r2-ps/dnsserver/Add-DnsServerResourceRecord.md @@ -166,7 +166,7 @@ Add-DnsServerResourceRecord [-ZoneName] [-ComputerName ] [-Pass ## 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. +Use different switches for different record types. For more information about resource records, see Managing Resource Recordshttp://technet.microsoft.com/en-us/library/cc754308.aspx (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. @@ -184,9 +184,9 @@ 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. -VERBOSE: Adding DNS resource record host21.admin of type A in zone contoso.com on ROOT server. +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 -------- ---------- --------- ---------- ---------- @@ -239,6 +239,18 @@ PS C:\>Add-DnsServerResourceRecord -Srv -Name "sip" -ZoneName "contoso.com" -Dom 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 +```powershell +$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 @@ -248,7 +260,7 @@ An A resource record maps a host name to an IPv4 address. ```yaml Type: SwitchParameter Parameter Sets: A -Aliases: +Aliases: Required: True Position: 3 @@ -264,7 +276,7 @@ An AAAA resource record maps a host name to an IPv6 address. ```yaml Type: SwitchParameter Parameter Sets: AAAA -Aliases: +Aliases: Required: True Position: 3 @@ -282,7 +294,7 @@ The most significant byte is byte 0. ```yaml Type: String Parameter Sets: ATMA -Aliases: +Aliases: Required: True Position: Named @@ -298,7 +310,7 @@ Valid values are: 0, for an ATM End System Address (AESA) format, and 1, for an ```yaml Type: String Parameter Sets: ATMA -Aliases: +Aliases: Accepted values: E164, AESA Required: True @@ -315,7 +327,7 @@ An AFSDB resource record gives the location of the AFS cell database server and ```yaml Type: SwitchParameter Parameter Sets: AFSDB -Aliases: +Aliases: Required: True Position: 3 @@ -331,7 +343,7 @@ A DNS server can scavenge resource records that have become stale based on a tim ```yaml Type: SwitchParameter Parameter Sets: X25 -Aliases: +Aliases: Required: False Position: Named @@ -343,7 +355,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: WKS, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: False Position: Named @@ -358,7 +370,7 @@ Indicates that any authenticated user can update a resource record that has the ```yaml Type: SwitchParameter Parameter Sets: InputObject -Aliases: +Aliases: Required: False Position: Named @@ -370,7 +382,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: X25, WKS, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: False Position: Named @@ -385,7 +397,7 @@ ps_cimcommon_asjob ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -400,7 +412,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an ATM addr ```yaml Type: SwitchParameter Parameter Sets: ATMA -Aliases: +Aliases: Required: True Position: 3 @@ -415,7 +427,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a canonical ```yaml Type: SwitchParameter Parameter Sets: CNAME -Aliases: +Aliases: Required: True Position: 3 @@ -430,7 +442,7 @@ Specifies how long, in seconds, that a DNS server caches a response from a WINS ```yaml Type: TimeSpan Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: True Position: Named @@ -495,7 +507,7 @@ You can find the CPU type in a host information (HINFO) resource record. ```yaml Type: String Parameter Sets: HINFO -Aliases: +Aliases: Required: True Position: Named @@ -511,7 +523,7 @@ A PTR resource record maps an IP address to a host name. ```yaml Type: SwitchParameter Parameter Sets: AAAA -Aliases: +Aliases: Required: False Position: Named @@ -523,7 +535,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: A -Aliases: +Aliases: Required: False Position: Named @@ -539,7 +551,7 @@ A DNAME resource record renames the root and all descendants in a domain namespa ```yaml Type: SwitchParameter Parameter Sets: DNAME -Aliases: +Aliases: Required: True Position: 3 @@ -554,7 +566,7 @@ Specifies text to describe the person or people that are responsible for the dom ```yaml Type: String Parameter Sets: RP -Aliases: +Aliases: Required: True Position: Named @@ -564,12 +576,12 @@ Accept wildcard characters: False ``` ### -DescriptiveText -Specifies additional text to describe a resource record on a DNS server. +Specifies additional text to describe a resource record on a DNS server. It is limited to 254 characters per line. ```yaml Type: String Parameter Sets: TXT -Aliases: +Aliases: Required: True Position: Named @@ -584,7 +596,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Dynamic H ```yaml Type: SwitchParameter Parameter Sets: DHCID -Aliases: +Aliases: Required: True Position: 3 @@ -599,7 +611,7 @@ Specifies a public key that is associated with an FQDN, as described in section ```yaml Type: String Parameter Sets: DHCID -Aliases: +Aliases: Required: True Position: Named @@ -614,7 +626,7 @@ Specifies the name of a domain. ```yaml Type: String Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -629,7 +641,7 @@ Specifies the alias for a domain name. ```yaml Type: String Parameter Sets: DNAME -Aliases: +Aliases: Required: True Position: Named @@ -645,7 +657,7 @@ By default, the cmdlet prompts you for confirmation before it proceeds. ```yaml Type: SwitchParameter Parameter Sets: InputObject, WINSR, WINS -Aliases: +Aliases: Required: False Position: Named @@ -660,7 +672,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a host info ```yaml Type: SwitchParameter Parameter Sets: HINFO -Aliases: +Aliases: Required: True Position: 3 @@ -676,7 +688,7 @@ This must be a fully qualified domain name (FQDN). ```yaml Type: String Parameter Sets: CNAME -Aliases: +Aliases: Required: True Position: Named @@ -691,7 +703,7 @@ Specifies the IPv4 address of a host. ```yaml Type: IPAddress Parameter Sets: A -Aliases: +Aliases: Required: True Position: Named @@ -706,7 +718,7 @@ Specifies the IPv6 address of a host. ```yaml Type: IPAddress Parameter Sets: AAAA -Aliases: +Aliases: Required: True Position: Named @@ -723,7 +735,7 @@ This parameter takes an object of type **DnsServerResourceRecord**. ```yaml Type: CimInstance Parameter Sets: InputObject -Aliases: +Aliases: Required: True Position: Named @@ -738,7 +750,7 @@ Specifies the FQDN of a host that routes packets to a destination host. ```yaml Type: String Parameter Sets: RT -Aliases: +Aliases: Required: True Position: Named @@ -753,7 +765,7 @@ Specifies the IP address of the owner of a resource record. ```yaml Type: IPAddress Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: Named @@ -769,7 +781,7 @@ Valid values are: UDP or TCP. ```yaml Type: String Parameter Sets: WKS -Aliases: +Aliases: Accepted values: UDP, TCP Required: True @@ -785,7 +797,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an Integrat ```yaml Type: SwitchParameter Parameter Sets: ISDN -Aliases: +Aliases: Required: True Position: 3 @@ -802,7 +814,7 @@ The phone number can contain a country/region code, an area code, and a local ph ```yaml Type: String Parameter Sets: ISDN -Aliases: +Aliases: Required: True Position: Named @@ -819,7 +831,7 @@ The subaddress is an identifier that describes the ISDN subaddress encoding type ```yaml Type: String Parameter Sets: ISDN -Aliases: +Aliases: Required: True Position: Named @@ -834,7 +846,7 @@ Specifies the lookup time-out value for a resource record. ```yaml Type: TimeSpan Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: True Position: Named @@ -849,7 +861,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a mail exch ```yaml Type: SwitchParameter Parameter Sets: MX -Aliases: +Aliases: Required: True Position: 3 @@ -864,7 +876,7 @@ Specifies the FQDN of the host that is acting as a mail exchanger for the owner. ```yaml Type: String Parameter Sets: MX -Aliases: +Aliases: Required: True Position: Named @@ -879,7 +891,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Name Serv ```yaml Type: SwitchParameter Parameter Sets: NS -Aliases: +Aliases: Required: True Position: 3 @@ -894,7 +906,7 @@ Specifies the name of a DNS server resource record object. ```yaml Type: String Parameter Sets: X25, WKS, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: True Position: 2 @@ -909,7 +921,7 @@ Specifies the name server of a domain. ```yaml Type: String Parameter Sets: NS -Aliases: +Aliases: Required: True Position: Named @@ -925,7 +937,7 @@ You can find the operating system identifier in a HINFO resource record. ```yaml Type: String Parameter Sets: HINFO -Aliases: +Aliases: Required: True Position: Named @@ -941,7 +953,7 @@ By default, this cmdlet does not generate any output. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -956,7 +968,7 @@ Specifies the port where the server listens for the service. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -971,7 +983,7 @@ Specifies the priority for this resource record among other resource records tha ```yaml Type: UInt16 Parameter Sets: RT, MX -Aliases: +Aliases: Required: True Position: Named @@ -987,7 +999,7 @@ Clients try to contact the server that has the lowest priority. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1002,7 +1014,7 @@ Specifies the public switched data network (PSDN) address of the owner of a reso ```yaml Type: String Parameter Sets: X25 -Aliases: +Aliases: Required: True Position: Named @@ -1017,7 +1029,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a PTR resou ```yaml Type: SwitchParameter Parameter Sets: PTR -Aliases: +Aliases: Required: True Position: 3 @@ -1032,7 +1044,7 @@ Specifies the FQDN of the host when you add a PTR resource record. ```yaml Type: String Parameter Sets: PTR -Aliases: +Aliases: Required: True Position: Named @@ -1047,7 +1059,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Responsib ```yaml Type: SwitchParameter Parameter Sets: RP -Aliases: +Aliases: Required: True Position: 3 @@ -1062,7 +1074,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Route Thr ```yaml Type: SwitchParameter Parameter Sets: RT -Aliases: +Aliases: Required: True Position: 3 @@ -1077,7 +1089,7 @@ Indicates that the DNS server allows WINS replication. ```yaml Type: SwitchParameter Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: False Position: Named @@ -1094,7 +1106,7 @@ When used together with the MR parameter set, this value specifies a mailbox tha ```yaml Type: String Parameter Sets: RP -Aliases: +Aliases: Required: True Position: Named @@ -1109,7 +1121,7 @@ Specifies the domain name to append to returned NetBIOS names. ```yaml Type: String Parameter Sets: WINSR -Aliases: +Aliases: Required: True Position: Named @@ -1126,7 +1138,7 @@ For subtype 2 (value=2), the host has an authenticated name server holding the c ```yaml Type: String Parameter Sets: AFSDB -Aliases: +Aliases: Required: True Position: Named @@ -1143,7 +1155,7 @@ Available services include Well-known Service (WKS) and NAPTR. ```yaml Type: String[] Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: Named @@ -1158,7 +1170,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Service ( ```yaml Type: SwitchParameter Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: 3 @@ -1177,7 +1189,7 @@ For more information about server subtypes, see [RFC 1183](https://www.ietf.org/ ```yaml Type: UInt16 Parameter Sets: AFSDB -Aliases: +Aliases: Required: True Position: Named @@ -1194,7 +1206,7 @@ The throttle limit applies only to the current cmdlet, not to the session or to ```yaml Type: Int32 Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1210,7 +1222,7 @@ Other DNS servers use this length of time to determine how long to cache a recor ```yaml Type: TimeSpan Parameter Sets: X25, WKS, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: False Position: Named @@ -1225,7 +1237,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a TXT resou ```yaml Type: SwitchParameter Parameter Sets: TXT -Aliases: +Aliases: Required: True Position: 3 @@ -1242,7 +1254,7 @@ Use of the host is proportional to its weight. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1273,7 +1285,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a WINS reso ```yaml Type: SwitchParameter Parameter Sets: WINS -Aliases: +Aliases: Required: True Position: 3 @@ -1288,7 +1300,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a WINS reve ```yaml Type: SwitchParameter Parameter Sets: WINSR -Aliases: +Aliases: Required: True Position: 3 @@ -1303,7 +1315,7 @@ Specifies one or more IP addresses of WINS servers that you want to use for a re ```yaml Type: IPAddress[] Parameter Sets: WINS -Aliases: +Aliases: Required: True Position: Named @@ -1318,7 +1330,7 @@ Indicates that the record that this cmdlet adds to the DNS server is WKS resourc ```yaml Type: SwitchParameter Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: 3 @@ -1333,7 +1345,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an X25 reso ```yaml Type: SwitchParameter Parameter Sets: X25 -Aliases: +Aliases: Required: True Position: 3 @@ -1348,7 +1360,7 @@ Specifies the name of a DNS zone. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: True Position: 1 @@ -1377,4 +1389,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable [Show-DnsServerCache](./Show-DnsServerCache.md) [Set-DnsServerZoneAging](./Set-DnsServerZoneAging.md) - diff --git a/docset/winserver2016-ps/dnsserver/Add-DnsServerResourceRecord.md b/docset/winserver2016-ps/dnsserver/Add-DnsServerResourceRecord.md index 8b8382af35..9830e442f8 100644 --- a/docset/winserver2016-ps/dnsserver/Add-DnsServerResourceRecord.md +++ b/docset/winserver2016-ps/dnsserver/Add-DnsServerResourceRecord.md @@ -202,7 +202,7 @@ Add-DnsServerResourceRecord [-ZoneName] [-ComputerName ] [-Pass ## 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. +Use different switches for different record types. For more information about resource records, see [Managing Resource Records](https://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. @@ -268,6 +268,18 @@ PS C:\> Add-DnsServerResourceRecord -Srv -Name "sip" -ZoneName "contoso.com" -Do 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 +```powershell +$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 @@ -277,7 +289,7 @@ An A resource record maps a host name to an IPv4 address. ```yaml Type: SwitchParameter Parameter Sets: A -Aliases: +Aliases: Required: True Position: 3 @@ -293,7 +305,7 @@ An AAAA resource record maps a host name to an IPv6 address. ```yaml Type: SwitchParameter Parameter Sets: AAAA -Aliases: +Aliases: Required: True Position: 3 @@ -311,7 +323,7 @@ The most significant byte is byte 0. ```yaml Type: String Parameter Sets: ATMA -Aliases: +Aliases: Required: True Position: Named @@ -327,7 +339,7 @@ Valid values are: 0, for an ATM End System Address (AESA) format, and 1, for an ```yaml Type: String Parameter Sets: ATMA -Aliases: +Aliases: Accepted values: E164, AESA Required: True @@ -344,7 +356,7 @@ An AFSDB resource record gives the location of the AFS cell database server and ```yaml Type: SwitchParameter Parameter Sets: AFSDB -Aliases: +Aliases: Required: True Position: 3 @@ -360,7 +372,7 @@ A DNS server can scavenge resource records that have become stale based on a tim ```yaml Type: SwitchParameter Parameter Sets: X25, TLSA -Aliases: +Aliases: Required: False Position: Named @@ -372,7 +384,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: WKS, Unknown, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: False Position: Named @@ -387,7 +399,7 @@ Indicates that any authenticated user can update a resource record that has the ```yaml Type: SwitchParameter Parameter Sets: InputObject, TLSA -Aliases: +Aliases: Required: False Position: Named @@ -399,7 +411,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: X25, WKS, Unknown, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: False Position: Named @@ -409,19 +421,19 @@ 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. +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](https://go.microsoft.com/fwlink/?LinkID=113372) cmdlet. +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](https://go.microsoft.com/fwlink/?LinkID=113372) cmdlet. For more information about Windows PowerShell background jobs, see [about_Jobs](https://go.microsoft.com/fwlink/?LinkID=113251). ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -436,7 +448,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an ATM addr ```yaml Type: SwitchParameter Parameter Sets: ATMA -Aliases: +Aliases: Required: True Position: 3 @@ -451,7 +463,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a canonical ```yaml Type: SwitchParameter Parameter Sets: CNAME -Aliases: +Aliases: Required: True Position: 3 @@ -466,7 +478,7 @@ Specifies how long, in seconds, that a DNS server caches a response from a WINS ```yaml Type: TimeSpan Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: True Position: Named @@ -481,7 +493,7 @@ Specifies the certificate association data for a Transport Layer Security (TLS) ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Required: True Position: Named @@ -496,7 +508,7 @@ Specifies the certificate usage TLS authentication record. ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Accepted values: CAConstraint, ServiceCertificateConstraint, TrustAnchorAssertion, DomainIssuedCertificate Required: True @@ -562,7 +574,7 @@ You can find the CPU type in a host information (HINFO) resource record. ```yaml Type: String Parameter Sets: HINFO -Aliases: +Aliases: Required: True Position: Named @@ -578,7 +590,7 @@ A PTR resource record maps an IP address to a host name. ```yaml Type: SwitchParameter Parameter Sets: AAAA -Aliases: +Aliases: Required: False Position: Named @@ -590,7 +602,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: A -Aliases: +Aliases: Required: False Position: Named @@ -606,7 +618,7 @@ A DNAME resource record renames the root and all descendants in a domain namespa ```yaml Type: SwitchParameter Parameter Sets: DNAME -Aliases: +Aliases: Required: True Position: 3 @@ -621,7 +633,7 @@ Specifies text to describe the person or people that are responsible for the dom ```yaml Type: String Parameter Sets: RP -Aliases: +Aliases: Required: True Position: Named @@ -631,12 +643,12 @@ Accept wildcard characters: False ``` ### -DescriptiveText -Specifies additional text to describe a resource record on a DNS server. +Specifies additional text to describe a resource record on a DNS server. It is limited to 254 characters per line. ```yaml Type: String Parameter Sets: TXT -Aliases: +Aliases: Required: True Position: Named @@ -651,7 +663,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Dynamic H ```yaml Type: SwitchParameter Parameter Sets: DHCID -Aliases: +Aliases: Required: True Position: 3 @@ -666,7 +678,7 @@ Specifies a public key that is associated with an FQDN, as described in section ```yaml Type: String Parameter Sets: DHCID -Aliases: +Aliases: Required: True Position: Named @@ -681,7 +693,7 @@ Specifies the name of a domain. ```yaml Type: String Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -696,7 +708,7 @@ Specifies the alias for a domain name. ```yaml Type: String Parameter Sets: DNAME -Aliases: +Aliases: Required: True Position: Named @@ -712,7 +724,7 @@ By default, the cmdlet prompts you for confirmation before it proceeds. ```yaml Type: SwitchParameter Parameter Sets: InputObject, WINSR, WINS -Aliases: +Aliases: Required: False Position: Named @@ -727,7 +739,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a host info ```yaml Type: SwitchParameter Parameter Sets: HINFO -Aliases: +Aliases: Required: True Position: 3 @@ -743,7 +755,7 @@ This must be a fully qualified domain name (FQDN). ```yaml Type: String Parameter Sets: CNAME -Aliases: +Aliases: Required: True Position: Named @@ -758,7 +770,7 @@ Specifies the IPv4 address of a host. ```yaml Type: IPAddress Parameter Sets: A -Aliases: +Aliases: Required: True Position: Named @@ -773,7 +785,7 @@ Specifies the IPv6 address of a host. ```yaml Type: IPAddress Parameter Sets: AAAA -Aliases: +Aliases: Required: True Position: Named @@ -783,13 +795,13 @@ Accept wildcard characters: False ``` ### -InputObject -Specifies the input to this cmdlet. +Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet. ```yaml Type: CimInstance Parameter Sets: InputObject -Aliases: +Aliases: Required: True Position: Named @@ -804,7 +816,7 @@ Specifies the FQDN of a host that routes packets to a destination host. ```yaml Type: String Parameter Sets: RT -Aliases: +Aliases: Required: True Position: Named @@ -819,7 +831,7 @@ Specifies the IP address of the owner of a resource record. ```yaml Type: IPAddress Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: Named @@ -835,7 +847,7 @@ Valid values are: UDP or TCP. ```yaml Type: String Parameter Sets: WKS -Aliases: +Aliases: Accepted values: UDP, TCP Required: True @@ -851,7 +863,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an Integrat ```yaml Type: SwitchParameter Parameter Sets: ISDN -Aliases: +Aliases: Required: True Position: 3 @@ -868,7 +880,7 @@ The phone number can contain a country/region code, an area code, and a local ph ```yaml Type: String Parameter Sets: ISDN -Aliases: +Aliases: Required: True Position: Named @@ -885,7 +897,7 @@ The subaddress is an identifier that describes the ISDN subaddress encoding type ```yaml Type: String Parameter Sets: ISDN -Aliases: +Aliases: Required: True Position: Named @@ -900,7 +912,7 @@ Specifies the lookup time-out value for a resource record. ```yaml Type: TimeSpan Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: True Position: Named @@ -915,7 +927,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a mail exch ```yaml Type: SwitchParameter Parameter Sets: MX -Aliases: +Aliases: Required: True Position: 3 @@ -930,7 +942,7 @@ Specifies the FQDN of the host that is acting as a mail exchanger for the owner. ```yaml Type: String Parameter Sets: MX -Aliases: +Aliases: Required: True Position: Named @@ -943,14 +955,14 @@ Accept wildcard characters: False Specifies the matching type for the record. The acceptable values for this parameter are: -- ExactMatch -- Sha256Hash +- ExactMatch +- Sha256Hash - Sha512Hash ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Accepted values: ExactMatch, Sha256Hash, Sha512Hash Required: True @@ -966,7 +978,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Name Serv ```yaml Type: SwitchParameter Parameter Sets: NS -Aliases: +Aliases: Required: True Position: 3 @@ -981,7 +993,7 @@ Specifies the name of a DNS server resource record object. ```yaml Type: String Parameter Sets: X25, WKS, Unknown, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: True Position: 2 @@ -993,7 +1005,7 @@ Accept wildcard characters: False ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Required: False Position: 2 @@ -1008,7 +1020,7 @@ Specifies the name server of a domain. ```yaml Type: String Parameter Sets: NS -Aliases: +Aliases: Required: True Position: Named @@ -1024,7 +1036,7 @@ You can find the operating system identifier in a HINFO resource record. ```yaml Type: String Parameter Sets: HINFO -Aliases: +Aliases: Required: True Position: Named @@ -1040,7 +1052,7 @@ By default, this cmdlet does not generate any output. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1055,7 +1067,7 @@ Specifies the port where the server listens for the service. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1070,7 +1082,7 @@ Specifies the priority for this resource record among other resource records tha ```yaml Type: UInt16 Parameter Sets: RT, MX -Aliases: +Aliases: Required: True Position: Named @@ -1086,7 +1098,7 @@ Clients try to contact the server that has the lowest priority. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1101,7 +1113,7 @@ Specifies the public switched data network (PSDN) address of the owner of a reso ```yaml Type: String Parameter Sets: X25 -Aliases: +Aliases: Required: True Position: Named @@ -1116,7 +1128,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a PTR resou ```yaml Type: SwitchParameter Parameter Sets: PTR -Aliases: +Aliases: Required: True Position: 3 @@ -1131,7 +1143,7 @@ Specifies the FQDN of the host when you add a PTR resource record. ```yaml Type: String Parameter Sets: PTR -Aliases: +Aliases: Required: True Position: Named @@ -1146,7 +1158,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Responsib ```yaml Type: SwitchParameter Parameter Sets: RP -Aliases: +Aliases: Required: True Position: 3 @@ -1161,7 +1173,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Route Thr ```yaml Type: SwitchParameter Parameter Sets: RT -Aliases: +Aliases: Required: True Position: 3 @@ -1176,7 +1188,7 @@ Specifies the data contained in the resource record you want to add. ```yaml Type: String Parameter Sets: Unknown -Aliases: +Aliases: Required: True Position: 4 @@ -1191,7 +1203,7 @@ Indicates that the DNS server allows WINS replication. ```yaml Type: SwitchParameter Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: False Position: Named @@ -1208,7 +1220,7 @@ When used together with the MR parameter set, this value specifies a mailbox tha ```yaml Type: String Parameter Sets: RP -Aliases: +Aliases: Required: True Position: Named @@ -1223,7 +1235,7 @@ Specifies the domain name to append to returned NetBIOS names. ```yaml Type: String Parameter Sets: WINSR -Aliases: +Aliases: Required: True Position: Named @@ -1238,7 +1250,7 @@ Specifies a selector. ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Accepted values: FullCertificate, SubjectPublicKeyInfo Required: True @@ -1256,7 +1268,7 @@ For subtype 2 (value=2), the host has an authenticated name server holding the c ```yaml Type: String Parameter Sets: AFSDB -Aliases: +Aliases: Required: True Position: Named @@ -1273,7 +1285,7 @@ Available services include Well-known Service (WKS) and NAPTR. ```yaml Type: String[] Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: Named @@ -1288,7 +1300,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Service ( ```yaml Type: SwitchParameter Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: 3 @@ -1307,7 +1319,7 @@ For more information about server subtypes, see [RFC 1183](http://www.ietf.org/r ```yaml Type: UInt16 Parameter Sets: AFSDB -Aliases: +Aliases: Required: True Position: Named @@ -1322,7 +1334,7 @@ Indicates that the record that this cmdlet adds is a TLS authentication resource ```yaml Type: SwitchParameter Parameter Sets: TLSA -Aliases: +Aliases: Required: True Position: 3 @@ -1339,7 +1351,7 @@ The throttle limit applies only to the current cmdlet, not to the session or to ```yaml Type: Int32 Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1355,7 +1367,7 @@ Other DNS servers use this length of time to determine how long to cache a recor ```yaml Type: TimeSpan Parameter Sets: X25, WKS, Unknown, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: False Position: Named @@ -1367,7 +1379,7 @@ Accept wildcard characters: False ```yaml Type: TimeSpan Parameter Sets: TLSA -Aliases: +Aliases: Required: False Position: Named @@ -1382,7 +1394,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a TXT resou ```yaml Type: SwitchParameter Parameter Sets: TXT -Aliases: +Aliases: Required: True Position: 3 @@ -1397,7 +1409,7 @@ Specifies the type of the resource record. ```yaml Type: UInt16 Parameter Sets: Unknown -Aliases: +Aliases: Required: True Position: 3 @@ -1415,7 +1427,7 @@ This parameter is optional and if not provided it will add the zone into the def ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1432,7 +1444,7 @@ Use of the host is proportional to its weight. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1463,7 +1475,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a WINS reso ```yaml Type: SwitchParameter Parameter Sets: WINS -Aliases: +Aliases: Required: True Position: 3 @@ -1478,7 +1490,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a WINS reve ```yaml Type: SwitchParameter Parameter Sets: WINSR -Aliases: +Aliases: Required: True Position: 3 @@ -1493,7 +1505,7 @@ Specifies one or more IP addresses of WINS servers that you want to use for a re ```yaml Type: IPAddress[] Parameter Sets: WINS -Aliases: +Aliases: Required: True Position: Named @@ -1508,7 +1520,7 @@ Indicates that the record that this cmdlet adds to the DNS server is WKS resourc ```yaml Type: SwitchParameter Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: 3 @@ -1523,7 +1535,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an X25 reso ```yaml Type: SwitchParameter Parameter Sets: X25 -Aliases: +Aliases: Required: True Position: 3 @@ -1538,7 +1550,7 @@ Specifies the name of a DNS zone. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: True Position: 1 @@ -1553,7 +1565,7 @@ Specifies the name of a zone scope. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1582,4 +1594,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable [Show-DnsServerCache](./Show-DnsServerCache.md) [Set-DnsServerZoneAging](./Set-DnsServerZoneAging.md) - diff --git a/docset/winserver2019-ps/dnsserver/Add-DnsServerResourceRecord.md b/docset/winserver2019-ps/dnsserver/Add-DnsServerResourceRecord.md index fa47f17f54..913f10a12a 100644 --- a/docset/winserver2019-ps/dnsserver/Add-DnsServerResourceRecord.md +++ b/docset/winserver2019-ps/dnsserver/Add-DnsServerResourceRecord.md @@ -202,7 +202,7 @@ Add-DnsServerResourceRecord [-ZoneName] [-ComputerName ] [-Pass ## 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. +Use different switches for different record types. For more information about resource records, see [Managing Resource Records](https://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. @@ -268,6 +268,18 @@ PS C:\> Add-DnsServerResourceRecord -Srv -Name "sip" -ZoneName "contoso.com" -Do 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 +```powershell +$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 @@ -277,7 +289,7 @@ An A resource record maps a host name to an IPv4 address. ```yaml Type: SwitchParameter Parameter Sets: A -Aliases: +Aliases: Required: True Position: 3 @@ -293,7 +305,7 @@ An AAAA resource record maps a host name to an IPv6 address. ```yaml Type: SwitchParameter Parameter Sets: AAAA -Aliases: +Aliases: Required: True Position: 3 @@ -311,7 +323,7 @@ The most significant byte is byte 0. ```yaml Type: String Parameter Sets: ATMA -Aliases: +Aliases: Required: True Position: Named @@ -327,7 +339,7 @@ Valid values are: 0, for an ATM End System Address (AESA) format, and 1, for an ```yaml Type: String Parameter Sets: ATMA -Aliases: +Aliases: Accepted values: E164, AESA Required: True @@ -344,7 +356,7 @@ An AFSDB resource record gives the location of the AFS cell database server and ```yaml Type: SwitchParameter Parameter Sets: AFSDB -Aliases: +Aliases: Required: True Position: 3 @@ -360,7 +372,7 @@ A DNS server can scavenge resource records that have become stale based on a tim ```yaml Type: SwitchParameter Parameter Sets: X25, TLSA -Aliases: +Aliases: Required: False Position: Named @@ -372,7 +384,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: WKS, Unknown, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: False Position: Named @@ -387,7 +399,7 @@ Indicates that any authenticated user can update a resource record that has the ```yaml Type: SwitchParameter Parameter Sets: InputObject, TLSA -Aliases: +Aliases: Required: False Position: Named @@ -399,7 +411,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: X25, WKS, Unknown, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: False Position: Named @@ -409,19 +421,19 @@ 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. +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](https://go.microsoft.com/fwlink/?LinkID=113372) cmdlet. +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](https://go.microsoft.com/fwlink/?LinkID=113372) cmdlet. For more information about Windows PowerShell background jobs, see [about_Jobs](https://go.microsoft.com/fwlink/?LinkID=113251). ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -436,7 +448,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an ATM addr ```yaml Type: SwitchParameter Parameter Sets: ATMA -Aliases: +Aliases: Required: True Position: 3 @@ -451,7 +463,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a canonical ```yaml Type: SwitchParameter Parameter Sets: CNAME -Aliases: +Aliases: Required: True Position: 3 @@ -466,7 +478,7 @@ Specifies how long, in seconds, that a DNS server caches a response from a WINS ```yaml Type: TimeSpan Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: True Position: Named @@ -481,7 +493,7 @@ Specifies the certificate association data for a Transport Layer Security (TLS) ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Required: True Position: Named @@ -496,7 +508,7 @@ Specifies the certificate usage TLS authentication record. ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Accepted values: CAConstraint, ServiceCertificateConstraint, TrustAnchorAssertion, DomainIssuedCertificate Required: True @@ -562,7 +574,7 @@ You can find the CPU type in a host information (HINFO) resource record. ```yaml Type: String Parameter Sets: HINFO -Aliases: +Aliases: Required: True Position: Named @@ -578,7 +590,7 @@ A PTR resource record maps an IP address to a host name. ```yaml Type: SwitchParameter Parameter Sets: AAAA -Aliases: +Aliases: Required: False Position: Named @@ -590,7 +602,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: A -Aliases: +Aliases: Required: False Position: Named @@ -606,7 +618,7 @@ A DNAME resource record renames the root and all descendants in a domain namespa ```yaml Type: SwitchParameter Parameter Sets: DNAME -Aliases: +Aliases: Required: True Position: 3 @@ -621,7 +633,7 @@ Specifies text to describe the person or people that are responsible for the dom ```yaml Type: String Parameter Sets: RP -Aliases: +Aliases: Required: True Position: Named @@ -631,12 +643,12 @@ Accept wildcard characters: False ``` ### -DescriptiveText -Specifies additional text to describe a resource record on a DNS server. +Specifies additional text to describe a resource record on a DNS server. It is limited to 254 characters per line. ```yaml Type: String Parameter Sets: TXT -Aliases: +Aliases: Required: True Position: Named @@ -651,7 +663,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Dynamic H ```yaml Type: SwitchParameter Parameter Sets: DHCID -Aliases: +Aliases: Required: True Position: 3 @@ -666,7 +678,7 @@ Specifies a public key that is associated with an FQDN, as described in section ```yaml Type: String Parameter Sets: DHCID -Aliases: +Aliases: Required: True Position: Named @@ -681,7 +693,7 @@ Specifies the name of a domain. ```yaml Type: String Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -696,7 +708,7 @@ Specifies the alias for a domain name. ```yaml Type: String Parameter Sets: DNAME -Aliases: +Aliases: Required: True Position: Named @@ -712,7 +724,7 @@ By default, the cmdlet prompts you for confirmation before it proceeds. ```yaml Type: SwitchParameter Parameter Sets: InputObject, WINSR, WINS -Aliases: +Aliases: Required: False Position: Named @@ -727,7 +739,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a host info ```yaml Type: SwitchParameter Parameter Sets: HINFO -Aliases: +Aliases: Required: True Position: 3 @@ -743,7 +755,7 @@ This must be a fully qualified domain name (FQDN). ```yaml Type: String Parameter Sets: CNAME -Aliases: +Aliases: Required: True Position: Named @@ -758,7 +770,7 @@ Specifies the IPv4 address of a host. ```yaml Type: IPAddress Parameter Sets: A -Aliases: +Aliases: Required: True Position: Named @@ -773,7 +785,7 @@ Specifies the IPv6 address of a host. ```yaml Type: IPAddress Parameter Sets: AAAA -Aliases: +Aliases: Required: True Position: Named @@ -783,13 +795,13 @@ Accept wildcard characters: False ``` ### -InputObject -Specifies the input to this cmdlet. +Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet. ```yaml Type: CimInstance Parameter Sets: InputObject -Aliases: +Aliases: Required: True Position: Named @@ -804,7 +816,7 @@ Specifies the FQDN of a host that routes packets to a destination host. ```yaml Type: String Parameter Sets: RT -Aliases: +Aliases: Required: True Position: Named @@ -819,7 +831,7 @@ Specifies the IP address of the owner of a resource record. ```yaml Type: IPAddress Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: Named @@ -835,7 +847,7 @@ Valid values are: UDP or TCP. ```yaml Type: String Parameter Sets: WKS -Aliases: +Aliases: Accepted values: UDP, TCP Required: True @@ -851,7 +863,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an Integrat ```yaml Type: SwitchParameter Parameter Sets: ISDN -Aliases: +Aliases: Required: True Position: 3 @@ -868,7 +880,7 @@ The phone number can contain a country/region code, an area code, and a local ph ```yaml Type: String Parameter Sets: ISDN -Aliases: +Aliases: Required: True Position: Named @@ -885,7 +897,7 @@ The subaddress is an identifier that describes the ISDN subaddress encoding type ```yaml Type: String Parameter Sets: ISDN -Aliases: +Aliases: Required: True Position: Named @@ -900,7 +912,7 @@ Specifies the lookup time-out value for a resource record. ```yaml Type: TimeSpan Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: True Position: Named @@ -915,7 +927,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a mail exch ```yaml Type: SwitchParameter Parameter Sets: MX -Aliases: +Aliases: Required: True Position: 3 @@ -930,7 +942,7 @@ Specifies the FQDN of the host that is acting as a mail exchanger for the owner. ```yaml Type: String Parameter Sets: MX -Aliases: +Aliases: Required: True Position: Named @@ -943,14 +955,14 @@ Accept wildcard characters: False Specifies the matching type for the record. The acceptable values for this parameter are: -- ExactMatch -- Sha256Hash +- ExactMatch +- Sha256Hash - Sha512Hash ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Accepted values: ExactMatch, Sha256Hash, Sha512Hash Required: True @@ -966,7 +978,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Name Serv ```yaml Type: SwitchParameter Parameter Sets: NS -Aliases: +Aliases: Required: True Position: 3 @@ -981,7 +993,7 @@ Specifies the name of a DNS server resource record object. ```yaml Type: String Parameter Sets: X25, WKS, Unknown, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: True Position: 2 @@ -993,7 +1005,7 @@ Accept wildcard characters: False ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Required: False Position: 2 @@ -1008,7 +1020,7 @@ Specifies the name server of a domain. ```yaml Type: String Parameter Sets: NS -Aliases: +Aliases: Required: True Position: Named @@ -1024,7 +1036,7 @@ You can find the operating system identifier in a HINFO resource record. ```yaml Type: String Parameter Sets: HINFO -Aliases: +Aliases: Required: True Position: Named @@ -1040,7 +1052,7 @@ By default, this cmdlet does not generate any output. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1055,7 +1067,7 @@ Specifies the port where the server listens for the service. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1070,7 +1082,7 @@ Specifies the priority for this resource record among other resource records tha ```yaml Type: UInt16 Parameter Sets: RT, MX -Aliases: +Aliases: Required: True Position: Named @@ -1086,7 +1098,7 @@ Clients try to contact the server that has the lowest priority. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1101,7 +1113,7 @@ Specifies the public switched data network (PSDN) address of the owner of a reso ```yaml Type: String Parameter Sets: X25 -Aliases: +Aliases: Required: True Position: Named @@ -1116,7 +1128,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a PTR resou ```yaml Type: SwitchParameter Parameter Sets: PTR -Aliases: +Aliases: Required: True Position: 3 @@ -1131,7 +1143,7 @@ Specifies the FQDN of the host when you add a PTR resource record. ```yaml Type: String Parameter Sets: PTR -Aliases: +Aliases: Required: True Position: Named @@ -1146,7 +1158,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Responsib ```yaml Type: SwitchParameter Parameter Sets: RP -Aliases: +Aliases: Required: True Position: 3 @@ -1161,7 +1173,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Route Thr ```yaml Type: SwitchParameter Parameter Sets: RT -Aliases: +Aliases: Required: True Position: 3 @@ -1176,7 +1188,7 @@ Specifies the data contained in the resource record you want to add. ```yaml Type: String Parameter Sets: Unknown -Aliases: +Aliases: Required: True Position: 4 @@ -1191,7 +1203,7 @@ Indicates that the DNS server allows WINS replication. ```yaml Type: SwitchParameter Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: False Position: Named @@ -1208,7 +1220,7 @@ When used together with the MR parameter set, this value specifies a mailbox tha ```yaml Type: String Parameter Sets: RP -Aliases: +Aliases: Required: True Position: Named @@ -1223,7 +1235,7 @@ Specifies the domain name to append to returned NetBIOS names. ```yaml Type: String Parameter Sets: WINSR -Aliases: +Aliases: Required: True Position: Named @@ -1238,7 +1250,7 @@ Specifies a selector. ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Accepted values: FullCertificate, SubjectPublicKeyInfo Required: True @@ -1256,7 +1268,7 @@ For subtype 2 (value=2), the host has an authenticated name server holding the c ```yaml Type: String Parameter Sets: AFSDB -Aliases: +Aliases: Required: True Position: Named @@ -1273,7 +1285,7 @@ Available services include Well-known Service (WKS) and NAPTR. ```yaml Type: String[] Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: Named @@ -1288,7 +1300,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Service ( ```yaml Type: SwitchParameter Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: 3 @@ -1307,7 +1319,7 @@ For more information about server subtypes, see [RFC 1183](http://www.ietf.org/r ```yaml Type: UInt16 Parameter Sets: AFSDB -Aliases: +Aliases: Required: True Position: Named @@ -1322,7 +1334,7 @@ Indicates that the record that this cmdlet adds is a TLS authentication resource ```yaml Type: SwitchParameter Parameter Sets: TLSA -Aliases: +Aliases: Required: True Position: 3 @@ -1339,7 +1351,7 @@ The throttle limit applies only to the current cmdlet, not to the session or to ```yaml Type: Int32 Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1355,7 +1367,7 @@ Other DNS servers use this length of time to determine how long to cache a recor ```yaml Type: TimeSpan Parameter Sets: X25, WKS, Unknown, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: False Position: Named @@ -1367,7 +1379,7 @@ Accept wildcard characters: False ```yaml Type: TimeSpan Parameter Sets: TLSA -Aliases: +Aliases: Required: False Position: Named @@ -1382,7 +1394,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a TXT resou ```yaml Type: SwitchParameter Parameter Sets: TXT -Aliases: +Aliases: Required: True Position: 3 @@ -1397,7 +1409,7 @@ Specifies the type of the resource record. ```yaml Type: UInt16 Parameter Sets: Unknown -Aliases: +Aliases: Required: True Position: 3 @@ -1415,7 +1427,7 @@ This parameter is optional and if not provided it will add the zone into the def ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1432,7 +1444,7 @@ Use of the host is proportional to its weight. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1463,7 +1475,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a WINS reso ```yaml Type: SwitchParameter Parameter Sets: WINS -Aliases: +Aliases: Required: True Position: 3 @@ -1478,7 +1490,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a WINS reve ```yaml Type: SwitchParameter Parameter Sets: WINSR -Aliases: +Aliases: Required: True Position: 3 @@ -1493,7 +1505,7 @@ Specifies one or more IP addresses of WINS servers that you want to use for a re ```yaml Type: IPAddress[] Parameter Sets: WINS -Aliases: +Aliases: Required: True Position: Named @@ -1508,7 +1520,7 @@ Indicates that the record that this cmdlet adds to the DNS server is WKS resourc ```yaml Type: SwitchParameter Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: 3 @@ -1523,7 +1535,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an X25 reso ```yaml Type: SwitchParameter Parameter Sets: X25 -Aliases: +Aliases: Required: True Position: 3 @@ -1538,7 +1550,7 @@ Specifies the name of a DNS zone. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: True Position: 1 @@ -1553,7 +1565,7 @@ Specifies the name of a zone scope. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1582,4 +1594,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable [Show-DnsServerCache](./Show-DnsServerCache.md) [Set-DnsServerZoneAging](./Set-DnsServerZoneAging.md) - diff --git a/docset/winserver2022-ps/dnsserver/Add-DnsServerResourceRecord.md b/docset/winserver2022-ps/dnsserver/Add-DnsServerResourceRecord.md index fd92bb7b4b..45c7717878 100644 --- a/docset/winserver2022-ps/dnsserver/Add-DnsServerResourceRecord.md +++ b/docset/winserver2022-ps/dnsserver/Add-DnsServerResourceRecord.md @@ -202,7 +202,7 @@ Add-DnsServerResourceRecord [-ZoneName] [-ComputerName ] [-Pass ## 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. +Use different switches for different record types. For more information about resource records, see [Managing Resource Records](https://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. @@ -268,6 +268,18 @@ PS C:\> Add-DnsServerResourceRecord -Srv -Name "sip" -ZoneName "contoso.com" -Do 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 +```powershell +$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 @@ -277,7 +289,7 @@ An A resource record maps a host name to an IPv4 address. ```yaml Type: SwitchParameter Parameter Sets: A -Aliases: +Aliases: Required: True Position: 3 @@ -293,7 +305,7 @@ An AAAA resource record maps a host name to an IPv6 address. ```yaml Type: SwitchParameter Parameter Sets: AAAA -Aliases: +Aliases: Required: True Position: 3 @@ -311,7 +323,7 @@ The most significant byte is byte 0. ```yaml Type: String Parameter Sets: ATMA -Aliases: +Aliases: Required: True Position: Named @@ -327,7 +339,7 @@ Valid values are: 0, for an ATM End System Address (AESA) format, and 1, for an ```yaml Type: String Parameter Sets: ATMA -Aliases: +Aliases: Accepted values: E164, AESA Required: True @@ -344,7 +356,7 @@ An AFSDB resource record gives the location of the AFS cell database server and ```yaml Type: SwitchParameter Parameter Sets: AFSDB -Aliases: +Aliases: Required: True Position: 3 @@ -360,7 +372,7 @@ A DNS server can scavenge resource records that have become stale based on a tim ```yaml Type: SwitchParameter Parameter Sets: X25, TLSA -Aliases: +Aliases: Required: False Position: Named @@ -372,7 +384,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: WKS, Unknown, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: False Position: Named @@ -387,7 +399,7 @@ Indicates that any authenticated user can update a resource record that has the ```yaml Type: SwitchParameter Parameter Sets: InputObject, TLSA -Aliases: +Aliases: Required: False Position: Named @@ -399,7 +411,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: X25, WKS, Unknown, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: False Position: Named @@ -409,19 +421,19 @@ 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. +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](https://go.microsoft.com/fwlink/?LinkID=113372) cmdlet. +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](https://go.microsoft.com/fwlink/?LinkID=113372) cmdlet. For more information about Windows PowerShell background jobs, see [about_Jobs](https://go.microsoft.com/fwlink/?LinkID=113251). ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -436,7 +448,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an ATM addr ```yaml Type: SwitchParameter Parameter Sets: ATMA -Aliases: +Aliases: Required: True Position: 3 @@ -451,7 +463,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a canonical ```yaml Type: SwitchParameter Parameter Sets: CNAME -Aliases: +Aliases: Required: True Position: 3 @@ -466,7 +478,7 @@ Specifies how long, in seconds, that a DNS server caches a response from a WINS ```yaml Type: TimeSpan Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: True Position: Named @@ -481,7 +493,7 @@ Specifies the certificate association data for a Transport Layer Security (TLS) ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Required: True Position: Named @@ -496,7 +508,7 @@ Specifies the certificate usage TLS authentication record. ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Accepted values: CAConstraint, ServiceCertificateConstraint, TrustAnchorAssertion, DomainIssuedCertificate Required: True @@ -562,7 +574,7 @@ You can find the CPU type in a host information (HINFO) resource record. ```yaml Type: String Parameter Sets: HINFO -Aliases: +Aliases: Required: True Position: Named @@ -578,7 +590,7 @@ A PTR resource record maps an IP address to a host name. ```yaml Type: SwitchParameter Parameter Sets: AAAA -Aliases: +Aliases: Required: False Position: Named @@ -590,7 +602,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: A -Aliases: +Aliases: Required: False Position: Named @@ -606,7 +618,7 @@ A DNAME resource record renames the root and all descendants in a domain namespa ```yaml Type: SwitchParameter Parameter Sets: DNAME -Aliases: +Aliases: Required: True Position: 3 @@ -621,7 +633,7 @@ Specifies text to describe the person or people that are responsible for the dom ```yaml Type: String Parameter Sets: RP -Aliases: +Aliases: Required: True Position: Named @@ -631,12 +643,12 @@ Accept wildcard characters: False ``` ### -DescriptiveText -Specifies additional text to describe a resource record on a DNS server. +Specifies additional text to describe a resource record on a DNS server. It is limited to 254 characters per line. ```yaml Type: String Parameter Sets: TXT -Aliases: +Aliases: Required: True Position: Named @@ -651,7 +663,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Dynamic H ```yaml Type: SwitchParameter Parameter Sets: DHCID -Aliases: +Aliases: Required: True Position: 3 @@ -666,7 +678,7 @@ Specifies a public key that is associated with an FQDN, as described in section ```yaml Type: String Parameter Sets: DHCID -Aliases: +Aliases: Required: True Position: Named @@ -681,7 +693,7 @@ Specifies the name of a domain. ```yaml Type: String Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -696,7 +708,7 @@ Specifies the alias for a domain name. ```yaml Type: String Parameter Sets: DNAME -Aliases: +Aliases: Required: True Position: Named @@ -712,7 +724,7 @@ By default, the cmdlet prompts you for confirmation before it proceeds. ```yaml Type: SwitchParameter Parameter Sets: InputObject, WINSR, WINS -Aliases: +Aliases: Required: False Position: Named @@ -727,7 +739,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a host info ```yaml Type: SwitchParameter Parameter Sets: HINFO -Aliases: +Aliases: Required: True Position: 3 @@ -743,7 +755,7 @@ This must be a fully qualified domain name (FQDN). ```yaml Type: String Parameter Sets: CNAME -Aliases: +Aliases: Required: True Position: Named @@ -758,7 +770,7 @@ Specifies the IPv4 address of a host. ```yaml Type: IPAddress Parameter Sets: A -Aliases: +Aliases: Required: True Position: Named @@ -773,7 +785,7 @@ Specifies the IPv6 address of a host. ```yaml Type: IPAddress Parameter Sets: AAAA -Aliases: +Aliases: Required: True Position: Named @@ -783,13 +795,13 @@ Accept wildcard characters: False ``` ### -InputObject -Specifies the input to this cmdlet. +Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet. ```yaml Type: CimInstance Parameter Sets: InputObject -Aliases: +Aliases: Required: True Position: Named @@ -804,7 +816,7 @@ Specifies the FQDN of a host that routes packets to a destination host. ```yaml Type: String Parameter Sets: RT -Aliases: +Aliases: Required: True Position: Named @@ -819,7 +831,7 @@ Specifies the IP address of the owner of a resource record. ```yaml Type: IPAddress Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: Named @@ -835,7 +847,7 @@ Valid values are: UDP or TCP. ```yaml Type: String Parameter Sets: WKS -Aliases: +Aliases: Accepted values: UDP, TCP Required: True @@ -851,7 +863,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an Integrat ```yaml Type: SwitchParameter Parameter Sets: ISDN -Aliases: +Aliases: Required: True Position: 3 @@ -868,7 +880,7 @@ The phone number can contain a country/region code, an area code, and a local ph ```yaml Type: String Parameter Sets: ISDN -Aliases: +Aliases: Required: True Position: Named @@ -885,7 +897,7 @@ The subaddress is an identifier that describes the ISDN subaddress encoding type ```yaml Type: String Parameter Sets: ISDN -Aliases: +Aliases: Required: True Position: Named @@ -900,7 +912,7 @@ Specifies the lookup time-out value for a resource record. ```yaml Type: TimeSpan Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: True Position: Named @@ -915,7 +927,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a mail exch ```yaml Type: SwitchParameter Parameter Sets: MX -Aliases: +Aliases: Required: True Position: 3 @@ -930,7 +942,7 @@ Specifies the FQDN of the host that is acting as a mail exchanger for the owner. ```yaml Type: String Parameter Sets: MX -Aliases: +Aliases: Required: True Position: Named @@ -943,14 +955,14 @@ Accept wildcard characters: False Specifies the matching type for the record. The acceptable values for this parameter are: -- ExactMatch -- Sha256Hash +- ExactMatch +- Sha256Hash - Sha512Hash ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Accepted values: ExactMatch, Sha256Hash, Sha512Hash Required: True @@ -966,7 +978,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Name Serv ```yaml Type: SwitchParameter Parameter Sets: NS -Aliases: +Aliases: Required: True Position: 3 @@ -981,7 +993,7 @@ Specifies the name of a DNS server resource record object. ```yaml Type: String Parameter Sets: X25, WKS, Unknown, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: True Position: 2 @@ -993,7 +1005,7 @@ Accept wildcard characters: False ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Required: False Position: 2 @@ -1008,7 +1020,7 @@ Specifies the name server of a domain. ```yaml Type: String Parameter Sets: NS -Aliases: +Aliases: Required: True Position: Named @@ -1024,7 +1036,7 @@ You can find the operating system identifier in a HINFO resource record. ```yaml Type: String Parameter Sets: HINFO -Aliases: +Aliases: Required: True Position: Named @@ -1040,7 +1052,7 @@ By default, this cmdlet does not generate any output. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1055,7 +1067,7 @@ Specifies the port where the server listens for the service. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1070,7 +1082,7 @@ Specifies the priority for this resource record among other resource records tha ```yaml Type: UInt16 Parameter Sets: RT, MX -Aliases: +Aliases: Required: True Position: Named @@ -1086,7 +1098,7 @@ Clients try to contact the server that has the lowest priority. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1101,7 +1113,7 @@ Specifies the public switched data network (PSDN) address of the owner of a reso ```yaml Type: String Parameter Sets: X25 -Aliases: +Aliases: Required: True Position: Named @@ -1116,7 +1128,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a PTR resou ```yaml Type: SwitchParameter Parameter Sets: PTR -Aliases: +Aliases: Required: True Position: 3 @@ -1131,7 +1143,7 @@ Specifies the FQDN of the host when you add a PTR resource record. ```yaml Type: String Parameter Sets: PTR -Aliases: +Aliases: Required: True Position: Named @@ -1146,7 +1158,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Responsib ```yaml Type: SwitchParameter Parameter Sets: RP -Aliases: +Aliases: Required: True Position: 3 @@ -1161,7 +1173,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Route Thr ```yaml Type: SwitchParameter Parameter Sets: RT -Aliases: +Aliases: Required: True Position: 3 @@ -1176,7 +1188,7 @@ Specifies the data contained in the resource record you want to add. ```yaml Type: String Parameter Sets: Unknown -Aliases: +Aliases: Required: True Position: 4 @@ -1191,7 +1203,7 @@ Indicates that the DNS server allows WINS replication. ```yaml Type: SwitchParameter Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: False Position: Named @@ -1208,7 +1220,7 @@ When used together with the MR parameter set, this value specifies a mailbox tha ```yaml Type: String Parameter Sets: RP -Aliases: +Aliases: Required: True Position: Named @@ -1223,7 +1235,7 @@ Specifies the domain name to append to returned NetBIOS names. ```yaml Type: String Parameter Sets: WINSR -Aliases: +Aliases: Required: True Position: Named @@ -1238,7 +1250,7 @@ Specifies a selector. ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Accepted values: FullCertificate, SubjectPublicKeyInfo Required: True @@ -1256,7 +1268,7 @@ For subtype 2 (value=2), the host has an authenticated name server holding the c ```yaml Type: String Parameter Sets: AFSDB -Aliases: +Aliases: Required: True Position: Named @@ -1273,7 +1285,7 @@ Available services include Well-known Service (WKS) and NAPTR. ```yaml Type: String[] Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: Named @@ -1288,7 +1300,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a Service ( ```yaml Type: SwitchParameter Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: 3 @@ -1307,7 +1319,7 @@ For more information about server subtypes, see [RFC 1183](http://www.ietf.org/r ```yaml Type: UInt16 Parameter Sets: AFSDB -Aliases: +Aliases: Required: True Position: Named @@ -1322,7 +1334,7 @@ Indicates that the record that this cmdlet adds is a TLS authentication resource ```yaml Type: SwitchParameter Parameter Sets: TLSA -Aliases: +Aliases: Required: True Position: 3 @@ -1339,7 +1351,7 @@ The throttle limit applies only to the current cmdlet, not to the session or to ```yaml Type: Int32 Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1355,7 +1367,7 @@ Other DNS servers use this length of time to determine how long to cache a recor ```yaml Type: TimeSpan Parameter Sets: X25, WKS, Unknown, TXT, SRV, RT, RP, PTR, NS, MX, ISDN, HINFO, DNAME, DHCID, CNAME, ATMA, AFSDB, AAAA, A -Aliases: +Aliases: Required: False Position: Named @@ -1367,7 +1379,7 @@ Accept wildcard characters: False ```yaml Type: TimeSpan Parameter Sets: TLSA -Aliases: +Aliases: Required: False Position: Named @@ -1382,7 +1394,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a TXT resou ```yaml Type: SwitchParameter Parameter Sets: TXT -Aliases: +Aliases: Required: True Position: 3 @@ -1397,7 +1409,7 @@ Specifies the type of the resource record. ```yaml Type: UInt16 Parameter Sets: Unknown -Aliases: +Aliases: Required: True Position: 3 @@ -1415,7 +1427,7 @@ This parameter is optional and if not provided it will add the zone into the def ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1432,7 +1444,7 @@ Use of the host is proportional to its weight. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1463,7 +1475,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a WINS reso ```yaml Type: SwitchParameter Parameter Sets: WINS -Aliases: +Aliases: Required: True Position: 3 @@ -1478,7 +1490,7 @@ Indicates that the record that this cmdlet adds to the DNS server is a WINS reve ```yaml Type: SwitchParameter Parameter Sets: WINSR -Aliases: +Aliases: Required: True Position: 3 @@ -1493,7 +1505,7 @@ Specifies one or more IP addresses of WINS servers that you want to use for a re ```yaml Type: IPAddress[] Parameter Sets: WINS -Aliases: +Aliases: Required: True Position: Named @@ -1508,7 +1520,7 @@ Indicates that the record that this cmdlet adds to the DNS server is WKS resourc ```yaml Type: SwitchParameter Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: 3 @@ -1523,7 +1535,7 @@ Indicates that the record that this cmdlet adds to the DNS server is an X25 reso ```yaml Type: SwitchParameter Parameter Sets: X25 -Aliases: +Aliases: Required: True Position: 3 @@ -1538,7 +1550,7 @@ Specifies the name of a DNS zone. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: True Position: 1 @@ -1553,7 +1565,7 @@ Specifies the name of a zone scope. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1582,4 +1594,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable [Show-DnsServerCache](./Show-DnsServerCache.md) [Set-DnsServerZoneAging](./Set-DnsServerZoneAging.md) -