Get-StorageQoSFlow
Get-StorageQoSFlow
Retrieves performance metrics on an I/O flow that is monitored by Storage QoS.
構文
Parameter Set: Arguments
Get-StorageQoSFlow [[-FlowId] <Guid> ] [[-InitiatorId] <String> ] [[-FilePath] <String> ] [[-VolumeId] <String> ] [[-InitiatorName] <String> ] [[-InitiatorNodeName] <String> ] [[-StorageNodeName] <String> ] [[-Status] <Status> {Ok | InsufficientThroughput | UnknownPolicyId | LostCommunication} ] [[-IncludeHidden]] [-CimSession <CimSession> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]
Parameter Set: Object
Get-StorageQoSFlow [-Policy] <CimInstance> [-CimSession <CimSession> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]
詳細説明
The Get-StorageQoSFlow cmdlet retrieves performance metrics on an I/O flow that is monitored by Storage Quality of Service (Storage QoS). The metrics are throughput and latency averages, computed over a 5-minute rolling time interval.
Each file handle opened by a Hyper-V server to a VHD or VHDX file is considered a flow. If a virtual machine has two virtual hard disks attached, it will have 1 flow to the file server cluster per file. If a VHDX is shared with multiple virtual machines, it will have 1 flow per virtual machine.
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 |
-FilePath<String>
Specifies the path of the file that a flow accesses.
Aliases |
none |
必須/オプション |
false |
位置 |
3 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-FlowId<Guid>
Specifies the GUID that identifies the flow. This identifier is not unique across flow objects, because the same logical flow may be split across several volumes or storage nodes.
Aliases |
none |
必須/オプション |
false |
位置 |
1 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-IncludeHidden
Indicates that this cmdlet includes the default flow, which groups together all flows not governed by a policy.
Aliases |
none |
必須/オプション |
false |
位置 |
9 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-InitiatorId<String>
Identifies the virtual machine that is the initiator of the flow.
Aliases |
none |
必須/オプション |
false |
位置 |
2 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-InitiatorName<String>
Specifies the friendly name of the initiator.
Aliases |
none |
必須/オプション |
false |
位置 |
5 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-InitiatorNodeName<String>
Specifies the hostname of the node initiating the flow.
Aliases |
none |
必須/オプション |
false |
位置 |
6 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-Policy<CimInstance>
Specifies a policy for which to get associated flows.
Aliases |
none |
必須/オプション |
true |
位置 |
10 |
既定値 |
none |
パイプライン入力の受け入れ |
true(ByValue) |
ワイルドカード文字の受け入れ |
false |
-Status<Status>
Specifies the status of the flow.
-- Ok indicates that the flow meets the minimum Input/Output Operations Per Second (IOPS).
-- InsufficientThroughput indicates that the IOPS are below the minimum.
Aliases |
none |
必須/オプション |
false |
位置 |
8 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-StorageNodeName<String>
Specifies the hostname of the storage node servicing the flow.
Aliases |
none |
必須/オプション |
false |
位置 |
7 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-ThrottleLimit<Int32>
コマンドレットを実行する際に確立できる同時実行操作の最大数を指定します。このパラメーターを省略するか、値 0
を入力した場合、コンピューター上で実行されている CIM コマンドレットの数に基づいて、コマンドレットに最適なスロットル制限が Windows PowerShell® によって計算されます。スロットル制限は、セッションやコンピューターではなく、現在のコマンドレットにのみ適用されます。
Aliases |
none |
必須/オプション |
false |
位置 |
named |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-VolumeId<String>
Specifies the ID of a volume that the flow accesses.
Aliases |
none |
必須/オプション |
false |
位置 |
4 |
既定値 |
none |
パイプライン入力の受け入れ |
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_StorageQoSFlow
This cmdlet outputs a Common Information Model (CIM) object of type MSFT_StorageQoSFlow (https://msdn.microsoft.com/en-us/library/mt164591(v=vs.815).aspx).
Microsoft.Management.Infrastructure.CimInstance
オブジェクトは、Windows Management Instrumentation (WMI) オブジェクトを表示するラッパー クラスです。基になる WMI オブジェクトの名前空間とクラス名は、シャープ記号 (#
) に続くパスで指定されます。
使用例
Example 1: Get information on an I/O flow
This command gets information about all flow initiators accessing C:\ClusterStorage\Volume01\TEST.
PS C:\>
Get-StorageQoSFlow -FilePath "C:\ClusterStorage\Volume01\TEST"