Forrest logo
back to the qm tool

qm-shutdown:tldr:89db5

qm-shutdown: Shutdown a virtual machine and do not deactivate storage volumes.
$ qm shutdown --keepActive ${true} ${VM_ID}
try on your machine

This command is used to shut down a virtual machine (VM) using the qm utility, which is typically associated with the Proxmox Virtual Environment (PVE) platform.

Here is the breakdown of the command:

  • qm: It is the command-line utility for managing virtual machines in Proxmox VE.
  • shutdown: It is the action to be performed on the virtual machine. In this case, it is shutting down the VM.
  • --keepActive: It is an option that specifies whether or not to keep the guest agent active. The guest agent is a component running inside the VM that allows for efficient shutdown and other operations.
  • ${true}: It is a variable placeholder with a boolean value that determines whether to keep the guest agent active. Here, it is set to true, indicating that the guest agent should remain active.
  • ${VM_ID}: It is another variable placeholder that represents the ID of the virtual machine that needs to be shut down. The actual VM ID value needs to be inserted in place of ${VM_ID}.

To actually use this command, you should replace ${true} with true and ${VM_ID} with the actual VM ID assigned in your Proxmox VE environment.

This explanation was created by an AI. In most cases those are correct. But please always be careful and never run a command you are not sure if it is safe.
back to the qm tool