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 从 Virtual Machine Manager (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 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobGroup

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

Type:Guid
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

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

-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。

Type:VirtualSCSIAdapter
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

备注

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