Set-ZrUserPassword
Changes the password of an existing Zaris login user, hashing it server-side and applying it consistently across the cluster.
Syntax
Set-ZrUserPassword
-Name <string>
-Password <SecureString>
[-Managers <string[]>] [-Port <int>] [-Token <string>] [-TimeoutSec <int>]
[-WhatIf] [-Confirm]
Description
Set-ZrUserPassword sets a new password for an existing local user, hashing it on the server and fanning the change out to every connected manager so the credential stays consistent cluster-wide. Requires a connected manager (an active workspace or explicit -Managers) and an admin token. See Authentication & tokens for the identity model.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
-Name | string | Yes | The username whose password is being changed. Position 0. |
-Password | SecureString | Yes | The new password, supplied as a SecureString and hashed on the server. Position 1. |
-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. |
Supports -WhatIf and -Confirm.
Examples
Prompt securely for a new password and apply it to the user alice on all managers (never pass a literal password on the command line).
Set-ZrUserPassword -Name alice -Password (Read-Host -AsSecureString)