Set-SCVirtualScsiAdapter

Changes properties of a virtual SCSI adapter used in VMM.

Description

The Set-SCVirtualScsiAdapter cmdlet changes one or more properties of a virtual SCSI adapter used in a System Center Virtual Machine Manager (VMM) environment. Settings that you can modify include specifying whether or not a virtual SCSI adapter is shared and setting the adapter ID.

Note: Using the ShareVirtualScsiAdapter parameter to share a virtual SCSI adapter on a virtual machine in order to enable guest clustering is supported only if the virtual machine is deployed on a VMware ESX host. The SharedVirtualScsiAdapter parameter is not used for a virtual machine on a Hyper-V host because a virtual machine on a Hyper-V host uses iSCSI for shared storage.

Note: Set-SCVirtualScsiAdapter is not used for Citrix XenServer hosts because the SCSI adapter on Citrix XenServer virtual machines is not configurable.

For more information about Set-SCVirtualScsiAdapter, type: "Get-Help Set-SCVirtualScsiAdapter -online".

Parameters

VirtualScsiAdapter

Required? true
Accept Pipeline Input? true (ByValue)
Position? 0
Specifies a virtual SCSI adapter object for a virtual machine. 

TYPE OF HOST	NUMBER OF VIRTUAL SCSI ADAPTERS
------------	-------------------------------
Hyper-V		 Up to 4 synthetic virtual SCSI adapters per VM,
	and up to 64 devices per adapter
	Supports a virtual disk drive size up to 2040 GB. 
	Does not support emulated virtual SCSI adapters.
VMware ESX	Up to 4 virtual SCSI adapters per VM, 
	and up to 15 devices per adapter.
	Supports a virtual disk drive size up to 2048 GB.
Citrix XenServer   Always 1 virtual SCSI adapter per VM,
	and up to 8 devices per adapter.
	Supports a virtual disk drive size up to 2048 GB.

AdapterID

Required? false
Accept Pipeline Input? false
Position? named
Specifies the logical unit number, or LUN ID. Hyper-V and XenServer do not expose this value, and it cannot be changed. For a VMware ESX host, the default is 7 and cannot be changed. 

JobGroup

Required? false
Accept Pipeline Input? false
Position? named
Specifies an identifier for a series of commands that will run as a set just before the final command that includes the same job group identifier runs. 

JobVariable

Required? false
Accept Pipeline Input? false
Position? named
Specifies that job progress is tracked and stored in the variable named by this parameter. 

PROTipID

Required? false
Accept Pipeline Input? false
Position? named
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named
Indicates that the job runs asynchronously so that control returns to the command shell immediately. 

ScsiControllerType

Required? false
Accept Pipeline Input? false
Position? named
Specifies a SCSI controller type. Valid values are: DefaultType, NoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS.

ShareVirtualScsiAdapter

Required? false
Accept Pipeline Input? false
Position? named
Specifies that a virtual SCSI adapter will be shared so that it can be used in guest clustering.

 TYPE OF HOST		USES THIS PARAMETER
 ------------		--------------------
 Hyper-V host		No  (for guest clustering, use iSCSI storage)
 XenServer host  No  (Xen VMs always have exactly one SCSI adapter)
Note: When sharing a SCSI controller on a virtual machine on an ESX host, VMM defaults the SCSI sharing policy on VMware to "physical."
Requires a VMM virtual SCSI adapter object, which can be retrieved by using the Get-SCVirtualScsiAdapter cmdlet.

Examples

1: Share a specific virtual SCSI adapter on a virtual machine to enable it for guest clustering.
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualScsiAdapter -VM $VM 
PS C:\> Set-SCVirtualSCSIAdapter -VirtualScsiAdapter $Adapter -ShareVirtualScsiAdapter $True
The first command gets the virtual machine object named VM01 and stores the object in the $VM variable.

The second command gets the SCSI adapter object on VM01 and stores the object in the $Adapter variable. This example assumes that VM01 has one virtual SCSI adapter. However, a virtual machine can have up to four virtual SCSI adapters attached.

The last command enables the virtual SCSI adapter object stored in $Adapter and specifies that is it shared so that it can be used in guest clustering. 

NOTE: Using the Shared parameter to share a virtual SCSI adapter on a virtual machine is supported only if the virtual machine is deployed on an ESX host. The Shared parameter is not used for a virtual machine a Hyper-V host because a virtual machine on a Hyper-V host uses iSCSI for shared storage. The Shared parameter is also not used for a virtual machine on a XenServer host because XenServer-based virtual machines always have exactly one SCSI adapter.

See Also