Stop-ZrNode
Stops one or more named nodes of a Zaris store. A single-node stop defaults to a graceful drain and cluster-leave; -Force hard-kills the process instead.
Syntax
Stop-ZrNode
-StoreName <string>
-Name <string[]>
[-Force]
[-Managers <string[]>] [-Port <int>] [-Token <string>] [-TimeoutSec <int>] [-FailFast]
Description
Stop-ZrNode stops the named instances of the given store on each connected manager via the Management Service, printing a per-node result. A stop defaults to a graceful drain and cluster-leave so surviving peers get a clean handoff; -Force (alias -HardKill) skips that and hard-kills the node process. Requires an active workspace or an explicit -Managers. As a write operation it refuses to fan out across a mixed-mode (supervisor + attach) workspace.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
-StoreName | string | Yes | Name of the store the nodes belong to. Position 0. |
-Name | string[] | Yes | One or more node (instance) names to stop. Position 1. |
-Force | switch | No | Hard-kill the node process instead of a graceful drain and cluster-leave. Alias -HardKill. |
-Managers | string[] | No | Management Service endpoints to target; when omitted the active workspace's managers are used. |
-Port | int | No | Management Service port for bare-host managers. Default 7801. |
-Token | string | No | Admin bearer token for authenticated control-plane calls. |
-TimeoutSec | int | No | Per-request timeout in seconds. Default 30. |
-FailFast | switch | No | Stop at the first manager (or node) that returns an error instead of continuing. |
Examples
Gracefully stop a single node, draining and leaving the cluster cleanly.
Stop-ZrNode -StoreName orders -Name 10.0.0.11-n0
Hard-kill a node process without a graceful drain.
Stop-ZrNode -StoreName orders -Name 10.0.0.11-n0 -Force