Add-ClientNodeSecurity
This PowerShell Cmdlet enables secure communication between a client application and a cache by configuring the necessary user credentials in the client.ncconf file. This Cmdlet allows you to provide cache user credentials for a specified cache. However, the administrative credentials are only required if the client node itself is secured.
Warning
This cache security is replicated on every client node so any secondary users are added to the client node.
Add-ClientNodeSecurity [-CacheName] -AdminCredentials -NodeName -CacheUserCredentials [-Port] [-NoLogo] [-Server]
Examples of Add-ClientNodeSecurity
- This command configures the security credentials for the user john_smith in client.config file using the CEK specified on the cache server.
Add-ClientNodeSecurity -CacheName demoCache -CacheUserCredentials(Get-Credential john_smith) -NodeName 20.200.20.11 -Server 20.200.20.12
- This command configures the security credentials for the user john_smith in client.config file using the CEK specified on the server. However, the administrative credentials are only required if the client node itself is secured.
Add-ClientNodeSecurity -CacheName demoCache -CacheUserCredentials(Get-Credential john_smith) -NodeName 20.200.20.11 -Server 20.200.20.12 -AdminCredentials(Get-Credential john_smith)
Properties
Note
The parameters with asterisk (*) on their names are the required parameters and the rest are optional.
Parameters | Data Types | Description | Default Value |
---|---|---|---|
-CacheName* |
<String> |
Specifies the name of the cache for which cache-level credentials need to be configured. | - |
-AdminCredentials* |
<String> |
Specifies the credentials of a user with administrative rights on the client node. This is required only if security is enabled on the client node. If security is disabled, this parameter is ignored. | - |
-NodeName* |
<String> |
Specifies the IP address of the client node where the credentials configuration will take place. | - |
-CacheUserCredentials* |
<pscredential> |
Specifies the user credentials that the application should use to connect to the specified cache. These credentials should belong to a user who has access rights to the designated cache. | - |
-Port |
<Integer> |
Specifies the port on which the NCache Service is listening. | 8250 |
-NoLogo |
<SwitchParameter> |
Suppresses display of the logo banner. | - |
-Server* |
<String> |
Specifies the IP address of the server node in the cache, which provides the credentials encryption key (CEK) used to encrypt the credentials of the client node's security. | - |