Get-StorageQosPolicy

Get-StorageQosPolicy

Retrieves a storage QoS policy from the policy manager.

構文

Parameter Set: ByChild
Get-StorageQosPolicy [-ChildPolicy <CimInstance> ] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: ByFlow
Get-StorageQosPolicy [-CimSession <CimSession[]> ] [-Flow <CimInstance> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: ByParent
Get-StorageQosPolicy [-CimSession <CimSession[]> ] [-ParentPolicy <CimInstance> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: Id
Get-StorageQosPolicy [-CimSession <CimSession[]> ] [-PolicyId <Guid[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: Name
Get-StorageQosPolicy [-CimSession <CimSession[]> ] [-Name <String[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]

詳細説明

The Get-StorageQosPolicy cmdlet retrieves a storage Quality of Service (QoS) policy from the storage QoS Windows Management Instrumentation (WMI) provider.

For more information about Storage QoS, see Storage Quality of Service in Windows Server Technical Preview (https://technet.microsoft.com/en-us/library/Mt126108).

パラメーター

-ChildPolicy<CimInstance>

Specifies a child policy, for which to retrieve a parent policy. If the ChildPolicy parameter is specified, this cmdlet retrieves any parent policy associated with the input object.

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。コンピューター名またはセッション オブジェクト (New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など) を入力します。既定値は、ローカル コンピューター上の現在のセッションです。

-Flow<CimInstance>

Specifies a flow object. If the Flow parameter is specified, this cmdlet retrieves the policy governing the flow input object, if any.

-Name<String[]>

Specifies the name of the policy, or a wildcard pattern.

-ParentPolicy<CimInstance>

Specifies a parent policy for which to retrieve child policies. If the ParentPolicy parameter is specified, this cmdlet retrieves all of the child policies associated with the input object.

-PolicyId<Guid[]>

Specifies the GUID of the policy.

-ThrottleLimit<Int32>

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

<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: Get a QoS policy by name

This command gets the QoS policy named Policy01.

PS C:\> Get-StorageQosPolicy -Name "Policy01"

Example 2: Get a parent QoS policy

This command gets the parent policy of the policy named Policy02. If there are hierarchical policies, the hierarchy can be traversed using -ChildPolicy and -ParentPolicy.

PS C:\> 
Get-StorageQosPolicy -ChildPolicy (Get-StorageQosPolicy -Name "Policy02")

関連項目

Get-StorageQoSFlow

Get-StorageQosVolume

New-StorageQosPolicy

Remove-StorageQosPolicy

Set-StorageQosPolicy