Set-ScsiLun
This cmdlet modifies the configuration of a SCSI device.
Syntax
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
ScsiLun | ScsiLun[] | 2 |
|
Specifies the SCSI device you want to configure. |
| optional | PreferredPath | ScsiLunPath | 1 |
|
Specifies the preferred path to access the SCSI logical unit. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. |
| optional | BlocksToSwitchPath | Int32 | named |
|
Specifies the maximum number of I/O blocks that you want to issue on a given path before the system tries to select a different path. Modifying this setting affects all SCSI LUN devices that are connected to the same ESX/ESXi host. The default value is 2048. |
| optional | CommandsToSwitchPath | Int32 | named |
|
Specifies the maximum number of I/O requests that you want to issue on a given path before the system tries to select a different path. Modifying this setting affects all SCSI LUN devices that are connected to the same ESX host. The default value is 50. This parameter is not supported on vCenter Server 4.x. |
| optional | DeletePartitions | SwitchParameter | named |
|
Removes all partitions from the SCSI disk. A confirmation prompt appears. If Force is specified, the confirmation prompt does not appear and partitions are removed. |
| optional | Force | SwitchParameter | named |
|
Indicates that you want to suppress the prompt that appears when the DeletePartitions parameter is specified. If the Force parameter is specified, you are not asked for confirmation when deleting disk partitions. |
| optional | IsLocal | Boolean | named |
|
Marks the SCSI disk as local or remote. If the value is $true, the SCSI disk is local. If the value is $false, the SCSI disk is remote. |
| optional | IsLocatorLedOn | Boolean | named |
|
Turns the LED locator of a SCSI disk on or off. |
| optional | IsSsd | Boolean | named |
|
Marks the SCSI disk as an SSD or HDD. If the value is $true, the SCSI disk is an SSD type. If the value is $false, the SCSI disk is an HDD type. |
| optional | MultipathPolicy | ScsiLunMultipathPolicy | named |
|
Specifies the policy that the logical unit must use when choosing a path. The following values are valid: Fixed - uses the preferred path whenever possible. RoundRobin - load balance. MostRecentlyUsed - uses the most recently used path. Unknown - supported only when connected to vCenter Server 4.1/ESX 4.1. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. |
| optional | NoBlocksSwitch | SwitchParameter | named |
|
This parameter is deprecated and scheduled for removal. Indicates that switching based on blocks is deactivated. Not supported on vCenter Server 4.x. |
| optional | NoCommandsSwitch | SwitchParameter | named |
|
This parameter is deprecated and scheduled for removal. Indicates that switching based on commands is deactivated. Not supported on vCenter Server 4.x. |
Output
VMware.VimAutomation.ViCore.Types.V1.Host.Storage.Scsi.ScsiLunExamples
Example 1
$scsilun = Get-ScsiLun -VMHost 10.23.123.100 -LunType disk Set-ScsiLun -ScsiLun $scsilun -CommandsToSwitchPath 100
Configures the SCSI LUN device of the virtual machine host so that the maximum number of I/O requests that you want to issue before the system tries to select a different path is 100.
Related Commands
ScsiController
This cmdlet retrieves the virtual SCSI controllers assigned to the specified HardDisk, VirtualMachine, Template, and Snapshot objects.
This cmdlet creates a new SCSI controller.
This cmdlet modifies the specified SCSI controllers.
ScsiLun
This cmdlet retrieves the SCSI devices available on the vCenter Server system.
This cmdlet modifies the configuration of a SCSI device.
ScsiLunPath
This cmdlet retrieves the list of vmhba paths to a specified SCSI device.
This cmdlet configures a vmhba path to a SCSI device.