Get-ZrLicenseStatus
Shows the Zaris trial/license status of every manager machine in the workspace — one row per manager with its lifecycle stage, status, and badge.
Syntax
Get-ZrLicenseStatus
[-Managers <string[]>] [-Port <int>] [-Token <string>] [-TimeoutSec <int>]
Description
Licensing in Zaris is per machine: one machine is one seat, regardless of how many nodes it runs. Each manager in the workspace is a separate machine with its own seat, so Get-ZrLicenseStatus queries every resolved manager and prints a table with one row per manager showing:
- Stage — the lifecycle stage:
Trialing,TrialExpired,Stopped, orLicensed. - Status — a rolled-up token:
SUCCESSwhen the product and console are running (Licensed, Non-Production, or an active/extended trial),GATEDwhen the console is gated,STOPPEDwhen the product is stopped, orERRORif the manager could not be reached. - Badge — the manager's status badge (for example, days remaining).
It requires a connected manager (see New-ZrWorkspace / Use-ZrWorkspace) or an explicit -Managers list; with neither, it fails with NoManagersConnected.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
-Managers | string[] | No | Management Service endpoints (host, host:port, or URL) 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. |
Examples
Show the license stage and status for every manager in the active workspace.
Get-ZrLicenseStatus
Check the license status of two managers directly, without an active workspace.
Get-ZrLicenseStatus -Managers @('10.0.0.11:7801','10.0.0.12:7801')