Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP 7-mode documentation.

Cmdlet: New-NcQosWorkload


NAME
New-NcQosWorkload

SYNOPSIS
Create a new workload.

SYNTAX
New-NcQosWorkload [-Name] <String> [-Controller <NcController[]>] [<CommonPa
rameters>]


DESCRIPTION
Create a new workload. A unique name must be provided for the new workload.
No work will be classified to a workload unless the workload has at least
one stream. Therefore at least one stream should usually be created along w
ith a workload. If the performance of the workload is to be controlled by Q
oS, a policy must also be defined and attached to the workload.

This cmdlet is not available for Data ONTAP 8.2 and up.


PARAMETERS
-Name <String>
The user visible name of the QoS workload.

Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Controller <NcController[]>
A clustered Data ONTAP controller to receive this cmdlet, as embodied by
an NcController object. This parameter is returned by the Connect-NcCo
ntroller cmdlet. If not specified, the value in the global variable Cur
rentNcController is used. In the latter case, if CurrentNcController co
ntains a collection of NcController objects, this cmdlet is invoked on e
ach controller in succession.

Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS
DataONTAP.C.Types.Qos.QosWorkloadInfo


NOTES


Category: qos
API: qos-workload-create
Family: cluster

-------------- Example 1 --------------

C:\PS>New-NcQosWorkload test-workload


Create a new quality of service workload named "test-workload"


MatchPriority : 1
PolicyUuid : 700169c0-eae7-11e0-8b1e-123478563412
WorkloadClass : user_defined
WorkloadName : test-workload
WorkloadUuid : aba034e9-6e00-11e1-a794-123478563412
MatchPrioritySpecified : True



RELATED LINKS
Get-NcQosWorkload
Set-NcQosWorkload
Remove-NcQosWorkload
Update-NcQosWorkload







 Data ONTAP® PowerShell Toolkit