diff --git a/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md b/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md new file mode 100644 index 0000000000..391646622d --- /dev/null +++ b/docset/winserver2022-ps/dnsclient/Add-DnsClientDohServerAddress.md @@ -0,0 +1,221 @@ +--- +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: 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 +--- + +# Add-DnsClientDohServerAddress + +## SYNOPSIS +Adds a DoH server configuration to the supported DoH servers. + +## SYNTAX + +``` +Add-DnsClientDohServerAddress [-ServerAddress] [[-DohTemplate] ] + [[-AllowFallbackToUdp] ] [[-AutoUpgrade] ] [-CimSession ] + [-ThrottleLimit ] [-AsJob] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +The **Add-DnsClientDohServerAddress** cmdlet adds a DNS-over-HTTPS (DoH) server configuration to the supported DoH servers. + +## EXAMPLES + +### Example 1: Add a DoH server +```powershell +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: Add a DoH server with automatic upgrade +```powershell +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 +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 +Parameter Sets: (All) +Aliases: + +Required: False +Position: 2 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -AsJob +Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete. + +The cmdlet immediately returns an object that represents the job and then displays the command prompt. +You can continue to work in the session while the job completes. +To manage the job, use the `*-Job` cmdlets. +To get the job results, use the [Receive-Job](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: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -AutoUpgrade +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 +Parameter Sets: (All) +Aliases: + +Required: False +Position: 3 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -CimSession +Runs the cmdlet in a remote session or on a remote computer. +Enter a computer name or a session object, such as the output of a [New-CimSession](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[] +Parameter Sets: (All) +Aliases: Session + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -DohTemplate +Specifies a valid URI template used to connect to the DoH server. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -ServerAddress +Specifies the IP address of the DoH server. + +```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 +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 +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](https://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String + +### System.Boolean + +## 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 675a1a124d..1dd2345b26 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) +Adds a DoH server configuration to the supported DoH servers. + +### [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) +Gets the DoH server configuration. + +### [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) +Removes a DoH server configuration from the supported DoH servers. + +### [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) +Modifies an existing DoH server configuration. + +### [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..eb045ceec0 --- /dev/null +++ b/docset/winserver2022-ps/dnsclient/Get-DnsClientDohServerAddress.md @@ -0,0 +1,140 @@ +--- +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: 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 +--- + +# Get-DnsClientDohServerAddress + +## SYNOPSIS +Gets the DoH server configuration. + +## SYNTAX + +``` +Get-DnsClientDohServerAddress [[-ServerAddress] ] [-CimSession ] + [-ThrottleLimit ] [-AsJob] [] +``` + +## DESCRIPTION +The **Get-DnsClientDohServerAddress** cmdlet gets the DNS-over-HTTPS (DoH) server configuration for supported DoH servers. +If you don't specify a server, the command displays all supported DoH servers. + +## EXAMPLES + +### Example 1: Get configuration for all DoH servers +```powershell +Get-DnsClientDohServerAddress +``` + +This example gets configuration for all supported DoH servers. + +### Example 2: Get configuration for specific DoH servers +```powershell +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 +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 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -CimSession +Runs the cmdlet in a remote session or on a remote computer. +Enter a computer name or a session object, such as the output of a [New-CimSession](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[] +Parameter Sets: (All) +Aliases: Session + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ServerAddress +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[] +Parameter Sets: (All) +Aliases: + +Required: False +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName, ByValue) +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. +The throttle limit applies only to the current cmdlet, not to the session or to the computer. + +```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](https://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 + +[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 new file mode 100644 index 0000000000..dfad7e484e --- /dev/null +++ b/docset/winserver2022-ps/dnsclient/Remove-DnsClientDohServerAddress.md @@ -0,0 +1,203 @@ +--- +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: https://docs.microsoft.com/powershell/module/dnsclient/remove-dnsclientdohserveraddress?view=windowsserver2022-ps&wt.mc_id=ps-gethelp +schema: 2.0.0 +ms.date: 08/31/2021 +--- + +# Remove-DnsClientDohServerAddress + +## SYNOPSIS +Removes DoH server configurations from the supported DoH servers. + +## 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 +The **Remove-DnsClientDohServerAddress** cmdlet removes DNS-over-HTTPS (DoH) server configurations from the supported DoH servers. + +## EXAMPLES + +### Example 1: Remove configuration for DoH servers +```powershell +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. + +## PARAMETERS + +### -AsJob +Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete. + +The cmdlet immediately returns an object that represents the job and then displays the command prompt. +You can continue to work in the session while the job completes. +To manage the job, use the `*-Job` cmdlets. +To get the job results, use the [Receive-Job](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: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -CimSession +Runs the cmdlet in a remote session or on a remote computer. +Enter a computer name or a session object, such as the output of a [New-CimSession](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[] +Parameter Sets: (All) +Aliases: Session + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -InputObject +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 (cdxml) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + +### -PassThru +Returns an object representing the item with which you are working. +By default, this cmdlet does not generate any output. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ServerAddress +Specifies the IP addresses of the servers to remove from the supported servers. + +```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 +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 +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](https://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 + +[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 new file mode 100644 index 0000000000..1522976dd5 --- /dev/null +++ b/docset/winserver2022-ps/dnsclient/Set-DnsClientDohServerAddress.md @@ -0,0 +1,270 @@ +--- +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: https://docs.microsoft.com/powershell/module/dnsclient/set-dnsclientdohserveraddress?view=windowsserver2022-ps&wt.mc_id=ps-gethelp +schema: 2.0.0 +ms.date: 08/31/2021 +--- + +# Set-DnsClientDohServerAddress + +## SYNOPSIS +Modifies an existing DoH server configuration. + +## 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 +The **Set-DnsClientDohServerAddress** cmdlet modifies an existing DNS-over-HTTPS (DoH) server configuration. + +## EXAMPLES + +### Example 1: Change the URI template for a DoH server +```powershell +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: Change the URI template for a DoH server with automatic upgrade +```powershell +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 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. + + +## PARAMETERS + +### -AllowFallbackToUdp +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 +Parameter Sets: (All) +Aliases: + +Required: False +Position: 2 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -AsJob +Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete. + +The cmdlet immediately returns an object that represents the job and then displays the command prompt. +You can continue to work in the session while the job completes. +To manage the job, use the `*-Job` cmdlets. +To get the job results, use the [Receive-Job](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: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -AutoUpgrade +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 +Parameter Sets: (All) +Aliases: + +Required: False +Position: 3 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -CimSession +Runs the cmdlet in a remote session or on a remote computer. +Enter a computer name or a session object, such as the output of a [New-CimSession](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[] +Parameter Sets: (All) +Aliases: Session + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -DohTemplate +Specifies a valid URI template used to connect to the DoH server. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -InputObject +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 (cdxml) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + +### -PassThru +Returns an object representing the item with which you are working. +By default, this cmdlet does not generate any output. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ServerAddress +Specifies the IP address of the DoH server. + +```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 +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 +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](https://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 + +[Add-DnsClientDohServerAddress](Add-DnsClientDohServerAddress.md) + +[Add-DnsClientNrptRule](Add-DnsClientNrptRule.md) + +[Get-DnsClientDohServerAddress](Get-DnsClientDohServerAddress.md) + +[Remove-DnsClientDohServerAddress](Remove-DnsClientDohServerAddress.md)