Remove-SCVirtualScsiAdapter

从 VMM 中删除虚拟 SCSI 适配器对象。

语法

Remove-SCVirtualScsiAdapter
      [-VirtualScsiAdapter] <VirtualSCSIAdapter>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

说明

Remove-SCVirtualScsiAdapter cmdlet 从虚拟机、虚拟机模板或虚拟机管理器(VMM)环境中使用的硬件配置文件中删除一个或多个虚拟 SCSI 适配器对象。

Remove-SCVirtualSCSIAdapter cmdlet 仅当适配器未附加任何设备时,才会成功删除虚拟 SCSI 适配器。

Citrix XenServer 主机上的虚拟机始终具有一个虚拟 SCSI 适配器。 无法删除此适配器。

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

示例

示例 1:从虚拟机中删除第三个虚拟 SCSI 适配器

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualSCSIAdapter -VM $VM 
PS C:\> $Adapter[2] | Remove-SCVirtualScsiAdapter

第一个命令获取名为 VM01 的虚拟机对象,并将该对象存储在$VM变量中。

第二个命令获取 VM01 上的所有虚拟 SCSI 适配器对象,并将对象存储在$Adapter对象数组中。 一个虚拟机最多可以附加四个虚拟 SCSI 适配器。 此示例假定 VM01 至少有三个虚拟 SCSI 适配器。

最后一个命令将第三个虚拟 SCSI 适配器($Adapter[2])传递到 Remove-SCVirtualScsiAdapter,这会从 VM01 中删除此虚拟 SCSI 适配器。

参数

-Confirm

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

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

-JobGroup

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

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

-JobVariable

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

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

-OnBehalfOfUser

指定用户的名称。 此 cmdlet 将代表用户设置为此参数指定的用户。

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

-OnBehalfOfUserRole

指定用户角色。 此 cmdlet 将代表用户角色设置为此参数指定的用户角色。 若要获取用户角色对象,请使用 Get-SCUserRole cmdlet。

类型:UserRole
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

-VirtualScsiAdapter

指定虚拟机的虚拟 SCSI 适配器对象。

虚拟 SCSI 适配器的主机编号的类型

Hyper-V:每个 VM 最多四个合成虚拟 SCSI 适配器,每个适配器最多 64 台设备。 支持高达 2040 GB 的虚拟磁盘驱动器大小。 不支持模拟的虚拟 SCSI 适配器。 VMware ESX:每个 VM 最多四个虚拟 SCSI 适配器,每个适配器最多 15 台设备。 支持高达 2048 GB 的虚拟磁盘驱动器大小。 Citrix XenServer:每个 VM 始终有一个虚拟 SCSI 适配器,每个适配器最多有 8 台设备。 支持高达 2048 GB 的虚拟磁盘驱动器大小。

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

-WhatIf

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

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

备注

  • 需要 VMM 虚拟 SCSI 适配器对象,可以使用 Get-SCVirtualScsiAdapter cmdlet 进行检索。