Set-StorageQosPolicy

Artikel
11/16/2015

Set-StorageQosPolicy

Modifies an existing Storage QoS policy.

Syntax

Parameter Set: Id
Set-StorageQosPolicy [[-NewName] <String> ] [[-MaximumIops] <UInt64> ] [[-MinimumIops] <UInt64> ] [[-MaximumIOBandwidth] <UInt64> ] -PolicyId <Guid[]> [-CimSession <CimSession[]> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: InputObject (cdxml)
Set-StorageQosPolicy [[-NewName] <String> ] [[-MaximumIops] <UInt64> ] [[-MinimumIops] <UInt64> ] [[-MaximumIOBandwidth] <UInt64> ] [-CimSession <CimSession[]> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: Name
Set-StorageQosPolicy [[-NewName] <String> ] [[-MaximumIops] <UInt64> ] [[-MinimumIops] <UInt64> ] [[-MaximumIOBandwidth] <UInt64> ] -Name <String[]> [-CimSession <CimSession[]> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Detaillierte Beschreibung

The Set-StorageQosPolicy cmdlet modifies an existing Storage Quality of Service (Storage QoS) policy.

For more information about Storage QoS, see Storage Quality of Service in Windows Server Technical Preview (https://technet.microsoft.com/en-us/library/Mt126108).

Parameter

-CimSession<CimSession[]>

Das Cmdlet wird in einer Remotesitzung oder auf einem Remotecomputer ausgeführt. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, wie z. B. die Ausgabe eines New-CimSession oder Get-CimSession-Cmdlets. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

Aliase	Session
Erforderlich?	false
Position?	named
Standardwert	none
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-MaximumIOBandwidth<UInt64>

Specifies the bandwidth limit for the policy, in bytes per second.

Aliase	none
Erforderlich?	false
Position?	5
Standardwert	none
Pipelineeingaben akzeptieren?	true(ByPropertyName)
Platzhalterzeichen akzeptieren?	false

-MaximumIops<UInt64>

Specifies the throughput limit for the policy, in units of 8KB-normalized Input/Output Operations Per Second (IOPS).

Storage usage is measured in normalized IOPS. This is a count of the storage input/output operations per second. Any IO that is 8KB or smaller is considered as one normalized IOPS. Any IO that is larger than 8KB is treated as multiple normalized IOPS. For example, a 256KB request is treated as 32 normalized IOPS.

Aliase	none
Erforderlich?	false
Position?	3
Standardwert	none
Pipelineeingaben akzeptieren?	true(ByPropertyName)
Platzhalterzeichen akzeptieren?	false

-MinimumIops<UInt64>

Specifies the throughput reservation for the policy, in 8KB-normalized IOPS.

Aliase	none
Erforderlich?	false
Position?	4
Standardwert	none
Pipelineeingaben akzeptieren?	true(ByPropertyName)
Platzhalterzeichen akzeptieren?	false

-Name<String[]>

Specifies the name of the policy to be modified. Accepts wildcard patterns.

Aliase	none
Erforderlich?	true
Position?	named
Standardwert	none
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-NewName<String>

Specifies a new name for the policy.

Aliase	none
Erforderlich?	false
Position?	2
Standardwert	none
Pipelineeingaben akzeptieren?	true(ByPropertyName)
Platzhalterzeichen akzeptieren?	false

-PassThru

Gibt ein Objekt an, das das Element darstellt, mit dem Sie arbeiten. Dieses Cmdlet generiert standardmäßig keine Ausgabe.

Aliase	none
Erforderlich?	false
Position?	named
Standardwert	none
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-PolicyId<Guid[]>

Specifies the policy ID of the policy to be modified.

Aliase	none
Erforderlich?	true
Position?	named
Standardwert	none
Pipelineeingaben akzeptieren?	true(ByPropertyName)
Platzhalterzeichen akzeptieren?	false

-ThrottleLimit<Int32>

Gibt die maximale Anzahl gleichzeitiger Vorgänge an, die zum Ausführen des Cmdlets hergestellt werden können. Wenn dieser Parameter ausgelassen wird oder der Wert 0 eingegeben wird, berechnet Windows PowerShell ® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Der Grenzwert gilt nur für das aktuelle Cmdlet, nicht für die Sitzung oder den Computer.

Aliase	none
Erforderlich?	false
Position?	named
Standardwert	none
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Confirm

Fordert Sie vor der Ausführung des Cmdlet zum Bestätigen auf.

Erforderlich?	false
Position?	named
Standardwert	false
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-WhatIf

Zeit, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Erforderlich?	false
Position?	named
Standardwert	false
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

<WorkflowParameters>

Eingaben

Der Eingabetyp ist der Typ der Objekte, die Sie per Piping an das Cmdlet übergeben können.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

Beispiele

Example 1: Increase the IOPS limit on a policy

This command increases the IOPS limit on a policy named Policy01 to 200 8KB-normalized IOPS.

PS C:\> 
Get-StorageQosPolicy -Name "Policy1" | Set-StorageQosPolicy -MaximumIops 200

Share via

Set-StorageQosPolicy