New-StorageQosPolicy

New-StorageQosPolicy

Creates a Storage QoS policy.

構文

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

詳細説明

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

パラメーター

-CimSession<CimSession>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。コンピューター名またはセッション オブジェクト (New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など) を入力します。既定値は、ローカル コンピューター上の現在のセッションです。

-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. このパラメーターに指定できる値は、次のとおりです。 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>

コマンドレットを実行する際に確立できる同時実行操作の最大数を指定します。このパラメーターを省略するか、値 0 を入力した場合、コンピューター上で実行されている CIM コマンドレットの数に基づいて、コマンドレットに最適なスロットル制限が Windows PowerShell® によって計算されます。スロットル制限は、セッションやコンピューターではなく、現在のコマンドレットにのみ適用されます。

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

-WhatIf

コマンドレットが実行された場合に何が起きるのかを示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは共通のパラメーターをサポートしています(-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable)。詳細については、TechNet の「 「about_CommonParameters」 (https://go.microsoft.com/fwlink/p/?LinkID=113216) を参照してください。

<WorkflowParameters>

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットが出力するオブジェクトの型です。

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

  Microsoft.Management.Infrastructure.CimInstance オブジェクトは、Windows Management Instrumentation (WMI) オブジェクトを表示するラッパー クラスです。基になる WMI オブジェクトの名前空間とクラス名は、シャープ記号 (#) に続くパスで指定されます。

使用例

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

関連項目

Get-StorageQoSFlow

Get-StorageQosPolicy

Get-StorageQosVolume

Remove-StorageQosPolicy

Set-StorageQosPolicy