qm `<COMMAND> [ARGS] [OPTIONS]

qm 代理

'''qm guest cmd'''的别名。

qm cleanup `<vmid> <clean-shutdown> <guest-requested>

清理资源，如tap设备、虚拟GPU等。在虚拟机关闭、崩溃等情况后调用。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<clean-shutdown>`: `<boolean>

指示QEMU是否干净地关闭了。

<guest-requested>`: `<boolean>

指示关机是由客户端请求还是通过qmp执行的。

qm clone <vmid> <newid> `[OPTIONS]

创建虚拟机/模板的副本。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<newid>`: `<integer> (100 - 999999999)

克隆的VMID。

--bwlimit` <整数> (0 - N) ('默认值=' 从数据中心或存储配置克隆限制)

覆盖I/O带宽限制（以KiB/s为单位）。

--description` `<string>

新虚拟机的描述。

--format` `<qcow2 | raw | vmdk>

目标文件存储格式。仅对完全克隆有效。

--full` `<boolean>

创建所有磁盘的完整副本。克隆普通虚拟机时总是这样做。对于虚拟机模板，默认情况下我们尝试创建一个链接克隆。

--name` `<string>

为新的虚拟机设置一个名称。

--pool` `<string>

将新的虚拟机添加到指定的池中。

--snapname` `<string>

快照的名称。

--storage` `<string>

全克隆的目标存储。

--target` `<string>

目标节点。仅当原始虚拟机位于共享存储上时允许。

qm cloudinit dump `<vmid> <type>

获得自动生成的cloudinit配置。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<type>`：`<meta | network | user>

配置类型。

qm cloudinit pending `<vmid>

获取具有当前值和待处理值的cloudinit配置。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

qm cloudinit update `<vmid>

重新生成并更改cloudinit配置驱动器。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

qm config <vmid> `[OPTIONS]

获取应用了待处理配置更改的虚拟机配置。设置 'current' 参数以获取当前配置。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--current` <boolean> ('default =' 0)

获取当前值（而不是待处理的值）。

--snapshot` `<string>

从给定快照中获取配置值。

qm create <vmid> `[OPTIONS]

创建或恢复虚拟机。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--acpi` <boolean> ('default =' 1)

启用/禁用ACPI。

--affinity` `<string>

用于执行客户进程的主机核心列表，例如：0,5,8-11

--agent` `[enabled=]<1|0> [,freeze-fs-on-backup=<1|0>] [,fstrim_cloned_disks=<1|0>] [,type=<virtio|isa>]

启用/禁用与QEMU客户代理及其属性的通信。

--arch` `<aarch64 | x86_64>

虚拟处理器架构。默认为主机。

--archive` `<string>

备份存档。可以是指向.tar或.vma文件的文件系统路径（使用'-'来从标准输入中导入数据）或Proxmox存储备份卷标识符。

--args` `<string>

传递给kvm的任意参数。

--audio0` `device=<ich9-intel-hda|intel-hda|AC97> [,driver=<spice|none>]

配置音频设备，与QXL/Spice结合使用时很有用。

--autostart` <boolean> ('default =' 0)

崩溃后自动重启（当前被忽略）。

--balloon` `<integer> (0 - N)

VM中目标RAM的数量，以MiB为单位。使用零禁用气球驱动程序。

--bios` <ovmf | seabios> ('default =' seabios)

选择BIOS实现。

--boot` `[[legacy=]<[acdn]{1,4}>] [,order=<device[;device…​]>]

指定客户机启动顺序。使用 'order=' 子属性作为用法，没有键或使用 'legacy=' 已被弃用。

--bootdisk` `(ide|sata|scsi|virtio)\d+

从指定磁盘启动。不推荐使用：请改用 'boot: order=foo;bar'。

--bwlimit` <整数> (0 - N) ('默认值=' 从数据中心或存储配置恢复限制)

覆盖I/O带宽限制（以KiB/s为单位）。

--cdrom` `<volume>

这是选项-ide2的别名

--cicustom` `[meta=<volume>] [,network=<volume>] [,user=<volume>] [,vendor=<volume>]

cloud-init：指定自定义文件以替换启动时自动生成的文件。

--cipassword` `<password>

cloud-init: 分配给用户的密码。通常不建议使用此项。请改用ssh密钥。还要注意，较旧版本的cloud-init不支持哈希密码。

--citype` `<configdrive2 | nocloud | opennebula>

指定cloud-init配置格式。默认值取决于配置的操作系统类型(ostype)。我们对Linux使用`nocloud`格式，对Windows使用`configdrive2`格式。

--ciupgrade` <boolean> ('default =' 1)

cloud-init: 在第一次启动后自动进行包升级。

--ciuser` `<string>

cloud-init: 用于改变ssh密钥和密码的用户名，而不是镜像配置的默认用户。

--cores` <integer> (1 - N) ('默认值 =' 1)

每个插槽的核心数。

--cpu` `[[cputype=]<string>] [,flags=<+FLAG[;-FLAG…​]>] [,hidden=<1|0>] [,hv-vendor-id=<vendor-id>] [,phys-bits=<8-64|host>] [,reported-model=<enum>]

模拟的CPU类型。

--cpulimit` <number> (0 - 128) ('default =' 0)

CPU使用的限制。

--cpuunits` <整数> (1 - 262144)（'默认值=' cgroup v1: 1024, cgroup v2: 100）

虚拟机的CPU权重，将在cgroup v2中被限制在[1, 10000]范围内。

--description` `<string>

虚拟机的描述。在Web界面的虚拟机摘要中显示。这将作为配置文件内的注释保存。

--efidisk0` `[file=]<volume> [,efitype=<2m|4m>] [,format=<enum>] [,import-from=<source volume>] [,pre-enrolled-keys=<1|0>] [,size=<DiskSize>]

为存储EFI变量配置一个磁盘。使用特殊语法STORAGE_ID:SIZE_IN_GiB来分配一个新卷。请注意，在这里SIZE_IN_GiB被忽略，而默认的EFI变量会被复制到卷中。使用STORAGE_ID:0和’import-from’参数从现有卷中导入。

--force` `<boolean>

允许覆盖现有的虚拟机。

Note
 需要选项：`archive
--freeze` `<boolean>

在启动时冻结CPU（使用’c’监视器命令开始执行）。

--hookscript` `<string>

将在虚拟机生命周期中的不同步骤执行的脚本。

--hostpci[n]` `[[host=]<HOSTPCIID[;HOSTPCIID2…​]>] [,device-id=<hex id>] [,legacy-igd=<1|0>] [,mapping=<mapping-id>] [,mdev=<string>] [,pcie=<1|0>] [,rombar=<1|0>] [,romfile=<string>] [,sub-device-id=<hex id>] [,sub-vendor-id=<hex id>] [,vendor-id=<hex id>] [,x-vga=<1|0>]

将主机PCI设备映射到客户机中。

--hotplug` <string> ('default =' network,disk,usb)

选择性地启用热插拔功能。这是一个由逗号分隔的热插拔功能列表：'network'（网络），'disk'（磁盘），'cpu'（处理器），'memory'（内存），'usb'（USB）和 'cloudinit'（云初始化）。使用 '0' 完全禁用热插拔。使用 '1' 作为值是默认 network,disk,usb 的别名。对于机器版本 >= 7.1 且操作系统类型为 l26 或 windows > 7 的客户机，USB 热插拔是可能的。

--hugepages` `<1024 | 2 | any>

启用/禁用巨页内存。

--ide[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,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>] [,import-from=<source volume>] [,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>]

使用卷作为IDE硬盘或CD-ROM（n为0至3）。使用特殊语法STORAGE_ID:SIZE_IN_GiB为分配一个新的卷。使用STORAGE_ID:0和’import-from’参数从现有卷导入。

--ipconfig[n]` `[gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>]

cloud-init: 为相应接口指定IP地址和网关。

IP地址使用CIDR表示法，网关是可选的，但需要指定相同类型的IP地址。

特殊字符串’dhcp’可用于IP地址以使用DHCP，在这种情况下不应提供显式网关。对于IPv6，特殊字符串’auto’可用于使用无状态自动配置。这需要cloud-init 19.4或更高版本。

如果启用了cloud-init且既未指定IPv4地址也未指定IPv6地址，它将默认使用IPv4上的dhcp。

--ivshmem` `size=<integer> [,name=<string>]

虚拟机间共享内存。对于虚拟机之间或者与主机之间的直接通信很有用。

--keephugepages <boolean> ('default =' 0)

与hugepages一起使用。如果启用，hugepages在虚拟机关闭后不会被删除，并可用于后续启动。

--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>

VNC服务器的键盘布局。这个选项通常不是必需的，而且经常最好在宾主操作系统内部处理。

--kvm` <boolean> ('default =' 1)

启用/禁用 KVM 硬件虚拟化。

--live-restore` `<boolean>

在导入或恢复过程中后台运行，立即启动虚拟机。

--localtime` `<boolean>

将实时时钟 (RTC) 设置为本地时间。如果`ostype`指示为Microsoft Windows操作系统，默认情况下会启用此功能。

--lock` `<backup | clone | create | migrate | rollback | snapshot | snapshot-delete | suspended | suspending>

锁定/解锁虚拟机。

--machine` `(pc|pc(-i440fx)?-\d+(\.\d+)(\+pve\d)?(\.pxe)?|q35|pc-q35-\d+(\.\d+)(\+pve\d)?(\.pxe)?|virt(?:-\d+(\.\d+))?(\+pve\d)?)

指定QEMU的机器类型。

--memory` `[current=]<integer>

内存属性。

--migrate_downtime` <number> (0 - N) ('default =' 0.1)

为迁移设置最大容忍停机时间（以秒为单位）。

--migrate_speed` <integer> (0 - N) ('default =' 0)

设置迁移的最大速度（以MB/s为单位）。值0表示没有限制。

--name` `<string>

为虚拟机设置一个名称。仅在配置的网页界面上使用。

--nameserver` `<string>

cloud-init：为容器设置DNS服务器IP地址。如果未设置searchdomain或nameserver，创建操作将自动使用来自主机的设置。

--net[n]` `[model=]<enum> [,bridge=<bridge>] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=<XX:XX:XX:XX:XX:XX>] [,mtu=<integer>] [,queues=<integer>] [,rate=<number>] [,tag=<integer>] [,trunks=<vlanid[;vlanid…​]>] [,<model>=<macaddr>]

指定网络设备。

--numa` <boolean> ('default =' 0)

启用/禁用 NUMA。

--numa[n]` `cpus=<id[-id];…​> [,hostnodes=<id[-id];…​>] [,memory=<number>] [,policy=<preferred|bind|interleave>]

NUMA拓扑。

--onboot` <boolean> ('default =' 0)

指定虚拟机是否会在系统启动时启动。

--ostype` `<l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win10 | win11 | win7 | win8 | wvista | wxp>

指定客户操作系统。

--parallel[n]` `/dev/parport\d+|/dev/usb/lp\d+

将主机并行设备映射（n为0至2）。

--pool` `<string>

将虚拟机添加到指定的池中。

--protection` <boolean> ('default =' 0)

设置虚拟机的保护标志。这将禁用移除虚拟机和移除磁盘操作。

--reboot` <boolean> ('default =' 1)

允许重启。如果设置为'0'，则虚拟机在重启时退出。

--rng0` `[source=]</dev/urandom|/dev/random|/dev/hwrng> [,max_bytes=<integer>] [,period=<integer>]

配置基于VirtIO的随机数生成器。

--sata[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,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>] [,import-from=<source volume>] [,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>]

将卷用作SATA硬盘或CD-ROM（n为0到5）。使用特殊语法 STORAGE_ID:SIZE_IN_GiB 来分配新的卷。使用 STORAGE_ID:0 和 'import-from' 参数从现有卷导入。

--scsi[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,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>] [,import-from=<source volume>] [,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>] [,product=<product>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,vendor=<vendor>] [,werror=<enum>] [,wwn=<wwn>]

将卷作为SCSI硬盘或CD-ROM使用（n为0到30）。使用特殊语法STORAGE_ID:SIZE_IN_GiB来分配一个新卷。使用STORAGE_ID:0和’import-from’参数，从现有卷导入。

--scsihw` <lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single> ('默认=' lsi)

SCSI控制器型号

--searchdomain` `<string>

cloud-init: 为容器设置DNS搜索域。如果没有设置searchdomain或nameserver，创建操作将自动使用主机的设置。

--serial[n]` `(/dev/.+|socket)

在虚拟机内创建一个串行设备（n为0到3）

--shares` <整数> (0 - 50000) ('默认值 =' 1000)

自动调整内存分配的内存份额。数字越大，这个虚拟机获得的内存就越多。数字相对于所有其他运行中的虚拟机的权重而言。使用零禁用自动调整内存。自动调整内存由 pvestatd 完成。

--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>]

指定 SMBIOS 类型 1 字段。

--smp` <整数> (1 - N) ('默认值 =' 1)

CPU的数量。请改用选项-sockets。

--sockets` <integer> (1 - N) ('default =' 1)

CPU插槽的数量。

--spice_enhancements` `[foldersharing=<1|0>] [,videostreaming=<off|all|filter>]

为SPICE配置额外的增强功能。

--sshkeys` `<filepath>

cloud-init: 设置公共SSH密钥（每行一个密钥，OpenSSH格式）。

--start` <boolean> ('default =' 0)

在成功创建后启动虚拟机。

--startdate` (now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS) ('default =' now)

设置实时时钟的初始日期。日期的有效格式有：'now'、'2006-06-17T16:01:21' 或 '2006-06-17'。

--startup` `[[order=]\d+] [,up=\d+] [,down=\d+]

启动和关闭行为。顺序是一个非负数，用于定义一般的启动顺序。关闭时采用相反的顺序。此外，您可以设置“启动”或“关闭”延迟（以秒为单位），这指定了在启动或停止下一个虚拟机之前等待的延迟时间。

--storage` `<string>

默认存储。

--tablet` <boolean> ('default =' 1)

启用/禁用USB平板设备。

--tags` `<string>

VM的标签。这只是元信息。

--tdf` <boolean> ('default =' 0)

启用/禁用时间漂移修复。

--template` <boolean> ('default =' 0)

启用/禁用模板。

--tpmstate0` `[file=]<volume> [,import-from=<source volume>] [,size=<DiskSize>] [,version=<v1.2|v2.0>]

配置一个磁盘用于存储TPM状态。格式固定为’raw'。使用特殊语法STORAGE_ID:SIZE_IN_GiB来分配一个新的卷。注意，在这里SIZE_IN_GiB会被忽略，将会使用4 MiB作为代替。使用STORAGE_ID:0和’import-from’参数从现有卷导入。

--unique` `<boolean>

分配一个唯一的随机以太网地址。

Note
 需要选项：`archive
--unused[n]` `[file=]<volume>

引用未使用的卷。这是内部使用的，不应手动修改。

--usb[n]` `[[host=]<HOSTUSBDEVICE|spice>] [,mapping=<mapping-id>] [,usb3=<1|0>]

配置一个USB设备（n是0到4，对于机器版本>= 7.1并且操作系统类型为l26或Windows > 7，n可以达到14）。

--vcpus` <integer> (1 - N) ('default =' 0)

热插拔虚拟CPU的数量。

--vga` `[[type=]<enum>] [,clipboard=<vnc>] [,memory=<integer>]

配置VGA硬件。

--virtio[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,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>] [,import-from=<source volume>] [,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>] [,ro=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]

使用卷作为VIRTIO硬盘（n为0至15）。使用特殊语法STORAGE_ID:SIZE_IN_GiB来分配一个新的卷。使用STORAGE_ID:0和’import-from’参数从现有卷导入。

--vmgenid` <UUID> ('默认值=' 1 (自动生成))

设置 VM 生成 ID。使用 '1' 在创建或更新时自动生成，传递 '0' 明确禁用。

--vmstatestorage` `<string>

默认存储用于虚拟机状态卷/文件。

--watchdog` `[[model=]<i6300esb|ib700>] [,action=<enum>]

创建一个虚拟硬件看门狗设备。

qm delsnapshot <vmid> <snapname> `[OPTIONS]

删除一个虚拟机快照。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<snapname>：<string>

快照的名称。

--force` `<boolean>

即使移除磁盘快照失败，也从配置文件中移除。

qm destroy <vmid> `[OPTIONS]

销毁虚拟机及其使用/拥有的所有卷。移除任何特定于虚拟机的权限和防火墙规则。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--destroy-unreferenced-disks` <boolean> ('default =' 0)

如果设置了，就销毁所有在配置中未引用但与所有启用存储中的匹配VMID的磁盘。

--purge` `<boolean>

从配置中移除VMID，像是备份和复制作业以及高可用性。

--skiplock` `<boolean>

忽略锁定 - 只有root用户才允许使用此选项。

qm disk import <vmid> <source> <storage> `[OPTIONS]

将外部磁盘映像作为未使用的磁盘导入到虚拟机中。映像格式必须被 qemu-img(1) 支持。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<source>`: `<string>

要导入的磁盘映像的路径

<storage>`: `<string>

目标存储ID

--format` `<qcow2 | raw | vmdk>

目标格式

qm disk move <vmid> <disk> [<storage>] [OPTIONS]

将卷移动到不同的存储或其他虚拟机上。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<disk>`: `<efidisk0 | ide0 | ide1 | ide2 | ide3 | sata0 | sata1 | sata2 | sata3 | sata4 | sata5 | scsi0 | scsi1 | scsi10 | scsi11 | scsi12 | scsi13 | scsi14 | scsi15 | scsi16 | scsi17 | scsi18 | scsi19 | scsi2 | scsi20 | scsi21 | scsi22 | scsi23 | scsi24 | scsi25 | scsi26 | scsi27 | scsi28 | scsi29 | scsi3 | scsi30 | scsi4 | scsi5 | scsi6 | scsi7 | scsi8 | scsi9 | tpmstate0 | unused0 | unused1 | unused10 | unused100 | unused101 | unused102 | unused103 | unused104 | unused105 | unused106 | unused107 | unused108 | unused109 | unused11 | unused110 | unused111 | unused112 | unused113 | unused114 | unused115 | unused116 | unused117 | unused118 | unused119 | unused12 | unused120 | unused121 | unused122 | unused123 | unused124 | unused125 | unused126 | unused127 | unused128 | unused129 | unused13 | unused130 | unused131 | unused132 | unused133 | unused134 | unused135 | unused136 | unused137 | unused138 | unused139 | unused14 | unused140 | unused141 | unused142 | unused143 | unused144 | unused145 | unused146 | unused147 | unused148 | unused149 | unused15 | unused150 | unused151 | unused152 | unused153 | unused154 | unused155 | unused156 | unused157 | unused158 | unused159 | unused16 | unused160 | unused161 | unused162 | unused163 | unused164 | unused165 | unused166 | unused167 | unused168 | unused169 | unused17 | unused170 | unused171 | unused172 | unused173 | unused174 | unused175 | unused176 | unused177 | unused178 | unused179 | unused18 | unused180 | unused181 | unused182 | unused183 | unused184 | unused185 | unused186 | unused187 | unused188 | unused189 | unused19 | unused190 | unused191 | unused192 | unused193 | unused194 | unused195 | unused196 | unused197 | unused198 | unused199 | unused2 | unused20 | unused200 | unused201 | unused202 | unused203 | unused204 | unused205 | unused206 | unused207 | unused208 | unused209 | unused21 | unused210 | unused211 | unused212 | unused213 | unused214 | unused215 | unused216 | unused217 | unused218 | unused219 | unused22 | unused220 | unused221 | unused222 | unused223 | unused224 | unused225 | unused226 | unused227 | unused228 | unused229 | unused23 | unused230 | unused231 | unused232 | unused233 | unused234 | unused235 | unused236 | unused237 | unused238 | unused239 | unused24 | unused240 | unused241 | unused242 | unused243 | unused244 | unused245 | unused246 | unused247 | unused248 | unused249 | unused25 | unused250 | unused251 | unused252 | unused253 | unused254 | unused255 | unused26 | unused27 | unused28 | unused29 | unused3 | unused30 | unused31 | unused32 | unused33 | unused34 | unused35 | unused36 | unused37 | unused38 | unused39 | unused4 | unused40 | unused41 | unused42 | unused43 | unused44 | unused45 | unused46 | unused47 | unused48 | unused49 | unused5 | unused50 | unused51 | unused52 | unused53 | unused54 | unused55 | unused56 | unused57 | unused58 | unused59 | unused6 | unused60 | unused61 | unused62 | unused63 | unused64 | unused65 | unused66 | unused67 | unused68 | unused69 | unused7 | unused70 | unused71 | unused72 | unused73 | unused74 | unused75 | unused76 | unused77 | unused78 | unused79 | unused8 | unused80 | unused81 | unused82 | unused83 | unused84 | unused85 | unused86 | unused87 | unused88 | unused89 | unused9 | unused90 | unused91 | unused92 | unused93 | unused94 | unused95 | unused96 | unused97 | unused98 | unused99 | virtio0 | virtio1 | virtio10 | virtio11 | virtio12 | virtio13 | virtio14 | virtio15 | virtio2 | virtio3 | virtio4 | virtio5 | virtio6 | virtio7 | virtio8 | virtio9>

你想要移动的磁盘。

<storage>`: `<string>

目标存储。

--bwlimit` <整数> (0 - N) ('默认值=' 从数据中心或存储配置移除限制)

覆盖I/O带宽限制（以KiB/s为单位）。

--delete` <boolean> ('default =' 0)

在成功复制后删除原始磁盘。默认情况下，原始磁盘会被保留为未使用的磁盘。

--digest` `<string>

如果当前配置文件的SHA1摘要不同，则阻止更改。这可以用来防止并发修改。

--format` `<qcow2 | raw | vmdk>

目标格式。

--target-digest` `<string>

如果目标虚拟机的当前配置文件具有不同的SHA1摘要，则阻止更改。这可以用来检测并发修改。

--target-disk` `<efidisk0 | ide0 | ide1 | ide2 | ide3 | sata0 | sata1 | sata2 | sata3 | sata4 | sata5 | scsi0 | scsi1 | scsi10 | scsi11 | scsi12 | scsi13 | scsi14 | scsi15 | scsi16 | scsi17 | scsi18 | scsi19 | scsi2 | scsi20 | scsi21 | scsi22 | scsi23 | scsi24 | scsi25 | scsi26 | scsi27 | scsi28 | scsi29 | scsi3 | scsi30 | scsi4 | scsi5 | scsi6 | scsi7 | scsi8 | scsi9 | tpmstate0 | unused0 | unused1 | unused10 | unused100 | unused101 | unused102 | unused103 | unused104 | unused105 | unused106 | unused107 | unused108 | unused109 | unused11 | unused110 | unused111 | unused112 | unused113 | unused114 | unused115 | unused116 | unused117 | unused118 | unused119 | unused12 | unused120 | unused121 | unused122 | unused123 | unused124 | unused125 | unused126 | unused127 | unused128 | unused129 | unused13 | unused130 | unused131 | unused132 | unused133 | unused134 | unused135 | unused136 | unused137 | unused138 | unused139 | unused14 | unused140 | unused141 | unused142 | unused143 | unused144 | unused145 | unused146 | unused147 | unused148 | unused149 | unused15 | unused150 | unused151 | unused152 | unused153 | unused154 | unused155 | unused156 | unused157 | unused158 | unused159 | unused16 | unused160 | unused161 | unused162 | unused163 | unused164 | unused165 | unused166 | unused167 | unused168 | unused169 | unused17 | unused170 | unused171 | unused172 | unused173 | unused174 | unused175 | unused176 | unused177 | unused178 | unused179 | unused18 | unused180 | unused181 | unused182 | unused183 | unused184 | unused185 | unused186 | unused187 | unused188 | unused189 | unused19 | unused190 | unused191 | unused192 | unused193 | unused194 | unused195 | unused196 | unused197 | unused198 | unused199 | unused2 | unused20 | unused200 | unused201 | unused202 | unused203 | unused204 | unused205 | unused206 | unused207 | unused208 | unused209 | unused21 | unused210 | unused211 | unused212 | unused213 | unused214 | unused215 | unused216 | unused217 | unused218 | unused219 | unused22 | unused220 | unused221 | unused222 | unused223 | unused224 | unused225 | unused226 | unused227 | unused228 | unused229 | unused23 | unused230 | unused231 | unused232 | unused233 | unused234 | unused235 | unused236 | unused237 | unused238 | unused239 | unused24 | unused240 | unused241 | unused242 | unused243 | unused244 | unused245 | unused246 | unused247 | unused248 | unused249 | unused25 | unused250 | unused251 | unused252 | unused253 | unused254 | unused255 | unused26 | unused27 | unused28 | unused29 | unused3 | unused30 | unused31 | unused32 | unused33 | unused34 | unused35 | unused36 | unused37 | unused38 | unused39 | unused4 | unused40 | unused41 | unused42 | unused43 | unused44 | unused45 | unused46 | unused47 | unused48 | unused49 | unused5 | unused50 | unused51 | unused52 | unused53 | unused54 | unused55 | unused56 | unused57 | unused58 | unused59 | unused6 | unused60 | unused61 | unused62 | unused63 | unused64 | unused65 | unused66 | unused67 | unused68 | unused69 | unused7 | unused70 | unused71 | unused72 | unused73 | unused74 | unused75 | unused76 | unused77 | unused78 | unused79 | unused8 | unused80 | unused81 | unused82 | unused83 | unused84 | unused85 | unused86 | unused87 | unused88 | unused89 | unused9 | unused90 | unused91 | unused92 | unused93 | unused94 | unused95 | unused96 | unused97 | unused98 | unused99 | virtio0 | virtio1 | virtio10 | virtio11 | virtio12 | virtio13 | virtio14 | virtio15 | virtio2 | virtio3 | virtio4 | virtio5 | virtio6 | virtio7 | virtio8 | virtio9>

磁盘将被移动到目标虚拟机上的配置键（例如，ide0或scsi1）。默认为源磁盘键。

--target-vmid` `<integer> (100 - 999999999)

虚拟机的（唯一）ID。

qm disk rescan `[OPTIONS]

重新扫描所有存储空间并且更新磁盘大小和未使用的磁盘镜像。

--dryrun` <boolean> ('default =' 0)

不要实际将更改写入到 VM 配置中。

--vmid` `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

qm disk resize <vmid> <disk> <size> [OPTIONS]

扩展卷大小。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<disk>: <efidisk0 | ide0 | ide1 | ide2 | ide3 | sata0 | sata1 | sata2 | sata3 | sata4 | sata5 | scsi0 | scsi1 | scsi10 | scsi11 | scsi12 | scsi13 | scsi14 | scsi15 | scsi16 | scsi17 | scsi18 | scsi19 | scsi2 | scsi20 | scsi21 | scsi22 | scsi23 | scsi24 | scsi25 | scsi26 | scsi27 | scsi28 | scsi29 | scsi3 | scsi30 | scsi4 | scsi5 | scsi6 | scsi7 | scsi8 | scsi9 | tpmstate0 | virtio0 | virtio1 | virtio10 | virtio11 | virtio12 | virtio13 | virtio14 | virtio15 | virtio2 | virtio3 | virtio4 | virtio5 | virtio6 | virtio7 | virtio8 | virtio9>

你想要调整大小的磁盘。

<size>`: `+?\d+(\.\d+)?[KMGT]?

新的尺寸。使用 + 符号时，该值将被添加到卷的实际大小中；如果不使用，则该值被视为绝对值。不支持缩小磁盘尺寸。

--digest` `<string>

如果当前配置文件的SHA1摘要不同，则防止更改。这可用于防止并发修改。

--skiplock` `<boolean>

忽略锁定 - 只有root用户才允许使用此选项。

qm disk unlink <vmid> --idlist <string> `[OPTIONS]

卸载/删除磁盘映像。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--force` `<boolean>

强制物理删除。没有这个操作，我们只是从配置文件中移除磁盘，并创建一个名为’unused[n]'的额外配置项，其中包含卷ID。解除unused[n]的链接总会导致物理删除。

--idlist` `<string>

你想要删除的磁盘ID列表。

qm guest cmd `<vmid> <command>

执行 QEMU 客户端代理命令。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<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>

QGA指令。

qm guest exec <vmid> [<extra-args>] `[OPTIONS]

通过客户端代理执行给定的命令

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<extra-args>`: `<array>

额外参数作为数组

--pass-stdin` <boolean> ('default =' 0)

当设置时，读取STDIN直到EOF并通过’input-data’转发给客户代理（通常被视为启动由客户代理的进程的STDIN）。允许最大1 MiB。

--synchronous <boolean> (default = 1)

如果设置为关闭，立即返回pid，而不是等待命令结束或超时。

--timeout` <integer> (0 - N) ('default =' 30)

等待命令同步完成的最大时间。如果到达此时间，将返回pid。设置为0以停用此功能。

qm guest exec-status `<vmid> <pid>

获取由客户端代理启动的给定pid的状态

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<pid>`: `<integer>

要查询的PID

qm guest passwd <vmid> <username> `[OPTIONS]

将指定用户的密码设置为给定的密码

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<username>`：`<string>

要为其设置密码的用户。

--crypted` <boolean> ('default =' 0)

如果密码已经通过crypt()处理，则设置为1

qm help `[OPTIONS]

获得指定命令的帮助信息。

--extra-args` `<array>

为特定命令显示帮助信息

--verbose` `<boolean>

详细输出格式。

qm import <vmid> <source> --storage <string> `[OPTIONS]

从支持的导入源（例如ESXi存储）导入一个外来虚拟客户端。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<source>`: `<string>

导入源卷的ID。

--acpi` <boolean> ('default =' 1)

启用/禁用ACPI。

--affinity` `<string>

用于执行客户进程的主机核心列表，例如：0,5,8-11

--agent` `[enabled=]<1|0> [,freeze-fs-on-backup=<1|0>] [,fstrim_cloned_disks=<1|0>] [,type=<virtio|isa>]

启用/禁用与QEMU客户代理及其属性的通信。

--arch` `<aarch64 | x86_64>

虚拟处理器架构。默认为主机。

--args` `<string>

传递给kvm的任意参数。

--audio0` `device=<ich9-intel-hda|intel-hda|AC97> [,driver=<spice|none>]

配置音频设备，与QXL/Spice结合使用时很有用。

--autostart` <boolean> ('default =' 0)

崩溃后自动重启（当前被忽略）。

--balloon` `<integer> (0 - N)

VM中目标RAM的数量，以MiB为单位。使用零禁用气球驱动程序。

--bios` <ovmf | seabios> ('default =' seabios)

选择BIOS实现。

--boot` `[[legacy=]<[acdn]{1,4}>] [,order=<device[;device…​]>]

指定客户机启动顺序。使用 'order=' 子属性作为用法，没有键或使用 'legacy=' 已被弃用。

--bootdisk` `(ide|sata|scsi|virtio)\d+

从指定磁盘启动。不推荐使用：请改用 'boot: order=foo;bar'。

--cdrom` `<volume>

这是选项-ide2的别名

--cicustom` `[meta=<volume>] [,network=<volume>] [,user=<volume>] [,vendor=<volume>]

cloud-init：指定自定义文件以替换启动时自动生成的文件。

--cipassword` `<string>

cloud-init: 分配给用户的密码。通常不建议使用此项。请改用ssh密钥。还要注意，较旧版本的cloud-init不支持哈希密码。

--citype` `<configdrive2 | nocloud | opennebula>

指定cloud-init配置格式。默认值取决于配置的操作系统类型(ostype)。我们对Linux使用`nocloud`格式，对Windows使用`configdrive2`格式。

--ciupgrade` <boolean> ('default =' 1)

cloud-init: 在第一次启动后自动进行包升级。

--ciuser` `<string>

cloud-init: 用于改变ssh密钥和密码的用户名，而不是镜像配置的默认用户。

--cores` <integer> (1 - N) ('默认值 =' 1)

每个插槽的核心数。

--cpu` `[[cputype=]<string>] [,flags=<+FLAG[;-FLAG…​]>] [,hidden=<1|0>] [,hv-vendor-id=<vendor-id>] [,phys-bits=<8-64|host>] [,reported-model=<enum>]

模拟的CPU类型。

--cpulimit` <number> (0 - 128) ('default =' 0)

CPU使用的限制。

--cpuunits` <整数> (1 - 262144)（'默认值=' cgroup v1: 1024, cgroup v2: 100）

虚拟机的CPU权重，将在cgroup v2中被限制在[1, 10000]范围内。

--delete` `<string>

你想要删除的设置列表。

--description` `<string>

虚拟机的描述。在Web界面的虚拟机摘要中显示。这将作为配置文件内的注释保存。

--dryrun` <boolean> ('default =' 0)

显示创建命令并退出，不执行任何操作。

--efidisk0` `[file=]<volume> [,efitype=<2m|4m>] [,format=<enum>] [,pre-enrolled-keys=<1|0>] [,size=<DiskSize>]

配置磁盘以存储EFI变量。

--format` `<qcow2 | raw | vmdk>

目标格式

--freeze` `<boolean>

在启动时冻结CPU（使用’c’监视器命令开始执行）。

--hookscript` `<string>

将在虚拟机生命周期中的不同步骤执行的脚本。

--hostpci[n]` `[[host=]<HOSTPCIID[;HOSTPCIID2…​]>] [,device-id=<hex id>] [,legacy-igd=<1|0>] [,mapping=<mapping-id>] [,mdev=<string>] [,pcie=<1|0>] [,rombar=<1|0>] [,romfile=<string>] [,sub-device-id=<hex id>] [,sub-vendor-id=<hex id>] [,vendor-id=<hex id>] [,x-vga=<1|0>]

将主机PCI设备映射到客户机中。

--hotplug` <string> ('default =' network,disk,usb)

选择性地启用热插拔功能。这是一个由逗号分隔的热插拔功能列表：'network'（网络），'disk'（磁盘），'cpu'（处理器），'memory'（内存），'usb'（USB）和 'cloudinit'（云初始化）。使用 '0' 完全禁用热插拔。使用 '1' 作为值是默认 network,disk,usb 的别名。对于机器版本 >= 7.1 且操作系统类型为 l26 或 windows > 7 的客户机，USB 热插拔是可能的。

--hugepages` `<1024 | 2 | any>

启用/禁用巨页内存。

--ide[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,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>]

将卷作为IDE硬盘或CD-ROM使用（n为0至3）。

--ipconfig[n]` `[gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>]

cloud-init: 为相应接口指定IP地址和网关。

IP地址使用CIDR表示法，网关是可选的，但需要指定相同类型的IP地址。

特殊字符串’dhcp’可用于IP地址以使用DHCP，在这种情况下不应提供显式网关。对于IPv6，特殊字符串’auto’可用于使用无状态自动配置。这需要cloud-init 19.4或更高版本。

如果启用了cloud-init且既未指定IPv4地址也未指定IPv6地址，它将默认使用IPv4上的dhcp。

--ivshmem` `size=<integer> [,name=<string>]

虚拟机间共享内存。对于虚拟机之间或者与主机之间的直接通信很有用。

--keephugepages <boolean> ('default =' 0)

与hugepages一起使用。如果启用，hugepages在虚拟机关闭后不会被删除，并可用于后续启动。

--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>

VNC服务器的键盘布局。这个选项通常不是必需的，而且经常最好在宾主操作系统内部处理。

--kvm` <boolean> ('default =' 1)

启用/禁用 KVM 硬件虚拟化。

--live-import` <boolean> ('default =' 0)

立即启动虚拟机，并在后台复制数据。

--localtime` `<boolean>

将实时时钟 (RTC) 设置为本地时间。如果`ostype`指示为Microsoft Windows操作系统，默认情况下会启用此功能。

--lock` `<backup | clone | create | migrate | rollback | snapshot | snapshot-delete | suspended | suspending>

锁定/解锁虚拟机。

--machine` `(pc|pc(-i440fx)?-\d+(\.\d+)(\+pve\d)?(\.pxe)?|q35|pc-q35-\d+(\.\d+)(\+pve\d)?(\.pxe)?|virt(?:-\d+(\.\d+))?(\+pve\d)?)

指定QEMU的机器类型。

--memory` `[current=]<integer>

内存属性。

--migrate_downtime` <number> (0 - N) ('default =' 0.1)

为迁移设置最大容忍停机时间（以秒为单位）。

--migrate_speed` <integer> (0 - N) ('default =' 0)

设置迁移的最大速度（以MB/s为单位）。值0表示没有限制。

--name` `<string>

为虚拟机设置一个名称。仅在配置的网页界面上使用。

--nameserver` `<string>

cloud-init：为容器设置DNS服务器IP地址。如果未设置searchdomain或nameserver，创建操作将自动使用来自主机的设置。

--net[n]` `[model=]<enum> [,bridge=<bridge>] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=<XX:XX:XX:XX:XX:XX>] [,mtu=<integer>] [,queues=<integer>] [,rate=<number>] [,tag=<integer>] [,trunks=<vlanid[;vlanid…​]>] [,<model>=<macaddr>]

指定网络设备。

--numa` <boolean> ('default =' 0)

启用/禁用 NUMA。

--numa[n]` `cpus=<id[-id];…​> [,hostnodes=<id[-id];…​>] [,memory=<number>] [,policy=<preferred|bind|interleave>]

NUMA拓扑。

--onboot` <boolean> ('default =' 0)

指定虚拟机是否会在系统启动时启动。

--ostype` `<l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win10 | win11 | win7 | win8 | wvista | wxp>

指定客户操作系统。

--parallel[n]` `/dev/parport\d+|/dev/usb/lp\d+

将主机并行设备映射（n为0至2）。

--protection` <boolean> ('default =' 0)

设置虚拟机的保护标志。这将禁用移除虚拟机和移除磁盘操作。

--reboot` <boolean> ('default =' 1)

允许重启。如果设置为'0'，则虚拟机在重启时退出。

--rng0` `[source=]</dev/urandom|/dev/random|/dev/hwrng> [,max_bytes=<integer>] [,period=<integer>]

配置基于VirtIO的随机数生成器。

--sata[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,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>]

将卷作为SATA硬盘或CD-ROM使用（n为0至5）。

--scsi[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,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>] [,product=<product>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,vendor=<vendor>] [,werror=<enum>] [,wwn=<wwn>]

将卷作为SCSI硬盘或CD-ROM使用（n为0至30）。

--scsihw` <lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single> ('默认=' lsi)

SCSI控制器型号

--searchdomain` `<string>

cloud-init: 为容器设置DNS搜索域。如果没有设置searchdomain或nameserver，创建操作将自动使用主机的设置。

--serial[n]` `(/dev/.+|socket)

在虚拟机内创建一个串行设备（n为0到3）

--shares` <整数> (0 - 50000) ('默认值 =' 1000)

自动调整内存分配的内存份额。数字越大，这个虚拟机获得的内存就越多。数字相对于所有其他运行中的虚拟机的权重而言。使用零禁用自动调整内存。自动调整内存由 pvestatd 完成。

--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>]

指定 SMBIOS 类型 1 字段。

--smp` <整数> (1 - N) ('默认值 =' 1)

CPU的数量。请改用选项-sockets。

--sockets` <integer> (1 - N) ('default =' 1)

CPU插槽的数量。

--spice_enhancements` `[foldersharing=<1|0>] [,videostreaming=<off|all|filter>]

为SPICE配置额外的增强功能。

--sshkeys` `<string>

cloud-init: 设置公共SSH密钥（每行一个密钥，OpenSSH格式）。

--startdate` (now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS) ('default =' now)

设置实时时钟的初始日期。日期的有效格式有：'now'、'2006-06-17T16:01:21' 或 '2006-06-17'。

--startup` `[[order=]\d+] [,up=\d+] [,down=\d+]

启动和关闭行为。顺序是一个非负数，用于定义一般的启动顺序。关闭时采用相反的顺序。此外，您可以设置“启动”或“关闭”延迟（以秒为单位），这指定了在启动或停止下一个虚拟机之前等待的延迟时间。

--storage` `<string>

默认存储。

--tablet` <boolean> ('default =' 1)

启用/禁用USB平板设备。

--tags` `<string>

VM的标签。这只是元信息。

--tdf` <boolean> ('default =' 0)

启用/禁用时间漂移修复。

--template` <boolean> ('default =' 0)

启用/禁用模板。

--tpmstate0` `[file=]<volume> [,size=<DiskSize>] [,version=<v1.2|v2.0>]

为存储TPM状态配置一个磁盘。格式固定为’raw'。

--unused[n]` `[file=]<volume>

引用未使用的卷。这是内部使用的，不应手动修改。

--usb[n]` `[[host=]<HOSTUSBDEVICE|spice>] [,mapping=<mapping-id>] [,usb3=<1|0>]

配置一个USB设备（n是0到4，对于机器版本>= 7.1并且操作系统类型为l26或Windows > 7，n可以达到14）。

--vcpus` <integer> (1 - N) ('default =' 0)

热插拔虚拟CPU的数量。

--vga` `[[type=]<enum>] [,clipboard=<vnc>] [,memory=<integer>]

配置VGA硬件。

--virtio[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,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>] [,ro=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]

将卷作为 VIRTIO 硬盘使用（n 为 0 至 15）。

--vmgenid` <UUID> ('默认值=' 1 (自动生成))

设置 VM 生成 ID。使用 '1' 在创建或更新时自动生成，传递 '0' 明确禁用。

--vmstatestorage` `<string>

默认存储用于虚拟机状态卷/文件。

--watchdog` `[[model=]<i6300esb|ib700>] [,action=<enum>]

创建一个虚拟硬件看门狗设备。

'qm importdisk' 是命令行操作，所以我会原样返回这一内容：qm importdisk

'qm disk import’的别名。

qm importovf <vmid> <manifest> <storage> `[OPTIONS]

使用从OVF清单中读取的参数创建新的虚拟机

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<manifest>`: `<string>

OVF文件的路径

<storage>`: `<string>

目标存储ID

--dryrun` `<boolean>

打印提取的OVF参数的解析表示，但不创建虚拟机

--format` `<qcow2 | raw | vmdk>

目标格式

qm list `[OPTIONS]

虚拟机索引（每个节点）。

--full` `<boolean>

确定活跃虚拟机的全部状态。

qm listsnapshot `<vmid>

列出所有快照。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

qm migrate <vmid> <target> `[OPTIONS]

迁移虚拟机。创建一个新的迁移任务。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<target>：<string>

目标节点。

--bwlimit <整数> (0 - N) ('默认值=' 数据中心或存储配置的迁移限制)

覆盖I/O带宽限制（以KiB/s为单位）。

--force` `<boolean>

允许迁移使用本地设备的虚拟机。只有根用户可以使用此选项。

--migration_network` `<string>

用于迁移的（子）网络的CIDR。

--migration_type` `<insecure | secure>

默认情况下，迁移流量通过SSH隧道加密。在安全、完全私有的网络上，可以禁用此功能以提高性能。

--online` `<boolean>

如果虚拟机正在运行，请使用在线/实时迁移。如果虚拟机已停止，则忽略此操作。

--targetstorage` `<string>

从源存储到目标存储的映射。只提供单个存储 ID 会将所有源存储映射到该存储。提供特殊值 '1' 将把每个源存储映射到自身。

--with-local-disks` `<boolean>

为本地磁盘启用实时存储迁移

qm monitor `<vmid>

进入QEMU监视器界面。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

qm move-disk

'qm disk move’的别名。

qm move_disk

'qm disk move’的别名。

qm mtunnel

由qmigrate使用 - 请勿手动使用。

qm nbdstop `<vmid>

停止嵌入式nbd服务器。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

qm pending `<vmid>

获取具有当前值和待定值的虚拟机配置。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

qm reboot <vmid> `[OPTIONS]

通过关闭虚拟机并再次启动它来重启虚拟机。适用于待处理的更改。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--timeout` `<integer> (0 - N)

等待最大超时秒数以进行关机。

qm remote-migrate <vmid> [<target-vmid>] <target-endpoint> --target-bridge <string> --target-storage <string> `[OPTIONS]

将虚拟机迁移到远程集群。创建一个新的迁移任务。实验性功能！

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<target-vmid>`: `<integer> (100 - 999999999)

虚拟机的（唯一）ID。

<target-endpoint>`: `apitoken=<user@realm!token=SECRET> ,host=<ADDRESS> [,fingerprint=<FINGERPRINT>] [,port=<PORT>]

远程目标端点

--bwlimit <整数> (0 - N) ('默认值=' 数据中心或存储配置的迁移限制)

覆盖I/O带宽限制（以KiB/s为单位）。

--delete` <boolean> ('default =' 0)

在成功迁移后删除原始虚拟机及相关数据。默认情况下，原始虚拟机会被保留在源集群中，并处于停止状态。

--online` `<boolean>

如果虚拟机正在运行，请使用在线/实时迁移。如果虚拟机已停止，则忽略此操作。

--target-bridge` `<string>

从源到目标桥接的映射。仅提供单个桥接ID将所有源桥接映射到该桥接。提供特殊值'1’将使每个源桥接自映射至其自身。

--target-storage` `<string>

从源存储到目标存储的映射。只提供单个存储 ID 会将所有源存储映射到该存储。提供特殊值 '1' 将把每个源存储映射到自身。

重新扫描存储设备

"qm disk rescan"的别名。

qm reset <vmid> `[OPTIONS]

重置虚拟机。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--skiplock` `<boolean>

忽略锁定 - 只有root用户才允许使用此选项。

qm 调整大小

'qm disk resize’的别名。

qm resume <vmid> `[OPTIONS]

恢复虚拟机。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--nocheck` `<boolean>

没有可用描述

--skiplock` `<boolean>

忽略锁定 - 只有root用户才允许使用此选项。

qm rollback <vmid> <snapname> `[OPTIONS]

将虚拟机状态回滚到指定快照。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<snapname>：<string>

快照的名称。

--start` <boolean> ('default =' 0)

是否应在回滚成功后启动虚拟机。（注意：如果快照包含RAM，则虚拟机将自动启动。）

qm sendkey <vmid> <key> `[OPTIONS]

向虚拟机发送按键事件。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<key>`: `<string>

密钥（QEMU监控器编码）。

--skiplock` `<boolean>

忽略锁定 - 只有root用户才允许使用此选项。

qm set <vmid> `[OPTIONS]

设置虚拟机选项（同步API）- 对于涉及热插拔或存储分配的任何操作，你应该考虑使用POST方法来代替。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--acpi` <boolean> ('default =' 1)

启用/禁用ACPI。

--affinity` `<string>

用于执行客户进程的主机核心列表，例如：0,5,8-11

--agent` `[enabled=]<1|0> [,freeze-fs-on-backup=<1|0>] [,fstrim_cloned_disks=<1|0>] [,type=<virtio|isa>]

启用/禁用与QEMU客户代理及其属性的通信。

--arch` `<aarch64 | x86_64>

虚拟处理器架构。默认为主机。

--args` `<string>

传递给kvm的任意参数。

--audio0` `device=<ich9-intel-hda|intel-hda|AC97> [,driver=<spice|none>]

配置音频设备，与QXL/Spice结合使用时很有用。

--autostart` <boolean> ('default =' 0)

崩溃后自动重启（当前被忽略）。

--balloon` `<integer> (0 - N)

VM中目标RAM的数量，以MiB为单位。使用零禁用气球驱动程序。

--bios` <ovmf | seabios> ('default =' seabios)

选择BIOS实现。

--boot` `[[legacy=]<[acdn]{1,4}>] [,order=<device[;device…​]>]

指定客户机启动顺序。使用 'order=' 子属性作为用法，没有键或使用 'legacy=' 已被弃用。

--bootdisk` `(ide|sata|scsi|virtio)\d+

从指定磁盘启动。不推荐使用：请改用 'boot: order=foo;bar'。

--cdrom` `<volume>

这是选项-ide2的别名

--cicustom` `[meta=<volume>] [,network=<volume>] [,user=<volume>] [,vendor=<volume>]

cloud-init：指定自定义文件以替换启动时自动生成的文件。

--cipassword` `<password>

cloud-init: 分配给用户的密码。通常不建议使用此项。请改用ssh密钥。还要注意，较旧版本的cloud-init不支持哈希密码。

--citype` `<configdrive2 | nocloud | opennebula>

指定cloud-init配置格式。默认值取决于配置的操作系统类型(ostype)。我们对Linux使用`nocloud`格式，对Windows使用`configdrive2`格式。

--ciupgrade` <boolean> ('default =' 1)

cloud-init: 在第一次启动后自动进行包升级。

--ciuser` `<string>

cloud-init: 用于改变ssh密钥和密码的用户名，而不是镜像配置的默认用户。

--cores` <integer> (1 - N) ('默认值 =' 1)

每个插槽的核心数。

--cpu` `[[cputype=]<string>] [,flags=<+FLAG[;-FLAG…​]>] [,hidden=<1|0>] [,hv-vendor-id=<vendor-id>] [,phys-bits=<8-64|host>] [,reported-model=<enum>]

模拟的CPU类型。

--cpulimit` <number> (0 - 128) ('default =' 0)

CPU使用的限制。

--cpuunits` <整数> (1 - 262144)（'默认值=' cgroup v1: 1024, cgroup v2: 100）

虚拟机的CPU权重，将在cgroup v2中被限制在[1, 10000]范围内。

--delete` `<string>

你想要删除的设置列表。

--description` `<string>

虚拟机的描述。在Web界面的虚拟机摘要中显示。这将作为配置文件内的注释保存。

--digest` `<string>

如果当前配置文件的SHA1摘要不同，则防止更改。这可用于防止并发修改。

--efidisk0` `[file=]<volume> [,efitype=<2m|4m>] [,format=<enum>] [,import-from=<source volume>] [,pre-enrolled-keys=<1|0>] [,size=<DiskSize>]

为存储EFI变量配置一个磁盘。使用特殊语法STORAGE_ID:SIZE_IN_GiB来分配一个新卷。请注意，在这里SIZE_IN_GiB被忽略，而默认的EFI变量会被复制到卷中。使用STORAGE_ID:0和’import-from’参数从现有卷中导入。

--force` `<boolean>

强制物理删除。没有这个操作，我们只是从配置文件中移除磁盘，并创建一个名为’unused[n]'的额外配置项，其中包含卷ID。解除unused[n]的链接总会导致物理删除。

Note
 要求提供选项：`delete
--freeze` `<boolean>

在启动时冻结CPU（使用’c’监视器命令开始执行）。

--hookscript` `<string>

将在虚拟机生命周期中的不同步骤执行的脚本。

--hostpci[n]` `[[host=]<HOSTPCIID[;HOSTPCIID2…​]>] [,device-id=<hex id>] [,legacy-igd=<1|0>] [,mapping=<mapping-id>] [,mdev=<string>] [,pcie=<1|0>] [,rombar=<1|0>] [,romfile=<string>] [,sub-device-id=<hex id>] [,sub-vendor-id=<hex id>] [,vendor-id=<hex id>] [,x-vga=<1|0>]

将主机PCI设备映射到客户机中。

--hotplug` <string> ('default =' network,disk,usb)

选择性地启用热插拔功能。这是一个由逗号分隔的热插拔功能列表：'network'（网络），'disk'（磁盘），'cpu'（处理器），'memory'（内存），'usb'（USB）和 'cloudinit'（云初始化）。使用 '0' 完全禁用热插拔。使用 '1' 作为值是默认 network,disk,usb 的别名。对于机器版本 >= 7.1 且操作系统类型为 l26 或 windows > 7 的客户机，USB 热插拔是可能的。

--hugepages` `<1024 | 2 | any>

启用/禁用巨页内存。

--ide[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,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>] [,import-from=<source volume>] [,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>]

使用卷作为IDE硬盘或CD-ROM（n为0至3）。使用特殊语法STORAGE_ID:SIZE_IN_GiB为分配一个新的卷。使用STORAGE_ID:0和’import-from’参数从现有卷导入。

--ipconfig[n]` `[gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>]

cloud-init: 为相应接口指定IP地址和网关。

IP地址使用CIDR表示法，网关是可选的，但需要指定相同类型的IP地址。

特殊字符串’dhcp’可用于IP地址以使用DHCP，在这种情况下不应提供显式网关。对于IPv6，特殊字符串’auto’可用于使用无状态自动配置。这需要cloud-init 19.4或更高版本。

如果启用了cloud-init且既未指定IPv4地址也未指定IPv6地址，它将默认使用IPv4上的dhcp。

--ivshmem` `size=<integer> [,name=<string>]

虚拟机间共享内存。对于虚拟机之间或者与主机之间的直接通信很有用。

--keephugepages <boolean> ('default =' 0)

与hugepages一起使用。如果启用，hugepages在虚拟机关闭后不会被删除，并可用于后续启动。

--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>

VNC服务器的键盘布局。这个选项通常不是必需的，而且经常最好在宾主操作系统内部处理。

--kvm` <boolean> ('default =' 1)

启用/禁用 KVM 硬件虚拟化。

--localtime` `<boolean>

将实时时钟 (RTC) 设置为本地时间。如果`ostype`指示为Microsoft Windows操作系统，默认情况下会启用此功能。

--lock` `<backup | clone | create | migrate | rollback | snapshot | snapshot-delete | suspended | suspending>

锁定/解锁虚拟机。

--machine` `(pc|pc(-i440fx)?-\d+(\.\d+)(\+pve\d)?(\.pxe)?|q35|pc-q35-\d+(\.\d+)(\+pve\d)?(\.pxe)?|virt(?:-\d+(\.\d+))?(\+pve\d)?)

指定QEMU的机器类型。

--memory` `[current=]<integer>

内存属性。

--migrate_downtime` <number> (0 - N) ('default =' 0.1)

为迁移设置最大容忍停机时间（以秒为单位）。

--migrate_speed` <integer> (0 - N) ('default =' 0)

设置迁移的最大速度（以MB/s为单位）。值0表示没有限制。

--name` `<string>

为虚拟机设置一个名称。仅在配置的网页界面上使用。

--nameserver` `<string>

cloud-init：为容器设置DNS服务器IP地址。如果未设置searchdomain或nameserver，创建操作将自动使用来自主机的设置。

--net[n]` `[model=]<enum> [,bridge=<bridge>] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=<XX:XX:XX:XX:XX:XX>] [,mtu=<integer>] [,queues=<integer>] [,rate=<number>] [,tag=<integer>] [,trunks=<vlanid[;vlanid…​]>] [,<model>=<macaddr>]

指定网络设备。

--numa` <boolean> ('default =' 0)

启用/禁用 NUMA。

--numa[n]` `cpus=<id[-id];…​> [,hostnodes=<id[-id];…​>] [,memory=<number>] [,policy=<preferred|bind|interleave>]

NUMA拓扑。

--onboot` <boolean> ('default =' 0)

指定虚拟机是否会在系统启动时启动。

--ostype` `<l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win10 | win11 | win7 | win8 | wvista | wxp>

指定客户操作系统。

--parallel[n]` `/dev/parport\d+|/dev/usb/lp\d+

将主机并行设备映射（n为0至2）。

--protection` <boolean> ('default =' 0)

设置虚拟机的保护标志。这将禁用移除虚拟机和移除磁盘操作。

--reboot` <boolean> ('default =' 1)

允许重启。如果设置为'0'，则虚拟机在重启时退出。

--revert` `<string>

撤销一个待处理的更改。

--rng0` `[source=]</dev/urandom|/dev/random|/dev/hwrng> [,max_bytes=<integer>] [,period=<integer>]

配置基于VirtIO的随机数生成器。

--sata[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,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>] [,import-from=<source volume>] [,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>]

将卷用作SATA硬盘或CD-ROM（n为0到5）。使用特殊语法 STORAGE_ID:SIZE_IN_GiB 来分配新的卷。使用 STORAGE_ID:0 和 'import-from' 参数从现有卷导入。

--scsi[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,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>] [,import-from=<source volume>] [,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>] [,product=<product>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,vendor=<vendor>] [,werror=<enum>] [,wwn=<wwn>]

将卷作为SCSI硬盘或CD-ROM使用（n为0到30）。使用特殊语法STORAGE_ID:SIZE_IN_GiB来分配一个新卷。使用STORAGE_ID:0和’import-from’参数，从现有卷导入。

--scsihw` <lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single> ('默认=' lsi)

SCSI控制器型号

--searchdomain` `<string>

cloud-init: 为容器设置DNS搜索域。如果没有设置searchdomain或nameserver，创建操作将自动使用主机的设置。

--serial[n]` `(/dev/.+|socket)

在虚拟机内创建一个串行设备（n为0到3）

--shares` <整数> (0 - 50000) ('默认值 =' 1000)

自动调整内存分配的内存份额。数字越大，这个虚拟机获得的内存就越多。数字相对于所有其他运行中的虚拟机的权重而言。使用零禁用自动调整内存。自动调整内存由 pvestatd 完成。

--skiplock` `<boolean>

忽略锁定 - 只有root用户才允许使用此选项。

--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>]

指定 SMBIOS 类型 1 字段。

--smp` <整数> (1 - N) ('默认值 =' 1)

CPU的数量。请改用选项-sockets。

--sockets` <integer> (1 - N) ('default =' 1)

CPU插槽的数量。

--spice_enhancements` `[foldersharing=<1|0>] [,videostreaming=<off|all|filter>]

为SPICE配置额外的增强功能。

--sshkeys` `<filepath>

cloud-init: 设置公共SSH密钥（每行一个密钥，OpenSSH格式）。

--startdate` (now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS) ('default =' now)

设置实时时钟的初始日期。日期的有效格式有：'now'、'2006-06-17T16:01:21' 或 '2006-06-17'。

--startup` `[[order=]\d+] [,up=\d+] [,down=\d+]

启动和关闭行为。顺序是一个非负数，用于定义一般的启动顺序。关闭时采用相反的顺序。此外，您可以设置“启动”或“关闭”延迟（以秒为单位），这指定了在启动或停止下一个虚拟机之前等待的延迟时间。

--tablet` <boolean> ('default =' 1)

启用/禁用USB平板设备。

--tags` `<string>

VM的标签。这只是元信息。

--tdf` <boolean> ('default =' 0)

启用/禁用时间漂移修复。

--template` <boolean> ('default =' 0)

启用/禁用模板。

--tpmstate0` `[file=]<volume> [,import-from=<source volume>] [,size=<DiskSize>] [,version=<v1.2|v2.0>]

配置一个磁盘用于存储TPM状态。格式固定为’raw'。使用特殊语法STORAGE_ID:SIZE_IN_GiB来分配一个新的卷。注意，在这里SIZE_IN_GiB会被忽略，将会使用4 MiB作为代替。使用STORAGE_ID:0和’import-from’参数从现有卷导入。

--unused[n]` `[file=]<volume>

引用未使用的卷。这是内部使用的，不应手动修改。

--usb[n]` `[[host=]<HOSTUSBDEVICE|spice>] [,mapping=<mapping-id>] [,usb3=<1|0>]

配置一个USB设备（n是0到4，对于机器版本>= 7.1并且操作系统类型为l26或Windows > 7，n可以达到14）。

--vcpus` <integer> (1 - N) ('default =' 0)

热插拔虚拟CPU的数量。

--vga` `[[type=]<enum>] [,clipboard=<vnc>] [,memory=<integer>]

配置VGA硬件。

--virtio[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,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>] [,import-from=<source volume>] [,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>] [,ro=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]

使用卷作为VIRTIO硬盘（n为0至15）。使用特殊语法STORAGE_ID:SIZE_IN_GiB来分配一个新的卷。使用STORAGE_ID:0和’import-from’参数从现有卷导入。

--vmgenid` <UUID> ('默认值=' 1 (自动生成))

设置 VM 生成 ID。使用 '1' 在创建或更新时自动生成，传递 '0' 明确禁用。

--vmstatestorage` `<string>

默认存储用于虚拟机状态卷/文件。

--watchdog` `[[model=]<i6300esb|ib700>] [,action=<enum>]

创建一个虚拟硬件看门狗设备。

qm showcmd <vmid> `[OPTIONS]

显示用于启动虚拟机（调试信息）的命令行。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--pretty` <boolean> ('default =' 0)

为了提高人类可读性，将每个选项放在新的一行上。

--snapshot` `<string>

从给定快照中获取配置值。

qm shutdown <vmid> `[OPTIONS]

关闭虚拟机。这类似于在物理机器上按电源按钮。这将向来宾操作系统发送一个ACPI事件，来宾操作系统随后应执行干净的关机操作。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--forceStop` <boolean> ('default = ' 0)

确保虚拟机停止。

--keepActive` <boolean> ('default =' 0)

不要停用存储卷。

--skiplock` `<boolean>

忽略锁定 - 只有root用户才允许使用此选项。

--timeout` `<integer> (0 - N)

等待最长超时秒数。

qm snapshot <vmid> <snapname> `[OPTIONS]

给虚拟机创建快照。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

<snapname>：<string>

快照的名称。

--description` `<string>

一段文字描述或评论。

--vmstate` `<boolean>

保存虚拟机状态

qm start <vmid> `[OPTIONS]

启动虚拟机。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--force-cpu` `<string>

用给定的字符串覆盖 QEMU 的 -cpu 参数。

--machine` `(pc|pc(-i440fx)?-\d+(\.\d+)(\+pve\d)?(\.pxe)?|q35|pc-q35-\d+(\.\d+)(\+pve\d)?(\.pxe)?|virt(?:-\d+(\.\d+))?(\+pve\d)?)

指定QEMU的机器类型。

--migratedfrom` `<string>

集群节点的名称。

--migration_network` `<string>

用于迁移的（子）网络的CIDR。

--migration_type` `<insecure | secure>

默认情况下，迁移流量通过SSH隧道加密。在安全、完全私有的网络上，可以禁用此功能以提高性能。

--skiplock` `<boolean>

忽略锁定 - 只有root用户才允许使用此选项。

--stateuri` `<string>

一些命令从这个位置保存/恢复状态。

--targetstorage` `<string>

从源存储到目标存储的映射。只提供单个存储 ID 会将所有源存储映射到该存储。提供特殊值 '1' 将把每个源存储映射到自身。

--timeout` <integer> (0 - N) ('default =' max(30, vm memory in GiB))

等待最长超时秒数。

qm status <vmid> `[OPTIONS]

显示虚拟机状态。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--verbose` `<boolean>

详细输出格式

qm stop <vmid> `[OPTIONS]

停止虚拟机。QEMU进程将立即退出。这类似于拔掉正在运行的计算机的电源插头，可能会损坏VM数据。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--keepActive` <boolean> ('default =' 0)

不要停用存储卷。

--migratedfrom` `<string>

集群节点的名称。

--skiplock` `<boolean>

忽略锁定 - 只有root用户才允许使用此选项。

--timeout` `<integer> (0 - N)

等待最长超时秒数。

qm suspend <vmid> `[OPTIONS]

挂起虚拟机。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--skiplock` `<boolean>

忽略锁定 - 只有root用户才允许使用此选项。

--statestorage` `<string>

虚拟机状态的存储

Note
 需要选项：`todisk
--todisk` <boolean> ('default =' 0)

如果设置，将虚拟机挂起到磁盘。下次启动虚拟机时将恢复。

qm template <vmid> `[OPTIONS]

创建一个模板。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--disk` `<efidisk0 | ide0 | ide1 | ide2 | ide3 | sata0 | sata1 | sata2 | sata3 | sata4 | sata5 | scsi0 | scsi1 | scsi10 | scsi11 | scsi12 | scsi13 | scsi14 | scsi15 | scsi16 | scsi17 | scsi18 | scsi19 | scsi2 | scsi20 | scsi21 | scsi22 | scsi23 | scsi24 | scsi25 | scsi26 | scsi27 | scsi28 | scsi29 | scsi3 | scsi30 | scsi4 | scsi5 | scsi6 | scsi7 | scsi8 | scsi9 | tpmstate0 | virtio0 | virtio1 | virtio10 | virtio11 | virtio12 | virtio13 | virtio14 | virtio15 | virtio2 | virtio3 | virtio4 | virtio5 | virtio6 | virtio7 | virtio8 | virtio9>

如果你只想将一张磁盘转换为基础镜像。

qm terminal <vmid> `[OPTIONS]

使用串行设备打开终端（虚拟机需要配置串行设备，例如’serial0: socket'）

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--escape` <string> ('default =' ^O)

转义字符。

--iface` `<serial0 | serial1 | serial2 | serial3>

选择串行设备。默认情况下，我们仅使用第一台合适的设备。

qm 解除链接

'qm disk unlink' 的别名。

解锁 `<vmid>

解锁虚拟机。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

启用 <vmid> 的 qm vncproxy 功能

将'''Proxy VM VNC流量'''代理到标准输入/标准输出

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

qm wait <vmid> `[OPTIONS]

等到虚拟机停止。

<vmid>`: `<整数> (100 - 999999999)

虚拟机的（唯一）ID。

--timeout` `<integer> (1 - N)

超时秒数。默认情况下是永远等待。