上一主题: dpmhv-importVMEx (Funclet) 命令-复制和导入 VM下一主题: dpmhv-setVMClustered (Cmdlet) 命令-在群集中设置 VM


dpmhv-setSysprepProperties (Cmdlet) 命令-创建虚拟磁盘

dpmhv-setSysprepProperties 命令用于创建虚拟磁盘映像。

此命令具有以下格式:

dpmhv-setSysprepProperties 
-host hostname 
-vm vmname|-vmid vmguid|-jobref job 
[-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 domname]
[-domainAdmin domad] 
[-domainAdminPass dompw]
[-workgroup wgname]
[-adminUser adminUser]
[-adminUserPass adminUserPW]
[-custom custom]
-host hostname

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

默认值:$$HVHost

-vm vmname

指定 VM 的名称。

-vmid vmguid

指定 VM 的唯一 ID。

-jobref job

指定异步作业的作业 ID。

注意:异步作业执行完成时,Hyper-V 仅保留作业信息几分钟(五分钟),超出该时间后信息将无效。

-computerName computerName

(可选)指定计算机的名称。 对该参数的支持需要使用 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 2003 管理员密码设置为空。

默认值:

-autoLogon alcnt

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

默认值:

-organization orgname

(可选)指定许可 VM 中的 Windows 副本的组织。 对该参数的支持需要一个使用 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 映像。 在异步执行中将忽略该参数。

默认值:

返回值

同步执行 dpmhv-setSysprepProperties 命令时,将返回空字符串。 如果异步执行,会将代表作业 ID 的字符串传递给 dpmhv-getJobErrorInfo、dpmhv-getJobInfo 或 dpmhv-getJobStatus。 如果在执行期间发生错误,将报告异常。

示例:创建虚拟磁盘

本示例创建 2 GB 的动态虚拟磁盘。

dpmhv-createVirtDisk -host hvserver -path C:\VMDisks\hdd.vhd -type dynamic -sizeGB 2