Remove-SCVirtualMachine
从 VMM 中删除虚拟机对象。
语法
Remove-SCVirtualMachine
[-VM] <VM>
[-SkipFileRemoval]
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
说明
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,该 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 提示) 的性能和资源优化提示的 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 |
-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 检索该对象。