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] [-TlsCertPath] [-TlsCertPassword] `
[-Credentials] [-NoLogo]
Examples
- This command disables TLS on the local NCache server when Mutual TLS is not enabled.
Disable-NCacheTLS
- This command disables TLS on server nodes
20.200.20.11and20.200.20.12when Mutual TLS is not enabled, 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-Credentialsupplies the credentials required to authorize the operation.
Disable-NCacheTLS -Node "20.200.20.11,20.200.20.12" -Credentials(Get-Credential john_smith)
- This command disables TLS when the target nodes require Mutual TLS, whether or not the machine running the cmdlet has an NCache server installation. 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
The parameters with asterisk (*) on their names are the required parameters and the rest are optional.
Note
-TlsCertPath is required when Mutual TLS is enabled on a target server, including when disabling TLS on the local server. Ensure that the client certificate is trusted on the machine running the cmdlet and that the server trusts its issuing Root CA. 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> |
Specifies the path to the client PEM certificate used to authenticate this cmdlet when the target NCache server requires Mutual TLS. This parameter is required for Mutual TLS connections even when the cmdlet runs on an NCache server. The PEM file must contain the private key, leaf certificate, and any intermediate certificates. Relative paths are resolved against the current PowerShell location, and the file must exist. You can generate a client certificate using New-NCacheTlsCertificate. | - |
-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 |