Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
Test-DnsResolution
Tests the Domain Name System (DNS) resolution for a given hostname in a specified environment.
Syntax
Default (Default)
Test-DnsResolution
[-EnvironmentId] <String>
[-HostName] <String>
[[-TenantId] <String>]
[[-Endpoint] <PPEndpoint>]
[[-Region] <String>]
[-ForceAuth]
[<CommonParameters>]
Description
The Test-DnsResolution cmdlet tests the DNS resolution for a given hostname in a specified environment. This cmdlet is executed in the context of your delegated subnet in the region that you have specified. If the region is not specified, it defaults to the region of the environment.
Examples
EXAMPLE 1
Test-DnsResolution -EnvironmentId "00000000-0000-0000-0000-000000000000" -HostName "microsoft.com"
Tests DNS resolution for microsoft.com from the environment's delegated subnet using default settings.
EXAMPLE 2
Test-DnsResolution -EnvironmentId "00000000-0000-0000-0000-000000000000" -HostName "microsoft.com" -Endpoint usgovhigh
Tests DNS resolution for microsoft.com for an environment in the US Government High cloud.
EXAMPLE 3
Test-DnsResolution -EnvironmentId "00000000-0000-0000-0000-000000000000" -HostName "microsoft.com" -Region "westus"
Tests DNS resolution for microsoft.com in the westus region instead of the environment's default region.
Parameters
-Endpoint
The Power Platform endpoint to connect to. Defaults to 'prod'.
Parameter properties
| Type: | PPEndpoint |
| Default value: | Prod |
| Accepted values: | unknown, tip1, tip2, prod, usgovhigh, dod, china |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnvironmentId
The Id of the environment to get usage for.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ForceAuth
Force re-authentication to Azure.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-HostName
The hostname that DNS should attempt to resolve. IP addresses are not supported.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Region
The Azure region in which to test the resolution. Defaults to the region the environment is in.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-TenantId
The id of the tenant that the environment belongs to.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.