The Set-MPIOSetting cmdlet changes Microsoft Multipath I/O (MPIO) settings.
The settings are as follows:
PathVerificationState
PathVerificationPeriod
PDORemovePeriod
RetryCount
RetryInterval
UseCustomPathRecoveryTime
CustomPathRecoveryTime
DiskTimeoutValue
You may be prompted to restart the computer for your changes to take effect.
Examples
Example 1: Change the disk time-out
PS C:\> Set-MPIOSetting -NewDiskTimeout 30
This command sets the disk time-out value to 30 seconds.
The system prompts you to restart after you change settings.
You can use the Get-MPIOSetting cmdlet to verify the change.
Parameters
-CustomPathRecovery
Specifies whether MPIO performs custom path recovery.
The acceptable values for this parameter are: Enabled and Disabled.
The default value is Disabled.
Parameter properties
Type:
String
Default value:
None
Accepted values:
Enabled, Disabled
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
6
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-NewDiskTimeout
Specifies the disk time-out value, in seconds.
This value is the length of time the server waits before it marks the I/O request as timed out.
The default value for DiskTimeoutValue is 120.
We recommend a maximum value of 30.
Parameter properties
Type:
Int32
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
5
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-NewPathRecoveryInterval
Specifies a custom path recovery time, in seconds.
This is the length of time before the server tries path recovery.
The default value is 40.
This parameter is not relevant unless you specify Enabled for the CustomPathRecovery parameter.
Parameter properties
Type:
Int32
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
7
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-NewPathVerificationPeriod
Specifies a path verification period, in seconds.
This is the length of time for the server to verify every path.
This parameter is not relevant unless the path verification state has a value of Enabled.
The default value is 30.
You can set the path verification state by using the NewPathVerificationState parameter.
Parameter properties
Type:
Int32
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
0
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-NewPathVerificationState
Specifies whether to enable path verification.
The acceptable values for this parameter are: Enabled and Disabled.
The default value is Disabled.
Parameter properties
Type:
String
Default value:
None
Accepted values:
Enabled, Disabled
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
1
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-NewPDORemovePeriod
Specifies a physical device object (PDO) removal period, in seconds.
This period is the length of time the server waits after all paths to a PDO have failed before it removes the PDO.
The default value is 20.
Parameter properties
Type:
Int32
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
2
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-NewRetryCount
Specifies the number of times to retry an I/O request.
The default value is three times.
Parameter properties
Type:
Int32
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
3
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-NewRetryInterval
Specifies a retry interval, in seconds.
This is the length of time after which the server retries a failed I/O request.
The default value is one second.
Parameter properties
Type:
Int32
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
4
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.