Set-ScsiLun Command | Vmware PowerCLI Reference

Set-ScsiLun

This cmdlet modifies the configuration of a SCSI device.

Syntax

Set-ScsiLun
[ -ScsiLun ] < ScsiLun[] >
[ [-PreferredPath ] < ScsiLunPath > ]
[-BlocksToSwitchPath < Int32 > ]
[-CommandsToSwitchPath < Int32 > ]
[-DeletePartitions ]
[-Force ]
[-IsLocal < Boolean > ]
[-IsLocatorLedOn < Boolean > ]
[-IsSsd < Boolean > ]
[-MultipathPolicy < ScsiLunMultipathPolicy > ]
[-NoBlocksSwitch ]
[-NoCommandsSwitch ]
[-ProgressAction < ActionPreference > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
ScsiLun ScsiLun[] 2
  • pipeline
Specifies the SCSI device you want to configure.
optional PreferredPath ScsiLunPath 1
  • pipeline
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
  • pipeline
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.
optional ProgressAction ActionPreference named

Output

VMware.VimAutomation.ViCore.Types.V1.Host.Storage.Scsi.ScsiLun

Examples

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.