Remove-SCVMTemplate
從 VMM 移除範本物件。
語法
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 檔案)。
這個 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,這會從 VMM 連結庫移除每個範本物件。 確認 參數會提示您確認是否要刪除每個範本。
參數
-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 提示) 的識別碼。 此參數可讓您稽核 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
擷取此物件。