参考指南 › AutoShell › AutoShell 可加载模块的命令参考 › CA Microsoft Hyper-V AutoShell 命令 › dpmhv-createVM (Funclet) 命令-创建 VM

dpmhv-createVM (Funclet) 命令-创建 VM

dpmhv-createVM 命令用于创建 VM。 该命令创建没有系统组件（如网络适配器或硬盘）的 VM。 创建 VM 后，可以使用相应的命令创建系统组件。

此命令具有以下格式：

dpmhv-createVM 
-host hostname 
-name name 
[-path pathname] 
[-template templatename]
[-templateid vmguid]
[-mem mem]
[-cpus cpus]
[-cpuidlimit limit] 
[-cpureserve reserve]
[-cpulimit limit]
[-cpuweight weight]
[-startAction {none|auto|always}]
[-startDelay delay] 
[-stopAction {save,off,shutdown}] 
[-recoveryAction {none,restart,revert}]
[-retval] 
[-silent]

-host hostname

指定 Hyper-V 服务器主机的名称。

-name name

（可选）指定 VM 的名称。

注意：VM 的名称必须是唯一的。

-dest pathname

（可选）指定要创建的 VM 的路径（模板已存储）。 如果没有指定该选项，将在 Hyper-V 服务器的默认位置创建 VM。 创建的模板名称存储在以下位置：%ALLUSERSPROFILE%\ca\vpm\Hyper-V_Templates。

注意：建议不要在 Hyper-V 默认位置中创建 VM。 使用模板创建 VM 时，它与未更改的虚拟磁盘映像文件名产生冲突。

-template templatename

（可选）指定现有 VM 的名称。 该选项用于复制现有 VM 的配置设置以创建新的 VM。 建议不要从现有 VM 创建 VM。 两个 VM 可共享资源（如虚拟磁盘），但不能同时运行。

注意：模板名称在本地模板目录中必须是唯一的。

-templateid vmguid

（可选）指定现有 VM 的唯一 ID (GUID)。 该选项用于复制现有 VM 的配置设置以创建新的 VM。 建议不要从现有 VM 创建 VM。 两个 VM 可以共享资源（如虚拟磁盘），但不能同时运行。

默认值：-1

注意：该选项不表示 VM 目录中的模板 ID，但表示 Hyper-V 环境中的现有 VM。

-mem mem

（可选）指定要创建的 VM 的 RAM 内存 (MB)。

默认值：-1

-cpus cpus

（可选）指定要分配给 VM 的 CPU 核心数。

-cpuidlimit limit

（可选）指定 VM 的 CPU ID 功能的限制。 该选项可改进与传统操作系统（如 Windows NT）的兼容性。

默认值：-1

-cpureserve reserve

（可选）指定要为 VM 保留的 CPU 的百分比。 如果没有指定该选项，Hyper-V 服务器会根据系统整体使用情况分配 CPU 周期。

默认值：-1

-cpulimit limit

（可选）指定 VM 使用的 CPU 资源数的限制。 该选项可改进在具有不同 CPU 功能的物理主机之间移动 VM 时的兼容性。

默认值：-1

-cpuweight weight

（可选）指定虚拟机的相对权重。 该选项控制多个 VM 运行时的资源分配。 有效条目：1 到 10000 的整数。

默认值：-1

-startAction {none,auto,always}

（可选）指定 Hyper-V 主机启动时要在 VM 上执行的操作。 选项包括：

无

不执行任何操作。

自动

自动启动 VM。

注意：如果 Hyper-V 主机关闭之前 VM 正在运行，则使用该选项。

always

始终启动 VM。

-startDelay delay

（可选）指定 Hyper-V 主机启动并运行后启动 VM 的延迟（秒）。

默认值：-1

-stopAction {save,off,shutdown}

（可选）指定物理 Hyper-V 关闭时要在 VM 上执行的操作。 选项包括：

save

挂起 VM。

关

关闭 VM 电源。

shutdown

关闭系统。

-recoveryAction {none,restart,revert}

（可选）指定因意外关闭而重新启动 Hyper-V 主机后要在 VM 上执行的操作。 选项包括：

无

不执行任何操作。

restart

重新启动 VM。

revert

还原到 VM 的最后一个快照。

-retval

返回一个值以进一步处理。

-silent

指定不输出到屏幕。

返回值

该命令将返回包含新建 VM 的唯一标识符 (GUID) 的字符串。

示例：使用默认设置创建 VM

本示例使用默认设置创建 VM“TestVM”。

dpmhv-createVM -host hvserver -name TestVM

示例：在用户定义的目录中使用默认设置创建 VM

本示例在用户定义的目录中使用默认设置创建 VM“TestVM”。

dpmhv-createVM -host hvserver -name TestVM -path c:\VMs\TestVM

示例：使用自定义的内存和 CPU 核心值创建 VM

本示例使用自定义的内存和 CPU 核心值创建 VM“TestVM”。

dpmhv-createVM -host hvserver -name TestVM -mem 1024 -cpus 2