Function newGuestsExecCmd

internal/cli/guests.go:472–500

── guests exec ──────────────────────────────────────────────────────────────

()

// ── guests exec ──────────────────────────────────────────────────────────────

func newGuestsExecCmd() *cobra.Command {
	cmd := &cobra.Command{
		Use:   "exec <vmid> <command>",
		Short: "Execute a command inside a guest via QEMU guest agent",
		Long: `Execute a shell command inside a running guest.

For QEMU VMs the command runs via the QEMU guest agent (no SSH to the guest
required). The VM must have the guest agent enabled and running.
On Linux guests the command runs via /bin/sh -c.
On Windows guests it runs via PowerShell.

For LXC containers the command runs via pct exec over SSH to the Proxmox node
(ssh_user must be configured). The command always runs via /bin/sh -c.

Note: unlike the command-runner plugin, exec imposes no command whitelist.
The caller is responsible for what they run. Security is enforced by the
Proxmox API token permissions and SSH access granted to this client.`,
		Example: `  pvetui guests exec 100 "uptime"
  pvetui guests exec 200 "df -h"
  pvetui --profile prod guests exec 100 "systemctl status nginx"`,
		Args:              cobra.ExactArgs(2),
		ValidArgsFunction: completeVMIDs,
		RunE:              runGuestsExec,
	}

	cmd.Flags().Duration("timeout", 30*time.Second, "Command execution timeout")

	return cmd
}

func runGuestsExec(cmd *cobra.Command, args []string) error {
	vmid, err := parseVMID(args[0])