共用方式為


Remove-SCVMTemplate

從 VMM 移除範本物件。

Syntax

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

Description

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 檔案) 。

這個指令程式會在成功時 (當內容 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,這會從 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 提示) 效能和資源優化提示的識別碼。 此參數可讓您稽核 PRO 秘訣。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

表示作業會以非同步方式執行,讓控制項立即返回命令殼層。

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 物件。

備註

  • 需要可使用 Get-SCVMTemplate Cmdlet 擷取的 VMM 範本物件。