Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
Test-TLSHandshake
Attempts to establish a Transport Layer Security (TLS) handshake with the provided destination and port.
Syntax
Default (Default)
Test-TLSHandshake
[-EnvironmentId] <String>
[-Destination] <String>
[[-Port] <String>]
[[-TenantId] <String>]
[[-Endpoint] <PPEndpoint>]
[[-Region] <String>]
[-ForceAuth]
[<CommonParameters>]
Description
The Test-TLSHandshake cmdlet tests that a TLS handshake can be established against the provided destination and port. The cmdlet is executed in the context of your delegated subnet in the region that you specify. If the region isn't specified, it defaults to the region of the environment.
Examples
EXAMPLE 1
Test-TLSHandshake -EnvironmentId "00000000-0000-0000-0000-000000000000" -Destination "microsoft.com"
Tests TLS handshake with microsoft.com on the default port (443) from the environment's delegated subnet.
EXAMPLE 2
Test-TLSHandshake -EnvironmentId "00000000-0000-0000-0000-000000000000" -Destination "unknowndb.database.windows.net" -Port 1433
Tests TLS handshake with a SQL database on port 1433 from the environment's delegated subnet.
EXAMPLE 3
Test-TLSHandshake -EnvironmentId "00000000-0000-0000-0000-000000000000" -Destination "unknowndb.database.windows.net" -Port 1433 -Endpoint usgovhigh
Tests TLS handshake with a SQL database for an environment in the US Government High cloud.
EXAMPLE 4
Test-TLSHandshake -EnvironmentId "00000000-0000-0000-0000-000000000000" -Destination "unknowndb.database.windows.net" -Port 1433 -Region "westus"
Tests TLS handshake with a SQL database in the westus region instead of the environment's default region.
Parameters
-Destination
The destination that should be used to attempt the handshake for. This should only be a hostname.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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 test the handshake 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
-Port
The port that should be used to attempt the handshake for. Defaults to 443
Parameter properties
| Type: | String |
| Default value: | 443 |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Region
The Azure region in which to test the handshake. 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.