New-StorageQosPolicy

New-StorageQosPolicy

Creates a Storage QoS policy.

Syntax

Parameter Set: Arguments
New-StorageQosPolicy [[-PolicyId] <Guid> ] [[-Name] <String> ] [[-MaximumIops] <UInt64> ] [[-MinimumIops] <UInt64> ] [[-MaximumIOBandwidth] <UInt64> ] [[-ParentPolicy] <CimInstance> ] [[-PolicyType] <PolicyType> {SingleInstance | MultiInstance} ] [-CimSession <CimSession> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: Object
New-StorageQosPolicy [-Policy] <CimInstance> [-CimSession <CimSession> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Detaillierte Beschreibung

The New-StorageQoSPolicy cmdlet creates a Storage Quality of Service (Storage QoS) policy that specifies the maximum and minimum throughput.

This cmdlet generates the ID of the policy that it creates, if the PolicyId parameter is not specified.

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.

-MaximumIOBandwidth<UInt64>

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

-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.

-MinimumIops<UInt64>

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

-Name<String>

Specifies the name of the policy to create.

-ParentPolicy<CimInstance>

Specifies the parent policy of the policy that this cmdlet creates. The object must specify the PolicyId field.

-Policy<CimInstance>

Specifies the storage QoS Policy that this cmdlet creates in the policy manager. Must be a valid MSFT_StorageQoSPolicy instance that specifies MaximumIops and MinimumIops.

-PolicyId<Guid>

Specifies the GUID of the policy that this cmdlet creates.

-PolicyType<PolicyType>

Specifies the type of the policy that this cmdlet creates. Die zulässigen Werte für diesen Parameter sind: SingleInstance or MultiInstance. In a single-instance policy, the maximum and minimum throughputs apply to the aggregate throughput of all initiators. In a multi-instance policy, the minimum and maximum throughputs apply to each initiator individually.

-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.

-Confirm

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

-WhatIf

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

<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.

• Microsoft.Management.Infrastructure.CimInstance#MSFT_StorageQoSPolicy

  This cmdlet outputs a Common Information Model (CIM) object of type MSFT_StorageQoSPolicy (https://msdn.microsoft.com/en-us/library/mt164592(v=vs.85).aspx).

  Das Microsoft.Management.Infrastructure.CimInstance-Objekt ist eine Wrapperklasse, die Windows-Verwaltungsinstrumentation-Objekte (Windows Management Instrumentation, WMI) angezeigt. Der Pfad nach dem Nummernzeichen (#) stellt den Namespace und den Klassennamen des zugrunde liegenden WMI-Objekts dar.

Beispiele

Example 1: Create a policy

This command creates a policy with a maximum of 100 8KB-normalized IOPS and a minimum of 10.

PS C:\> New-StorageQosPolicy -Name "Policy01" -MaximumIops 100 -MinimumIops 10

Verwandte Themen

Get-StorageQoSFlow

Get-StorageQosPolicy

Get-StorageQosVolume

Remove-StorageQosPolicy

Set-StorageQosPolicy