< Back
Disable-Tls
Post
NAME Disable-Tls
SYNOPSIS
Disables one or more supplied TLS versions without affecting other settings.
SYNTAX
Disable-Tls [-PassThru] [-Ssl3] [-Tls] [-Tls11] [-Tls12] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
Disables one or more supplied TLS versions. Other versions will not be affected. For example, it `-Tls` is
supplied and `Tls, Tls11` is currently configured, only `Tls` will be disabled.
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 disabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Tls [<SwitchParameter>]
If supplied, TLS 1.0 will be disabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Tls11 [<SwitchParameter>]
If supplied, TLS 1.1 will be disabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Tls12 [<SwitchParameter>]
If supplied, TLS 1.2 will be disabled.
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 --------------------------
# Disable TLS 1.0
Disable-Tls -Tls
The above example will disabled TLS 1.0.
RELATED LINKS
https://github.com/markekraus/BetterTls ... ble-Tls.md
https://github.com/markekraus/BetterTls ... ble-Tls.md
Enable-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
Disables one or more supplied TLS versions without affecting other settings.
SYNTAX
Disable-Tls [-PassThru] [-Ssl3] [-Tls] [-Tls11] [-Tls12] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
Disables one or more supplied TLS versions. Other versions will not be affected. For example, it `-Tls` is
supplied and `Tls, Tls11` is currently configured, only `Tls` will be disabled.
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 disabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Tls [<SwitchParameter>]
If supplied, TLS 1.0 will be disabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Tls11 [<SwitchParameter>]
If supplied, TLS 1.1 will be disabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Tls12 [<SwitchParameter>]
If supplied, TLS 1.2 will be disabled.
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 --------------------------
# Disable TLS 1.0
Disable-Tls -Tls
The above example will disabled TLS 1.0.
RELATED LINKS
https://github.com/markekraus/BetterTls ... ble-Tls.md
https://github.com/markekraus/BetterTls ... ble-Tls.md
Enable-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