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

dpmhv-createTemplateFromVM (Funclet) 命令-从 VM 创建模板

dpmhv-createTemplateFromVM 命令用于使用现有 VM 创建模板。 可以使用模板创建多个 VM。

模板将复制 VM 规格和附加到 VM 的虚拟硬盘。 如果使用附带快照的 VM 创建模板，将仅导出当前状态（不包括快照）。 该命令可为每个 Hyper-V 服务器创建模板目录。 该模板目录已进行维护，并可从以下位置进行查询：%ALLUSERSPROFILE%\ca\vpm\Hyper-V_Templates\TemplateCatalog.xml

此命令具有以下格式：

dpmhv-createTemplateFromVM 
-host hostname
-vm vmname|-vmid vmguid 
-template templatename 
[-async] 
[-path pathname] 
[-description description]
[-retval] 
[-silent]

-host hostname

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

-vm vmname

指定 VM 的名称。

-vmid vmguid

指定 VM 的唯一 ID。

-template templatename

指定在模板目录中创建的通用模板的名称。

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

-async

（可选）指定要异步执行命令的选项。 默认情况下，同步执行该命令。

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

-dest pathname

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

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

-description description

（可选）指定模板说明。

-retval

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

-silent

指定不输出到屏幕。

返回值

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

示例：从 VM 创建模板

本示例从 VM“TestVM”创建模板“MyTemplate”。

dpmhv-createTemplateFromVM -vm TestVM -template MyTemplate -host hvserver