< Back
Enable-Tls
Post
NAME Enable-Tls
SYNOPSIS
Enables one or more supplied TLS versions without affecting other settings.
SYNTAX
Enable-Tls [-PassThru] [-Ssl3] [-Tls] [-Tls11] [-Tls12] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
Enables one or more supplied TLS versions. Other versions will not be affected. For example, it `-Tls` is supplied
and `Tls11` is currently configured, the result will be `Tls, Tls11`.
These TLS Settings are used by `Invoke-WebRequest` and `Invoke-RestMethod` when connecting to remote end points.
These settings may also be used by other .NET APIs. Caution should be used when changing this as you may decrease
your security settings or break access to previously working endpoints.
PARAMETERS
-PassThru [<SwitchParameter>]
By default, this cmdlet does not supply any output. Supplying `-PassThru` will cause the cmdlet to return the
current TLS configuration.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Ssl3 [<SwitchParameter>]
If supplied, SSL 3.0 will be enabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Tls [<SwitchParameter>]
If supplied, TLS 1.0 will be enabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Tls11 [<SwitchParameter>]
If supplied, TLS 1.1 will be enabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Tls12 [<SwitchParameter>]
If supplied, TLS 1.2 will be enabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
OUTPUTS
System.Net.SecurityProtocolType
NOTES
This function calls `Set-Tls`.
-------------------------- Example 1 --------------------------
# Enable TLS 1.2
Disable-Tls -Tls12
The above example will enable TLS 1.2.
RELATED LINKS
https://github.com/markekraus/BetterTls ... ble-Tls.md
https://github.com/markekraus/BetterTls ... ble-Tls.md
Disable-Tls https://github.com/markekraus/BetterTls ... ble-Tls.md
Get-Tls https://github.com/markekraus/BetterTls ... Get-Tls.md
Set-Tls https://github.com/markekraus/BetterTls ... Set-Tls.md
SYNOPSIS
Enables one or more supplied TLS versions without affecting other settings.
SYNTAX
Enable-Tls [-PassThru] [-Ssl3] [-Tls] [-Tls11] [-Tls12] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
Enables one or more supplied TLS versions. Other versions will not be affected. For example, it `-Tls` is supplied
and `Tls11` is currently configured, the result will be `Tls, Tls11`.
These TLS Settings are used by `Invoke-WebRequest` and `Invoke-RestMethod` when connecting to remote end points.
These settings may also be used by other .NET APIs. Caution should be used when changing this as you may decrease
your security settings or break access to previously working endpoints.
PARAMETERS
-PassThru [<SwitchParameter>]
By default, this cmdlet does not supply any output. Supplying `-PassThru` will cause the cmdlet to return the
current TLS configuration.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Ssl3 [<SwitchParameter>]
If supplied, SSL 3.0 will be enabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Tls [<SwitchParameter>]
If supplied, TLS 1.0 will be enabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Tls11 [<SwitchParameter>]
If supplied, TLS 1.1 will be enabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Tls12 [<SwitchParameter>]
If supplied, TLS 1.2 will be enabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
OUTPUTS
System.Net.SecurityProtocolType
NOTES
This function calls `Set-Tls`.
-------------------------- Example 1 --------------------------
# Enable TLS 1.2
Disable-Tls -Tls12
The above example will enable TLS 1.2.
RELATED LINKS
https://github.com/markekraus/BetterTls ... ble-Tls.md
https://github.com/markekraus/BetterTls ... ble-Tls.md
Disable-Tls https://github.com/markekraus/BetterTls ... ble-Tls.md
Get-Tls https://github.com/markekraus/BetterTls ... Get-Tls.md
Set-Tls https://github.com/markekraus/BetterTls ... Set-Tls.md