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 コマンドレットの出力など) を入力します。既定値は、ローカル コンピューター上の現在のセッションです。
Aliases |
none |
必須/オプション |
false |
位置 |
named |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-MaximumIOBandwidth<UInt64>
Specifies the bandwidth limit for the policy, in bytes per seconds.
Aliases |
none |
必須/オプション |
false |
位置 |
5 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
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.
Aliases |
none |
必須/オプション |
false |
位置 |
3 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-MinimumIops<UInt64>
Specifies the throughput reservation for the policy, in 8KB-normalized IOPS.
Aliases |
none |
必須/オプション |
false |
位置 |
4 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-Name<String>
Specifies the name of the policy to create.
Aliases |
none |
必須/オプション |
false |
位置 |
2 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-ParentPolicy<CimInstance>
Specifies the parent policy of the policy that this cmdlet creates. The object must specify the PolicyId field.
Aliases |
none |
必須/オプション |
false |
位置 |
6 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-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.
Aliases |
none |
必須/オプション |
true |
位置 |
1 |
既定値 |
none |
パイプライン入力の受け入れ |
true(ByValue) |
ワイルドカード文字の受け入れ |
false |
-PolicyId<Guid>
Specifies the GUID of the policy that this cmdlet creates.
Aliases |
none |
必須/オプション |
false |
位置 |
1 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-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.
Aliases |
none |
必須/オプション |
false |
位置 |
7 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-ThrottleLimit<Int32>
コマンドレットを実行する際に確立できる同時実行操作の最大数を指定します。このパラメーターを省略するか、値 0
を入力した場合、コンピューター上で実行されている CIM コマンドレットの数に基づいて、コマンドレットに最適なスロットル制限が Windows PowerShell® によって計算されます。スロットル制限は、セッションやコンピューターではなく、現在のコマンドレットにのみ適用されます。
Aliases |
none |
必須/オプション |
false |
位置 |
named |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
必須/オプション |
false |
位置 |
named |
既定値 |
false |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-WhatIf
コマンドレットが実行された場合に何が起きるのかを示します。コマンドレットは実行されません。
必須/オプション |
false |
位置 |
named |
既定値 |
false |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
<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