New-SCStorageQoSPolicy
Creates a storage QoS policy on one or more storage file servers.
Syntax
New-SCStorageQoSPolicy
[-VMMServer <ServerConnection>]
-Name <String>
[-Description <String>]
-PolicyType <StorageQoSPolicyType>
[-IOPSNormalizationSizeKB <UInt32>]
[-IOPSMaximum <UInt64>]
[-IOPSMinimum <UInt64>]
[-BandwidthLimitMBPS <UInt64>]
[-StorageFileServer <StorageFileServer[]>]
[-StorageArray <StorageArray[]>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
The New-SCStorageQoSPolicy cmdlet creates a storage Quality of Service (QoS) policy on one or more storage file servers.
Examples
Example 1: Create a multi-instance storage QoS policy with maximum IOPS settings for a single file server
PS C:\> $FileServersToAdd = @()
PS C:\> $FileServersToAdd += Get-SCStorageFileServer -Name "FileServer01c"
PS C:\> New-SCStorageQoSPolicy -Name "MAXIOPSPolicy" -Description "" -PolicyType "MultiInstance" -IOPSMinimum "0" -IOPSMaximum "10000" -StorageFileServer $FileServersToAddThis command creates a multi-instance storage QoS policy with maximum IOPS settings for a single file server.
Example 2: Create a single-instance storage QoS policy with minimum IOPS settings for two file servers
PS C:\> $FileServersToAdd = @()
PS C:\> $FileServersToAdd += Get-SCStorageFileServer -Name "FileServer01c"
PS C:\> $FileServersToAdd += Get-SCStorageFileServer -Name "FileServer02c"
New-SCStorageQoSPolicy -Name "MINIOPSPolicy" -Description "" -PolicyType "SingleInstance" -IOPSMinimum "5000" -IOPSMaximum "0" -StorageFileServer $FileServersToAddThis command creates a single-instance storage QoS policy with minimum IOPS settings for two file servers.
Parameters
-BandwidthLimitMBPS
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Specifies a description for the policy.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IOPSMaximum
Specifies the maximum IOPS.
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IOPSMinimum
Specifies the minimum IOPS.
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IOPSNormalizationSizeKB
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Specifies a variable in which job progress is tracked and stored.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specifies the name of a Virtual Machine Manager (VMM) object.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PolicyType
Specifies the QoS policy type. The acceptable values for this parameter are:
- SingleInstance
- MultiInstance
| Type: | StorageQoSPolicyType |
| Accepted values: | Aggregated, Dedicated |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indicates that the job runs asynchronously so that control returns to the command shell immediately.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageArray
| Type: | StorageArray[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageFileServer
Specifies an array of storage file server objects.
| Type: | StorageFileServer[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Specifies a VMM server object.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Outputs
StorageQoSPolicy
This cmdlet returns a StorageQoSPolicy object.