From 2258058344c3366af1e768c8e5dbd22806387b8b Mon Sep 17 00:00:00 2001 From: TimShererWithAquent <28902327+TimShererWithAquent@users.noreply.github.com> Date: Tue, 24 Aug 2021 22:27:24 +0000 Subject: [PATCH 1/5] Add cmdlets to docs. --- .../Add-DnsClientDohServerAddress.md | 185 ++++++++++++++ .../winserver2022-ps/dnsclient/DnsClient.md | 20 +- .../Get-DnsClientDohServerAddress.md | 109 +++++++++ .../Remove-DnsClientDohServerAddress.md | 179 ++++++++++++++ .../Set-DnsClientDohServerAddress.md | 230 ++++++++++++++++++ 5 files changed, 719 insertions(+), 4 deletions(-) create mode 100644 docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md create mode 100644 docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md create mode 100644 docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md create mode 100644 docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md diff --git a/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md new file mode 100644 index 0000000000..c7b84eb55f --- /dev/null +++ b/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md @@ -0,0 +1,185 @@ +--- +external help file: MSFT_DnsClientDohServerAddress.cdxml-help.xml +Module Name: DnsClient +online version: +schema: 2.0.0 +--- + +# Add-DnsClientDohServerAddress + +## SYNOPSIS +{{ Fill in the Synopsis }} + +## SYNTAX + +``` +Add-DnsClientDohServerAddress [-ServerAddress] [[-DohTemplate] ] + [[-AllowFallbackToUdp] ] [[-AutoUpgrade] ] [-CimSession ] + [-ThrottleLimit ] [-AsJob] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +{{ Fill in the Description }} + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> {{ Add example code here }} +``` + +{{ Add example description here }} + +## PARAMETERS + +### -AllowFallbackToUdp +{{ Fill AllowFallbackToUdp Description }} + +```yaml +Type: Boolean +Parameter Sets: (All) +Aliases: + +Required: False +Position: 2 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -AsJob +{{ Fill AsJob Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -AutoUpgrade +{{ Fill AutoUpgrade Description }} + +```yaml +Type: Boolean +Parameter Sets: (All) +Aliases: + +Required: False +Position: 3 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -CimSession +{{ Fill CimSession Description }} + +```yaml +Type: CimSession[] +Parameter Sets: (All) +Aliases: Session + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -DohTemplate +{{ Fill DohTemplate Description }} + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -ServerAddress +{{ Fill ServerAddress Description }} + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName, ByValue) +Accept wildcard characters: False +``` + +### -ThrottleLimit +{{ Fill ThrottleLimit Description }} + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. +The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String + +### System.Boolean + +## OUTPUTS + +### System.Object +## NOTES + +## RELATED LINKS diff --git a/docset/winserver2022-ps/dnsclient/DnsClient.md b/docset/winserver2022-ps/dnsclient/DnsClient.md index 675a1a124d..a2efa41eba 100644 --- a/docset/winserver2022-ps/dnsclient/DnsClient.md +++ b/docset/winserver2022-ps/dnsclient/DnsClient.md @@ -14,7 +14,10 @@ title: DnsClient This reference provides cmdlet descriptions and syntax for all Domain Name System (DNS) Client-specific cmdlets. It lists the cmdlets in alphabetical order based on the verb at the beginning of the cmdlet. ## DnsClient Cmdlets -### [Add-DnsClientNrptRule](./Add-DnsClientNrptRule.md) +### [Add-DnsClientDohServerAddress](Add-DnsClientDohServerAddress.md) +{{ Fill in the Synopsis }} + +### [Add-DnsClientNrptRule](Add-DnsClientNrptRule.md) Adds a rule to the NRPT. ### [Clear-DnsClientCache](./Clear-DnsClientCache.md) @@ -26,7 +29,10 @@ Gets details of the network interfaces configured on a specified computer. ### [Get-DnsClientCache](./Get-DnsClientCache.md) Retrieves the contents of the DNS client cache. -### [Get-DnsClientGlobalSetting](./Get-DnsClientGlobalSetting.md) +### [Get-DnsClientDohServerAddress](Get-DnsClientDohServerAddress.md) +{{ Fill in the Synopsis }} + +### [Get-DnsClientGlobalSetting](Get-DnsClientGlobalSetting.md) Retrieves global DNS client settings like the suffix search list. ### [Get-DnsClientNrptGlobal](./Get-DnsClientNrptGlobal.md) @@ -44,7 +50,10 @@ Gets DNS server IP addresses from the TCP/IP properties on an interface. ### [Register-DnsClient](./Register-DnsClient.md) Registers all of the IP addresses on the computer onto the configured DNS server. -### [Remove-DnsClientNrptRule](./Remove-DnsClientNrptRule.md) +### [Remove-DnsClientDohServerAddress](Remove-DnsClientDohServerAddress.md) +{{ Fill in the Synopsis }} + +### [Remove-DnsClientNrptRule](Remove-DnsClientNrptRule.md) Removes the specified DNS client NRPT rule. ### [Resolve-DnsName](./Resolve-DnsName.md) @@ -53,7 +62,10 @@ Performs a DNS name query resolution for the specified name. ### [Set-DnsClient](./Set-DnsClient.md) Sets the interface-specific DNS client configurations on the computer. -### [Set-DnsClientGlobalSetting](./Set-DnsClientGlobalSetting.md) +### [Set-DnsClientDohServerAddress](Set-DnsClientDohServerAddress.md) +{{ Fill in the Synopsis }} + +### [Set-DnsClientGlobalSetting](Set-DnsClientGlobalSetting.md) Sets the DNS client global, non-interface specific, settings. ### [Set-DnsClientNrptGlobal](./Set-DnsClientNrptGlobal.md) diff --git a/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md new file mode 100644 index 0000000000..c3d2798003 --- /dev/null +++ b/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md @@ -0,0 +1,109 @@ +--- +external help file: MSFT_DnsClientDohServerAddress.cdxml-help.xml +Module Name: DnsClient +online version: +schema: 2.0.0 +--- + +# Get-DnsClientDohServerAddress + +## SYNOPSIS +{{ Fill in the Synopsis }} + +## SYNTAX + +``` +Get-DnsClientDohServerAddress [[-ServerAddress] ] [-CimSession ] + [-ThrottleLimit ] [-AsJob] [] +``` + +## DESCRIPTION +{{ Fill in the Description }} + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> {{ Add example code here }} +``` + +{{ Add example description here }} + +## PARAMETERS + +### -AsJob +{{ Fill AsJob Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -CimSession +{{ Fill CimSession Description }} + +```yaml +Type: CimSession[] +Parameter Sets: (All) +Aliases: Session + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ServerAddress +{{ Fill ServerAddress Description }} + +```yaml +Type: String[] +Parameter Sets: (All) +Aliases: + +Required: False +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName, ByValue) +Accept wildcard characters: False +``` + +### -ThrottleLimit +{{ Fill ThrottleLimit Description }} + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String[] + +## OUTPUTS + +### Microsoft.Management.Infrastructure.CimInstance + +### Microsoft.Management.Infrastructure.CimInstance#ROOT/StandardCimv2/MSFT_DNSClientDohServerAddress + +## NOTES + +## RELATED LINKS diff --git a/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md new file mode 100644 index 0000000000..103180f794 --- /dev/null +++ b/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md @@ -0,0 +1,179 @@ +--- +external help file: MSFT_DnsClientDohServerAddress.cdxml-help.xml +Module Name: DnsClient +online version: +schema: 2.0.0 +--- + +# Remove-DnsClientDohServerAddress + +## SYNOPSIS +{{ Fill in the Synopsis }} + +## SYNTAX + +### Query (cdxml) (Default) +``` +Remove-DnsClientDohServerAddress [-ServerAddress] [-CimSession ] + [-ThrottleLimit ] [-AsJob] [-PassThru] [-WhatIf] [-Confirm] [] +``` + +### InputObject (cdxml) +``` +Remove-DnsClientDohServerAddress -InputObject [-CimSession ] + [-ThrottleLimit ] [-AsJob] [-PassThru] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +{{ Fill in the Description }} + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> {{ Add example code here }} +``` + +{{ Add example description here }} + +## PARAMETERS + +### -AsJob +{{ Fill AsJob Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -CimSession +{{ Fill CimSession Description }} + +```yaml +Type: CimSession[] +Parameter Sets: (All) +Aliases: Session + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -InputObject +{{ Fill InputObject Description }} + +```yaml +Type: CimInstance[] +Parameter Sets: InputObject (cdxml) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + +### -PassThru +{{ Fill PassThru Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ServerAddress +{{ Fill ServerAddress Description }} + +```yaml +Type: String[] +Parameter Sets: Query (cdxml) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName, ByValue) +Accept wildcard characters: False +``` + +### -ThrottleLimit +{{ Fill ThrottleLimit Description }} + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. +The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String[] + +### Microsoft.Management.Infrastructure.CimInstance[] + +## OUTPUTS + +### Microsoft.Management.Infrastructure.CimInstance + +### Microsoft.Management.Infrastructure.CimInstance#ROOT/StandardCimv2/MSFT_DNSClientDohServerAddress + +## NOTES + +## RELATED LINKS diff --git a/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md new file mode 100644 index 0000000000..8c95c1bb29 --- /dev/null +++ b/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md @@ -0,0 +1,230 @@ +--- +external help file: MSFT_DnsClientDohServerAddress.cdxml-help.xml +Module Name: DnsClient +online version: +schema: 2.0.0 +--- + +# Set-DnsClientDohServerAddress + +## SYNOPSIS +{{ Fill in the Synopsis }} + +## SYNTAX + +### Query (cdxml) (Default) +``` +Set-DnsClientDohServerAddress [-ServerAddress] [[-DohTemplate] ] + [[-AllowFallbackToUdp] ] [[-AutoUpgrade] ] [-CimSession ] + [-ThrottleLimit ] [-AsJob] [-PassThru] [-WhatIf] [-Confirm] [] +``` + +### InputObject (cdxml) +``` +Set-DnsClientDohServerAddress -InputObject [[-DohTemplate] ] + [[-AllowFallbackToUdp] ] [[-AutoUpgrade] ] [-CimSession ] + [-ThrottleLimit ] [-AsJob] [-PassThru] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +{{ Fill in the Description }} + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> {{ Add example code here }} +``` + +{{ Add example description here }} + +## PARAMETERS + +### -AllowFallbackToUdp +{{ Fill AllowFallbackToUdp Description }} + +```yaml +Type: Boolean +Parameter Sets: (All) +Aliases: + +Required: False +Position: 2 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -AsJob +{{ Fill AsJob Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -AutoUpgrade +{{ Fill AutoUpgrade Description }} + +```yaml +Type: Boolean +Parameter Sets: (All) +Aliases: + +Required: False +Position: 3 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -CimSession +{{ Fill CimSession Description }} + +```yaml +Type: CimSession[] +Parameter Sets: (All) +Aliases: Session + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -DohTemplate +{{ Fill DohTemplate Description }} + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -InputObject +{{ Fill InputObject Description }} + +```yaml +Type: CimInstance[] +Parameter Sets: InputObject (cdxml) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + +### -PassThru +{{ Fill PassThru Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ServerAddress +{{ Fill ServerAddress Description }} + +```yaml +Type: String[] +Parameter Sets: Query (cdxml) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName, ByValue) +Accept wildcard characters: False +``` + +### -ThrottleLimit +{{ Fill ThrottleLimit Description }} + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. +The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String[] + +### Microsoft.Management.Infrastructure.CimInstance[] + +### System.String + +### System.Boolean + +## OUTPUTS + +### Microsoft.Management.Infrastructure.CimInstance + +### Microsoft.Management.Infrastructure.CimInstance#ROOT/StandardCimv2/MSFT_DNSClientDohServerAddress + +## NOTES + +## RELATED LINKS From e55ae2ed983abd7f64e2e6137588ca248428eb81 Mon Sep 17 00:00:00 2001 From: TimShererWithAquent <28902327+TimShererWithAquent@users.noreply.github.com> Date: Thu, 26 Aug 2021 10:23:26 -0700 Subject: [PATCH 2/5] Add content. --- .../Add-DnsClientDohServerAddress.md | 60 ++++++++++++---- .../winserver2022-ps/dnsclient/DnsClient.md | 8 +-- .../Get-DnsClientDohServerAddress.md | 49 ++++++++++--- .../Remove-DnsClientDohServerAddress.md | 46 ++++++++++--- .../Set-DnsClientDohServerAddress.md | 68 +++++++++++++++---- 5 files changed, 181 insertions(+), 50 deletions(-) diff --git a/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md index c7b84eb55f..9d6241e603 100644 --- a/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md +++ b/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md @@ -1,14 +1,17 @@ --- +title: Add-DnsClientDohServerAddress +description: The Add-DnsClientDohServerAddress cmdlet adds a DNS-over-HTTPS (DoH) server configuration to the supported DoH servers. external help file: MSFT_DnsClientDohServerAddress.cdxml-help.xml Module Name: DnsClient online version: schema: 2.0.0 +ms.date: 08/31/2021 --- # Add-DnsClientDohServerAddress ## SYNOPSIS -{{ Fill in the Synopsis }} +Adds a DoH server configuration to the supported DoH servers. ## SYNTAX @@ -19,21 +22,32 @@ Add-DnsClientDohServerAddress [-ServerAddress] [[-DohTemplate] ``` ## DESCRIPTION -{{ Fill in the Description }} +The **Add-DnsClientDohServerAddress** cmdlet adds a DNS-over-HTTPS (DoH) server configuration to the supported DoH servers. ## EXAMPLES ### Example 1 ```powershell -PS C:\> {{ Add example code here }} +PS C:\> Add-DnsClientDohServerAddress -ServerAddress 10.23.1.1 -DohTemplate https://adatum.com/dns-query ``` -{{ Add example description here }} +This example adds 10.23.1.1 to the system DoH list with the specified URI template. + +### Example 2 +```powershell +PS C:\> Add-DnsClientDohServerAddress -ServerAddress 10.23.1.1 -DohTemplate https://adatum.com/dns-query -AllowFallbackToUdp $True -AutoUpgrade $True +``` + +This example adds 10.23.1.1 to the system DoH list with the specified URI template. +The command upgrades any resolutions to 10.23.1.1 to DoH. +If the encrypted name resolution fails, the command allows fallback to unencrypted DNS. ## PARAMETERS ### -AllowFallbackToUdp -{{ Fill AllowFallbackToUdp Description }} +Specifies whether to allow fallback to unencrypted DNS if the DoH query to the server fails. +This parameter applies only if **AutoUpgrade** is `True`. +The default is `False`. ```yaml Type: Boolean @@ -48,7 +62,14 @@ Accept wildcard characters: False ``` ### -AsJob -{{ Fill AsJob Description }} +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. + +For more information about Windows PowerShell background jobs, see [about_Jobs](https://go.microsoft.com/fwlink/?LinkID=113251). ```yaml Type: SwitchParameter @@ -63,7 +84,9 @@ Accept wildcard characters: False ``` ### -AutoUpgrade -{{ Fill AutoUpgrade Description }} +Specifies whether to encrypt all name resolutions to this server using the DoH settings. +The upgrade occurs if the server is configured on an adapter or if it is part of a Name Resolution Policy Table (NRPT) rule. +The default is `False`. ```yaml Type: Boolean @@ -78,7 +101,9 @@ Accept wildcard characters: False ``` ### -CimSession -{{ Fill CimSession Description }} +Runs the cmdlet in a remote session or on a remote computer. +Enter a computer name or a session object, such as the output of a [New-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227967) or [Get-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227966) cmdlet. +The default is the current session on the local computer. ```yaml Type: CimSession[] @@ -93,7 +118,7 @@ Accept wildcard characters: False ``` ### -DohTemplate -{{ Fill DohTemplate Description }} +Specifies a valid URI template used to connect to the DoH server. ```yaml Type: String @@ -108,7 +133,7 @@ Accept wildcard characters: False ``` ### -ServerAddress -{{ Fill ServerAddress Description }} +Specifies the IP address of the DoH server. ```yaml Type: String @@ -123,7 +148,9 @@ Accept wildcard characters: False ``` ### -ThrottleLimit -{{ Fill ThrottleLimit Description }} +Specifies the maximum number of concurrent operations that can be established to run the cmdlet. +If this parameter is omitted or a value of `0` is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. +The throttle limit applies only to the current cmdlet, not to the session or to the computer. ```yaml Type: Int32 @@ -169,7 +196,7 @@ Accept wildcard characters: False ``` ### CommonParameters -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS @@ -180,6 +207,15 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS ### System.Object + ## NOTES ## RELATED LINKS + +[Add-DnsClientNrptRule](Add-DnsClientNrptRule.md) + +[Get-DnsClientDohServerAddress](Get-DnsClientDohServerAddress.md) + +[Remove-DnsClientDohServerAddress](Remove-DnsClientDohServerAddress.md) + +[Set-DnsClientDohServerAddress](Set-DnsClientDohServerAddress.md) diff --git a/docset/winserver2022-ps/dnsclient/DnsClient.md b/docset/winserver2022-ps/dnsclient/DnsClient.md index a2efa41eba..1dd2345b26 100644 --- a/docset/winserver2022-ps/dnsclient/DnsClient.md +++ b/docset/winserver2022-ps/dnsclient/DnsClient.md @@ -15,7 +15,7 @@ This reference provides cmdlet descriptions and syntax for all Domain Name Syste ## DnsClient Cmdlets ### [Add-DnsClientDohServerAddress](Add-DnsClientDohServerAddress.md) -{{ Fill in the Synopsis }} +Adds a DoH server configuration to the supported DoH servers. ### [Add-DnsClientNrptRule](Add-DnsClientNrptRule.md) Adds a rule to the NRPT. @@ -30,7 +30,7 @@ Gets details of the network interfaces configured on a specified computer. Retrieves the contents of the DNS client cache. ### [Get-DnsClientDohServerAddress](Get-DnsClientDohServerAddress.md) -{{ Fill in the Synopsis }} +Gets the DoH server configuration. ### [Get-DnsClientGlobalSetting](Get-DnsClientGlobalSetting.md) Retrieves global DNS client settings like the suffix search list. @@ -51,7 +51,7 @@ Gets DNS server IP addresses from the TCP/IP properties on an interface. Registers all of the IP addresses on the computer onto the configured DNS server. ### [Remove-DnsClientDohServerAddress](Remove-DnsClientDohServerAddress.md) -{{ Fill in the Synopsis }} +Removes a DoH server configuration from the supported DoH servers. ### [Remove-DnsClientNrptRule](Remove-DnsClientNrptRule.md) Removes the specified DNS client NRPT rule. @@ -63,7 +63,7 @@ Performs a DNS name query resolution for the specified name. Sets the interface-specific DNS client configurations on the computer. ### [Set-DnsClientDohServerAddress](Set-DnsClientDohServerAddress.md) -{{ Fill in the Synopsis }} +Modifies an existing DoH server configuration. ### [Set-DnsClientGlobalSetting](Set-DnsClientGlobalSetting.md) Sets the DNS client global, non-interface specific, settings. diff --git a/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md index c3d2798003..f554a97737 100644 --- a/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md +++ b/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md @@ -1,14 +1,17 @@ --- +title: Get-DnsClientDohServerAddress +description: The Get-DnsClientDohServerAddress cmdlet gets the DNS-over-HTTPS (DoH) server configuration from the supported DoH servers. external help file: MSFT_DnsClientDohServerAddress.cdxml-help.xml Module Name: DnsClient online version: schema: 2.0.0 +ms.date: 08/31/2021 --- # Get-DnsClientDohServerAddress ## SYNOPSIS -{{ Fill in the Synopsis }} +Gets the DoH server configuration. ## SYNTAX @@ -18,21 +21,36 @@ Get-DnsClientDohServerAddress [[-ServerAddress] ] [-CimSession {{ Add example code here }} +PS C:\> Get-DnsClientDohServerAddress ``` -{{ Add example description here }} +This example gets configuration for all supported DoH servers. + +### Example 2 +```powershell +PS C:\> Get-DnsClientDohServerAddress -ServerAddress 10.23.1.1,10.18.1.1 +``` + +This example gets DoH configuration for the servers 10.23.1.1 and 10.18.1.1. ## PARAMETERS ### -AsJob -{{ Fill AsJob Description }} +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. + +For more information about Windows PowerShell background jobs, see [about_Jobs](https://go.microsoft.com/fwlink/?LinkID=113251). ```yaml Type: SwitchParameter @@ -47,7 +65,9 @@ Accept wildcard characters: False ``` ### -CimSession -{{ Fill CimSession Description }} +Runs the cmdlet in a remote session or on a remote computer. +Enter a computer name or a session object, such as the output of a [New-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227967) or [Get-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227966) cmdlet. +The default is the current session on the local computer. ```yaml Type: CimSession[] @@ -62,7 +82,8 @@ Accept wildcard characters: False ``` ### -ServerAddress -{{ Fill ServerAddress Description }} +Specifies the IP addresses for which to retrieve the system DoH configuration. +Addresses must be present in the system list for the command to succeed. ```yaml Type: String[] @@ -77,7 +98,9 @@ Accept wildcard characters: False ``` ### -ThrottleLimit -{{ Fill ThrottleLimit Description }} +Specifies the maximum number of concurrent operations that can be established to run the cmdlet. +If this parameter is omitted or a value of `0` is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. +The throttle limit applies only to the current cmdlet, not to the session or to the computer. ```yaml Type: Int32 @@ -92,7 +115,7 @@ Accept wildcard characters: False ``` ### CommonParameters -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS @@ -107,3 +130,11 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## NOTES ## RELATED LINKS + +[Add-DnsClientDohServerAddress](Add-DnsClientDohServerAddress.md) + +[Add-DnsClientNrptRule](Add-DnsClientNrptRule.md) + +[Remove-DnsClientDohServerAddress](Remove-DnsClientDohServerAddress.md) + +[Set-DnsClientDohServerAddress](Set-DnsClientDohServerAddress.md) diff --git a/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md index 103180f794..d021f083b7 100644 --- a/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md +++ b/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md @@ -1,14 +1,17 @@ --- +title: Remove-DnsClientDohServerAddress +description: The Remove-DnsClientDohServerAddress cmdlet removes a DNS-over-HTTPS (DoH) server configuration from the supported DoH servers. external help file: MSFT_DnsClientDohServerAddress.cdxml-help.xml Module Name: DnsClient online version: schema: 2.0.0 +ms.date: 08/31/2021 --- # Remove-DnsClientDohServerAddress ## SYNOPSIS -{{ Fill in the Synopsis }} +Removes a DoH server configuration from the supported DoH servers. ## SYNTAX @@ -25,21 +28,28 @@ Remove-DnsClientDohServerAddress -InputObject [-CimSession {{ Add example code here }} +PS C:\> Remove-DnsClientDohServerAddress -ServerAddress 10.23.1.1,10.18.1.1 ``` -{{ Add example description here }} +This example removes DoH configuration for the servers 10.23.1.1 and 10.18.1.1. ## PARAMETERS ### -AsJob -{{ Fill AsJob Description }} +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. + +For more information about Windows PowerShell background jobs, see [about_Jobs](https://go.microsoft.com/fwlink/?LinkID=113251). ```yaml Type: SwitchParameter @@ -54,7 +64,9 @@ Accept wildcard characters: False ``` ### -CimSession -{{ Fill CimSession Description }} +Runs the cmdlet in a remote session or on a remote computer. +Enter a computer name or a session object, such as the output of a [New-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227967) or [Get-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227966) cmdlet. +The default is the current session on the local computer. ```yaml Type: CimSession[] @@ -69,7 +81,8 @@ Accept wildcard characters: False ``` ### -InputObject -{{ Fill InputObject Description }} +Specifies the input to this cmdlet. +You can use this parameter, or you can pipe the input to this cmdlet. ```yaml Type: CimInstance[] @@ -84,7 +97,8 @@ Accept wildcard characters: False ``` ### -PassThru -{{ Fill PassThru Description }} +Returns an object representing the item with which you are working. +By default, this cmdlet does not generate any output. ```yaml Type: SwitchParameter @@ -99,7 +113,7 @@ Accept wildcard characters: False ``` ### -ServerAddress -{{ Fill ServerAddress Description }} +Specifies the IP addresses of the servers to remove from the supported servers. ```yaml Type: String[] @@ -114,7 +128,9 @@ Accept wildcard characters: False ``` ### -ThrottleLimit -{{ Fill ThrottleLimit Description }} +Specifies the maximum number of concurrent operations that can be established to run the cmdlet. +If this parameter is omitted or a value of `0` is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. +The throttle limit applies only to the current cmdlet, not to the session or to the computer. ```yaml Type: Int32 @@ -160,7 +176,7 @@ Accept wildcard characters: False ``` ### CommonParameters -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS @@ -177,3 +193,11 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## NOTES ## RELATED LINKS + +[Add-DnsClientDohServerAddress](Add-DnsClientDohServerAddress.md) + +[Add-DnsClientNrptRule](Add-DnsClientNrptRule.md) + +[Get-DnsClientDohServerAddress](Get-DnsClientDohServerAddress.md) + +[Set-DnsClientDohServerAddress](Set-DnsClientDohServerAddress.md) diff --git a/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md index 8c95c1bb29..ac6a9db9c8 100644 --- a/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md +++ b/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md @@ -1,14 +1,17 @@ --- +title: Set-DnsClientDohServerAddress +description: The Set-DnsClientDohServerAddress cmdlet modifies an existing DNS-over-HTTPS (DoH) server configuration. external help file: MSFT_DnsClientDohServerAddress.cdxml-help.xml Module Name: DnsClient online version: schema: 2.0.0 +ms.date: 08/31/2021 --- # Set-DnsClientDohServerAddress ## SYNOPSIS -{{ Fill in the Synopsis }} +Modifies an existing DoH server configuration. ## SYNTAX @@ -27,21 +30,35 @@ Set-DnsClientDohServerAddress -InputObject [[-DohTemplate] {{ Add example code here }} +PS C:\> Set-DnsClientDohServerAddress -ServerAddress 10.23.1.1 -DohTemplate https://adatum.com/dns-query ``` -{{ Add example description here }} +This example changes the URI template for 10.23.1.1. +The command sets the **AutoUpgrade** and **AllowFallbackToUdp** values to `False`. + +### Example 2 +```powershell +PS C:\> -ServerAddress 10.23.1.1 -DohTemplate https://adatum.com/dns-query -AutoUpgrade $True +``` + +This example changes the URI template for 10.23.1.1. +The command upgrades any resolutions to 10.23.1.1 to DoH. +The **AllowFallbackToUdp** parameter value defaults to `False`. +If the encrypted name resolution fails, it does not revert to unencrypted DNS. + ## PARAMETERS ### -AllowFallbackToUdp -{{ Fill AllowFallbackToUdp Description }} +Specifies whether to allow fallback to unencrypted DNS if the DoH query to the server fails. +This parameter applies only if **AutoUpgrade** is `True`. +The default is `False`. ```yaml Type: Boolean @@ -56,7 +73,14 @@ Accept wildcard characters: False ``` ### -AsJob -{{ Fill AsJob Description }} +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. + +For more information about Windows PowerShell background jobs, see [about_Jobs](https://go.microsoft.com/fwlink/?LinkID=113251). ```yaml Type: SwitchParameter @@ -71,7 +95,9 @@ Accept wildcard characters: False ``` ### -AutoUpgrade -{{ Fill AutoUpgrade Description }} +Specifies whether to encrypt all name resolutions to this server using the DoH settings. +The upgrade occurs if the server is configured on an adapter or if it is part of a Name Resolution Policy Table (NRPT) rule. +The default is `False`. ```yaml Type: Boolean @@ -86,7 +112,9 @@ Accept wildcard characters: False ``` ### -CimSession -{{ Fill CimSession Description }} +Runs the cmdlet in a remote session or on a remote computer. +Enter a computer name or a session object, such as the output of a [New-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227967) or [Get-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227966) cmdlet. +The default is the current session on the local computer. ```yaml Type: CimSession[] @@ -101,7 +129,7 @@ Accept wildcard characters: False ``` ### -DohTemplate -{{ Fill DohTemplate Description }} +Specifies a valid URI template used to connect to the DoH server. ```yaml Type: String @@ -116,7 +144,8 @@ Accept wildcard characters: False ``` ### -InputObject -{{ Fill InputObject Description }} +Specifies the input to this cmdlet. +You can use this parameter, or you can pipe the input to this cmdlet. ```yaml Type: CimInstance[] @@ -131,7 +160,8 @@ Accept wildcard characters: False ``` ### -PassThru -{{ Fill PassThru Description }} +Returns an object representing the item with which you are working. +By default, this cmdlet does not generate any output. ```yaml Type: SwitchParameter @@ -146,7 +176,7 @@ Accept wildcard characters: False ``` ### -ServerAddress -{{ Fill ServerAddress Description }} +Specifies the IP address of the DoH server. ```yaml Type: String[] @@ -161,7 +191,9 @@ Accept wildcard characters: False ``` ### -ThrottleLimit -{{ Fill ThrottleLimit Description }} +Specifies the maximum number of concurrent operations that can be established to run the cmdlet. +If this parameter is omitted or a value of `0` is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. +The throttle limit applies only to the current cmdlet, not to the session or to the computer. ```yaml Type: Int32 @@ -207,7 +239,7 @@ Accept wildcard characters: False ``` ### CommonParameters -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS @@ -228,3 +260,11 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## NOTES ## RELATED LINKS + +[Add-DnsClientDohServerAddress](Add-DnsClientDohServerAddress.md) + +[Add-DnsClientNrptRule](Add-DnsClientNrptRule.md) + +[Get-DnsClientDohServerAddress](Get-DnsClientDohServerAddress.md) + +[Remove-DnsClientDohServerAddress](Remove-DnsClientDohServerAddress.md) From 6eb8a5cf1d7eb97ddc3c2597581fad5ee1e768b2 Mon Sep 17 00:00:00 2001 From: TimShererWithAquent <28902327+TimShererWithAquent@users.noreply.github.com> Date: Thu, 26 Aug 2021 10:53:57 -0700 Subject: [PATCH 3/5] Fixes and add online version. --- .../dnsclient/Add-DnsClientDohServerAddress.md | 2 +- .../dnsclient/Get-DnsClientDohServerAddress.md | 4 ++-- .../dnsclient/Remove-DnsClientDohServerAddress.md | 6 +++--- .../dnsclient/Set-DnsClientDohServerAddress.md | 8 ++++---- 4 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md index 9d6241e603..1c88912045 100644 --- a/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md +++ b/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md @@ -3,7 +3,7 @@ title: Add-DnsClientDohServerAddress description: The Add-DnsClientDohServerAddress cmdlet adds a DNS-over-HTTPS (DoH) server configuration to the supported DoH servers. external help file: MSFT_DnsClientDohServerAddress.cdxml-help.xml Module Name: DnsClient -online version: +online version: https://docs.microsoft.com/powershell/module/dnsclient/add-dnsclientdohserveraddress?view=windowsserver2022-ps&wt.mc_id=ps-gethelp schema: 2.0.0 ms.date: 08/31/2021 --- diff --git a/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md index f554a97737..3d703c7947 100644 --- a/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md +++ b/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md @@ -3,7 +3,7 @@ title: Get-DnsClientDohServerAddress description: The Get-DnsClientDohServerAddress cmdlet gets the DNS-over-HTTPS (DoH) server configuration from the supported DoH servers. external help file: MSFT_DnsClientDohServerAddress.cdxml-help.xml Module Name: DnsClient -online version: +online version: https://docs.microsoft.com/powershell/module/dnsclient/get-dnsclientdohserveraddress?view=windowsserver2022-ps&wt.mc_id=ps-gethelp schema: 2.0.0 ms.date: 08/31/2021 --- @@ -21,7 +21,7 @@ Get-DnsClientDohServerAddress [[-ServerAddress] ] [-CimSession [-CimSession Set-DnsClientDohServerAddress -ServerAddress 10.23.1.1 -DohTemplate http ``` This example changes the URI template for 10.23.1.1. -The command sets the **AutoUpgrade** and **AllowFallbackToUdp** values to `False`. +The command sets the **AutoUpgrade** and **AllowFallbackToUdp** values to the default value `False`. ### Example 2 ```powershell -PS C:\> -ServerAddress 10.23.1.1 -DohTemplate https://adatum.com/dns-query -AutoUpgrade $True +PS C:\> Set-DnsClientDohServerAddress -ServerAddress 10.23.1.1 -DohTemplate https://adatum.com/dns-query -AutoUpgrade $True ``` This example changes the URI template for 10.23.1.1. -The command upgrades any resolutions to 10.23.1.1 to DoH. +The command also upgrades any resolutions to 10.23.1.1. The **AllowFallbackToUdp** parameter value defaults to `False`. If the encrypted name resolution fails, it does not revert to unencrypted DNS. From 1bc23d0ee4a9ffe1066c72714b227bd8f7b360a8 Mon Sep 17 00:00:00 2001 From: TimShererWithAquent <28902327+TimShererWithAquent@users.noreply.github.com> Date: Thu, 26 Aug 2021 16:09:15 -0700 Subject: [PATCH 4/5] Additional changes. --- .../dnsclient/Add-DnsClientDohServerAddress.md | 8 ++++---- .../dnsclient/Get-DnsClientDohServerAddress.md | 8 ++++---- .../dnsclient/Remove-DnsClientDohServerAddress.md | 4 ++-- .../dnsclient/Set-DnsClientDohServerAddress.md | 8 ++++---- 4 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md index 1c88912045..c9d680a76a 100644 --- a/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md +++ b/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md @@ -26,16 +26,16 @@ The **Add-DnsClientDohServerAddress** cmdlet adds a DNS-over-HTTPS (DoH) server ## EXAMPLES -### Example 1 +### Example 1: Add a DoH server ```powershell -PS C:\> Add-DnsClientDohServerAddress -ServerAddress 10.23.1.1 -DohTemplate https://adatum.com/dns-query +Add-DnsClientDohServerAddress -ServerAddress 10.23.1.1 -DohTemplate https://adatum.com/dns-query ``` This example adds 10.23.1.1 to the system DoH list with the specified URI template. -### Example 2 +### Example 2: Add a DoH server with automatic upgrade ```powershell -PS C:\> Add-DnsClientDohServerAddress -ServerAddress 10.23.1.1 -DohTemplate https://adatum.com/dns-query -AllowFallbackToUdp $True -AutoUpgrade $True +Add-DnsClientDohServerAddress -ServerAddress 10.23.1.1 -DohTemplate https://adatum.com/dns-query -AllowFallbackToUdp $True -AutoUpgrade $True ``` This example adds 10.23.1.1 to the system DoH list with the specified URI template. diff --git a/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md index 3d703c7947..2f9f9419af 100644 --- a/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md +++ b/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md @@ -26,16 +26,16 @@ If you don't specify a server, the command displays all supported DoH servers. ## EXAMPLES -### Example 1 +### Example 1: Get configuration for all DoH servers ```powershell -PS C:\> Get-DnsClientDohServerAddress +Get-DnsClientDohServerAddress ``` This example gets configuration for all supported DoH servers. -### Example 2 +### Example 2: Get configuration for specific DoH servers ```powershell -PS C:\> Get-DnsClientDohServerAddress -ServerAddress 10.23.1.1,10.18.1.1 +Get-DnsClientDohServerAddress -ServerAddress 10.23.1.1,10.18.1.1 ``` This example gets DoH configuration for the servers 10.23.1.1 and 10.18.1.1. diff --git a/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md index ca884a59bd..6cae8f48d1 100644 --- a/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md +++ b/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md @@ -32,9 +32,9 @@ The **Remove-DnsClientDohServerAddress** cmdlet removes DNS-over-HTTPS (DoH) ser ## EXAMPLES -### Example 1 +### Example 1: Remove configuration for DoH servers ```powershell -PS C:\> Remove-DnsClientDohServerAddress -ServerAddress 10.23.1.1,10.18.1.1 +Remove-DnsClientDohServerAddress -ServerAddress 10.23.1.1,10.18.1.1 ``` This example removes DoH configuration for the servers 10.23.1.1 and 10.18.1.1. diff --git a/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md index 317551916b..da6987ece7 100644 --- a/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md +++ b/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md @@ -34,17 +34,17 @@ The **Set-DnsClientDohServerAddress** cmdlet modifies an existing DNS-over-HTTPS ## EXAMPLES -### Example 1 +### Example 1: Change the URI template for a DoH server ```powershell -PS C:\> Set-DnsClientDohServerAddress -ServerAddress 10.23.1.1 -DohTemplate https://adatum.com/dns-query +Set-DnsClientDohServerAddress -ServerAddress 10.23.1.1 -DohTemplate https://adatum.com/dns-query ``` This example changes the URI template for 10.23.1.1. The command sets the **AutoUpgrade** and **AllowFallbackToUdp** values to the default value `False`. -### Example 2 +### Example 2: Change the URI template for a DoH server with automatic upgrade ```powershell -PS C:\> Set-DnsClientDohServerAddress -ServerAddress 10.23.1.1 -DohTemplate https://adatum.com/dns-query -AutoUpgrade $True +Set-DnsClientDohServerAddress -ServerAddress 10.23.1.1 -DohTemplate https://adatum.com/dns-query -AutoUpgrade $True ``` This example changes the URI template for 10.23.1.1. From f306b166a4451027189e5323f54dd624d3eabdbc Mon Sep 17 00:00:00 2001 From: Tim Sherer <28902327+TimShererWithAquent@users.noreply.github.com> Date: Thu, 2 Sep 2021 14:43:28 +0000 Subject: [PATCH 5/5] Apply suggestions from code review Co-authored-by: JohanFreelancer9 <48568725+JohanFreelancer9@users.noreply.github.com> --- .../winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md | 2 +- .../winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md | 2 +- .../dnsclient/Remove-DnsClientDohServerAddress.md | 2 +- .../winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md index c9d680a76a..391646622d 100644 --- a/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md +++ b/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md @@ -149,7 +149,7 @@ Accept wildcard characters: False ### -ThrottleLimit Specifies the maximum number of concurrent operations that can be established to run the cmdlet. -If this parameter is omitted or a value of `0` is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. +If this parameter is omitted or a value of `0` is entered, then Windows PowerShell calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer. ```yaml diff --git a/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md index 2f9f9419af..eb045ceec0 100644 --- a/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md +++ b/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md @@ -99,7 +99,7 @@ Accept wildcard characters: False ### -ThrottleLimit Specifies the maximum number of concurrent operations that can be established to run the cmdlet. -If this parameter is omitted or a value of `0` is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. +If this parameter is omitted or a value of `0` is entered, then Windows PowerShell calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer. ```yaml diff --git a/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md index 6cae8f48d1..dfad7e484e 100644 --- a/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md +++ b/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md @@ -129,7 +129,7 @@ Accept wildcard characters: False ### -ThrottleLimit Specifies the maximum number of concurrent operations that can be established to run the cmdlet. -If this parameter is omitted or a value of `0` is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. +If this parameter is omitted or a value of `0` is entered, then Windows PowerShell calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer. ```yaml diff --git a/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md index da6987ece7..1522976dd5 100644 --- a/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md +++ b/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md @@ -192,7 +192,7 @@ Accept wildcard characters: False ### -ThrottleLimit Specifies the maximum number of concurrent operations that can be established to run the cmdlet. -If this parameter is omitted or a value of `0` is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. +If this parameter is omitted or a value of `0` is entered, then Windows PowerShell calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer. ```yaml