Remove-SCVMTemplate
从 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 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
强制运行命令而不要求用户确认。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
指定跟踪作业进度，并将其存储在此参数命名的变量中。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
指定触发此操作 (PRO 提示) 的性能和资源优化提示的 ID。 此参数允许审核 PRO 提示。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
指示作业异步运行，以便控件立即返回到命令 shell。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMTemplate
指定一个用于创建虚拟机的 VMM 模板对象。
| Type: | Template |
| Aliases: | Template |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输出
SCVMTemplate
此 cmdlet 返回 SCVMTemplate 对象。
备注
- 需要 VMM 模板对象，可以使用 Get-SCVMTemplate cmdlet 检索该对象。