From bf901483333158c8a366fb0e245bf623e787726e Mon Sep 17 00:00:00 2001 From: BWMerlin <857916+BWMerlin@users.noreply.github.com> Date: Mon, 14 Jun 2021 21:25:47 +1000 Subject: [PATCH 1/6] Added the location of the export zone file Added the location to where the export zone file can be found (C:\Windows\System32\DNS) and that the location is on the DNS server. Also added a note that -FileName is a filename and not a filepath. This should clarify how users can use this command and where they can locate the output. --- docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md b/docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md index 6713b37a2e..ccaf709b0b 100644 --- a/docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md +++ b/docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md @@ -32,7 +32,7 @@ By default, the cmdlet places the file in the Domain Name System (DNS) directory PS C:\> Export-DnsServerZone -Name "western.contoso.com" -FileName "exportedcontoso.com" ``` -This command exports the zone named western.contoso.com to a file called exportedcontoso.com. +This command exports the zone named western.contoso.com to a file called exportedcontoso.com located in C:\Windows\System32\DNS on the DNS server. Note that -FileName is a filename not a filepath. ## PARAMETERS From 6086632b1f1393c9e94eb6c50f60b6257c8bb76f Mon Sep 17 00:00:00 2001 From: BWMerlin <857916+BWMerlin@users.noreply.github.com> Date: Tue, 15 Jun 2021 19:28:06 +1000 Subject: [PATCH 2/6] Update docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md Co-authored-by: JohanFreelancer9 <48568725+JohanFreelancer9@users.noreply.github.com> --- docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md b/docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md index ccaf709b0b..0bdbff441c 100644 --- a/docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md +++ b/docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md @@ -32,7 +32,7 @@ By default, the cmdlet places the file in the Domain Name System (DNS) directory PS C:\> Export-DnsServerZone -Name "western.contoso.com" -FileName "exportedcontoso.com" ``` -This command exports the zone named western.contoso.com to a file called exportedcontoso.com located in C:\Windows\System32\DNS on the DNS server. Note that -FileName is a filename not a filepath. +This command exports the zone named western.contoso.com to a file called exportedcontoso.com located in C:\Windows\System32\DNS on the DNS server. Note that -FileName is a filename, not a file path. ## PARAMETERS @@ -210,4 +210,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable [Suspend-DnsServerZone](./Suspend-DnsServerZone.md) [Sync-DnsServerZone](./Sync-DnsServerZone.md) - From 8466fb3fd157bbccbf3d811339b1c732f00ed41d Mon Sep 17 00:00:00 2001 From: Borislav Velkov Date: Fri, 25 Jun 2021 10:26:36 +0300 Subject: [PATCH 3/6] Resolves #2423 Add info about character limit in TXT records https://github.com/MicrosoftDocs/windows-powershell-docs/issues/2423 --- .../dnsserver/Add-DnsServerResourceRecord.md | 168 ++++++++------- .../dnsserver/Add-DnsServerResourceRecord.md | 160 ++++++++------- .../dnsserver/Add-DnsServerResourceRecord.md | 192 ++++++++++-------- .../dnsserver/Add-DnsServerResourceRecord.md | 192 ++++++++++-------- .../dnsserver/Add-DnsServerResourceRecord.md | 192 ++++++++++-------- 5 files changed, 482 insertions(+), 422 deletions(-) diff --git a/docset/winserver2012-ps/dnsserver/Add-DnsServerResourceRecord.md b/docset/winserver2012-ps/dnsserver/Add-DnsServerResourceRecord.md index e41a7036e0..e859ef2902 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,19 @@ 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 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 mutliline TXT resource record. String is split in 252 characters sets and then new line is added in the end which is 2 characters in Windows. + ## PARAMETERS ### -A @@ -246,7 +259,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 +275,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 +293,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 +309,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 +325,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 +341,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 +353,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_18 -Aliases: +Aliases: Required: False Position: Named @@ -355,7 +368,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 +380,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 +395,7 @@ ps_cimcommon_asjob ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -397,7 +410,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 +425,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 +442,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 +457,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 +474,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 +490,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 +506,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 +518,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: UNNAMED_PARAMETER_SET_3 -Aliases: +Aliases: Required: False Position: Named @@ -520,7 +533,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 +543,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 +563,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 +578,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 +594,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 +609,7 @@ Specifies the name of a domain. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_8 -Aliases: +Aliases: Required: True Position: Named @@ -611,7 +624,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 +640,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 +655,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 +671,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 +688,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 +703,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 +718,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 +734,7 @@ Valid values are: UDP or TCP. ```yaml Type: String Parameter Sets: UNNAMED_PARAMETER_SET_10 -Aliases: +Aliases: Required: True Position: Named @@ -736,7 +749,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 +764,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 +779,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 +796,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 +813,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 +828,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 +843,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 +858,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 +873,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 +888,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 +903,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 +919,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 +935,7 @@ By default, this cmdlet does not generate any output. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -937,7 +950,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 +965,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 +981,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 +996,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 +1011,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 +1026,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 +1041,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 +1058,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 +1073,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 +1088,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 +1103,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 +1120,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 +1137,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 +1152,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 +1171,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 +1188,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 +1204,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 +1219,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 +1236,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 +1251,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 +1266,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 +1281,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 +1296,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 +1311,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 +1326,7 @@ Specifies the name of a DNS zone. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: True Position: 2 @@ -1328,7 +1341,7 @@ Prompts you for confirmation before running the cmdlet. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1344,7 +1357,7 @@ The cmdlet is not run. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1370,4 +1383,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..e9e980943f 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,19 @@ 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 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 mutliline TXT resource record. String is split in 252 characters sets and then new line is added in the end which is 2 characters in Windows. + ## PARAMETERS ### -A @@ -248,7 +261,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 +277,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 +295,7 @@ The most significant byte is byte 0. ```yaml Type: String Parameter Sets: ATMA -Aliases: +Aliases: Required: True Position: Named @@ -298,7 +311,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 +328,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 +344,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 +356,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 +371,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 +383,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 +398,7 @@ ps_cimcommon_asjob ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -400,7 +413,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 +428,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 +443,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 +508,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 +524,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 +536,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: A -Aliases: +Aliases: Required: False Position: Named @@ -539,7 +552,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 +567,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 +577,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 +597,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 +612,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 +627,7 @@ Specifies the name of a domain. ```yaml Type: String Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -629,7 +642,7 @@ Specifies the alias for a domain name. ```yaml Type: String Parameter Sets: DNAME -Aliases: +Aliases: Required: True Position: Named @@ -645,7 +658,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 +673,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 +689,7 @@ This must be a fully qualified domain name (FQDN). ```yaml Type: String Parameter Sets: CNAME -Aliases: +Aliases: Required: True Position: Named @@ -691,7 +704,7 @@ Specifies the IPv4 address of a host. ```yaml Type: IPAddress Parameter Sets: A -Aliases: +Aliases: Required: True Position: Named @@ -706,7 +719,7 @@ Specifies the IPv6 address of a host. ```yaml Type: IPAddress Parameter Sets: AAAA -Aliases: +Aliases: Required: True Position: Named @@ -723,7 +736,7 @@ This parameter takes an object of type **DnsServerResourceRecord**. ```yaml Type: CimInstance Parameter Sets: InputObject -Aliases: +Aliases: Required: True Position: Named @@ -738,7 +751,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 +766,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 +782,7 @@ Valid values are: UDP or TCP. ```yaml Type: String Parameter Sets: WKS -Aliases: +Aliases: Accepted values: UDP, TCP Required: True @@ -785,7 +798,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 +815,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 +832,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 +847,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 +862,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 +877,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 +892,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 +907,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 +922,7 @@ Specifies the name server of a domain. ```yaml Type: String Parameter Sets: NS -Aliases: +Aliases: Required: True Position: Named @@ -925,7 +938,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 +954,7 @@ By default, this cmdlet does not generate any output. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -956,7 +969,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 +984,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 +1000,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 +1015,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 +1030,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 +1045,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 +1060,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 +1075,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 +1090,7 @@ Indicates that the DNS server allows WINS replication. ```yaml Type: SwitchParameter Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: False Position: Named @@ -1094,7 +1107,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 +1122,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 +1139,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 +1156,7 @@ Available services include Well-known Service (WKS) and NAPTR. ```yaml Type: String[] Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: Named @@ -1158,7 +1171,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 +1190,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 +1207,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 +1223,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 +1238,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 +1255,7 @@ Use of the host is proportional to its weight. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1273,7 +1286,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 +1301,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 +1316,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 +1331,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 +1346,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 +1361,7 @@ Specifies the name of a DNS zone. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: True Position: 1 @@ -1377,4 +1390,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..45bd509991 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,19 @@ 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 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 mutliline TXT resource record. String is split in 252 characters sets and then new line is added in the end which is 2 characters in Windows. + ## PARAMETERS ### -A @@ -277,7 +290,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 +306,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 +324,7 @@ The most significant byte is byte 0. ```yaml Type: String Parameter Sets: ATMA -Aliases: +Aliases: Required: True Position: Named @@ -327,7 +340,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 +357,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 +373,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 +385,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 +400,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 +412,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 +422,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 +449,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 +464,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 +479,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 +494,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 +509,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 +575,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 +591,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 +603,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: A -Aliases: +Aliases: Required: False Position: Named @@ -606,7 +619,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 +634,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 +644,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 +664,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 +679,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 +694,7 @@ Specifies the name of a domain. ```yaml Type: String Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -696,7 +709,7 @@ Specifies the alias for a domain name. ```yaml Type: String Parameter Sets: DNAME -Aliases: +Aliases: Required: True Position: Named @@ -712,7 +725,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 +740,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 +756,7 @@ This must be a fully qualified domain name (FQDN). ```yaml Type: String Parameter Sets: CNAME -Aliases: +Aliases: Required: True Position: Named @@ -758,7 +771,7 @@ Specifies the IPv4 address of a host. ```yaml Type: IPAddress Parameter Sets: A -Aliases: +Aliases: Required: True Position: Named @@ -773,7 +786,7 @@ Specifies the IPv6 address of a host. ```yaml Type: IPAddress Parameter Sets: AAAA -Aliases: +Aliases: Required: True Position: Named @@ -783,13 +796,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 +817,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 +832,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 +848,7 @@ Valid values are: UDP or TCP. ```yaml Type: String Parameter Sets: WKS -Aliases: +Aliases: Accepted values: UDP, TCP Required: True @@ -851,7 +864,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 +881,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 +898,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 +913,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 +928,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 +943,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 +956,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 +979,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 +994,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 +1006,7 @@ Accept wildcard characters: False ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Required: False Position: 2 @@ -1008,7 +1021,7 @@ Specifies the name server of a domain. ```yaml Type: String Parameter Sets: NS -Aliases: +Aliases: Required: True Position: Named @@ -1024,7 +1037,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 +1053,7 @@ By default, this cmdlet does not generate any output. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1055,7 +1068,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 +1083,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 +1099,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 +1114,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 +1129,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 +1144,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 +1159,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 +1174,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 +1189,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 +1204,7 @@ Indicates that the DNS server allows WINS replication. ```yaml Type: SwitchParameter Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: False Position: Named @@ -1208,7 +1221,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 +1236,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 +1251,7 @@ Specifies a selector. ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Accepted values: FullCertificate, SubjectPublicKeyInfo Required: True @@ -1256,7 +1269,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 +1286,7 @@ Available services include Well-known Service (WKS) and NAPTR. ```yaml Type: String[] Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: Named @@ -1288,7 +1301,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 +1320,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 +1335,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 +1352,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 +1368,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 +1380,7 @@ Accept wildcard characters: False ```yaml Type: TimeSpan Parameter Sets: TLSA -Aliases: +Aliases: Required: False Position: Named @@ -1382,7 +1395,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 +1410,7 @@ Specifies the type of the resource record. ```yaml Type: UInt16 Parameter Sets: Unknown -Aliases: +Aliases: Required: True Position: 3 @@ -1415,7 +1428,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 +1445,7 @@ Use of the host is proportional to its weight. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1463,7 +1476,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 +1491,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 +1506,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 +1521,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 +1536,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 +1551,7 @@ Specifies the name of a DNS zone. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: True Position: 1 @@ -1553,7 +1566,7 @@ Specifies the name of a zone scope. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1582,4 +1595,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..8304e02112 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,19 @@ 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 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 mutliline TXT resource record. String is split in 252 characters sets and then new line is added in the end which is 2 characters in Windows. + ## PARAMETERS ### -A @@ -277,7 +290,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 +306,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 +324,7 @@ The most significant byte is byte 0. ```yaml Type: String Parameter Sets: ATMA -Aliases: +Aliases: Required: True Position: Named @@ -327,7 +340,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 +357,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 +373,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 +385,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 +400,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 +412,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 +422,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 +449,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 +464,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 +479,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 +494,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 +509,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 +575,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 +591,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 +603,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: A -Aliases: +Aliases: Required: False Position: Named @@ -606,7 +619,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 +634,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 +644,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 +664,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 +679,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 +694,7 @@ Specifies the name of a domain. ```yaml Type: String Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -696,7 +709,7 @@ Specifies the alias for a domain name. ```yaml Type: String Parameter Sets: DNAME -Aliases: +Aliases: Required: True Position: Named @@ -712,7 +725,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 +740,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 +756,7 @@ This must be a fully qualified domain name (FQDN). ```yaml Type: String Parameter Sets: CNAME -Aliases: +Aliases: Required: True Position: Named @@ -758,7 +771,7 @@ Specifies the IPv4 address of a host. ```yaml Type: IPAddress Parameter Sets: A -Aliases: +Aliases: Required: True Position: Named @@ -773,7 +786,7 @@ Specifies the IPv6 address of a host. ```yaml Type: IPAddress Parameter Sets: AAAA -Aliases: +Aliases: Required: True Position: Named @@ -783,13 +796,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 +817,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 +832,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 +848,7 @@ Valid values are: UDP or TCP. ```yaml Type: String Parameter Sets: WKS -Aliases: +Aliases: Accepted values: UDP, TCP Required: True @@ -851,7 +864,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 +881,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 +898,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 +913,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 +928,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 +943,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 +956,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 +979,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 +994,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 +1006,7 @@ Accept wildcard characters: False ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Required: False Position: 2 @@ -1008,7 +1021,7 @@ Specifies the name server of a domain. ```yaml Type: String Parameter Sets: NS -Aliases: +Aliases: Required: True Position: Named @@ -1024,7 +1037,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 +1053,7 @@ By default, this cmdlet does not generate any output. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1055,7 +1068,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 +1083,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 +1099,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 +1114,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 +1129,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 +1144,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 +1159,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 +1174,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 +1189,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 +1204,7 @@ Indicates that the DNS server allows WINS replication. ```yaml Type: SwitchParameter Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: False Position: Named @@ -1208,7 +1221,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 +1236,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 +1251,7 @@ Specifies a selector. ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Accepted values: FullCertificate, SubjectPublicKeyInfo Required: True @@ -1256,7 +1269,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 +1286,7 @@ Available services include Well-known Service (WKS) and NAPTR. ```yaml Type: String[] Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: Named @@ -1288,7 +1301,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 +1320,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 +1335,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 +1352,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 +1368,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 +1380,7 @@ Accept wildcard characters: False ```yaml Type: TimeSpan Parameter Sets: TLSA -Aliases: +Aliases: Required: False Position: Named @@ -1382,7 +1395,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 +1410,7 @@ Specifies the type of the resource record. ```yaml Type: UInt16 Parameter Sets: Unknown -Aliases: +Aliases: Required: True Position: 3 @@ -1415,7 +1428,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 +1445,7 @@ Use of the host is proportional to its weight. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1463,7 +1476,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 +1491,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 +1506,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 +1521,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 +1536,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 +1551,7 @@ Specifies the name of a DNS zone. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: True Position: 1 @@ -1553,7 +1566,7 @@ Specifies the name of a zone scope. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1582,4 +1595,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..b7ed926c17 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,19 @@ 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 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 mutliline TXT resource record. String is split in 252 characters sets and then new line is added in the end which is 2 characters in Windows. + ## PARAMETERS ### -A @@ -277,7 +290,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 +306,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 +324,7 @@ The most significant byte is byte 0. ```yaml Type: String Parameter Sets: ATMA -Aliases: +Aliases: Required: True Position: Named @@ -327,7 +340,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 +357,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 +373,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 +385,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 +400,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 +412,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 +422,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 +449,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 +464,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 +479,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 +494,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 +509,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 +575,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 +591,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 +603,7 @@ Accept wildcard characters: False ```yaml Type: SwitchParameter Parameter Sets: A -Aliases: +Aliases: Required: False Position: Named @@ -606,7 +619,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 +634,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 +644,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 +664,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 +679,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 +694,7 @@ Specifies the name of a domain. ```yaml Type: String Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -696,7 +709,7 @@ Specifies the alias for a domain name. ```yaml Type: String Parameter Sets: DNAME -Aliases: +Aliases: Required: True Position: Named @@ -712,7 +725,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 +740,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 +756,7 @@ This must be a fully qualified domain name (FQDN). ```yaml Type: String Parameter Sets: CNAME -Aliases: +Aliases: Required: True Position: Named @@ -758,7 +771,7 @@ Specifies the IPv4 address of a host. ```yaml Type: IPAddress Parameter Sets: A -Aliases: +Aliases: Required: True Position: Named @@ -773,7 +786,7 @@ Specifies the IPv6 address of a host. ```yaml Type: IPAddress Parameter Sets: AAAA -Aliases: +Aliases: Required: True Position: Named @@ -783,13 +796,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 +817,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 +832,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 +848,7 @@ Valid values are: UDP or TCP. ```yaml Type: String Parameter Sets: WKS -Aliases: +Aliases: Accepted values: UDP, TCP Required: True @@ -851,7 +864,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 +881,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 +898,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 +913,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 +928,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 +943,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 +956,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 +979,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 +994,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 +1006,7 @@ Accept wildcard characters: False ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Required: False Position: 2 @@ -1008,7 +1021,7 @@ Specifies the name server of a domain. ```yaml Type: String Parameter Sets: NS -Aliases: +Aliases: Required: True Position: Named @@ -1024,7 +1037,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 +1053,7 @@ By default, this cmdlet does not generate any output. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1055,7 +1068,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 +1083,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 +1099,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 +1114,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 +1129,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 +1144,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 +1159,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 +1174,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 +1189,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 +1204,7 @@ Indicates that the DNS server allows WINS replication. ```yaml Type: SwitchParameter Parameter Sets: WINSR, WINS -Aliases: +Aliases: Required: False Position: Named @@ -1208,7 +1221,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 +1236,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 +1251,7 @@ Specifies a selector. ```yaml Type: String Parameter Sets: TLSA -Aliases: +Aliases: Accepted values: FullCertificate, SubjectPublicKeyInfo Required: True @@ -1256,7 +1269,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 +1286,7 @@ Available services include Well-known Service (WKS) and NAPTR. ```yaml Type: String[] Parameter Sets: WKS -Aliases: +Aliases: Required: True Position: Named @@ -1288,7 +1301,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 +1320,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 +1335,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 +1352,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 +1368,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 +1380,7 @@ Accept wildcard characters: False ```yaml Type: TimeSpan Parameter Sets: TLSA -Aliases: +Aliases: Required: False Position: Named @@ -1382,7 +1395,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 +1410,7 @@ Specifies the type of the resource record. ```yaml Type: UInt16 Parameter Sets: Unknown -Aliases: +Aliases: Required: True Position: 3 @@ -1415,7 +1428,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 +1445,7 @@ Use of the host is proportional to its weight. ```yaml Type: UInt16 Parameter Sets: SRV -Aliases: +Aliases: Required: True Position: Named @@ -1463,7 +1476,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 +1491,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 +1506,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 +1521,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 +1536,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 +1551,7 @@ Specifies the name of a DNS zone. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: True Position: 1 @@ -1553,7 +1566,7 @@ Specifies the name of a zone scope. ```yaml Type: String Parameter Sets: (All) -Aliases: +Aliases: Required: False Position: Named @@ -1582,4 +1595,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable [Show-DnsServerCache](./Show-DnsServerCache.md) [Set-DnsServerZoneAging](./Set-DnsServerZoneAging.md) - From bbe1112044360b7a5a325c7dab282aa519aa4fc0 Mon Sep 17 00:00:00 2001 From: Borislav Velkov Date: Fri, 25 Jun 2021 17:00:17 +0300 Subject: [PATCH 4/6] Apply suggestions from code review Co-authored-by: JohanFreelancer9 <48568725+JohanFreelancer9@users.noreply.github.com> --- .../dnsserver/Add-DnsServerResourceRecord.md | 5 ++--- .../dnsserver/Add-DnsServerResourceRecord.md | 5 ++--- .../dnsserver/Add-DnsServerResourceRecord.md | 5 ++--- .../dnsserver/Add-DnsServerResourceRecord.md | 5 ++--- .../dnsserver/Add-DnsServerResourceRecord.md | 5 ++--- 5 files changed, 10 insertions(+), 15 deletions(-) diff --git a/docset/winserver2012-ps/dnsserver/Add-DnsServerResourceRecord.md b/docset/winserver2012-ps/dnsserver/Add-DnsServerResourceRecord.md index e859ef2902..388e115f9a 100644 --- a/docset/winserver2012-ps/dnsserver/Add-DnsServerResourceRecord.md +++ b/docset/winserver2012-ps/dnsserver/Add-DnsServerResourceRecord.md @@ -237,7 +237,7 @@ 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 multiline TXT resource record +### 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) @@ -245,10 +245,9 @@ $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 mutliline TXT resource record. String is split in 252 characters sets and then new line is added in the end which is 2 characters in Windows. +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 diff --git a/docset/winserver2012r2-ps/dnsserver/Add-DnsServerResourceRecord.md b/docset/winserver2012r2-ps/dnsserver/Add-DnsServerResourceRecord.md index e9e980943f..f9728339ae 100644 --- a/docset/winserver2012r2-ps/dnsserver/Add-DnsServerResourceRecord.md +++ b/docset/winserver2012r2-ps/dnsserver/Add-DnsServerResourceRecord.md @@ -239,7 +239,7 @@ 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 multiline TXT resource record +### 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) @@ -247,10 +247,9 @@ $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 mutliline TXT resource record. String is split in 252 characters sets and then new line is added in the end which is 2 characters in Windows. +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 diff --git a/docset/winserver2016-ps/dnsserver/Add-DnsServerResourceRecord.md b/docset/winserver2016-ps/dnsserver/Add-DnsServerResourceRecord.md index 45bd509991..9830e442f8 100644 --- a/docset/winserver2016-ps/dnsserver/Add-DnsServerResourceRecord.md +++ b/docset/winserver2016-ps/dnsserver/Add-DnsServerResourceRecord.md @@ -268,7 +268,7 @@ 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 multiline TXT resource record +### 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) @@ -276,10 +276,9 @@ $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 mutliline TXT resource record. String is split in 252 characters sets and then new line is added in the end which is 2 characters in Windows. +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 diff --git a/docset/winserver2019-ps/dnsserver/Add-DnsServerResourceRecord.md b/docset/winserver2019-ps/dnsserver/Add-DnsServerResourceRecord.md index 8304e02112..913f10a12a 100644 --- a/docset/winserver2019-ps/dnsserver/Add-DnsServerResourceRecord.md +++ b/docset/winserver2019-ps/dnsserver/Add-DnsServerResourceRecord.md @@ -268,7 +268,7 @@ 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 multiline TXT resource record +### 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) @@ -276,10 +276,9 @@ $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 mutliline TXT resource record. String is split in 252 characters sets and then new line is added in the end which is 2 characters in Windows. +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 diff --git a/docset/winserver2022-ps/dnsserver/Add-DnsServerResourceRecord.md b/docset/winserver2022-ps/dnsserver/Add-DnsServerResourceRecord.md index b7ed926c17..45c7717878 100644 --- a/docset/winserver2022-ps/dnsserver/Add-DnsServerResourceRecord.md +++ b/docset/winserver2022-ps/dnsserver/Add-DnsServerResourceRecord.md @@ -268,7 +268,7 @@ 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 multiline TXT resource record +### 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) @@ -276,10 +276,9 @@ $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 mutliline TXT resource record. String is split in 252 characters sets and then new line is added in the end which is 2 characters in Windows. +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 From bec3639a0ad7eb5a482f6f4c01642672c7b6dd9c Mon Sep 17 00:00:00 2001 From: BWMerlin <857916+BWMerlin@users.noreply.github.com> Date: Sun, 18 Jul 2021 19:27:09 +1000 Subject: [PATCH 5/6] Updated -FileName Removed wording about being able to add a file path when using -FileName as it is NOT possible to use a file path. --- docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md b/docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md index 0bdbff441c..13a39b2a8f 100644 --- a/docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md +++ b/docset/winserver2019-ps/dnsserver/Export-DnsServerZone.md @@ -109,7 +109,6 @@ Accept wildcard characters: False ### -FileName Specifies a name for the export file. -You can include a file path. ```yaml Type: String From d8226373afa76a5db6c0dce1ae5a059e51721cd6 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Mon, 19 Jul 2021 16:04:07 -0500 Subject: [PATCH 6/6] Remove Hyper-V from CabGen exclusions --- docset/mapping/cabgenConfig.json | 5 ----- 1 file changed, 5 deletions(-) diff --git a/docset/mapping/cabgenConfig.json b/docset/mapping/cabgenConfig.json index 7f73abe4bc..71c5f0e25a 100644 --- a/docset/mapping/cabgenConfig.json +++ b/docset/mapping/cabgenConfig.json @@ -3,7 +3,6 @@ { "WindowsServer2022-ps": { "exclude": [ - "docset/winserver2022-ps/hyper-v", "docset/winserver2022-ps/Microsoft.DiagnosticDataViewer", "docset/winserver2022-ps/Microsoft.Windows.ServerManager.Migration", "docset/winserver2022-ps/windowsdiagnosticdata" @@ -11,7 +10,6 @@ }, "WindowsServer2019-ps": { "exclude": [ - "docset/winserver2019-ps/hyper-v", "docset/winserver2019-ps/Microsoft.DiagnosticDataViewer", "docset/winserver2019-ps/Microsoft.Windows.ServerManager.Migration", "docset/winserver2019-ps/windowsdiagnosticdata" @@ -19,7 +17,6 @@ }, "WindowsServer2016-ps": { "exclude": [ - "docset/winserver2016-ps/hyper-v", "docset/winserver2016-ps/Microsoft.DiagnosticDataViewer", "docset/winserver2016-ps/Microsoft.Windows.ServerManager.Migration", "docset/winserver2016-ps/windowsdiagnosticdata" @@ -28,13 +25,11 @@ "winserver2012r2-ps": { "exclude": [ "docset/winserver2012r2-ps/hpc", - "docset/winserver2012r2-ps/hyper-v", "docset/winserver2012r2-ps/servermigrationcmdlets" ] }, "winserver2012-ps": { "exclude": [ - "docset/winserver2012-ps/hyper-v", "docset/winserver2012-ps/servermigrationcmdlets" ] }