Skip to content

Set-NBCipherSSL

Since

v1.7.1

SYNOPSIS

Enables modern TLS protocols for PowerShell Desktop (5.1).

SYNTAX

Set-NBCipherSSL [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

Configures ServicePointManager to use TLS 1.2 (and optionally TLS 1.3). This is required for PowerShell Desktop (5.1) which defaults to older protocols. PowerShell Core (7+) already uses modern TLS by default.

EXAMPLES

EXAMPLE 1

Set-NBCipherSSL

Enables TLS 1.2 (and TLS 1.3 if available) for the current PowerShell session. This is automatically called by Connect-NBAPI on PowerShell Desktop (5.1).

EXAMPLE 2

Set-NBCipherSSL -Verbose

Enables modern TLS protocols with verbose output showing which protocols were enabled.

PARAMETERS

-ProgressAction

{{ Fill ProgressAction Description }}

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

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

OUTPUTS

System.Void

NOTES

AddedInVersion: v1.7.1 This function should only be called on PowerShell Desktop edition. SSL3 and TLS 1.0/1.1 are intentionally excluded as they are deprecated. PowerShell Core (7+) uses modern TLS by default and does not require this function.

Common parameters

common request params