Set-SCVirtualScsiAdapter

更改 VMM 中使用的虚拟 SCSI 适配器的属性。

语法

Set-SCVirtualScsiAdapter
   [-ScsiControllerType <VMSCSIControllerType>]
   [-VirtualScsiAdapter] <VirtualSCSIAdapter>
   [-AdapterID <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

说明

Set-SCVirtualScsiAdapter cmdlet 更改 Virtual Machine Manager (VMM) 环境中使用的虚拟 SCSI 适配器的一个或多个属性。 可以修改的设置包括指定是否共享虚拟 SCSI 适配器并设置适配器 ID。

注意:仅当虚拟机部署在 VMware ESX 主机上时,才支持使用 ShareVirtualScsiAdapter 参数在虚拟机上共享虚拟 SCSI 适配器以启用来宾群集。 SharedVirtualScsiAdapter 参数不用于 Hyper-V 主机上的虚拟机,因为 Hyper-V 主机上的虚拟机使用 iSCSI 进行共享存储。

注意: Set-SCVirtualScsiAdapter 不用于 Citrix XenServer 主机,因为 Citrix XenServer 虚拟机上的 SCSI 适配器不可配置。

示例

示例 1:共享虚拟机上的特定虚拟 SCSI 适配器以启用来宾群集

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualScsiAdapter -VM $VM 
PS C:\> Set-SCVirtualSCSIAdapter -VirtualScsiAdapter $Adapter -ShareVirtualScsiAdapter $True

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

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

最后一个命令启用存储在$Adapter中的虚拟 SCSI 适配器对象,并指定它是共享的,以便可以在来宾群集中使用。

注意:仅当虚拟机部署在 ESX 主机上时,才支持使用 共享 参数在虚拟机上共享虚拟 SCSI 适配器。 共享参数不用于 Hyper-V 主机的虚拟机,因为 Hyper-V 主机上的虚拟机使用 iSCSI 进行共享存储。 共享参数也不适用于 XenServer 主机上的虚拟机,因为基于 XenServer 的虚拟机始终只有一个 SCSI 适配器。

参数

-AdapterID

指定逻辑单元号或 LUN ID。 Hyper-V 和 XenServer 不公开此值,并且无法更改该值。 对于 VMware ESX 主机,默认值为 7,无法更改。

Type:Byte
Position:Named
Default value:None
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

-ScsiControllerType

指定 SCSI 控制器类型。 有效值为:

  • DefaultType
  • NoType
  • LsiLogic
  • BusLogic
  • ParaVirtualSCSI
  • LsiLogicSAS
Type:VMSCSIControllerType
Accepted values:DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShareVirtualScsiAdapter

指示是否共享虚拟 SCSI 适配器,以便可以在来宾群集中使用它。

主机类型:Hyper-V 主机使用此参数:

  • Hyper-V 主机:没有来宾群集 (,请使用 iSCSI 存储)
  • XenServer 主机:没有 (Xen VM 始终只有一个 SCSI 适配器)

注意:在 ESX 主机上的虚拟机上共享 SCSI 控制器时,VMM 将 VMware 上的 SCSI 共享策略默认为“物理”。

Type:Boolean
Aliases:Shared
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

输出

VirtualSCSIAdapter

此 cmdlet 返回 VirtualScsiAdapter 对象。

备注

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