Remove-Node

The Remove-Node PowerShell cmdlet removes a specific server node from an existing NCache clustered cache. It supports graceful removal, allowing the node to complete in-flight operations and transfer data before leaving the cluster, thereby preserving data consistency and preventing data loss in clustered topologies.

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. -