Skip to content

Get‑TlsProtocol

dscbot edited this page Mar 31, 2026 · 3 revisions

SYNOPSIS

Returns configured SCHANNEL protocol settings for Server or Client.

SYNTAX

Get-TlsProtocol [[-Protocol] <SChannelSslProtocols>] [-Client] 
 [<CommonParameters>]

DESCRIPTION

Reads the Enabled and DisabledByDefault values for one or more SCHANNEL protocol keys and returns a PSCustomObject with the results. By default, all supported protocols are queried if no specific protocol is specified.

EXAMPLES

EXAMPLE 1

Get-TlsProtocol

Returns the SCHANNEL protocol settings for all supported protocols for server-side connections.

EXAMPLE 2

Get-TlsProtocol -Protocol Tls12

Returns the SCHANNEL protocol settings for TLS 1.2 for server-side connections.

EXAMPLE 3

Get-TlsProtocol -Protocol Tls12, Tls13 -Client

Returns the SCHANNEL protocol settings for TLS 1.2 and TLS 1.3 for client-side connections.

EXAMPLE 4

Get-TlsProtocol | Format-Table -AutoSize

Returns all protocol settings and displays them in a formatted table.

PARAMETERS

-Client

When specified, reads the Client key. By default the Server key is used.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Protocol

One or more protocol names. Accepts values from the [SChannelSslProtocols] enum such as Ssl2, Ssl3, Tls, Tls11, Tls12, Tls13, Dtls1, Dtls12. If not specified, all supported protocols are returned.

Type: SChannelSslProtocols
Parameter Sets: (All)
Aliases:
Accepted values: Ssl2, Ssl3, Tls, Tls11, Tls12, Tls13, DTls1, DTls12

Required: False
Position: 1
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.

INPUTS

None.

OUTPUTS

System.Management.Automation.PSCustomObject

Returns one or more objects with the following properties: Protocol,

Target, Enabled, DisabledByDefault, and RegistryPath.

NOTES

RELATED LINKS

Clone this wiki locally