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>

원격 세션이나 원격 컴퓨터에서 cmdlet을 실행합니다. 컴퓨터 이름이나 New-CimSession 또는 Get-CimSession cmdlet의 출력과 같은 세션 개체를 입력하세요. 기본값은 로컬 컴퓨터 상의 현재 세션입니다.

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

Cmdlet을 실행하도록 설정할 수 있는 동시 작업의 최대 수를 지정합니다. 이 매개 변수를 생략하거나 값으로 0 을 입력하면 Windows PowerShell®은 컴퓨터에서 실행 중인 CIM cmdlet의 수에 따라 cmdlet에 대한 최적의 스로틀 제한을 계산합니다. 스로틀 제한은 현재 cmdlet에만 적용되고, 세션이나 컴퓨터에는 적용되지 않습니다.

-VolumeId<String>

Specifies the ID of a volume that the flow accesses.

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216)

<WorkflowParameters>

입력

입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.

출력

출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.

• 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 개체는 WMI(Windows Management Instrumentation) 개체를 표시하는 래퍼 클래스입니다. 파운드 기호(#) 뒤의 경로는 기본 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