Syntax
Set-ScsiLun [[-MultipathPolicy] <ScsiLunMultipathPolicy>] [[-PreferredPath] <ScsiLunPath>] [-ScsiLun] <ScsiLun[]> [-BlocksToSwitchPath <Int32>] [-CommandsToSwitchPath <Int32>] [-DeletePartitions] [-Force] [-IsLocal <Boolean>] [-IsLocatorLedOn <Boolean>] [-IsSsd <Boolean>] [-NoBlocksSwitch] [-NoCommandsSwitch] [-Confirm] [-WhatIf] [<CommonParameters>]Related Commands
Online VersionDetailed Description
This cmdlet modifies the configuration of a SCSI device.Parameters
Name | Type | Description | Required? | Pipeline Input | Default Value |
---|---|---|---|---|---|
MultipathPolicy | ScsiLunMultipathPolicy | 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 disabled in a future release. | false | True (ByValue) | |
PreferredPath | ScsiLunPath | 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. | false | True (ByValue) | |
ScsiLun | ScsiLun[] | Specifies the SCSI device you want to configure. | true | True (ByValue) | |
BlocksToSwitchPath | Int32 | Specifies the maximum number of I/O blocks to be issued on a given path before the system tries to select a different path. Modifying this setting affects all ScsiLun devices that are connected to the same ESX/ESXi host. The default value is 2048. Setting this parameter to zero (0) disables switching based on blocks. | false | False | |
CommandsToSwitchPath | Int32 | Specifies the maximum number of I/O requests to be issued on a given path before the system tries to select a different path. Modifying this setting affects all ScsiLun devices that are connected to the same ESX host. The default value is 50. Setting this parameter to zero (0) disables switching based on commands. This parameter is not supported on vCenter Server 4.x. | false | 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. | false | False | |
DeletePartitions | SwitchParameter | 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. | false | False | |
Force | SwitchParameter | Indicates that you want to suppress the prompt that appears when DeletePartitions is specified. If Force is specified, you are not asked for confirmation when deleting disk partitions. | false | False | |
IsLocal | Boolean | 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. | false | False | |
IsLocatorLedOn | Boolean | Turns the LED locator of a SCSI disk on or off. | false | False | |
IsSsd | Boolean | Marks the SCSI disk as an SSD or HDD. If the value is $true, the SCSI disk is SSD type. If the value is $false, the SCSI disk is HDD type. | false | False | |
NoBlocksSwitch | SwitchParameter | Indicates that switching based on blocks is disabled. Not supported on vCenter Server 4.x. | false | False | |
NoCommandsSwitch | SwitchParameter | Indicates that switching based on commands is disabled. Not supported on vCenter Server 4.x. | false | False | |
WhatIf | SwitchParameter | Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified. | false | False |
Return Type
Zero or more modified ScsiLun objectsNotes
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 to be issued before the system tries to select a different path is 100.