Get-StorageQosPolicy
Get-StorageQosPolicy
Retrieves a storage QoS policy from the policy manager.
Sintaxis
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>]
Descripción detallada
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).
Parámetros
-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.
Alias |
none |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-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 |
Session |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Flow<CimInstance>
Specifies a flow object. If the Flow parameter is specified, this cmdlet retrieves the policy governing the flow input object, if any.
Alias |
none |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
true(ByValue) |
¿Aceptar caracteres comodín? |
false |
-Name<String[]>
Specifies the name of the policy, or a wildcard pattern.
Alias |
none |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-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.
Alias |
none |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
true(ByValue) |
¿Aceptar caracteres comodín? |
false |
-PolicyId<Guid[]>
Specifies the GUID of the policy.
Alias |
none |
¿Necesario? |
false |
¿Posición? |
named |
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 |
<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_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).
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 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")