Get-ZrRole
Lists the security roles defined in the cluster, including the permissions each role confers.
Syntax
Get-ZrRole
[-Managers <string[]>] [-Port <int>] [-Token <string>] [-TimeoutSec <int>]
Description
Get-ZrRole queries the first available manager and emits a SecurityRoleInfo object for each role known to the cluster, including the permissions each role confers. Requires a connected manager (an active workspace or explicit -Managers) and an admin token. Use it to discover the role names you pass to Grant-ZrRole and Revoke-ZrRole. See Authorization & RBAC for the role model.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
-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. |
Examples
List all defined security roles and their permissions.
Get-ZrRole