stado host user create
Invocation
stado host user create [OPTIONS] <USERNAME>Purpose
Create USERNAME on selected registry-managed hosts over SSH
Required inputs and options
| Input or option | Contract |
|---|---|
<USERNAME> | Positional input; required or optional as shown in the invocation. |
--target <TARGET> | Registry target name. Repeat to provision several hosts |
--all | Provision every kind=local registry target with SSH configured |
--full-name <FULL_NAME> | Account display name |
--shell <SHELL> | Absolute login shell; host OS default if omitted [default: ""] |
--admin | Create an administrator account instead of a standard user |
--require-password-change | Require the new user to change the initial password on first login |
--dry-run | Validate and list targets without connecting |
--registry-source <REGISTRY_SOURCE> | Where the registry is read from: the canonical store, the bundled file, or the store with the bundled file behind it Possible values: - remote: The canonical registry in whichever store `WC_STORAGE_BACKEND` selects - local: The registry file bundled with this binary - auto: The canonical registry, then the bundled file when the store does not answer [default: remote] |
--json | Emit one JSON document listing every host's outcome |
Output and state effect
It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.
Refusals
- Require the new user to change the initial password on first login
- Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.