New-FileTreeQuota
SYNOPSIS
Creates a new file tree quota.
SYNTAX
New-FileTreeQuota [-Cluster] <Cluster> [-FileSystemId] <string> [-Path] <string> [-Description <string>]
[-HardLimit <long>] [-SoftLimit <long>] [-UserQuotasEnforced <boolean>] [-GracePeriod <int>]
DESCRIPTION
Creates a new file tree quota.
EXAMPLES
Example 1
PS C:\> New-FileTreeQuota -Cluster $cluster -FileSystemId uuid1 -Path /path1/
Where $cluster is a PowerStore cluster instance. Creates a new file tree quota on the file system with ID uuid1 and local path /path1. It is essential to provide the Path with both leading and trailing slashes. Not doing so will cause the cmdlet to fail, as the path will be seen as a file instead of a directory.
Example 2
PS C:\> New-FileTreeQuota -Cluster $cluster -FileSystemId uuid1 -Path /path1/ -SoftLimit 100000 -HardLimit 500000
Where $cluster is a PowerStore cluster instance. Creates a new file tree quota on the file system with ID uuid1 and local path /path1. Sets the soft limit to 100000 bytes and the hard limit to 500000 bytes on the quota, rounding up to the filesystem block size. It is essential to provide the Path with both leading and trailing slashes. Not doing so will cause the cmdlet to fail, as the path will be seen as a file instead of a directory.
Example 3
PS C:\> New-FileTreeQuota -Cluster $cluster -FileSystemId uuid1 -Path /path1/ -UserQuotasEnforced 1
Where $cluster is a PowerStore cluster instance. Creates a new file tree quota on the file system with ID uuid1 and local path /path1. Configures the quota to be enabled for all users. It is essential to provide the Path with both leading and trailing slashes. Not doing so will cause the cmdlet to fail, as the path will be seen as a file instead of a directory.
PARAMETERS
-Cluster
The PowerStore cluster.
Type: Cluster
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FileSystemId
The UUID of the file system to place the file tree quota on.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Local path to the directory the quota is being placed on, relative to the root of the filesystem. The location of this folder must already exist in the directory tree, but the folder itself can be created by this cmdlet. It is essential to provide the Path with both leading and trailing slashes. Not doing so will cause the cmdlet to fail, as the path will be seen as a file instead of a directory.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Description
File tree quota description.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HardLimit
Hard limit of the tree quota, in bytes. No hard limit when set to 0. This value can be used to compute amount of space that is consumed without limiting the space. Value is always rounded up to match the physical block size of the filesystem. Must be higher than soft limit, and cannot be set to a nonzero value while soft limit is still set to zero.
Type: Long
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SoftLimit
Soft limit of the tree quota, in bytes. No soft limit when set to 0. Value is always rounded up to match the physical block size of the filesystem.
Type: Long
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserQuotasEnforced
Whether the quota must be enabled for all users, and whether user quota limits, if any, are enforced. Values are:
- true - Start tracking usage for all users on the quota tree, and enforce user quota limits.
- false - Stop tracking usage for all users on the quota tree, and do not enforce user quota limits (default).
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GracePeriod
Grace period of soft limit (seconds). This will override the default grace period set at filesystem level.
- -1 - Infinite grace period (Windows policy).
- 0 - Use default grace period of 1 week (default).
- Positive - Grace period after which the soft limit is treated as a hard limit (seconds).
Type: Integer
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.