Skip to main content

Get-ZrNode

Shows the nodes of a Zaris store and their roles — a table of all nodes, or a detailed view of a single node.

Syntax

Get-ZrNode
-StoreName <string>
[-Name <string>]
[-Managers <string[]>] [-Port <int>] [-Token <string>] [-TimeoutSec <int>]

Description

Get-ZrNode lists every instance of the given store with its status, address, role, and partition-map version. When -Name is supplied it shows a detailed view of that single node — status, role, PID, primary and replica partitions, map version, and time since the last role change. Data is read from the connected Management Services and aggregated across the workspace (in supervisor mode each manager owns only its local nodes, so the view is unioned to be cluster-wide). Requires an active workspace or an explicit -Managers.

Parameters

ParameterTypeRequiredDescription
-StoreNamestringYesName of the store whose nodes to show. Position 0.
-NamestringNoName of a single node to show in detail; lists all nodes when omitted. Position 1.
-Managersstring[]NoManagement Service endpoints to target; when omitted the active workspace's managers are used.
-PortintNoManagement Service port for bare-host managers. Default 7801.
-TokenstringNoAdmin bearer token for authenticated control-plane calls.
-TimeoutSecintNoPer-request timeout in seconds. Default 30.

Examples

List all nodes of the orders store with their status and roles.

Get-ZrNode -StoreName orders

Show a single node in detail, including its primary and replica partitions.

Get-ZrNode -StoreName orders -Name 10.0.0.11-n0