Data ONTAP® PowerShell Toolkit

Cmdlet: Add-NaQuota


NAME
Add-NaQuota

SYNOPSIS
Adds a quota entry.

SYNTAX
Add-NaQuota [-Type] <String> [-Target] <String[]> [-Volume] <String> [[-Qtre
e] <String>] [-DiskLimit <String>] [-FileLimit <String>] [-Threshold <String
>] [-SoftDiskLimit <String>] [-SoftFileLimit <String>] [-Controller <NaContr
oller>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<Co
mmonParameters>]


DESCRIPTION
Adds a quota entry. If the type, target, volume, and tree do not exist, a n
ew entry is created. If the type, target, volume, and tree exist, then an e
rror is returned.


PARAMETERS
-Type <String>
This is the quota type: "user", "group", or "tree".

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

-Target <String[]>
This is the quota target of the type specified. The target can be of th
e form: <name>, <number>, or <path name>. Multiple targets can be speci
fied by a comma-separated list.

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

-Volume <String>
This is the volume name that the quota resides on.

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

-Qtree <String>
This is the qtree name that the quota resides on. It can be the qtree n
ame or omitted if no qtree.

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

-DiskLimit <String>
This is the amount of disk space that is reserved for the the target. T
he value is expressed in bytes. Omit or set the value to "-" if the lim
it is to be unlimited. Default is unlimited.

The format to use is:

<number>[k|m|g|t]

where "k" means kilobytes, "m" means megabytes, "g" means gigabytes, and
"t" means terabytes.

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

-FileLimit <String>
This is the number of files that the target can have. Omit or set the v
alue to "-" if the limit is to be unlimited. Default is unlimited.

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

-Threshold <String>
This is the amount of disk space the target would have to exceed before
a message is logged. The value is expressed in bytes. Omit or set the
value to "-" if the limit is to be unlimited. Default is unlimited.

The format to use is:

<number>[k|m|g|t]

where "k" means kilobytes, "m" means megabytes, "g" means gigabytes, and
"t" means terabytes.

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

-SoftDiskLimit <String>
This is the amount of disk space the target would have to exceed before
a message is logged and an SNMP trap is generated. The value is express
ed in bytes. Omit or set the value to "-" if the limit is to be unlimit
ed. Default is unlimited.

The format to use is:

<number>[k|m|g|t]

where "k" means kilobytes, "m" means megabytes, "g" means gigabytes, and
"t" means terabytes.

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

-SoftFileLimit <String>
This is the number of files the target would have to exceed before a mes
sage is logged and an SNMP trap is generated. Omit or set the value to
"-" if the limit is to be unlimited. Default is unlimited.

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

-Controller <NaController>
The DataONTAP controller object, embodied by an NaController object. Th
is parameter is returned by the Connect-NaController cmdlet. If not spe
cified, the value in the global variable CurrentNaController is used.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WarningAction <ActionPreference>


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WarningVariable <String>


Required? false
Position? named
Default value
Accept pipeline input? false
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
System.Collections.Hashtable


NOTES


Category: quota
API: quota-add-entry

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

C:\PS>Add-NaQuota tree * vol0 -DiskLimit 50g


Set the disk limit on volume 'vol' to 50 gigabytes.


Name Value
---- -----
DiskLimitKB 52428800
FileLimit -
PerformUserMapping False
ThresholdKB -
SoftDiskLimitKB -
SoftFileLimit -
QuotaError



RELATED LINKS
Get-NaQuota
Remove-NaQuota







 Data ONTAP® PowerShell Toolkit