Set-ScsiLun

This cmdlet modifies the configuration of a SCSI device.

Syntax

[-ScsiLun]  <ScsiLun[]>
[[-PreferredPath]  <ScsiLunPath>]
[-BlocksToSwitchPath  <Int32>]
[-CommandsToSwitchPath  <Int32>]
[-DeletePartitions]
[-Force]
[-IsLocal  <Boolean>]
[-IsLocatorLedOn  <Boolean>]
[-IsSsd  <Boolean>]
[-MultipathPolicy  <ScsiLunMultipathPolicy>]
[-NoBlocksSwitch]
[-NoCommandsSwitch]
[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 disabled 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:
    optional
    NoBlocksSwitch
    SwitchParameter named This parameter is deprecated and scheduled for removal. Indicates that switching based on blocks is disabled. 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 disabled. Not supported on vCenter Server 4.x.

    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

    Feedback

    Was this page helpful?