Export (0) Print
Expand All

Set-MPIOSetting

Windows Server 2012 R2 and Windows 8.1

Updated: October 17, 2013

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Set-MPIOSetting

Changes MPIO settings.

Syntax

Parameter Set: Default
Set-MPIOSetting [[-NewPathVerificationPeriod] <Int32> ] [[-NewPathVerificationState] <String> ] [[-NewPDORemovePeriod] <Int32> ] [[-NewRetryCount] <Int32> ] [[-NewRetryInterval] <Int32> ] [[-NewDiskTimeout] <Int32> ] [[-CustomPathRecovery] <String> ] [[-NewPathRecoveryInterval] <Int32> ] [ <CommonParameters>]




Detailed Description

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.

Parameters

-CustomPathRecovery<String>

Specifies whether MPIO performs custom path recovery. The acceptable values for this parameter are:  Enabled and Disabled. The default value is Disabled.


Aliases

none

Required?

false

Position?

7

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NewDiskTimeout<Int32>

Specifies the disk timeout 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.


Aliases

none

Required?

false

Position?

6

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NewPathRecoveryInterval<Int32>

Specifies a custom path recovery time, in seconds. This is the length of time before the server attempts path recovery. The default value is 40. This parameter is not relevant unless the CustomPathRecovery parameter has the value Enabled.


Aliases

none

Required?

false

Position?

8

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NewPathVerificationPeriod<Int32>

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.


Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NewPathVerificationState<String>

Specifies whether to enable path verification. The acceptable values for this parameter are:  Enabled and Disabled. The default value is Disabled.


Aliases

none

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NewPDORemovePeriod<Int32>

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.


Aliases

none

Required?

false

Position?

3

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NewRetryCount<Int32>

Specifies the number of times to retry an I/O request. The default value is three times.


Aliases

none

Required?

false

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NewRetryInterval<Int32>

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.


Aliases

none

Required?

false

Position?

5

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Change the disk timeout

This command sets the disk timeout 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.


PS C:\> Set-MPIOSetting -NewDiskTimeout 30

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft