Skip to main content

Start-ZrStore

Starts all instances of a Zaris store, or a single named instance, through the connected managers.

Syntax

Start-ZrStore
-Name <string>
[-InstanceName <string>]
[-Managers <string[]>] [-Port <int>] [-Token <string>]
[-TimeoutSec <int>] [-Parallel] [-FailFast]

Description

Start-ZrStore enumerates the store's instances on each connected manager and starts them via the Management Service, reporting per-instance success or failure. When -InstanceName is given, only that instance is started. The cmdlet requires an active workspace (see New-ZrWorkspace / Use-ZrWorkspace) or an explicit -Managers list.

Parameters

ParameterTypeRequiredDescription
-NamestringYesName of the store to start. Position 0.
-InstanceNamestringNoStart only this instance; starts all instances of the store when omitted.
-Managersstring[]NoManagement Service endpoints (host, host:port, or URL) to target. When omitted, the active workspace/connected managers are used.
-PortintNoManager port for bare-host endpoints or localhost fallback. Default 7801.
-TokenstringNoAdmin bearer token for authenticated calls; falls back to the token from the active workspace.
-TimeoutSecintNoPer-request timeout in seconds. Default 30.
-ParallelswitchNoFan the operation out to all resolved managers concurrently.
-FailFastswitchNoStop at the first manager or instance that returns an error.

Examples

Start every instance of a store.

Start-ZrStore -Name orders

Start a single named instance.

Start-ZrStore -Name orders -InstanceName 10.0.0.11-n0

Start across several managers concurrently.

Start-ZrStore -Name orders -Managers 10.0.0.11,10.0.0.12,10.0.0.13 -Parallel

Output

Results are rendered as a table with Manager, Action (StartInstance:<name>), Result (SUCCESS/ERROR), and a message column — one row per instance start.