Red Hat Training

A Red Hat training course is available for Red Hat Virtualization

4.22. vm

vm 资源类型对 Red Hat Virtualization 环境中的所有虚拟机资源进行分组。

表 4.58. 虚拟机参数

名称 类型 Description 必填 用户 Creatable User Updatable
--name
字符串
虚拟机的名称
是
是
是
--template-id|name
字符串
对用作虚拟机基础的模板的引用。
是
是
否
--cluster-id|name
字符串
对包含此虚拟机的集群的引用。
是
是
是
--instance_type-id|name
字符串
定义实例类型。指定自定义、大、medium、small、tiny 或 xlarge。
否
是
是
--quota-id
字符串
对虚拟机配额使用量的引用。
否
是
否
--timezone
字符串
Windows 虚拟机的 Sysprep 时区设置。
否
是
是
--os-boot
集合
虚拟机的引导设备。指定 cdrom、hd 或 网络。
否
是
是
--custom_properties-custom_property
集合
一组用户定义的环境变量，作为参数传递给自定义脚本。
否
是
是
--os-type
字符串
此虚拟机的操作系统类型。
否
是
是
--usb-enabled
布尔值
定义虚拟机的 USB 策略。设置为 true 以在虚拟机上启用 USB。
否
是
是
--usb-type
字符串
定义 USB 类型（如果启用）。
否
是
是
--type
字符串
定义虚拟机类型。指定 desktop 或 server。
否
是
是
--os-initRd
字符串
与指定内核一起使用的 initrd 镜像的路径。这个选项支持直接引导 Linux 内核，而不是通过 BIOS 引导装载程序引导。
否
是
是
--display-monitors
int
定义可用显示的数量。
否
是
是
--display-single_qxl_pci
布尔值
设置为 true，以使用单个虚拟 PCI 设备驱动多个监视器。
否
是
是
--display-type
字符串
定义显示类型。指定 spice 或 vnc。
否
是
是
--display-allow_override
布尔值
设置为 true 以允许覆盖虚拟机控制台设置。
否
是
是
--display-smartcard_enabled
布尔值
设置为 true 以启用智能卡功能。
否
是
是
--display-file_transfer_enabled
布尔值
设置为 true 以启用 SPICE 文件传输。
否
是
是
--display-copy_paste_enabled
布尔值
设置为 true 以启用 SPICE 剪贴板复制和粘贴。
否
是
是
--display-keyboard_layout
字符串
定义虚拟机的键盘布局。这个选项只在使用 VNC 协议时可用。指定格式，如 en-US。
否
是
是
--os-cmdline
字符串
与定义的内核一起使用的内核命令行参数字符串。这个选项支持直接引导 Linux 内核，而不是通过 BIOS 引导装载程序引导。
否
是
是
--cpu-topology-cores
int
虚拟机可用的 CPU 内核数。
否
是
是
--cpu-architecture
字符串
定义 CPU 架构。指定 x86_64、ppc64 或 未定义。
否
是
是
--memory
long
虚拟机的内存量，以字节为单位。
否
是
是
--memory_policy-guaranteed
long
在主机上保证最小内存量（以字节为单位），以便虚拟机运行。
否
是
是
--memory_policy-ballooning
布尔值
设置为 true 以启用内存气球设备。
否
是
是
--high_availability-priority
int
使用高可用性设置每个虚拟机的优先级值（迁移和重启顺序）。
否
是
是
--high_availability-enabled
布尔值
定义是否为虚拟机启用高可用性。
否
是
是
--domain-name
字符串
虚拟机的域名。
否
是
是
--description
字符串
虚拟机的描述。
否
是
是
--comment
字符串
虚拟机的评论。
否
是
是
--stateless
布尔值
如果虚拟机无状态，则设置为 true。无状态虚拟机包含引导时获取的磁盘镜像的快照，并在关机时删除。这意味着状态更改在重启后不会保留。
否
是
是
--permissions-clone
布尔值
设置为 true，以将源虚拟机的权限复制到模板。
否
是
是
--delete_protected
布尔值
设置为 true 以便无法删除从此模板创建的虚拟机。
否
是
是
--sso-methods-method
集合
定义所用的单点登录方法。例如，--sso-methods-method method.id=GUEST_AGENT。
否
是
是
--rng_device-rate-bytes
int
指定每个期间内允许消耗的字节数。
否
是
是
--rng_device-rate-period
int
以毫秒为单位指定期间的持续时间。如果指定，则必须指定 --rng_device-rate-bytes。
否
是
是
--rng_device-source
字符串
随机数字生成器的来源。指定 random 或 hwrng。
否
是
是
--console-enabled
布尔值
设置为 true 以启用 VirtIO 控制台设备功能。
否
是
是
--cpu-mode
字符串
定义 CPU 模式。指定自定义、host_model 或 host_passthrough。
否
是
是
--cpu-topology-sockets
int
虚拟机可用的 CPU 插槽数量。
否
是
是
--cpu_shares
int
虚拟机相对于其他虚拟机可能需要的 CPU 资源级别。例如 ，512 代表低优先级虚拟机，1024 代表中等优先级虚拟机，2048 个高优先级虚拟机。
否
是
是
--placement_policy-affinity
字符串
每个虚拟机的迁移关联性。指定可 migratable、user_migratable 或 pinned。
否
是
是
--placement_policy-host-id|name
字符串
对迁移关联性的首选主机的引用。
否
是
是
--origin
字符串
虚拟机的源。指定 rhev 、 VMware 或 xen。
否
是
是
--os-kernel
字符串
为虚拟机配置的内核镜像的路径。这个选项支持直接引导 Linux 内核，而不是通过 BIOS 引导装载程序引导。
否
是
是
--disks-clone
布尔值
定义是否从定义的 模板 克隆磁盘。
否
是
否
--disks-disk
集合
对附加到虚拟机的磁盘引用。
否
是
是
--tunnel_migration
布尔值
设置为 true，以通过 libvirt 守护进程启用数据传输。隧道的传输使用更强大的加密算法，但会增加传输过程中的数据负载。
否
是
是
--migration_downtime
int
定义虚拟机在实时迁移期间可以停机的最大毫秒数。
否
是
是
--virtio_scsi-enabled
布尔值
设置为 true 以允许将 VirtIO 控制台设备附加到虚拟机。
否
是
是
--soundcard_enabled:
布尔值
设置为 true 以启用声音卡。
否
是
是
--payloads-payload
集合
定义在启动时要发送到虚拟机的内容。
否
是
是
--initialization-configuration-type
字符串
定义虚拟机格式。仅接受 ovf。
否
是
是
--initialization-configuration-data
字符串
这个参数必须与 --initialization-configuration-type 参数匹配。仅接受 ovf。
否
是
是
--cpu-cpu_tune-vcpu_pin
集合
定义要固定到主机的物理 CPU 的虚拟机 CPU。
否
是
是
--serial_number-policy
字符串
定义虚拟机模板的序列号策略。指定 主机、vm 或 自定义。如果使用 custom，也使用 --serial_number-value 定义序列号值。
否
是
是
--serial_number-value
字符串
定义虚拟机模板的序列号。
否
是
是
--bios-boot_menu-enabled
布尔值
设置为 true 以启用引导菜单。
否
是
是
--numa_tune_mode
字符串
定义如何为 NUMA 主机上的域进程分配内存。指定 interleave、严格 或 首选。如果未指定值，则参数默认为 strict。
否
是
是
--cpu_profile-id
字符串
定义要使用的 CPU 配置集。使用 list cpuprofiles 命令检索 CPU 配置集 ID 的完整列表。
否
是
是
--expect
'201-created'
请求会变得异步，直到返回预期的 HTTP 标头。对于长时间运行的任务，在任务完成之前，否则会返回的任务。
否
否
否
--correlation_id
字符串
用于跨系统日志记录的操作标记标识符。如果客户端没有定义标识符，则会生成一个。
否
是
否
--os-boot 参数是一个集合，其使用下表中的子参数。

表 4.59. --os-boot 参数

名称 类型 Description
boot.dev
字符串
虚拟机模板的引导设备。指定 cdrom、hd 或 网络。
--custom_properties-custom_property 参数是下表中使用子参数的集合。

表 4.60. --custom_properties-custom_property parameters

名称 类型 Description
custom_property.name
字符串
自定义属性名称。
custom_property.value
字符串
自定义属性值。
--sso-methods-method 参数是下表中使用子参数的集合。

表 4.61. --SSO-methods-method 参数

名称 类型 Description
method.id
字符串
使用的单点登录方法： GUEST_AGENT。
--disks-disk 参数是下表中使用子参数的集合。

表 4.62. --disks-disk 参数

名称 类型 Description
disk.id
字符串
对虚拟磁盘的引用。
storage_domains.storage_domain
集合
为磁盘的存储域定义一组子参数。
--payloads-payload 参数是下表中使用子参数的集合。

表 4.63. --payloads-payload parameters

名称 类型 Description
payload.type
字符串
有效负载交付类型。指定 cdrom 或 floppy。
payload.file.name
字符串
有效负载文件名和虚拟机根文件系统中的位置。
payload.file.content
字符串
要提供给该文件的内容。
--cpu-cpu_tune-vcpu_pin 参数是下表中使用子参数的集合。

表 4.64. --cpu-cpu_tune-vcpu_pin

名称 类型 Description
vcpu_pin.vcpu
int
要分配的虚拟 CPU。
vcpu_pin.cpu_set
字符串
主机上的物理 CPU。

例 4.45. 创建新虚拟机

[RHEVM shell (connected)]# add vm --name MyVM --template-name Blank --cluster-name Default --memory 536870912

例 4.46. 更新虚拟机

[RHEVM shell (connected)]# update vm MyVM --memory 1073741824

例 4.47. 删除虚拟机

[RHEVM shell (connected)]# remove vm MyVM
下表列出了虚拟机资源的操作。

表 4.65. 虚拟机操作

操作 Description
start 启动虚拟机。
stop 停止虚拟机。
shutdown 关闭虚拟机。
suspend 暂停虚拟机。
detach 从池中分离虚拟机。
migrate 迁移虚拟机到另一主机上。
取消迁移 停止正在进行中的迁移。
export 将虚拟机导出到导出存储域。
Move 将虚拟磁盘移动到另一个存储域。
ticket 为控制台访问创建一个 ticket。
logon 启用用户登录，以使用第三方应用程序进行控制台访问。