pvecm: re-add "multiple cluster in same net" section
[pve-docs.git] / qm.1-synopsis.adoc
index cafec11..43c3022 100644 (file)
 *qm* `<COMMAND> [ARGS] [OPTIONS]`
 
+*qm agent*
+
+An alias for 'qm guest cmd'.
+
+*qm cleanup* `<vmid> <clean-shutdown> <guest-requested>`
+
+Cleans up resources like tap devices, vgpus, etc. Called after a vm shuts
+down, crashes, etc.
+
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
+
+`<clean-shutdown>`: `<boolean>` ::
+
+Indicates if qemu shutdown cleanly.
+
+`<guest-requested>`: `<boolean>` ::
+
+Indicates if the shutdown was requested by the guest or via qmp.
+
 *qm clone* `<vmid> <newid>` `[OPTIONS]`
 
 Create a copy of virtual machine/template.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`<newid>` `integer (1 - N)` ::
+`<newid>`: `<integer> (1 - N)` ::
 
 VMID for the clone.
 
-`-description` `string` ::
+`--bwlimit` `<integer> (0 - N)` ('default =' `clone limit from datacenter or storage config`)::
+
+Override I/O bandwidth limit (in KiB/s).
+
+`--description` `<string>` ::
 
 Description for the new VM.
 
-`-format` `(qcow2 | raw | vmdk)` ::
+`--format` `<qcow2 | raw | vmdk>` ::
 
-Target format for file storage.
-+
-NOTE: Requires option(s): `full`
+Target format for file storage. Only valid for full clone.
 
-`-full` `boolean` (default=`0`)::
+`--full` `<boolean>` ::
 
-Create a full copy of all disk. This is always done when you clone a normal VM. For VM templates, we try to create a linked clone by default.
+Create a full copy of all disks. This is always done when you clone a normal VM. For VM templates, we try to create a linked clone by default.
 
-`-name` `string` ::
+`--name` `<string>` ::
 
 Set a name for the new VM.
 
-`-pool` `string` ::
+`--pool` `<string>` ::
 
 Add the new VM to the specified pool.
 
-`-snapname` `string` ::
+`--snapname` `<string>` ::
 
 The name of the snapshot.
 
-`-storage` `string` ::
+`--storage` `<string>` ::
 
 Target storage for full clone.
-+
-NOTE: Requires option(s): `full`
 
-`-target` `string` ::
+`--target` `<string>` ::
 
 Target node. Only allowed if the original VM is on shared storage.
 
+*qm cloudinit dump* `<vmid> <type>`
+
+Get automatically generated cloudinit config.
+
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
+
+`<type>`: `<meta | network | user>` ::
 
+Config type.
 
 *qm config* `<vmid>` `[OPTIONS]`
 
 Get current virtual machine configuration. This does not include pending
 configuration changes (see 'pending' API).
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-current` `boolean` (default=`0`)::
+`--current` `<boolean>` ('default =' `0`)::
 
 Get current values (instead of pending values).
 
+`--snapshot` `<string>` ::
 
+Fetch config values from given snapshot.
 
 *qm create* `<vmid>` `[OPTIONS]`
 
 Create or restore a virtual machine.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-acpi` `boolean` (default=`1`)::
+`--acpi` `<boolean>` ('default =' `1`)::
 
 Enable/disable ACPI.
 
-`-agent` `boolean` (default=`0`)::
+`--agent` `[enabled=]<1|0> [,fstrim_cloned_disks=<1|0>]` ::
 
-Enable/disable Qemu GuestAgent.
+Enable/disable Qemu GuestAgent and its properties.
 
-`-archive` `string` ::
+`--arch` `<aarch64 | x86_64>` ::
+
+Virtual processor architecture. Defaults to the host.
+
+`--archive` `<string>` ::
 
 The backup file.
 
-`-args` `string` ::
+`--args` `<string>` ::
 
 Arbitrary arguments passed to kvm.
 
-`-autostart` `boolean` (default=`0`)::
+`--autostart` `<boolean>` ('default =' `0`)::
 
 Automatic restart after crash (currently ignored).
 
-`-balloon` `integer (0 - N)` ::
+`--balloon` `<integer> (0 - N)` ::
 
 Amount of target RAM for the VM in MB. Using zero disables the ballon driver.
 
-`-bios` `(ovmf | seabios)` (default=`seabios`)::
+`--bios` `<ovmf | seabios>` ('default =' `seabios`)::
 
 Select BIOS implementation.
 
-`-boot` `[acdn]{1,4}` (default=`cdn`)::
+`--boot` `[acdn]{1,4}` ('default =' `cdn`)::
 
 Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).
 
-`-bootdisk` `(ide|sata|scsi|virtio)\d+` ::
+`--bootdisk` `(ide|sata|scsi|virtio)\d+` ::
 
 Enable booting from specified disk.
 
-`-cdrom` `volume` ::
+`--bwlimit` `<integer> (0 - N)` ('default =' `restore limit from datacenter or storage config`)::
+
+Override I/O bandwidth limit (in KiB/s).
+
+`--cdrom` `<volume>` ::
 
 This is an alias for option -ide2
 
-`-cores` `integer (1 - N)` (default=`1`)::
+`--cicustom` `[meta=<volume>] [,network=<volume>] [,user=<volume>]` ::
+
+cloud-init: Specify custom files to replace the automatically generated ones at start.
+
+`--cipassword` `<password>` ::
+
+cloud-init: Password to assign the user. Using this is generally not recommended. Use ssh keys instead. Also note that older cloud-init versions do not support hashed passwords.
+
+`--citype` `<configdrive2 | nocloud>` ::
+
+Specifies the cloud-init configuration format. The default depends on the configured operating system type (`ostype`. We use the `nocloud` format for Linux, and `configdrive2` for windows.
+
+`--ciuser` `<string>` ::
+
+cloud-init: User name to change ssh keys and password for instead of the image's configured default user.
+
+`--cores` `<integer> (1 - N)` ('default =' `1`)::
 
 The number of cores per socket.
 
-`-cpu` `[cputype=]<cputype> [,hidden=<1|0>]` ::
+`--cpu` `[cputype=]<enum> [,flags=<+FLAG[;-FLAG...]>] [,hidden=<1|0>] [,hv-vendor-id=<vendor-id>]` ::
 
 Emulated CPU type.
 
-`-cpulimit` `number (0 - 128)` (default=`0`)::
+`--cpulimit` `<number> (0 - 128)` ('default =' `0`)::
 
 Limit of CPU usage.
 
-`-cpuunits` `integer (0 - 500000)` (default=`1000`)::
+`--cpuunits` `<integer> (2 - 262144)` ('default =' `1024`)::
 
 CPU weight for a VM.
 
-`-description` `string` ::
+`--description` `<string>` ::
 
 Description for the VM. Only used on the configuration web interface. This is saved as comment inside the configuration file.
 
-`-efidisk0` `[file=]<volume> [,format=<image format>] [,size=<DiskSize>]` ::
+`--efidisk0` `[file=]<volume> [,format=<enum>] [,size=<DiskSize>]` ::
 
 Configure a Disk for storing EFI vars
 
-`-force` `boolean` ::
+`--force` `<boolean>` ::
 
 Allow to overwrite existing VM.
 +
 NOTE: Requires option(s): `archive`
 
-`-freeze` `boolean` ::
+`--freeze` `<boolean>` ::
 
 Freeze CPU at startup (use 'c' monitor command to start execution).
 
-`-hostpci[n]` `[host=]<HOSTPCIID[;HOSTPCIID2...]> [,pcie=<1|0>] [,rombar=<1|0>] [,x-vga=<1|0>]` ::
+`--hookscript` `<string>` ::
+
+Script that will be executed during various steps in the vms lifetime.
+
+`--hostpci[n]` `[host=]<HOSTPCIID[;HOSTPCIID2...]> [,mdev=<string>] [,pcie=<1|0>] [,rombar=<1|0>] [,romfile=<string>] [,x-vga=<1|0>]` ::
 
 Map host PCI devices into guest.
 
-`-hotplug` `string` (default=`network,disk,usb`)::
+`--hotplug` `<string>` ('default =' `network,disk,usb`)::
 
 Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to disable hotplug completely. Value '1' is an alias for the default 'network,disk,usb'.
 
-`-hugepages` `(1024 | 2 | any)` ::
+`--hugepages` `<1024 | 2 | any>` ::
 
 Enable/disable hugepages memory.
 
-`-ide[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_rd=<bps>] [,bps_wr=<bps>] [,cache=<none|writethrough|writeback|unsafe|directsync>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<image format>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,model=<model>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enospc|ignore|report|stop>]` ::
+`--ide[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,model=<model>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>] [,wwn=<wwn>]` ::
 
 Use volume as IDE hard disk or CD-ROM (n is 0 to 3).
 
-`-keyboard` `(da | de | de-ch | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sl | sv | tr)` (default=`en-us`)::
+`--ipconfig[n]` `[gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>]` ::
+
+cloud-init: Specify IP addresses and gateways for the corresponding interface.
++
+IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.
++
+The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.
+For IPv6 the special string 'auto' can be used to use stateless autoconfiguration.
++
+If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.
+
+`--ivshmem` `size=<integer> [,name=<string>]` ::
 
-Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.conf' configuration file.
+Inter-VM shared memory. Useful for direct communication between VMs, or to the host.
 
-`-kvm` `boolean` (default=`1`)::
+`--keyboard` `<da | de | de-ch | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sl | sv | tr>` ::
+
+Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.It should not be necessary to set it.
+
+`--kvm` `<boolean>` ('default =' `1`)::
 
 Enable/disable KVM hardware virtualization.
 
-`-localtime` `boolean` ::
+`--localtime` `<boolean>` ::
 
 Set the real time clock to local time. This is enabled by default if ostype indicates a Microsoft OS.
 
-`-lock` `(backup | migrate | rollback | snapshot)` ::
+`--lock` `<backup | clone | create | migrate | rollback | snapshot | snapshot-delete | suspended | suspending>` ::
 
 Lock/unlock the VM.
 
-`-machine` `(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?)` ::
+`--machine` `(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?|virt(?:-\d+\.\d+)?)` ::
 
-Specific the Qemu machine type.
+Specifies the Qemu machine type.
 
-`-memory` `integer (16 - N)` (default=`512`)::
+`--memory` `<integer> (16 - N)` ('default =' `512`)::
 
 Amount of RAM for the VM in MB. This is the maximum available memory when you use the balloon device.
 
-`-migrate_downtime` `number (0 - N)` (default=`0.1`)::
+`--migrate_downtime` `<number> (0 - N)` ('default =' `0.1`)::
 
 Set maximum tolerated downtime (in seconds) for migrations.
 
-`-migrate_speed` `integer (0 - N)` (default=`0`)::
+`--migrate_speed` `<integer> (0 - N)` ('default =' `0`)::
 
 Set maximum speed (in MB/s) for migrations. Value 0 is no limit.
 
-`-name` `string` ::
+`--name` `<string>` ::
 
 Set a name for the VM. Only used on the configuration web interface.
 
-`-net[n]` `[model=]<model> [,bridge=<bridge>] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=<XX:XX:XX:XX:XX:XX>] [,queues=<integer>] [,rate=<number>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,<model>=<macaddr>]` ::
+`--nameserver` `<string>` ::
+
+cloud-init: Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.
+
+`--net[n]` `[model=]<enum> [,bridge=<bridge>] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=<XX:XX:XX:XX:XX:XX>] [,queues=<integer>] [,rate=<number>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,<model>=<macaddr>]` ::
 
 Specify network devices.
 
-`-numa` `boolean` (default=`0`)::
+`--numa` `<boolean>` ('default =' `0`)::
 
 Enable/disable NUMA.
 
-`-numa[n]` `cpus=<id[-id];...> [,hostnodes=<id[-id];...>] [,memory=<number>] [,policy=<preferred|bind|interleave>]` ::
+`--numa[n]` `cpus=<id[-id];...> [,hostnodes=<id[-id];...>] [,memory=<number>] [,policy=<preferred|bind|interleave>]` ::
 
 NUMA topology.
 
-`-onboot` `boolean` (default=`0`)::
+`--onboot` `<boolean>` ('default =' `0`)::
 
 Specifies whether a VM will be started during system bootup.
 
-`-ostype` `(l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win7 | win8 | wvista | wxp)` ::
+`--ostype` `<l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win10 | win7 | win8 | wvista | wxp>` ::
 
 Specify guest operating system.
 
-`-parallel[n]` `/dev/parport\d+|/dev/usb/lp\d+` ::
+`--parallel[n]` `/dev/parport\d+|/dev/usb/lp\d+` ::
 
 Map host parallel devices (n is 0 to 2).
 
-`-pool` `string` ::
+`--pool` `<string>` ::
 
 Add the VM to the specified pool.
 
-`-protection` `boolean` (default=`0`)::
+`--protection` `<boolean>` ('default =' `0`)::
 
 Sets the protection flag of the VM. This will disable the remove VM and remove disk operations.
 
-`-reboot` `boolean` (default=`1`)::
+`--reboot` `<boolean>` ('default =' `1`)::
 
 Allow reboot. If set to '0' the VM exit on reboot.
 
-`-sata[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_rd=<bps>] [,bps_wr=<bps>] [,cache=<none|writethrough|writeback|unsafe|directsync>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<image format>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enospc|ignore|report|stop>]` ::
+`--sata[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>] [,wwn=<wwn>]` ::
 
 Use volume as SATA hard disk or CD-ROM (n is 0 to 5).
 
-`-scsi[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_rd=<bps>] [,bps_wr=<bps>] [,cache=<none|writethrough|writeback|unsafe|directsync>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<image format>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,queues=<integer>] [,secs=<integer>] [,serial=<serial>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enospc|ignore|report|stop>]` ::
+`--scsi[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>] [,wwn=<wwn>]` ::
 
 Use volume as SCSI hard disk or CD-ROM (n is 0 to 13).
 
-`-scsihw` `(lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single)` (default=`lsi`)::
+`--scsihw` `<lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single>` ('default =' `lsi`)::
 
 SCSI controller model
 
-`-serial[n]` `(/dev/.+|socket)` ::
+`--searchdomain` `<string>` ::
+
+cloud-init: Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.
+
+`--serial[n]` `(/dev/.+|socket)` ::
 
 Create a serial device inside the VM (n is 0 to 3)
 
-`-shares` `integer (0 - 50000)` (default=`1000`)::
+`--shares` `<integer> (0 - 50000)` ('default =' `1000`)::
 
-Amount of memory shares for auto-ballooning. The larger the number is, the more memory this VM gets. Number is relative to weights of all other running VMs. Using zero disables auto-ballooning
+Amount of memory shares for auto-ballooning. The larger the number is, the more memory this VM gets. Number is relative to weights of all other running VMs. Using zero disables auto-ballooning. Auto-ballooning is done by pvestatd.
 
-`-smbios1` `[family=<string>] [,manufacturer=<string>] [,product=<string>] [,serial=<string>] [,sku=<string>] [,uuid=<UUID>] [,version=<string>]` ::
+`--smbios1` `[base64=<1|0>] [,family=<Base64 encoded string>] [,manufacturer=<Base64 encoded string>] [,product=<Base64 encoded string>] [,serial=<Base64 encoded string>] [,sku=<Base64 encoded string>] [,uuid=<UUID>] [,version=<Base64 encoded string>]` ::
 
 Specify SMBIOS type 1 fields.
 
-`-smp` `integer (1 - N)` (default=`1`)::
+`--smp` `<integer> (1 - N)` ('default =' `1`)::
 
 The number of CPUs. Please use option -sockets instead.
 
-`-sockets` `integer (1 - N)` (default=`1`)::
+`--sockets` `<integer> (1 - N)` ('default =' `1`)::
 
 The number of CPU sockets.
 
-`-startdate` `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` (default=`now`)::
+`--sshkeys` `<filepath>` ::
+
+cloud-init: Setup public SSH keys (one key per line, OpenSSH format).
+
+`--start` `<boolean>` ('default =' `0`)::
+
+Start VM after it was created successfully.
+
+`--startdate` `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` ('default =' `now`)::
 
 Set the initial date of the real time clock. Valid format for date are: 'now' or '2006-06-17T16:01:21' or '2006-06-17'.
 
-`-startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
+`--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
 
 Startup and shutdown behavior. Order is a non-negative number defining the general startup order. Shutdown in done with reverse ordering. Additionally you can set the 'up' or 'down' delay in seconds, which specifies a delay to wait before the next VM is started or stopped.
 
-`-storage` `string` ::
+`--storage` `<string>` ::
 
 Default storage.
 
-`-tablet` `boolean` (default=`1`)::
+`--tablet` `<boolean>` ('default =' `1`)::
 
 Enable/disable the USB tablet device.
 
-`-tdf` `boolean` (default=`0`)::
+`--tdf` `<boolean>` ('default =' `0`)::
 
 Enable/disable time drift fix.
 
-`-template` `boolean` (default=`0`)::
+`--template` `<boolean>` ('default =' `0`)::
 
 Enable/disable Template.
 
-`-unique` `boolean` ::
+`--unique` `<boolean>` ::
 
 Assign a unique random ethernet address.
 +
 NOTE: Requires option(s): `archive`
 
-`-unused[n]` `string` ::
+`--unused[n]` `<string>` ::
 
 Reference to unused volumes. This is used internally, and should not be modified manually.
 
-`-usb[n]` `[host=]<HOSTUSBDEVICE|spice> [,usb3=<1|0>]` ::
+`--usb[n]` `[host=]<HOSTUSBDEVICE|spice> [,usb3=<1|0>]` ::
 
 Configure an USB device (n is 0 to 4).
 
-`-vcpus` `integer (1 - N)` (default=`0`)::
+`--vcpus` `<integer> (1 - N)` ('default =' `0`)::
 
 Number of hotplugged vcpus.
 
-`-vga` `(cirrus | qxl | qxl2 | qxl3 | qxl4 | serial0 | serial1 | serial2 | serial3 | std | vmware)` ::
+`--vga` `[[type=]<enum>] [,memory=<integer>]` ::
 
-Select the VGA type.
+Configure the VGA hardware.
 
-`-virtio[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_rd=<bps>] [,bps_wr=<bps>] [,cache=<none|writethrough|writeback|unsafe|directsync>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<image format>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enospc|ignore|report|stop>]` ::
+`--virtio[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::
 
 Use volume as VIRTIO hard disk (n is 0 to 15).
 
-`-watchdog` `[[model=]<i6300esb|ib700>] [,action=<reset|shutdown|poweroff|pause|debug|none>]` ::
+`--vmgenid` `<UUID>` ('default =' `1 (autogenerated)`)::
 
-Create a virtual hardware watchdog device.
+Set VM Generation ID. Use '1' to autogenerate on create or update, pass '0' to disable explicitly.
+
+`--vmstatestorage` `<string>` ::
 
+Default storage for VM state volumes/files.
 
+`--watchdog` `[[model=]<i6300esb|ib700>] [,action=<enum>]` ::
+
+Create a virtual hardware watchdog device.
 
 *qm delsnapshot* `<vmid> <snapname>` `[OPTIONS]`
 
 Delete a VM snapshot.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`<snapname>` `string` ::
+`<snapname>`: `<string>` ::
 
 The name of the snapshot.
 
-`-force` `boolean` ::
+`--force` `<boolean>` ::
 
 For removal from config file, even if removing disk snapshots fails.
 
-
-
 *qm destroy* `<vmid>` `[OPTIONS]`
 
 Destroy the vm (also delete all used/owned volumes).
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-skiplock` `boolean` ::
+`--skiplock` `<boolean>` ::
 
 Ignore locks - only root is allowed to use this option.
 
+*qm guest cmd* `<vmid> <command>`
+
+Execute Qemu Guest Agent commands.
+
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
+
+`<command>`: `<fsfreeze-freeze | fsfreeze-status | fsfreeze-thaw | fstrim | get-fsinfo | get-host-name | get-memory-block-info | get-memory-blocks | get-osinfo | get-time | get-timezone | get-users | get-vcpus | info | network-get-interfaces | ping | shutdown | suspend-disk | suspend-hybrid | suspend-ram>` ::
+
+The QGA command.
+
+*qm guest exec* `<vmid> [<extra-args>]` `[OPTIONS]`
+
+Executes the given command via the guest agent
+
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
+
+`<extra-args>`: `<array>` ::
+
+Extra arguments as array
+
+`--synchronous` `<boolean>` ('default =' `1`)::
+
+If set to off, returns the pid immediately instead of waiting for the commmand to finish or the timeout.
+
+`--timeout` `<integer> (0 - N)` ('default =' `30`)::
+
+The maximum time to wait synchronously for the command to finish. If reached, the pid gets returned. Set to 0 to deactivate
+
+*qm guest exec-status* `<vmid> <pid>`
+
+Gets the status of the given pid started by the guest-agent
+
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
 
+`<pid>`: `<integer>` ::
 
+The PID to query
 
-*qm help* `[<cmd>]` `[OPTIONS]`
+*qm guest passwd* `<vmid> <username>` `[OPTIONS]`
+
+Sets the password for the given user to the given password
+
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
+
+`<username>`: `<string>` ::
+
+The user to set the password for.
+
+`--crypted` `<boolean>` ('default =' `0`)::
+
+set to 1 if the password has already been passed through crypt()
+
+*qm help* `[OPTIONS]`
 
 Get help about specified command.
 
-`<cmd>` `string` ::
+`--extra-args` `<array>` ::
 
-Command name
+Shows help for a specific command
 
-`-verbose` `boolean` ::
+`--verbose` `<boolean>` ::
 
 Verbose output format.
 
+*qm importdisk* `<vmid> <source> <storage>` `[OPTIONS]`
+
+Import an external disk image as an unused disk in a VM. The
+ image format has to be supported by qemu-img(1).
+
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
+
+`<source>`: `<string>` ::
+
+Path to the disk image to import
+
+`<storage>`: `<string>` ::
+
+Target storage ID
+
+`--format` `<qcow2 | raw | vmdk>` ::
+
+Target format
+
+*qm importovf* `<vmid> <manifest> <storage>` `[OPTIONS]`
+
+Create a new VM using parameters read from an OVF manifest
+
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
+
+`<manifest>`: `<string>` ::
 
+path to the ovf file
 
+`<storage>`: `<string>` ::
+
+Target storage ID
+
+`--dryrun` `<boolean>` ::
+
+Print a parsed representation of the extracted OVF parameters, but do not create a VM
+
+`--format` `<qcow2 | raw | vmdk>` ::
+
+Target format
 
 *qm list* `[OPTIONS]`
 
 Virtual machine index (per node).
 
-`-full` `boolean` ::
+`--full` `<boolean>` ::
 
 Determine the full status of active VMs.
 
+*qm listsnapshot* `<vmid>`
+
+List all snapshots.
 
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
 
 *qm migrate* `<vmid> <target>` `[OPTIONS]`
 
 Migrate virtual machine. Creates a new migration task.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`<target>` `string` ::
+`<target>`: `<string>` ::
 
 Target node.
 
-`-force` `boolean` ::
+`--bwlimit` `<integer> (0 - N)` ('default =' `migrate limit from datacenter or storage config`)::
+
+Override I/O bandwidth limit (in KiB/s).
+
+`--force` `<boolean>` ::
 
 Allow to migrate VMs which use local devices. Only root may use this option.
 
-`-online` `boolean` ::
+`--migration_network` `<string>` ::
+
+CIDR of the (sub) network that is used for migration.
+
+`--migration_type` `<insecure | secure>` ::
+
+Migration traffic is encrypted using an SSH tunnel by default. On secure, completely private networks this can be disabled to increase performance.
+
+`--online` `<boolean>` ::
 
 Use online/live migration.
 
+`--targetstorage` `<string>` ::
+
+Default target storage.
 
+`--with-local-disks` `<boolean>` ::
 
+Enable live storage migration for local disk
 
 *qm monitor* `<vmid>`
 
 Enter Qemu Monitor interface.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-
-
-
 *qm move_disk* `<vmid> <disk> <storage>` `[OPTIONS]`
 
 Move volume to different storage.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`<disk>` `(efidisk0 | ide0 | ide1 | ide2 | ide3 | sata0 | sata1 | sata2 | sata3 | sata4 | sata5 | scsi0 | scsi1 | scsi10 | scsi11 | scsi12 | scsi13 | scsi2 | scsi3 | scsi4 | scsi5 | scsi6 | scsi7 | scsi8 | scsi9 | virtio0 | virtio1 | virtio10 | virtio11 | virtio12 | virtio13 | virtio14 | virtio15 | virtio2 | virtio3 | virtio4 | virtio5 | virtio6 | virtio7 | virtio8 | virtio9)` ::
+`<disk>`: `<efidisk0 | ide0 | ide1 | ide2 | ide3 | sata0 | sata1 | sata2 | sata3 | sata4 | sata5 | scsi0 | scsi1 | scsi10 | scsi11 | scsi12 | scsi13 | scsi2 | scsi3 | scsi4 | scsi5 | scsi6 | scsi7 | scsi8 | scsi9 | virtio0 | virtio1 | virtio10 | virtio11 | virtio12 | virtio13 | virtio14 | virtio15 | virtio2 | virtio3 | virtio4 | virtio5 | virtio6 | virtio7 | virtio8 | virtio9>` ::
 
 The disk you want to move.
 
-`<storage>` `string` ::
+`<storage>`: `<string>` ::
 
 Target storage.
 
-`-delete` `boolean` (default=`0`)::
+`--bwlimit` `<integer> (0 - N)` ('default =' `move limit from datacenter or storage config`)::
+
+Override I/O bandwidth limit (in KiB/s).
+
+`--delete` `<boolean>` ('default =' `0`)::
 
 Delete the original disk after successful copy. By default the original disk is kept as unused disk.
 
-`-digest` `string` ::
+`--digest` `<string>` ::
 
 Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
 
-`-format` `(qcow2 | raw | vmdk)` ::
+`--format` `<qcow2 | raw | vmdk>` ::
 
 Target Format.
 
-
-
-
 *qm mtunnel*
 
 Used by qmigrate - do not use manually.
 
+*qm nbdstop* `<vmid>`
 
+Stop embedded nbd server.
 
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
 
 *qm pending* `<vmid>`
 
 Get virtual machine configuration, including pending changes.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-
-
-
 *qm rescan* `[OPTIONS]`
 
 Rescan all storages and update disk sizes and unused disk images.
 
-`-vmid` `integer (1 - N)` ::
-
-The (unique) ID of the VM.
+`--dryrun` `<boolean>` ('default =' `0`)::
 
+Do not actually write changes out to VM config(s).
 
+`--vmid` `<integer> (1 - N)` ::
 
+The (unique) ID of the VM.
 
 *qm reset* `<vmid>` `[OPTIONS]`
 
 Reset virtual machine.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-skiplock` `boolean` ::
+`--skiplock` `<boolean>` ::
 
 Ignore locks - only root is allowed to use this option.
 
-
-
 *qm resize* `<vmid> <disk> <size>` `[OPTIONS]`
 
 Extend volume size.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`<disk>` `(efidisk0 | ide0 | ide1 | ide2 | ide3 | sata0 | sata1 | sata2 | sata3 | sata4 | sata5 | scsi0 | scsi1 | scsi10 | scsi11 | scsi12 | scsi13 | scsi2 | scsi3 | scsi4 | scsi5 | scsi6 | scsi7 | scsi8 | scsi9 | virtio0 | virtio1 | virtio10 | virtio11 | virtio12 | virtio13 | virtio14 | virtio15 | virtio2 | virtio3 | virtio4 | virtio5 | virtio6 | virtio7 | virtio8 | virtio9)` ::
+`<disk>`: `<efidisk0 | ide0 | ide1 | ide2 | ide3 | sata0 | sata1 | sata2 | sata3 | sata4 | sata5 | scsi0 | scsi1 | scsi10 | scsi11 | scsi12 | scsi13 | scsi2 | scsi3 | scsi4 | scsi5 | scsi6 | scsi7 | scsi8 | scsi9 | virtio0 | virtio1 | virtio10 | virtio11 | virtio12 | virtio13 | virtio14 | virtio15 | virtio2 | virtio3 | virtio4 | virtio5 | virtio6 | virtio7 | virtio8 | virtio9>` ::
 
 The disk you want to resize.
 
-`<size>` `\+?\d+(\.\d+)?[KMGT]?` ::
+`<size>`: `\+?\d+(\.\d+)?[KMGT]?` ::
 
-The new size. With the '+' sign the value is added to the actual size of the volume and without it, the value is taken as an absolute one. Shrinking disk size is not supported.
+The new size. With the `+` sign the value is added to the actual size of the volume and without it, the value is taken as an absolute one. Shrinking disk size is not supported.
 
-`-digest` `string` ::
+`--digest` `<string>` ::
 
 Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
 
-`-skiplock` `boolean` ::
+`--skiplock` `<boolean>` ::
 
 Ignore locks - only root is allowed to use this option.
 
-
-
 *qm resume* `<vmid>` `[OPTIONS]`
 
 Resume virtual machine.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-nocheck` `boolean` ::
+`--nocheck` `<boolean>` ::
 
 no description available
 
-`-skiplock` `boolean` ::
+`--skiplock` `<boolean>` ::
 
 Ignore locks - only root is allowed to use this option.
 
-
-
 *qm rollback* `<vmid> <snapname>`
 
 Rollback VM state to specified snapshot.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`<snapname>` `string` ::
+`<snapname>`: `<string>` ::
 
 The name of the snapshot.
 
-
-
 *qm sendkey* `<vmid> <key>` `[OPTIONS]`
 
 Send key event to virtual machine.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`<key>` `string` ::
+`<key>`: `<string>` ::
 
 The key (qemu monitor encoding).
 
-`-skiplock` `boolean` ::
+`--skiplock` `<boolean>` ::
 
 Ignore locks - only root is allowed to use this option.
 
-
-
 *qm set* `<vmid>` `[OPTIONS]`
 
 Set virtual machine options (synchrounous API) - You should consider using
 the POST method instead for any actions involving hotplug or storage
 allocation.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-acpi` `boolean` (default=`1`)::
+`--acpi` `<boolean>` ('default =' `1`)::
 
 Enable/disable ACPI.
 
-`-agent` `boolean` (default=`0`)::
+`--agent` `[enabled=]<1|0> [,fstrim_cloned_disks=<1|0>]` ::
+
+Enable/disable Qemu GuestAgent and its properties.
 
-Enable/disable Qemu GuestAgent.
+`--arch` `<aarch64 | x86_64>` ::
 
-`-args` `string` ::
+Virtual processor architecture. Defaults to the host.
+
+`--args` `<string>` ::
 
 Arbitrary arguments passed to kvm.
 
-`-autostart` `boolean` (default=`0`)::
+`--autostart` `<boolean>` ('default =' `0`)::
 
 Automatic restart after crash (currently ignored).
 
-`-balloon` `integer (0 - N)` ::
+`--balloon` `<integer> (0 - N)` ::
 
 Amount of target RAM for the VM in MB. Using zero disables the ballon driver.
 
-`-bios` `(ovmf | seabios)` (default=`seabios`)::
+`--bios` `<ovmf | seabios>` ('default =' `seabios`)::
 
 Select BIOS implementation.
 
-`-boot` `[acdn]{1,4}` (default=`cdn`)::
+`--boot` `[acdn]{1,4}` ('default =' `cdn`)::
 
 Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).
 
-`-bootdisk` `(ide|sata|scsi|virtio)\d+` ::
+`--bootdisk` `(ide|sata|scsi|virtio)\d+` ::
 
 Enable booting from specified disk.
 
-`-cdrom` `volume` ::
+`--cdrom` `<volume>` ::
 
 This is an alias for option -ide2
 
-`-cores` `integer (1 - N)` (default=`1`)::
+`--cicustom` `[meta=<volume>] [,network=<volume>] [,user=<volume>]` ::
+
+cloud-init: Specify custom files to replace the automatically generated ones at start.
+
+`--cipassword` `<password>` ::
+
+cloud-init: Password to assign the user. Using this is generally not recommended. Use ssh keys instead. Also note that older cloud-init versions do not support hashed passwords.
+
+`--citype` `<configdrive2 | nocloud>` ::
+
+Specifies the cloud-init configuration format. The default depends on the configured operating system type (`ostype`. We use the `nocloud` format for Linux, and `configdrive2` for windows.
+
+`--ciuser` `<string>` ::
+
+cloud-init: User name to change ssh keys and password for instead of the image's configured default user.
+
+`--cores` `<integer> (1 - N)` ('default =' `1`)::
 
 The number of cores per socket.
 
-`-cpu` `[cputype=]<cputype> [,hidden=<1|0>]` ::
+`--cpu` `[cputype=]<enum> [,flags=<+FLAG[;-FLAG...]>] [,hidden=<1|0>] [,hv-vendor-id=<vendor-id>]` ::
 
 Emulated CPU type.
 
-`-cpulimit` `number (0 - 128)` (default=`0`)::
+`--cpulimit` `<number> (0 - 128)` ('default =' `0`)::
 
 Limit of CPU usage.
 
-`-cpuunits` `integer (0 - 500000)` (default=`1000`)::
+`--cpuunits` `<integer> (2 - 262144)` ('default =' `1024`)::
 
 CPU weight for a VM.
 
-`-delete` `string` ::
+`--delete` `<string>` ::
 
 A list of settings you want to delete.
 
-`-description` `string` ::
+`--description` `<string>` ::
 
 Description for the VM. Only used on the configuration web interface. This is saved as comment inside the configuration file.
 
-`-digest` `string` ::
+`--digest` `<string>` ::
 
 Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
 
-`-efidisk0` `[file=]<volume> [,format=<image format>] [,size=<DiskSize>]` ::
+`--efidisk0` `[file=]<volume> [,format=<enum>] [,size=<DiskSize>]` ::
 
 Configure a Disk for storing EFI vars
 
-`-force` `boolean` ::
+`--force` `<boolean>` ::
 
 Force physical removal. Without this, we simple remove the disk from the config file and create an additional configuration entry called 'unused[n]', which contains the volume ID. Unlink of unused[n] always cause physical removal.
 +
 NOTE: Requires option(s): `delete`
 
-`-freeze` `boolean` ::
+`--freeze` `<boolean>` ::
 
 Freeze CPU at startup (use 'c' monitor command to start execution).
 
-`-hostpci[n]` `[host=]<HOSTPCIID[;HOSTPCIID2...]> [,pcie=<1|0>] [,rombar=<1|0>] [,x-vga=<1|0>]` ::
+`--hookscript` `<string>` ::
+
+Script that will be executed during various steps in the vms lifetime.
+
+`--hostpci[n]` `[host=]<HOSTPCIID[;HOSTPCIID2...]> [,mdev=<string>] [,pcie=<1|0>] [,rombar=<1|0>] [,romfile=<string>] [,x-vga=<1|0>]` ::
 
 Map host PCI devices into guest.
 
-`-hotplug` `string` (default=`network,disk,usb`)::
+`--hotplug` `<string>` ('default =' `network,disk,usb`)::
 
 Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to disable hotplug completely. Value '1' is an alias for the default 'network,disk,usb'.
 
-`-hugepages` `(1024 | 2 | any)` ::
+`--hugepages` `<1024 | 2 | any>` ::
 
 Enable/disable hugepages memory.
 
-`-ide[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_rd=<bps>] [,bps_wr=<bps>] [,cache=<none|writethrough|writeback|unsafe|directsync>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<image format>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,model=<model>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enospc|ignore|report|stop>]` ::
+`--ide[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,model=<model>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>] [,wwn=<wwn>]` ::
 
 Use volume as IDE hard disk or CD-ROM (n is 0 to 3).
 
-`-keyboard` `(da | de | de-ch | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sl | sv | tr)` (default=`en-us`)::
+`--ipconfig[n]` `[gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>]` ::
+
+cloud-init: Specify IP addresses and gateways for the corresponding interface.
++
+IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.
++
+The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.
+For IPv6 the special string 'auto' can be used to use stateless autoconfiguration.
++
+If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.
+
+`--ivshmem` `size=<integer> [,name=<string>]` ::
 
-Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.conf' configuration file.
+Inter-VM shared memory. Useful for direct communication between VMs, or to the host.
 
-`-kvm` `boolean` (default=`1`)::
+`--keyboard` `<da | de | de-ch | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sl | sv | tr>` ::
+
+Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.It should not be necessary to set it.
+
+`--kvm` `<boolean>` ('default =' `1`)::
 
 Enable/disable KVM hardware virtualization.
 
-`-localtime` `boolean` ::
+`--localtime` `<boolean>` ::
 
 Set the real time clock to local time. This is enabled by default if ostype indicates a Microsoft OS.
 
-`-lock` `(backup | migrate | rollback | snapshot)` ::
+`--lock` `<backup | clone | create | migrate | rollback | snapshot | snapshot-delete | suspended | suspending>` ::
 
 Lock/unlock the VM.
 
-`-machine` `(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?)` ::
+`--machine` `(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?|virt(?:-\d+\.\d+)?)` ::
 
-Specific the Qemu machine type.
+Specifies the Qemu machine type.
 
-`-memory` `integer (16 - N)` (default=`512`)::
+`--memory` `<integer> (16 - N)` ('default =' `512`)::
 
 Amount of RAM for the VM in MB. This is the maximum available memory when you use the balloon device.
 
-`-migrate_downtime` `number (0 - N)` (default=`0.1`)::
+`--migrate_downtime` `<number> (0 - N)` ('default =' `0.1`)::
 
 Set maximum tolerated downtime (in seconds) for migrations.
 
-`-migrate_speed` `integer (0 - N)` (default=`0`)::
+`--migrate_speed` `<integer> (0 - N)` ('default =' `0`)::
 
 Set maximum speed (in MB/s) for migrations. Value 0 is no limit.
 
-`-name` `string` ::
+`--name` `<string>` ::
 
 Set a name for the VM. Only used on the configuration web interface.
 
-`-net[n]` `[model=]<model> [,bridge=<bridge>] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=<XX:XX:XX:XX:XX:XX>] [,queues=<integer>] [,rate=<number>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,<model>=<macaddr>]` ::
+`--nameserver` `<string>` ::
+
+cloud-init: Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.
+
+`--net[n]` `[model=]<enum> [,bridge=<bridge>] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=<XX:XX:XX:XX:XX:XX>] [,queues=<integer>] [,rate=<number>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,<model>=<macaddr>]` ::
 
 Specify network devices.
 
-`-numa` `boolean` (default=`0`)::
+`--numa` `<boolean>` ('default =' `0`)::
 
 Enable/disable NUMA.
 
-`-numa[n]` `cpus=<id[-id];...> [,hostnodes=<id[-id];...>] [,memory=<number>] [,policy=<preferred|bind|interleave>]` ::
+`--numa[n]` `cpus=<id[-id];...> [,hostnodes=<id[-id];...>] [,memory=<number>] [,policy=<preferred|bind|interleave>]` ::
 
 NUMA topology.
 
-`-onboot` `boolean` (default=`0`)::
+`--onboot` `<boolean>` ('default =' `0`)::
 
 Specifies whether a VM will be started during system bootup.
 
-`-ostype` `(l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win7 | win8 | wvista | wxp)` ::
+`--ostype` `<l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win10 | win7 | win8 | wvista | wxp>` ::
 
 Specify guest operating system.
 
-`-parallel[n]` `/dev/parport\d+|/dev/usb/lp\d+` ::
+`--parallel[n]` `/dev/parport\d+|/dev/usb/lp\d+` ::
 
 Map host parallel devices (n is 0 to 2).
 
-`-protection` `boolean` (default=`0`)::
+`--protection` `<boolean>` ('default =' `0`)::
 
 Sets the protection flag of the VM. This will disable the remove VM and remove disk operations.
 
-`-reboot` `boolean` (default=`1`)::
+`--reboot` `<boolean>` ('default =' `1`)::
 
 Allow reboot. If set to '0' the VM exit on reboot.
 
-`-revert` `string` ::
+`--revert` `<string>` ::
 
 Revert a pending change.
 
-`-sata[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_rd=<bps>] [,bps_wr=<bps>] [,cache=<none|writethrough|writeback|unsafe|directsync>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<image format>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enospc|ignore|report|stop>]` ::
+`--sata[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>] [,wwn=<wwn>]` ::
 
 Use volume as SATA hard disk or CD-ROM (n is 0 to 5).
 
-`-scsi[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_rd=<bps>] [,bps_wr=<bps>] [,cache=<none|writethrough|writeback|unsafe|directsync>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<image format>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,queues=<integer>] [,secs=<integer>] [,serial=<serial>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enospc|ignore|report|stop>]` ::
+`--scsi[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>] [,wwn=<wwn>]` ::
 
 Use volume as SCSI hard disk or CD-ROM (n is 0 to 13).
 
-`-scsihw` `(lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single)` (default=`lsi`)::
+`--scsihw` `<lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single>` ('default =' `lsi`)::
 
 SCSI controller model
 
-`-serial[n]` `(/dev/.+|socket)` ::
+`--searchdomain` `<string>` ::
+
+cloud-init: Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.
+
+`--serial[n]` `(/dev/.+|socket)` ::
 
 Create a serial device inside the VM (n is 0 to 3)
 
-`-shares` `integer (0 - 50000)` (default=`1000`)::
+`--shares` `<integer> (0 - 50000)` ('default =' `1000`)::
 
-Amount of memory shares for auto-ballooning. The larger the number is, the more memory this VM gets. Number is relative to weights of all other running VMs. Using zero disables auto-ballooning
+Amount of memory shares for auto-ballooning. The larger the number is, the more memory this VM gets. Number is relative to weights of all other running VMs. Using zero disables auto-ballooning. Auto-ballooning is done by pvestatd.
 
-`-skiplock` `boolean` ::
+`--skiplock` `<boolean>` ::
 
 Ignore locks - only root is allowed to use this option.
 
-`-smbios1` `[family=<string>] [,manufacturer=<string>] [,product=<string>] [,serial=<string>] [,sku=<string>] [,uuid=<UUID>] [,version=<string>]` ::
+`--smbios1` `[base64=<1|0>] [,family=<Base64 encoded string>] [,manufacturer=<Base64 encoded string>] [,product=<Base64 encoded string>] [,serial=<Base64 encoded string>] [,sku=<Base64 encoded string>] [,uuid=<UUID>] [,version=<Base64 encoded string>]` ::
 
 Specify SMBIOS type 1 fields.
 
-`-smp` `integer (1 - N)` (default=`1`)::
+`--smp` `<integer> (1 - N)` ('default =' `1`)::
 
 The number of CPUs. Please use option -sockets instead.
 
-`-sockets` `integer (1 - N)` (default=`1`)::
+`--sockets` `<integer> (1 - N)` ('default =' `1`)::
 
 The number of CPU sockets.
 
-`-startdate` `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` (default=`now`)::
+`--sshkeys` `<filepath>` ::
+
+cloud-init: Setup public SSH keys (one key per line, OpenSSH format).
+
+`--startdate` `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` ('default =' `now`)::
 
 Set the initial date of the real time clock. Valid format for date are: 'now' or '2006-06-17T16:01:21' or '2006-06-17'.
 
-`-startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
+`--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
 
 Startup and shutdown behavior. Order is a non-negative number defining the general startup order. Shutdown in done with reverse ordering. Additionally you can set the 'up' or 'down' delay in seconds, which specifies a delay to wait before the next VM is started or stopped.
 
-`-tablet` `boolean` (default=`1`)::
+`--tablet` `<boolean>` ('default =' `1`)::
 
 Enable/disable the USB tablet device.
 
-`-tdf` `boolean` (default=`0`)::
+`--tdf` `<boolean>` ('default =' `0`)::
 
 Enable/disable time drift fix.
 
-`-template` `boolean` (default=`0`)::
+`--template` `<boolean>` ('default =' `0`)::
 
 Enable/disable Template.
 
-`-unused[n]` `string` ::
+`--unused[n]` `<string>` ::
 
 Reference to unused volumes. This is used internally, and should not be modified manually.
 
-`-usb[n]` `[host=]<HOSTUSBDEVICE|spice> [,usb3=<1|0>]` ::
+`--usb[n]` `[host=]<HOSTUSBDEVICE|spice> [,usb3=<1|0>]` ::
 
 Configure an USB device (n is 0 to 4).
 
-`-vcpus` `integer (1 - N)` (default=`0`)::
+`--vcpus` `<integer> (1 - N)` ('default =' `0`)::
 
 Number of hotplugged vcpus.
 
-`-vga` `(cirrus | qxl | qxl2 | qxl3 | qxl4 | serial0 | serial1 | serial2 | serial3 | std | vmware)` ::
+`--vga` `[[type=]<enum>] [,memory=<integer>]` ::
 
-Select the VGA type.
+Configure the VGA hardware.
 
-`-virtio[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_rd=<bps>] [,bps_wr=<bps>] [,cache=<none|writethrough|writeback|unsafe|directsync>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<image format>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enospc|ignore|report|stop>]` ::
+`--virtio[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::
 
 Use volume as VIRTIO hard disk (n is 0 to 15).
 
-`-watchdog` `[[model=]<i6300esb|ib700>] [,action=<reset|shutdown|poweroff|pause|debug|none>]` ::
+`--vmgenid` `<UUID>` ('default =' `1 (autogenerated)`)::
 
-Create a virtual hardware watchdog device.
+Set VM Generation ID. Use '1' to autogenerate on create or update, pass '0' to disable explicitly.
 
+`--vmstatestorage` `<string>` ::
 
+Default storage for VM state volumes/files.
 
+`--watchdog` `[[model=]<i6300esb|ib700>] [,action=<enum>]` ::
 
-*qm showcmd* `<vmid>`
+Create a virtual hardware watchdog device.
+
+*qm showcmd* `<vmid>` `[OPTIONS]`
 
 Show command line which is used to start the VM (debug info).
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
+`--pretty` `<boolean>` ('default =' `0`)::
+
+Puts each option on a new line to enhance human readability
 
+`--snapshot` `<string>` ::
 
+Fetch config values from given snapshot.
 
 *qm shutdown* `<vmid>` `[OPTIONS]`
 
@@ -841,215 +1111,212 @@ Shutdown virtual machine. This is similar to pressing the power button on a
 physical machine.This will send an ACPI event for the guest OS, which
 should then proceed to a clean shutdown.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-forceStop` `boolean` (default=`0`)::
+`--forceStop` `<boolean>` ('default =' `0`)::
 
 Make sure the VM stops.
 
-`-keepActive` `boolean` (default=`0`)::
+`--keepActive` `<boolean>` ('default =' `0`)::
 
-Do not decativate storage volumes.
+Do not deactivate storage volumes.
 
-`-skiplock` `boolean` ::
+`--skiplock` `<boolean>` ::
 
 Ignore locks - only root is allowed to use this option.
 
-`-timeout` `integer (0 - N)` ::
+`--timeout` `<integer> (0 - N)` ::
 
 Wait maximal timeout seconds.
 
-
-
 *qm snapshot* `<vmid> <snapname>` `[OPTIONS]`
 
 Snapshot a VM.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`<snapname>` `string` ::
+`<snapname>`: `<string>` ::
 
 The name of the snapshot.
 
-`-description` `string` ::
+`--description` `<string>` ::
 
 A textual description or comment.
 
-`-vmstate` `boolean` ::
+`--vmstate` `<boolean>` ::
 
 Save the vmstate
 
-
-
 *qm start* `<vmid>` `[OPTIONS]`
 
 Start virtual machine.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-machine` `(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?)` ::
+`--machine` `(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?|virt(?:-\d+\.\d+)?)` ::
 
-Specific the Qemu machine type.
+Specifies the Qemu machine type.
 
-`-migratedfrom` `string` ::
+`--migratedfrom` `<string>` ::
 
 The cluster node name.
 
-`-skiplock` `boolean` ::
+`--migration_network` `<string>` ::
+
+CIDR of the (sub) network that is used for migration.
+
+`--migration_type` `<insecure | secure>` ::
+
+Migration traffic is encrypted using an SSH tunnel by default. On secure, completely private networks this can be disabled to increase performance.
+
+`--skiplock` `<boolean>` ::
 
 Ignore locks - only root is allowed to use this option.
 
-`-stateuri` `string` ::
+`--stateuri` `<string>` ::
 
 Some command save/restore state from this location.
 
+`--targetstorage` `<string>` ::
 
-
+Target storage for the migration. (Can be '1' to use the same storage id as on the source node.)
 
 *qm status* `<vmid>` `[OPTIONS]`
 
 Show VM status.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-verbose` `boolean` ::
+`--verbose` `<boolean>` ::
 
 Verbose output format
 
-
-
-
 *qm stop* `<vmid>` `[OPTIONS]`
 
 Stop virtual machine. The qemu process will exit immediately. Thisis akin
 to pulling the power plug of a running computer and may damage the VM data
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-keepActive` `boolean` (default=`0`)::
+`--keepActive` `<boolean>` ('default =' `0`)::
 
-Do not decativate storage volumes.
+Do not deactivate storage volumes.
 
-`-migratedfrom` `string` ::
+`--migratedfrom` `<string>` ::
 
 The cluster node name.
 
-`-skiplock` `boolean` ::
+`--skiplock` `<boolean>` ::
 
 Ignore locks - only root is allowed to use this option.
 
-`-timeout` `integer (0 - N)` ::
+`--timeout` `<integer> (0 - N)` ::
 
 Wait maximal timeout seconds.
 
-
-
 *qm suspend* `<vmid>` `[OPTIONS]`
 
 Suspend virtual machine.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-skiplock` `boolean` ::
+`--skiplock` `<boolean>` ::
 
 Ignore locks - only root is allowed to use this option.
 
+`--statestorage` `<string>` ::
 
+The storage for the VM state
++
+NOTE: Requires option(s): `todisk`
+
+`--todisk` `<boolean>` ('default =' `0`)::
+
+If set, suspends the VM to disk. Will be resumed on next VM start.
 
 *qm template* `<vmid>` `[OPTIONS]`
 
 Create a Template.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-disk` `(efidisk0 | ide0 | ide1 | ide2 | ide3 | sata0 | sata1 | sata2 | sata3 | sata4 | sata5 | scsi0 | scsi1 | scsi10 | scsi11 | scsi12 | scsi13 | scsi2 | scsi3 | scsi4 | scsi5 | scsi6 | scsi7 | scsi8 | scsi9 | virtio0 | virtio1 | virtio10 | virtio11 | virtio12 | virtio13 | virtio14 | virtio15 | virtio2 | virtio3 | virtio4 | virtio5 | virtio6 | virtio7 | virtio8 | virtio9)` ::
+`--disk` `<efidisk0 | ide0 | ide1 | ide2 | ide3 | sata0 | sata1 | sata2 | sata3 | sata4 | sata5 | scsi0 | scsi1 | scsi10 | scsi11 | scsi12 | scsi13 | scsi2 | scsi3 | scsi4 | scsi5 | scsi6 | scsi7 | scsi8 | scsi9 | virtio0 | virtio1 | virtio10 | virtio11 | virtio12 | virtio13 | virtio14 | virtio15 | virtio2 | virtio3 | virtio4 | virtio5 | virtio6 | virtio7 | virtio8 | virtio9>` ::
 
 If you want to convert only 1 disk to base image.
 
-
-
-
 *qm terminal* `<vmid>` `[OPTIONS]`
 
 Open a terminal using a serial device (The VM need to have a serial device
 configured, for example 'serial0: socket')
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-iface` `(serial0 | serial1 | serial2 | serial3)` ::
-
-Select the serial device. By default we simply use the first suitable device.
+`--escape` `<string>` ('default =' `^O`)::
 
+Escape character.
 
+`--iface` `<serial0 | serial1 | serial2 | serial3>` ::
 
+Select the serial device. By default we simply use the first suitable device.
 
-*qm unlink* `<vmid> -idlist <string>` `[OPTIONS]`
+*qm unlink* `<vmid> --idlist <string>` `[OPTIONS]`
 
 Unlink/delete disk images.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-force` `boolean` ::
+`--force` `<boolean>` ::
 
 Force physical removal. Without this, we simple remove the disk from the config file and create an additional configuration entry called 'unused[n]', which contains the volume ID. Unlink of unused[n] always cause physical removal.
 
-`-idlist` `string` ::
+`--idlist` `<string>` ::
 
 A list of disk IDs you want to delete.
 
-
-
-
 *qm unlock* `<vmid>`
 
 Unlock the VM.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-
-
 *qm vncproxy* `<vmid>`
 
 Proxy VM VNC traffic to stdin/stdout
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-
-
 *qm wait* `<vmid>` `[OPTIONS]`
 
 Wait until the VM is stopped.
 
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
 
 The (unique) ID of the VM.
 
-`-timeout` `integer (1 - N)` ::
+`--timeout` `<integer> (1 - N)` ::
 
 Timeout in seconds. Default is to wait forever.
 
 
-
-