Set-MSDSMGlobalDefaultLoadBalancePolicy
Set-MSDSMGlobalDefaultLoadBalancePolicy
Sets the default load balance policy for MPIO devices.
Syntax
Parameter Set: __AllParameterSets
Set-MSDSMGlobalDefaultLoadBalancePolicy [-Policy] <String> [ <CommonParameters>]
Detailed Description
The Set-MSDSMGlobalDefaultLoadBalancePolicy cmdlet sets the default load balance policy for Microsoft Multipath I/O (MPIO) devices. Microsoft Device Specific Module (MSDSM) applies this policy only to devices that it claims after you set the policy.
Use the Get-MSDSMGlobalDefaultLoadBalancePolicy cmdlet to see the current default policy.
Parameters
-Policy<String>
Specifies a default value for load balance policy. The acceptable values for this parameter are:
-- None. Clears any currently configured default load balance policy.
-- FOO. Fail Over Only.
-- RR. Round Robin.
-- LQD. Least Queue Depth.
-- LB. Least Blocks.
Aliases |
none |
Required? |
true |
Position? |
1 |
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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
- System.String
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Set round robin as default policy
This command sets the default load balance policy to round robin.
PS C:\> Set-MSDSMGlobalLoadBalancePolicy -Policy RR
Example 2: Clear default policy
This command clears any current configured default load balance policy.
PS C:\> Set-MSDSMGlobalLoadBalancePolicy -Policy None