Get-StorageQoSFlow

Get-StorageQoSFlow

Retrieves performance metrics on an I/O flow that is monitored by Storage QoS.

Sintaxis

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

Descripción detallada

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

Parámetros

-CimSession<CimSession>

Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession. El valor predeterminado es la sesión actual en el equipo local.

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-FilePath<String>

Specifies the path of the file that a flow accesses.

Alias	none
¿Necesario?	false
¿Posición?	3
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	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.

Alias	none
¿Necesario?	false
¿Posición?	1
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-IncludeHidden

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

Alias	none
¿Necesario?	false
¿Posición?	9
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-InitiatorId<String>

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

Alias	none
¿Necesario?	false
¿Posición?	2
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-InitiatorName<String>

Specifies the friendly name of the initiator.

Alias	none
¿Necesario?	false
¿Posición?	5
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-InitiatorNodeName<String>

Specifies the hostname of the node initiating the flow.

Alias	none
¿Necesario?	false
¿Posición?	6
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-Policy<CimInstance>

Specifies a policy for which to get associated flows.

Alias	none
¿Necesario?	true
¿Posición?	10
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	true(ByValue)
¿Aceptar caracteres comodín?	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.

Alias	none
¿Necesario?	false
¿Posición?	8
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-StorageNodeName<String>

Specifies the hostname of the storage node servicing the flow.

Alias	none
¿Necesario?	false
¿Posición?	7
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-ThrottleLimit<Int32>

Especifica el número máximo de operaciones simultáneas que pueden establecerse para ejecutar el cmdlet. Si se omite este parámetro o si se escribe un valor de 0, Windows PowerShell® calcula un límite óptimo para el cmdlet en función del número de cmdlets CIM que se ejecutan en el equipo. El límite solo se aplica al cmdlet actual, no a la sesión o al equipo.

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-VolumeId<String>

Specifies the ID of a volume that the flow accesses.

Alias	none
¿Necesario?	false
¿Posición?	4
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

<WorkflowParameters>

Entradas

El tipo de entrada es el tipo de objetos que se pueden canalizar al cmdlet.

Salidas

El tipo de resultado es el tipo de los objetos que el cmdlet emite.

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

  El objeto Microsoft.Management.Infrastructure.CimInstance es una clase contenedora que muestra los objetos de Instrumental de administración de Windows (WMI). La ruta de acceso después de la almohadilla (#) proporciona el espacio de nombres y el nombre de clase del objeto WMI subyacente.

Ejemplos

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"

Temas relacionados

Get-StorageQosPolicy

Get-StorageQosVolume

New-StorageQosPolicy

Remove-StorageQosPolicy

Set-StorageQosPolicy