vSphere PowerCLI Reference

New-ScsiController

Synopsis

Creates a new SCSI controller.

Syntax

New-ScsiController [-HardDisk] <HardDisk[]> [[-Type] <ScsiControllerType>] [[-BusSharingMode] <ScsiBusSharingMode>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-ScsiController
Set-ScsiController

Detailed Description

Creates a new SCSI controller.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
HardDiskHardDisk[]Specify the hard disks you want to attach to the new SCSI controller.truetrue (ByValue)
TypeScsiControllerTypeSpecify the type of the SCSI controller. The valid values are ParaVirtual, VirtualBusLogic, VirtualLsiLogic, and VirtualLsiLogicSAS.falsefalse
BusSharingModeScsiBusSharingModeSpecify the bus sharing mode of the SCSI controller. The valid values are NoSharing, Physical, and Virtual.falsefalse
ConfirmSwitchParameterIf the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.falsefalse
WhatIfSwitchParameterIndicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

Return Type

ScsiController

Notes

Examples

-------------- Example 1 --------------

$vm = Get-VM VM | New-HardDisk -CapacityKB 10485760 | New-ScsiController

Creates a new 10GB hard disk and a new SCSI controller with default values for the BusSharingMode and Type properties.

-------------- Example 2 --------------

$disk = Get-HardDisk -VM VM | Select -First 2  New-ScsiController -HardDisk $disk -BusSharingMode Physical -Type VirtualLsiLogicSAS

Creates for the first two hard disks of VM a new SCSI controller of VirtualLsiLogicSAS type and with Physical bus sharing mode.


Copyright © 1998 - 2011 VMware, Inc. All rights reserved.