Remove-ClientNode
This PowerShell cmdlet enables users to remove the client(s) node from the existing clustered cache.
Remove-ClientNode -Cachename -ClientNode [-Port] -Server [-Credentials] [-NoLogo]
Examples
- This command removes the 20.200.20.12 client node from a cache named demoCache which exists on the server node 20.200.20.11.
Remove-ClientNode -CacheName demoCache -ClientNode 20.200.20.12 –Server 20.200.20.11
- This command uses port and removes the 20.200.20.12 client node from the demoCache which exists on server 20.200.20.11.
Remove-ClientNode -CacheName demoCache -ClientNode 20.200.20.12 -Server 20.200.20.11 -Port 8250
- This command removes the 20.200.20.12 client node from a cache named demoCache which exists on the server node 20.200.20.11 using security credentials.
Remove-ClientNode -CacheName demoCache -ClientNode 20.200.20.12 –Server 20.200.20.11 -Credentials(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 clustered cache from which the client node will be removed. Note: The cache must already exist on the source server. |
- |
-ClientNode* |
<String> |
Specifies the client node to be removed, where the NCache Service is running. |
- |
-NoLogo |
<SwitchParameter> |
Suppresses display of the logo banner. |
False |
-Port |
<Integer> |
Specifies the server port where the NCache Service is listening. |
8250 |
-Server* |
<String> |
Specifies a server name where the NCache Service is running and a cache with the specified cache-name is registered. |
- |
-Credentials |
<pscredential> |
Specifies the user credentials required to authorize access for the specified operation. These credentials should belong to a user with the appropriate permissions at the node. |
- |
remove-clientnode -cachename -clientnode [-port] -server [-userid] [-password] [-nologo]
Examples
- This command removes the 20.200.20.12 client node from a cache named demoCache which exists on the server node 20.200.20.11.
remove-clientnode -cachename demoCache -clientnode 20.200.20.12 –server 20.200.20.11
- This command uses port and removes the 20.200.20.12 client node from the demoCache which exists on server 20.200.20.11.
remove-clientnode -cachename demoCache -clientnode 20.200.20.12 -server 20.200.20.11 -port 8250
- This command removes the 20.200.20.12 client node from a cache named demoCache which exists on the server node 20.200.20.11 using security credentials.
remove-clientnode -cachename demoCache -clientnode 20.200.20.12 –server 20.200.20.11 -userid john_smith -password pass123
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 clustered cache from which the client node will be removed. Note: The cache must already exist on the source server. |
- |
-clientnode* |
<String> |
Specifies the client node to be removed, where the NCache Service is running. |
- |
-nologo |
<SwitchParameter> |
Suppresses display of the logo banner. |
False |
-port |
<Integer> |
Specifies the server port where the NCache Service is listening. |
8250 |
-server* |
<String> |
Specifies a server name where the NCache Service is running and a cache with the specified cache-name is registered. |
- |
-userid |
<String> |
Specifies the user id used to authorize the user for this operation. It is required in case security is enabled on Cache Server. This user id must be the active directory user id. |
- |
-password |
<String> |
Specifies the password of the user that is used to authorize the user for this operation. It is required in case security is enabled on Cache Server. This password must be the same as the active directory user password. |
- |