Remove-SCVirtualMachine

語法

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 會在成功時傳回 物件，其值為 $True MarkedForDeletion 屬性。 如果失敗，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

-Force

-JobVariable

-OnBehalfOfUser

-OnBehalfOfUserRole

-PROTipID

-RunAsynchronously

-SkipFileRemoval

-VM

-WhatIf

備註

此 Cmdlet 需要 VMM 虛擬機物件，您可以使用 get-SCVirtualMachine Cmdlet 來擷取此物件。

相關連結

• Get-SCUserRole
• Get-SCVirtualMachine
• Move-SCVirtualMachine
• New-SCVirtualMachine
• Read-SCVirtualMachine
• Repair-SCVirtualMachine
• Resume-SCVirtualMachine
• Save-SCVirtualMachine
• Set-SCVirtualMachine
• Start-SCVirtualMachine
• Stop-SCVirtualMachine
• Suspend-SCVirtualMachine