上一主题: dpmhv-createVM (Funclet) 命令-创建 VM下一主题: dpmhv-createVMFromTemplateEx (Funclet) 命令-使用模板创建 VM


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

dpmhv-createVMFromTemplate 命令用于从先前创建的 Microsoft System Center Virtual Machine Manager (SCVMM) 模板创建 VM,并选择性地自定义 Windows 映像的设置。

该模板保留未使用,以便单个模板可用于创建任意数量的虚拟机。 该命令仅支持 (SCVMM) 托管模板。 有关没有 SCVMM 的本地模板支持的信息,请参阅 dpmhv-createVMFromTemplateEx。

此命令具有以下格式:

dpmhv-createVMFromTemplate 
-host hostname 
-vm vmname 
-template templatename 
-dest pathname
-scvmmHost  scvmmHostname
-adminPass adminPW
[-computerName computerName] 
[-ip4addr ip4addr] 
[-ip4dhcp ip4dhcpInt] 
[-ip4mask ip4mask] 
[-ip4gw ip4gw]
[-ip4metric ip4metric] 
[-ip4dns ip4dns]
[-productKey key]
[-userName UserName]
[-organization orgname] 
[-domain domainname] 
[-domainAdmin domad] 
[-domainAdminPass dompw] 
[-workgroup wgname] 
[-adminUser adminUser] 
[-adminUserPass adminUserPW]
[-mem mem]
[-cpus cpus]
[-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 时,它与未更改的虚拟磁盘映像文件名产生冲突。

-scvmmHost scvmmHostname

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

-adminPass adminPW

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

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

-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 映像。 该选项对于异步执行命令无效。

-adminPass adminPW

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

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

-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 映像。 该选项对于异步执行命令无效。

-mem mem

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

默认值:-1

-cpus cpus

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

默认值:-1

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

示例:从 SCVMM 模板创建 VM

本示例使您可以使用指定硬件和来宾 OS 配置文件的选项从 SCVMM 模板创建 VM:

dpmhv-createVMFromTemplate -host hvserver -vm NewVM -dest c:\VMs\NewBox -template Win2k3Clean 
-scvmmHost SCVMMLibSrv -hardwareProf hw_def -guestOSProf os_def -async -adminPass #admin#

另请参阅:

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