pve_agent_set_password
Set a guest OS user's password inside a Proxmox VM using the QEMU guest agent. Returns a dry-run plan by default; execute with confirm=True to apply the change.
Instructions
MUTATION: set a guest OS user's password via the qemu-agent.
Requires PROXIMO_ENABLE_AGENT=1, the VMID in PROXIMO_AGENT_ALLOWLIST, and a running guest agent inside the VM. Dry-run by default (returns a PLAN); confirm=True executes and returns {"status": "ok", "result": None}. Password is UNCONDITIONALLY redacted from the ledger (fingerprint only — "[redacted]"). Irreversible without knowledge of the old password; no undo primitive on this plane.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | Proxmox node name hosting the guest; auto-detected if omitted. | |
| vmid | Yes | Numeric VM ID of the guest whose OS user password is being set. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the password change. | |
| password | Yes | New password for the guest OS user; unconditionally redacted from the ledger. | |
| username | Yes | Guest OS username whose password will be changed. | |
| proximo_target | No | Which configured Proxmox target to run this call against — a target name from your multi-target config (a specific PVE/PBS/PMG/PDM box). Omit to use the single/default target from the environment; the selection applies only to this call. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |