Remove-SCVirtualMachine
從 VMM 移除虛擬機器物件。
Syntax
Remove-SCVirtualMachine
[-VM] <VM>
[-SkipFileRemoval]
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
Remove-SCVirtualMachine Cmdlet 會移除部署在主機上或儲存在 Virtual Machine Manager 上的虛擬機器物件， (VMM) 程式庫伺服器。
此 Cmdlet 會從 VMM 資料庫刪除虛擬機器記錄、刪除與虛擬機器相關聯的所有檔案，並從部署所在的主機或從儲存所在的程式庫伺服器中移除虛擬機器。
如果 VMM 為這部虛擬機器建立主機上的資料夾，而不是 Hyper-V 或 VMware 所建立，而且如果該資料夾不包含其他虛擬機器或其他資料，您可以在移除虛擬機器之後，使用檔案系統來刪除資料夾。
如果您指定 Force 參數，此 Cmdlet 只會從 VMM 資料庫刪除虛擬機器。 它不會刪除虛擬機器本身。
這個 Cmdlet 會在成功時傳回物件，其值為 MarkedForDeletion 屬性的 $True。 如果失敗，Cmdlet 會傳回錯誤訊息。
範例
範例 1：移除部署在主機上的特定虛擬機器
PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.VMHost.Name -eq "VMHost01.Contoso.com" -and $_.Name -eq "VM01" }
PS C:\> Remove-SCVirtualMachine -VM $VM第一個命令會取得部署在 VMHost01 上名為 VM01 的虛擬機器物件，然後將虛擬機器物件儲存在$VM變數中。
第二個命令會移除儲存在 $VM 中的 物件，並從其主機上的檔案系統中刪除對應的虛擬機器檔案。
範例 2：移除名稱包含特定字串的所有虛擬機器
PS C:\> $VMs = @(Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -Match "VM0" } )
PS C:\> $VMs | Remove-SCVirtualMachine第一個命令會取得所有部署在名稱包含字串 VM0 的主機上的所有虛擬機器物件，然後將這些虛擬機器物件儲存在名為 $VMs 的陣列中。
第二個命令會移除$VMs陣列中的每個虛擬機器物件，並從每個主機上的檔案系統中刪除對應的虛擬機器檔案。
範例 3：移除儲存在 VMM 程式庫伺服器上的特定虛擬機器
PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer1.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "VM02" }
PS C:\> Remove-SCVirtualMachine -VM $VM第一個命令會取得 物件，該物件代表名為 VM03 的虛擬機器，然後將虛擬機器物件儲存在$VM中。 在此範例中，只有一個名為 VM03 的虛擬機器存在。
第二個命令會從程式庫移除代表 VM03 的物件，並刪除程式庫伺服器之檔案系統中的對應虛擬機器檔案。
範例 4：從 VMM 程式庫移除多個預存虛擬機器
PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "VM0" }
PS C:\> $VMs | Remove-SCVirtualMachine -Confirm第一個命令會取得名稱包含字串 VM0 且儲存在 LibraryServer01 上的所有虛擬機器物件。 命令接著會將虛擬機器物件儲存在名為 $VMs 的陣列中。
第二個命令會將儲存在 $VMs 中的每個虛擬機器物件傳遞給目前的 Cmdlet，這會從程式庫移除每個物件，並從程式庫伺服器上的檔案系統中刪除對應的虛擬機器檔案。 Confirm參數會提示您確認是否要刪除每部虛擬機器。
參數
-Confirm
在執行 Cmdlet 前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
表示此 Cmdlet 只會從 VMM 資料庫刪除虛擬機器。 它不會刪除虛擬機器本身。
注意
對於使用服務範本或 VMRole 部署的虛擬機器，會忽略此參數，而且也會刪除實際的虛擬機器。
| 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 |
-OnBehalfOfUser
指定使用者名稱。 這個 Cmdlet 會代表此參數所指定的使用者運作。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
指定使用者角色。 若要取得使用者角色，請使用 Get-SCUserRole Cmdlet。 這個 Cmdlet 會代表此參數所指定的使用者角色運作。
| Type: | UserRole |
| 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 |
-SkipFileRemoval
表示此 Cmdlet 不會直接移除虛擬機器相關檔案。 如果您指定此參數，則不會嘗試直接刪除任何檔案。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
指定虛擬機器物件。
| Type: | VM |
| 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 |
備註
此 Cmdlet 需要 VMM 虛擬機器物件，可以使用 Get-SCVirtualMachine Cmdlet 來擷取此物件。