PowerShell Logo Small

Set-NetQosPolicy



This is the built-in help made by Microsoft for the command 'Set-NetQosPolicy', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Updates the Quality of Service (QoS) policy settings.

SYNTAX


Set-NetQosPolicy [[-Name] <String[]>] [-AppPathNameMatchCondition <String>] [-AsJob] [-CimSession <CimSession[]>] [-DSCPAction <SByte>] [-IPDstPortEndMatchCondition
<UInt16>] [-IPDstPortMatchCondition <UInt16>] [-IPDstPortStartMatchCondition <UInt16>] [-IPDstPrefixMatchCondition <String>] [-IPPortMatchCondition <UInt16>]
[-IPProtocolMatchCondition <Protocol>] [-IPSrcPortEndMatchCondition <UInt16>] [-IPSrcPortMatchCondition <UInt16>] [-IPSrcPortStartMatchCondition <UInt16>]
[-IPSrcPrefixMatchCondition <String>] [-MinBandwidthWeightAction <Byte>] [-NetDirectPortMatchCondition <UInt16>] [-NetworkProfile <NetworkProfile>] [-PassThru] [-PolicyStore
<String>] [-Precedence <UInt32>] [-PriorityValue8021Action <SByte>] [-TemplateMatchCondition <Template>] [-ThrottleLimit <Int32>] [-ThrottleRateActionBitsPerSecond <UInt64>]
[-URIMatchCondition <String>] [-URIRecursiveMatchCondition <Boolean>] [-UserMatchCondition <String>] [-Confirm] [-WhatIf] [<CommonParameters>]
Set-NetQosPolicy [-AppPathNameMatchCondition <String>] [-AsJob] [-CimSession <CimSession[]>] [-DSCPAction <SByte>] [-IPDstPortEndMatchCondition <UInt16>]
[-IPDstPortMatchCondition <UInt16>] [-IPDstPortStartMatchCondition <UInt16>] [-IPDstPrefixMatchCondition <String>] [-IPPortMatchCondition <UInt16>]
[-IPProtocolMatchCondition <Protocol>] [-IPSrcPortEndMatchCondition <UInt16>] [-IPSrcPortMatchCondition <UInt16>] [-IPSrcPortStartMatchCondition <UInt16>]
[-IPSrcPrefixMatchCondition <String>] [-MinBandwidthWeightAction <Byte>] [-NetDirectPortMatchCondition <UInt16>] [-NetworkProfile <NetworkProfile>] [-PassThru] [-Precedence
<UInt32>] [-PriorityValue8021Action <SByte>] [-TemplateMatchCondition <Template>] [-ThrottleLimit <Int32>] [-ThrottleRateActionBitsPerSecond <UInt64>] [-URIMatchCondition
<String>] [-URIRecursiveMatchCondition <Boolean>] [-UserMatchCondition <String>] -InputObject <CimInstance[]> [-Confirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Set-NetQosPolicy cmdlet modifies an existing Quality of Service (QoS) policy. Match conditions or actions or general parameters of the policy such as NetworkProfile or
Precedence can be changed.


Users cannot change the location of where an existing QoS policy is stored. Changing the PolicyStore parameter value will fail.


If a policy was created to be in ActiveStore and a user attempts to make it persistent, such as storing the policy on the local computer, the user has to create a new policy
and place it on the local computer (localhost).


If the PolicyStore parameter is not specified, then the cmdlet will search for and update the policy on the local computer (localhost).



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?linkid=287437
Get-NetQosPolicy
New-NetQosPolicy
Remove-NetQosPolicy

REMARKS

<

Examples


EXAMPLE 1

PS C:\> Set-NetQosPolicy –Name "SMB Policy" -NetworkProfile Domain



This example updates the QoS policy named SMB Policy so that it only applies to traffic that is outgoing from a domain-joined network adapter.




EXAMPLE 2

PS C:\> Get-NetQosPolicy –Name "wildcard" | Set-NetQosPolicy -Precedence 250



This example gets the QoS policy named wildcard and updates the precedence of the policy to 250.




EXAMPLE 3

PS C:\> Set-NetQosPolicy –Name "Backup" -IPDstPortStart 3501 -IPDstPortEnd 3510



This example updates the QoS policy named Backup with additional matching conditions.




EXAMPLE 4

PS C:\> Set-NetQosPolicy –Name "IIS" -Recursive $true -ThrottleRateActionBytesPerSecond 3000KB



This example updates the QoS policy named IIS, so that it applies to the return traffic for both the specified URI and subdirectories and files under the URI. This cmdlet
also sets a new throttling rate at 3,000,000 bytes per second. Note: An alias for the ThrottleRateActionBytesPerSecond parameter is ThrottleRateAction. Another alias is
MaxBw.