COMMAND EVERYTHING.

Set-MPIOSetting

Changes MPIO settings.

PowerShell · Risk: High · Documentation Verified

Last verified: 2026-10-26

Microsoft MPIO reference: Changes MPIO settings. The syntax and selected example below are adapted from the pinned Windows Server 2025 reference. Module availability, target configuration and delegated permissions determine whether it can run in your environment. Documentation and parameter text: Microsoft, CC BY 4.0; formatting adapted by Cmdlet World. No execution testing is claimed.

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

Copied 0 times

Required permissions

Use an account with the target resource permissions documented for Set-MPIOSetting. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.

Supported environments

Windows / MPIO · Windows Server 2025 documentation; feature/module prerequisites apply

Parameters

-CustomPathRecovery: Specifies whether MPIO performs custom path recovery. The acceptable values for this parameter are: Enabled and Disabled. The default value is Disabled.
-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.
-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.
-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.
-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.
-NewPathVerificationState: Specifies whether to enable path verification. The acceptable values for this parameter are: Enabled and Disabled. The default value is Disabled.
-NewRetryCount: Specifies the number of times to retry an I/O request. The default value is three times.
-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.

Prerequisites

Windows with the MPIO module and the Windows feature or management tools that provide it. Confirm target connectivity and version compatibility using the linked Microsoft reference.

Security considerations

This cmdlet changes system state. Review every target and parameter in the official reference, test outside production, and prepare an appropriate backup or rollback. Do not execute the example automatically.

Examples

Example 1: Change the disk time-out

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. Source: Microsoft, CC BY 4.0; transcript prompt/output removed. This example was not executed.

Sources

https://github.com/MicrosoftDocs/windows-powershell-docs/blob/b7645dd8c687139b28e845119da30ec670526507/docset/winserver2025-ps/MPIO/Set-MPIOSetting.md

https://learn.microsoft.com/powershell/module/mpio/set-mpiosetting?view=windowsserver2025-ps

Personal collections

Explain or customize this command with AI

Related commands