New-StorageQosPolicy

New-StorageQosPolicy

Creates a Storage QoS policy.

Sintaxis

Parameter Set: Arguments
New-StorageQosPolicy [[-PolicyId] <Guid> ] [[-Name] <String> ] [[-MaximumIops] <UInt64> ] [[-MinimumIops] <UInt64> ] [[-MaximumIOBandwidth] <UInt64> ] [[-ParentPolicy] <CimInstance> ] [[-PolicyType] <PolicyType> {SingleInstance | MultiInstance} ] [-CimSession <CimSession> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: Object
New-StorageQosPolicy [-Policy] <CimInstance> [-CimSession <CimSession> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Descripción detallada

The New-StorageQoSPolicy cmdlet creates a Storage Quality of Service (Storage QoS) policy that specifies the maximum and minimum throughput.

This cmdlet generates the ID of the policy that it creates, if the PolicyId parameter is not specified.

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

-MaximumIOBandwidth<UInt64>

Specifies the bandwidth limit for the policy, in bytes per seconds.

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

-MaximumIops<UInt64>

Specifies the throughput limit for the policy, in units of 8KB-normalized Input/Output Operations Per Second (IOPS).

Storage usage is measured in normalized IOPS. This is a count of the storage input/output operations per second. Any IO that is 8KB or smaller is considered as one normalized IOPS. Any IO that is larger than 8KB is treated as multiple normalized IOPS. For example, a 256KB request is treated as 32 normalized IOPS.

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

-MinimumIops<UInt64>

Specifies the throughput reservation for the policy, in 8KB-normalized IOPS.

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

-Name<String>

Specifies the name of the policy to create.

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

-ParentPolicy<CimInstance>

Specifies the parent policy of the policy that this cmdlet creates. The object must specify the PolicyId field.

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 the storage QoS Policy that this cmdlet creates in the policy manager. Must be a valid MSFT_StorageQoSPolicy instance that specifies MaximumIops and MinimumIops.

Alias	none
¿Necesario?	true
¿Posición?	1
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 that this cmdlet creates.

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

-PolicyType<PolicyType>

Specifies the type of the policy that this cmdlet creates. Los valores aceptables para este parámetro son: SingleInstance or MultiInstance. In a single-instance policy, the maximum and minimum throughputs apply to the aggregate throughput of all initiators. In a multi-instance policy, the minimum and maximum throughputs apply to each initiator individually.

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

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

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

-WhatIf

Muestra lo que sucedería si se ejecuta el cmdlet. El cmdlet no se ejecuta.

¿Necesario?	false
¿Posición?	named
Valor predeterminado	false
¿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: Create a policy

This command creates a policy with a maximum of 100 8KB-normalized IOPS and a minimum of 10.

PS C:\> New-StorageQosPolicy -Name "Policy01" -MaximumIops 100 -MinimumIops 10

Temas relacionados

Get-StorageQoSFlow

Get-StorageQosPolicy

Get-StorageQosVolume

Remove-StorageQosPolicy

Set-StorageQosPolicy