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 }}

```yaml 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