Disable-NCacheTLS

The Disable-NCacheTLS PowerShell cmdlet disables TLS encryption on the specified NCache server nodes. TLS is disabled for client-server, server-to-server (cluster), and Bridge communication together. Run the cmdlet without -Node to disable TLS on the local server, or provide a comma-separated list through -Node to disable TLS on one or more remote servers.

Disable-NCacheTLS [-Node <string>] [-TlsCertPath <string>] [-TlsCertPassword <string>] `
                  [-Credentials <pscredential>] [-NoLogo]

Examples

  • This command disables TLS on the local NCache server.
Disable-NCacheTLS
  • This command disables TLS on server nodes 20.200.20.11 and 20.200.20.12 for client-server, server-to-server, and Bridge communication.
Disable-NCacheTLS -Node "20.200.20.11,20.200.20.12"
  • This command disables TLS on the specified remote nodes when NCache security is enabled. Get-Credential supplies the credentials required to authorize the operation.
Disable-NCacheTLS -Node "20.200.20.11,20.200.20.12" -Credentials (Get-Credential)
  • This command disables TLS remotely from a machine without an NCache server installation when the target nodes require mTLS. The client PEM contains a password-protected private key.
Disable-NCacheTLS -Node "20.200.20.11,20.200.20.12" `
                  -TlsCertPath "C:\certs\client.pem" `
                  -TlsCertPassword "clientKeyPassword"

Properties

Note

All parameters for this cmdlet are optional. When -Node is omitted, TLS is disabled on the local NCache server.

Parameters Data Types Description Default Value
-Node <String> Specifies one or more NCache server IP addresses as a comma-separated list. Each specified server is configured over the management RPC channel. When omitted, TLS is disabled on the local server. Local server
-TlsCertPath <String> Path to the client PEM certificate used when running this cmdlet from a machine without an NCache server installation against a server requiring mTLS. On an NCache server installation, the node certificate is used automatically. -
-TlsCertPassword <String> Password used to load the encrypted private key specified by -TlsCertPath. Not needed for an unencrypted key; not stored in server configuration. -
-Credentials <pscredential> Specifies the credentials used to authorize the operation on remote nodes when NCache security is enabled. This parameter is not required when disabling TLS on the local server. -
-NoLogo <SwitchParameter> Suppresses display of the NCache logo banner. False