上一主题: dpmhv-createVMFromTemplate (Funclet) 命令-使用模板创建 VM下一主题: dpmhv-destroyTemplate (Cmdlet) 命令-删除模板


dpmhv-createVMFromTemplateEx (Funclet) 命令-使用模板创建 VM

dpmhv-createVMFromTemplate 命令用于使用现有模板创建 VM。 如果原始模板是在 Sysprep 状态中创建,则可自定义使用命令参数创建的 VM(映像)的 (Windows) 设置。 创建 VM 后,可以使用相应的命令创建系统组件。 可使用一个模板创建多个虚拟机。

注意:在同步运行命令时,可以自定义 Windows 设置映像。 对于异步执行,在执行完成后,您可以使用 dpmhv-setSysprepProperties 命令自定义映像。

此命令具有以下格式:

dpmhv-createVMFromTemplateEx 
-host hostname 
-vm vmname 
-template templatename 
-dest pathname
[-computerName computerName] 
[-ip4addr ip4addr] 
[-ip4dhcp ip4dhcpInt] 
[-ip4mask ip4mask] 
[-ip4gw ip4gw]
[-ip4metric ip4metric] 
[-ip4dns ip4dns]
[-disableAdmin]
[-adminPass adminPW]
[-autoLogon alcnt]
[-duplicatorString dupstr]
[-timeZone timezone]
[-productKey key] 
[-userName UserName] 
[-organization orgname] 
[-domain domainname] 
[-domainAdmin domad] 
[-domainAdminPass dompw] 
[-workgroup wgname] 
[-adminUser adminUser] 
[-adminUserPass adminUserPW]
[-custom custom] 
[-async]
[-mem mem]
[-cpus cpus]
[-cpuidlimit limit] 
[-cpufeatlimit limit] 
[-cpureserve reserve] 
[-cpulimit limit]
[-cpuweight weight]
[-startAction {none,auto,always}]
[-startDelay delay] 
[-stopAction {save,off,shutdown}]
[-recoveryAction {none,restart,revert}]
[-scvmmHost  scvmmHostname]
[-hardwareProf hwprof]
[-guestOSProf osprof]
[-startVM]
-host hostname

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

-vm vmname

指定 VM 的名称。

-template templatename

指定要用于创建 VM 的源模板的名称。

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

-dest pathname

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

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

-computerName computerName

(可选)指定 VM 的计算机名称。 对该参数的支持需要使用 Sysprep 工具的映像。 该选项对于异步执行命令无效。

-ip4addr ip4addr

(可选)指定要分配给 VM 的接口的静态 IPv4 地址。 要设置专用接口的 IP 地址,请使用已知的接口名称作为 IP 地址的前缀并以“#”分隔。 例如,
-ip4addr "Local Area Connection#192.168.1.200"。 如果模板映像具有多个网络适配器,则 IP 地址将分配给第一个接口。 该选项对于异步执行命令无效。

-ip4dhcp ip4dhcpInt

(可选)指定一个选项来打开 VM 的特定接口的 DHCP。 您也可为该选项指定接口名称。 例如,
-ip4dhcp "Local Area Connection"。如果模板映像具有多个网络适配器,则为第一个接口打开 DHCP。 该选项对于异步执行命令无效。

默认值:local

-ip4mask ip4mask

(可选)指定要为 VM 分配的子网掩码。 该选项与
-ip4ddr 选项结合使用。 如果在
-ip4addr 选项中指定了接口名称,则必须在该选项中使用相同的接口名称。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

-ip4gw ip4gw

(可选)指定该选项来为 VM 设置网关。 该选项与 -ip4ddr 选项结合使用。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

注意:如果在
-ip4addr 选项中指定了接口名称,则必须在该选项中使用相同的接口名称。

-ip4metric ip4metric

(可选)指定要为 VM 设置的接口度量标准。 该选项与 -ip4ddr 选项结合使用。 如果在
-ip4addr 选项中指定了接口名称,则必须在该选项中使用相同的接口名称。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

默认:1

-ip4dns ip4dns

(可选)指定要为 VM 设置的 DNS 服务器。 该选项与 -ip4ddr 选项结合使用。 如果在
-ip4addr 选项中指定了接口名称,则必须在该选项中使用相同的接口名称。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

-disableAdmin

(可选)指定该选项可禁用 VM 的默认管理员帐户。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

-adminPass adminPW

(可选)该选项用于设置 VM 的默认管理员帐户密码。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 在异步执行中将忽略该参数。

注意:要成功设置该选项,请将使用 Sysprep 工具创建的 Windows Server 管理员密码设置为空。

-autoLogon alcnt

(可选)指定一个选项来设置要创建以使用默认管理员帐户自动登录的帐户数目。 帐户会在 Sysprep 进程完成之后创建。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

默认值:
-1

-duplicatorString dupstr

(可选)指定要在 VM 注册表中设置的系统复印机的名称。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

-timeZone timezone

(可选)指定使用模板创建的 VM 所用的时区。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

默认值:
-1

-productKey key

(可选)指定 VM 的 Windows 产品激活密钥。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

-userName UserName

(可选)指定在新 VM 上安装的 Windows 映像(使用 Sysprep 工具创建)的用户名。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

-organization orgname

(可选)指定在新 VM 上安装的 Windows 映像(使用 Sysprep 工具创建)的组织名称。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

-domain domainname

(可选)指定 VM 的域名。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。 域和工作组规格互不相容。

-domainAdmin domad

(可选)将用户帐户指定为要在域中创建的域管理员。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

-domainAdminPass dompw

(可选)指定要在域中创建的域管理员用户帐户的密码。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

-workgroup wgname

(可选)指定要为 VM 创建的工作组。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 域和工作组规格互不相容。 该选项对于异步执行命令无效。

-adminUser adminUser

(可选)指定要作为默认 Administrators 组的一部分创建的管理员用户名。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

-adminUserPass adminUserPW

(可选)指定要作为默认 Administrators 组的一部分创建的管理员用户帐户的密码。 对该参数的支持需要一个使用 Sysprep 工具创建的 Windows 映像。 该选项对于异步执行命令无效。

-custom custom

(可选)指定要在 Sysprep 进程结束时执行的自定义命令的逗号分隔列表。 该参数需要 Sysprep 的 Windows 映像。 在异步执行中将忽略该参数。

-async

(可选)指定要异步执行命令的选项。 默认情况下,同步执行该命令。

注意:如果执行该选项之前此命令完成执行,它将返回用于查看操作状态的作业 ID。

-mem mem

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

默认值:-1

-cpus cpus

(可选)指定要分配给 VM 的 CPU 核心数。

默认值:-1

-cpuidlimit limit

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

默认值:-1

-cpufeatlimit limit

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

默认值:-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 的最后一个快照。

-scvmmHost scvmmHostname

(可选)指定 Microsoft System Center Virtual Machine Manager (SCVMM) 库服务器的主机名。 使用 SCVMM 集成开通 VM 时,该参数有效。

-hardwareProf hwprof

(可选)指定 Microsoft System Center Virtual Machine Manager (SCVMM) 库服务器定义的硬件配置文件的名称。 该参数覆盖存储在 SCVMM 模板中的硬件配置设置。 使用 SCVMM 集成开通 VM 时,该参数有效。

-guestOSProf osprof

(可选)指定 Microsoft System Center Virtual Machine Manager (SCVMM) 库服务器定义的来宾操作系统配置文件的名称。 该参数覆盖存储在 SCVMM 库服务器中的操纵系统配置设置。 使用 SCVMM 集成开通 VM 时,该参数有效。

-startVM

(可选)指定该选项可在创建 VM 后自动启动它。 默认情况下,新 VM 处于关闭状态。 您必须自定义用于启动 VM 的 IP 配置选项。

返回值

同步执行 dpmhv-createVMFromTemplateEX 命令时,它将返回空字符串。 如果异步执行,会将代表作业 ID 的字符串传递给 dpmhv-getJobErrorInfodpmhv-getJobInfodpmhv-getJobStatus。 如果在执行期间发生错误,则该命令将报告异常。

示例:从模板创建 VM

本示例使用模板设置作为完整的静态 IPv4 配置创建 VM“TestVM”:

dpmhv-createVMFromTemplateEx -host hvserver -vm NewVM -dest c:\VMs\NewBox -template Win2k3SysPrepped 
-ip4addr 192.168.1.25 -ip4mask 255.255.255.0 -ip4gw 192.168.1.1 -ip4dns 192.168.1.1 
-computerName NewBox

另请参阅:

dpmhv-createVMFromTemplate (Funclet) 命令-使用模板创建 VM