Remove-Node
This PowerShell Cmdlet enables the user to remove the particular node from the existing cache on a server or specified node from provided clustered cache.
Remove-Node -CacheName -Server [-GracefulStop] [-NoLogo] [-Port] [-Credentials]
Examples
- This command removes the specified server node, i.e., 20.200.20.11 from the cache named demoCache.
Remove-Node –CacheName demoCache –Server 20.200.20.11
- This command removes the server node 20.200.20.11 from the cache named demoCache from the local server by gracefully stopping it.
Remove-Node -CacheName demoCache -Server 20.200.20.11 –GracefulStop
- This command removes the specified server node, i.e., 20.200.20.11 from the cache named demoCache using security credentials.
Remove-Node –CacheName demoCache –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 cache registered on the server, which will be unregistered from the server. Note: The cache must already exist on the source server. |
- |
-Server* |
<String> |
Specifies a server name where the NCache Service is running and a cache with the specified cache-name is registered. |
IP of local machine |
-GracefulStop |
<SwitchParameter> |
Provided by the user if the user wants the server to be stopped gracefully, i.e., the server will not be forcefully stopped. |
False |
-NoLogo |
<SwitchParameter> |
Suppresses display of the logo banner. |
False |
-Port |
<Integer> |
Specifies the server port where the NCache Service is listening. |
8250 |
-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-node -cachename -server [-gracefulstop] [-nologo] [-port] [-userid] [-password]
Examples
- This command removes the specified server node, i.e., 20.200.20.11 from the cache named demoCache.
remove-node –cachename demoCache –server 20.200.20.11
- This command removes the server node 20.200.20.11 from the cache named demoCache from the local server by gracefully stopping it.
remove-node -cachename demoCache -server 20.200.20.11 –gracefulstop
- This command removes the specified server node, i.e., 20.200.20.11 from the cache named demoCache using security credentials.
remove-node –cachename demoCache –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 cache registered on the server, which will be unregistered from the server. Note: The cache must already exist on the source server. |
- |
-server* |
<String> |
Specifies a server name where the NCache Service is running and a cache with the specified cache-name is registered. |
IP of local machine |
-gracefulstop |
<SwitchParameter> |
Provided by the user if the user wants the server to be stopped gracefully, i.e., the server will not be forcefully stopped. |
False |
-nologo |
<SwitchParameter> |
Suppresses display of the logo banner. |
False |
-port |
<Integer> |
Specifies the server port where the NCache Service is listening. |
8250 |
-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. |
- |