通过

Remove-SCVMTemplate

  • 参考
模块:
VirtualMachineManager

从 VMM 中删除模板对象。

语法

Remove-SCVMTemplate
      [-VMTemplate] <Template>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Remove-SCVMTemplate cmdlet 从 Virtual Machine Manager （VMM） 库中删除模板对象。 删除模板对象不会删除与模板关联的任何虚拟硬盘。

可与模板关联的文件类型包括虚拟硬盘文件（基于 Windows 的 .vhd 文件、基于 Citrix XenServer 的 .vhd 文件或基于 VMware 的 .vmdk 文件）、虚拟软盘文件（基于 Windows 的 .vfd 文件或基于 VMware 的 .flp 文件）和脚本文件（Windows PowerShell .ps1 脚本文件或应答文件脚本，包括 Sysprep.inf 和 Unattend.xml 文件）。

此 cmdlet 在成功时返回对象（属性 MarkedForDeletion 设置为 TRUE），或在失败时返回错误消息。

示例

示例 1：从库中删除特定模板

PS C:\> $Template = Get-SCVMTemplate -VMMServer "VMMServer1.Contoso.com" | where { $_.Name -eq "Template01" }
PS C:\> Remove-SCVMTemplate -VMTemplate $Template

第一个命令从 VMMServer01 上的库中获取名为 Template01 的模板对象，并将该对象存储在$Template变量中。

第二个命令从库中删除存储在$Template中的模板对象。

示例 2：从库中删除所有模板

PS C:\> $Templates = Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com"
PS C:\> $Templates | Remove-SCVMTemplate -Confirm

第一个命令从 VMMServer01 获取所有模板对象，并将对象存储在名为$Templates的数组中。

第二个命令将$Templates中的每个模板对象传递到 Remove-SCVMTemplate cmdlet，该 cmdlet 会从 VMM 库中删除每个模板对象。 Confirm 参数会提示你确认是否要删除每个模板。

参数

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Force

强制命令运行而不要求用户确认。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-JobVariable

指定在此参数命名的变量中跟踪和存储作业进度。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PROTipID

指定触发此操作的性能和资源优化提示（PRO 提示）的 ID。 此参数允许你审核 PRO 提示。

类型:Guid
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RunAsynchronously

指示作业以异步方式运行，以便控件立即返回到命令行界面。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMTemplate

指定用于创建虚拟机的 VMM 模板对象。

类型:Template
别名:Template
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输出

SCVMTemplate

此 cmdlet 返回 SCVMTemplate 对象。

备注

  • 需要 VMM 模板对象，可以使用 Get-SCVMTemplate cmdlet 进行检索。