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 コマンドレットの出力など) を入力します。既定値は、ローカル コンピューター上の現在のセッションです。

-FilePath<String>

Specifies the path of the file that a flow accesses.

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

-IncludeHidden

Indicates that this cmdlet includes the default flow, which groups together all flows not governed by a policy.

-InitiatorId<String>

Identifies the virtual machine that is the initiator of the flow.

-InitiatorName<String>

Specifies the friendly name of the initiator.

-InitiatorNodeName<String>

Specifies the hostname of the node initiating the flow.

-Policy<CimInstance>

Specifies a policy for which to get associated flows.

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

-StorageNodeName<String>

Specifies the hostname of the storage node servicing the flow.

-ThrottleLimit<Int32>

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

-VolumeId<String>

Specifies the ID of a volume that the flow accesses.

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

関連項目

Get-StorageQosPolicy

Get-StorageQosVolume

New-StorageQosPolicy

Remove-StorageQosPolicy

Set-StorageQosPolicy