< Back

New-ScsiController

Sun Jan 19, 2020 7:00 pm

NAME New-ScsiController



SYNOPSIS

This cmdlet creates a new SCSI controller.





SYNTAX

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

[-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

This cmdlet creates a new SCSI controller.





PARAMETERS

-BusSharingMode <ScsiBusSharingMode>

Specifies the bus sharing mode of the SCSI controller. The valid values are NoSharing, Physical, and Virtual.



Required? false

Position? 3

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-HardDisk <HardDisk>

Specifies the hard disk you want to attach to the new SCSI controller. Passing multiple values to this

parameter is obsolete.



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-Type <ScsiControllerType>

Specifies the type of the SCSI controller. The valid values are ParaVirtual, VirtualBusLogic, VirtualLsiLogic,

and VirtualLsiLogicSAS.



Required? false

Position? 2

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

If 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.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are

modified.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

The one or more newly created ScsiController objects







NOTES









-------------------------- 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.



RELATED LINKS

Online Version: https://code.vmware.com/doc/preview?id= ... oller.html

Get-ScsiController

Set-ScsiController