Set-MPIOSetting
Set-MPIOSetting
Changes MPIO settings.
Sintaxis
Parameter Set: Default
Set-MPIOSetting [[-NewPathVerificationPeriod] <Int32> ] [[-NewPathVerificationState] <String> ] [[-NewPDORemovePeriod] <Int32> ] [[-NewRetryCount] <Int32> ] [[-NewRetryInterval] <Int32> ] [[-NewDiskTimeout] <Int32> ] [[-CustomPathRecovery] <String> ] [[-NewPathRecoveryInterval] <Int32> ] [ <CommonParameters>]
Descripción detallada
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.
Parámetros
-CustomPathRecovery<String>
Specifies whether MPIO performs custom path recovery. Los valores aceptables para este parámetro son los siguientes: Enabled and Disabled. The default value is Disabled.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
7 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
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.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
6 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
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.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
8 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
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.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
1 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-NewPathVerificationState<String>
Specifies whether to enable path verification. Los valores aceptables para este parámetro son los siguientes: Enabled and Disabled. The default value is Disabled.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
2 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
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.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
3 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-NewRetryCount<Int32>
Specifies the number of times to retry an I/O request. The default value is three times.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
4 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
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.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
5 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entradas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.
Salidas
El tipo de resultado es el tipo de objetos que emite el cmdlet.
Ejemplos
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