qm-wait

Wait until the virtual machine is stopped

$ qm wait 100

$ qm wait --timeout 10 100

$ qm shutdown 100 && qm wait --timeout 10 100

qm wait [options] vmid

qm wait blocks until a virtual machine reaches stopped state. This is useful in scripts to ensure a VM has fully stopped before performing subsequent operations.
Combined with shutdown, it provides a way to gracefully stop VMs and wait for completion.

--timeout seconds

Maximum time to wait before returning

Without timeout, the command may block indefinitely if the VM doesn't stop. Always use timeout in scripts for predictable behavior.

Part of Proxmox VE QEMU/KVM management tools for virtual machine administration.

qm(1), qm-shutdown(1), qm-stop(1)