Gets the list of available SCSI controllers for a virtual machine that you can use to attach file-based or pass-through disks.
Syntax
Get-EmcAvailableScsiControllerLocation -VirtualMachineConfiguration <VirtualMachineConfiguration> -ScsiControllerIndex <UInt32> [-Silent] [<CommonParameters>]
Get-EmcAvailableScsiControllerLocation -VirtualMachineConfiguration <VirtualMachineConfiguration> [-Silent] -ScsiControllerId <String> [<CommonParameters>]
Parameters
-VirtualMachineConfiguration <VirtualMachineConfiguration>
Attributes: Required, Position: named
Specifies the ESI virtual machine configuration object, which you can get from the ESI hypervisor host system object VirtualMachinesConfigurations parameter or by using the Get-EmcVirtualMachineConfiguration cmdlet. This cmdlet encapsulates the virtual machine configuration information such as status, MAC addresses, GUID, and attached file-based or pass-through disks.
-ScsiControllerIndex <UInt32>
Attributes: Required, Position: named
Specifies the SCSI controller zero-based index to attach a file-based disk. You can get the SCSI controller information from the ESI hypervisor object or by using the Get-EmcVirtualMachineScsiController cmdlet.
-Silent <SwitchParameter>
Attributes: Optional, Position: named
Turns off all the informational and verbose messages. However, it still displays errors.
-ScsiControllerId <String>
Attributes: Required, Position: named
Specifies the SCSI controller ID to attach a file-based disk. You can get the virtual machine’s SCSI controller information from the ESI hypervisor object or by using the Get-EmcVirtualMachineScsiController cmdlet.
<CommonParameters>
This cmdlet supports these common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. Type get-help about_commonparameters for more details.
Examples
-------------- Example 1 --------------
C:\PS>$hyperv = Get-EmcHostSystem *.133
C:\PS>$hyperv.Model
Hyper-V, PowerEdge R710
C:\PS>Get-EmcHostSystem | Update-EmcSystem -Silent
C:\PS>$vm = Get-EmcHostSystem *.148
C:\PS>$vm.model
Virtual Machine
C:\PS>$vmconfig = $vm | Get-EmcVirtualMachineConfiguration
C:\PS>$vmconfig.status
Running
C:\PS >$sc = Get-EmcVirtualMachineScsiController -VirtualMachineConfiguration $vmconfig
C:\PS >$sc.ScsiControllerIndex
0
C:\PS>$locations =Get-EmcAvailableScsiControllerLocation -VirtualMachineConfiguration $vmconfig -ScsiControllerIndex 0
C:\PS>$locations[0]
0
This example gets the available SCSI controllers of a virtual machine.
---------- Example 2 ----------
C:\PS>$hyperv = Get-EmcHostSystem *.133
C:\PS>$hyperv.Model
Hyper-V, PowerEdge R710
C:\PS>Get-EmcHostSystem | Update-EmcSystem -Silent
C:\PS>$vm = Get-EmcHostSystem *.148
C:\PS>$vm.model
Virtual Machine
C:\PS>$vmconfig = $vm | Get-EmcVirtualMachineConfiguration
C:\PS>$vmconfig.status
Running
C:\PS>Get-EmcVirtualMachineScsiController -VirtualMachineConfiguration $vmconfig
VmName ScsiControllerIndex ScsiControllerId
------ ------------------- ----------------
RG-3 0 {7CDBA5E3-71DB-495A-9289-2452689320E4}
C:\PS>$locations = Get-EmcAvailableScsiControllerLocation -VirtualMachineConfiguration $vmconfig -ScsiControllerId "{7CDBA5E3-71DB-495A-9289-2452689320E4}"
C:\PS>$locations[0]
0
This example gets the available SCSI controllers of a virtual machine using the ScsiControllerId parameter.