Remove-SCVirtualHardDisk

从虚拟机或模板或 VMM 库中删除虚拟硬盘对象。

语法

Remove-SCVirtualHardDisk
      [-VirtualHardDisk] <VirtualHardDisk>
      [-JobGroup <Guid>]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Remove-SCVirtualHardDisk cmdlet 从虚拟机或模板或 Virtual Machine Manager (VMM) 库中删除虚拟硬盘对象。 Remove-VirtualHardDisk 还会从库服务器中删除相应的虚拟硬盘文件(基于 Windows 的 .vhd 文件、基于 Citrix XenServer 的 .vhd 文件或基于 VMware 的 .vmdk 文件)。

如果虚拟硬盘附加到虚拟机或模板上的虚拟磁盘驱动器(如果不使用 Force 参数),VMM 将列出包含虚拟硬盘的容器,并提示确认要删除虚拟硬盘:

  • 如果回答“是”,VMM 会删除虚拟硬盘与附加到它的容器之间的关联,然后从 VMM 中删除虚拟硬盘对象。

  • 如果回复“否”,则取消该操作。

此 cmdlet 在成功时返回对象(属性 MarkedForDeletion 设置为 True),或在失败时返回错误消息。

示例

示例 1:从库中删除虚拟硬盘对象

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Remove-SCVirtualHardDisk -VirtualHardDisk $VHD

第一个命令获取存储在 LibraryServer01 上的 VHD01.vhd 的虚拟硬盘对象,并将返回的对象存储在$VHD变量中。

第二个命令从库中删除存储在$VHD中的虚拟硬盘对象,并从库服务器上的文件系统中删除相应的文件。

示例 2:从虚拟机中删除虚拟硬盘

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }
PS C:\> $VHD | Remove-SCVirtualHardDisk

第一个命令连接到 VMMServer01。

第二个命令获取名为 VM01 的虚拟机对象,获取其名称包括字符串“DataDisk”的 VM01 上的所有虚拟硬盘,然后将这些虚拟硬盘对象存储在名为$VHD的数组中。

第三个命令从虚拟机中删除存储在$VHD数组中的每个虚拟硬盘对象,并从库服务器上的文件系统中删除每个相应文件。

参数

-Confirm

在运行 cmdlet 之前,提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Force

强制命令运行而不要求用户确认。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-JobGroup

指定一系列命令的标识符,该命令将在包含相同作业组标识符的最终命令运行之前作为集运行。

类型:Guid
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-JobVariable

指定在此参数命名的变量中跟踪和存储作业进度。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PROTipID

指定触发此操作的性能和资源优化提示(PRO 提示)的 ID。 此参数允许你审核 PRO 提示。

类型:Guid
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RunAsynchronously

指示作业以异步方式运行,以便控件立即返回到命令行界面。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VirtualHardDisk

指定虚拟硬盘对象。

类型:VirtualHardDisk
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

备注

  • 需要 VMM 虚拟硬盘对象,可以使用 Get-SCVirtualHardDisk cmdlet 进行检索。