Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP Cluster-mode documentation.

Cmdlet: Get-NaQuota


NAME
Get-NaQuota

SYNOPSIS
Obtains a quota entry specified by type, target, volume, and tree.

SYNTAX
Get-NaQuota -UserName <String[]> -Volume <String> [-Qtree <String>] [-Contro
ller <NaController>] [<CommonParameters>]

Get-NaQuota -GroupId <String> -Volume <String> [-Qtree <String>] [-Controlle
r <NaController>] [<CommonParameters>]

Get-NaQuota -Path <String> [-Controller <NaController>] [<CommonParameters>]

Get-NaQuota [-Type] <String> [-Target] <String[]> -Volume <String> [-Qtree <
String>] [-Controller <NaController>] [<CommonParameters>]


DESCRIPTION
Obtains a quota entry specified by type, target, volume, and tree. The disk
space quota values are returned in bytes.


PARAMETERS
-UserName <String[]>
A user can be specfied as a: unix user name, numerical user ID, windows
account name, Windows SID or a comma separated list of multiple users.

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

-Volume <String>
Name of the volume for the quota.

Required? true
Position? named
Default value
Accept pipeline input? false
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? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.

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

-GroupId <String>
May be one of the following: Unix group name, numerical group id (If the
group id is 0, no limits set will be enforced, but usage will still be
tracked), or the pathname of a file owned by that group (specifying a fi
le or directory will not affect the quota on that file or directory, onl
y the GID).

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

-Path <String>
A complete path to an existing qtree.

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

-Type <String>
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

<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.PowerShell.SDK.Cmdlets.Quota.Quota


NOTES


Category: quota
API: quota-get-entry

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

C:\PS>Get-NaQuota tree * vol0


Get the tree quota on volume 'testvol'.


DiskLimit : 53687091200
FileLimit : -
PerformUserMapping : False
QuotaError :
SoftDiskLimit : -
SoftFileLimit : -
Threshold : -


-------------- Example 2 --------------

C:\PS>Get-NaQuota -GroupId Users -Volume testvol -Qtree qtree2


Get a group quota.


Type : group
Target : {Users}
Volume : testvol
Qtree : qtree2
DiskLimit : 2147483648
FileLimit : -
PerformUserMapping : False
QuotaError :

SoftDiskLimit : -
SoftFileLimit : -
Threshold : -


-------------- Example 3 --------------

C:\PS>Get-NaQuota -Path /vol/testvol/qtree2


Gets the quota for qtree2 on testvol.


Type : tree
Target : {/vol/testvol/qtree2}
Volume : testvol
Qtree :
DiskLimit : 2147483648
FileLimit : -
PerformUserMapping : False
QuotaError :
SoftDiskLimit : -
SoftFileLimit : -
Threshold : -


-------------- Example 4 --------------

C:\PS>Get-NaQuota -UserName vf1user -Volume testvol -Qtree qtree2


Get the quota for vf1user for qtree2 on testvol.


Type : user
Target : {vf1user}
Volume : testvol
Qtree : qtree2
DiskLimit : 2147483648
FileLimit : -
PerformUserMapping : False
QuotaError :

SoftDiskLimit : -
SoftFileLimit : -
Threshold : -



RELATED LINKS
Get-NaQuotaEntry







 Data ONTAP® PowerShell Toolkit