PowerCLI Reference

New-ScsiController

Synopsis

This cmdlet 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

This cmdlet creates a new SCSI controller.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
HardDiskHardDiskSpecifies the hard disk you want to attach to the new SCSI controller. Passing multiple values to this parameter is obsolete.truetrue (ByValue)
TypeScsiControllerTypeSpecifies the type of the SCSI controller. The valid values are ParaVirtual, VirtualBusLogic, VirtualLsiLogic, and VirtualLsiLogicSAS.falsefalse
BusSharingModeScsiBusSharingModeSpecifies 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
WhatIfSwitchParameterIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

Return Type

The one or more newly created ScsiController objects

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
$disk | New-ScsiController -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 © VMware, Inc. All rights reserved.