Set-FileSystem
SYNOPSIS
Changes properties of a file system.
SYNTAX
Set-FileSystem [-Cluster] <Cluster> [-Id] <String> [-Size <Int64>] [-Description <String>]
[-ProtectionPolicy <String>] [-RemoveProtectionPolicy] [-AccessPolicy <String>] [-LockingPolicy <String>]
[-FolderRenamePolicy <String>] [-SmbNotifyOnChangeDirDepth <Int32>] [-EnableSmbSyncWrites <Boolean>]
[-EnableSmbNoNotify <Boolean>] [-EnableSmbOpLocks <Boolean>] [-EnableSmbNotifyOnAccess <Boolean>]
[-EnableSmbNotifyOnWrite <Boolean>] [-EnableAsyncMountTime <Boolean>] [-EnableQuota <Boolean>]
[-DefaultSoftLimit <Int64>] [-DefaultHardLimit <Int64>] [-GracePeriod <Int32>] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
Supports changing file system properties; description, size, protection policy, access policy, access notifications, and quotas.
EXAMPLES
Example 1
PS C:\> Set-FileSystem $cluster -Id 627411c4-1b81-548f-daa2-4687da6fdce8 -Size 10GB
Where $cluster is a PowerStore cluster instance. Sets the new size of the file system to 10GB.
Example 2
PS C:\> Set-FileSystem $cluster -Id 627411c4-1b81-548f-daa2-4687da6fdce8 -EnableQuota $True -DefaultSoftLimit 1GB -DefaultHardLimit 2GB
Where $cluster is a PowerStore cluster instance. Sets the new size of the file system quota limits. By default the grace period is one week.
Example 3
PS C:\> Set-FileSystem $cluster -Id 627411c4-1b81-548f-daa2-4687da6fdce8 -EnableQuota $False
Where $cluster is a PowerStore cluster instance. Disables quotas on the file system.
Example 4
PS C:\> Set-FileSystem $cluster -Id 627411c4-1b81-548f-daa2-4687da6fdce8 -ProtectionPolicy HourlySnapshots
Where $cluster is a PowerStore cluster instance. Sets the protection policy for the file system to the HourlySnapshots protection policy.
Example 5
PS C:\> Set-FileSystem $cluster -Id 627411c4-1b81-548f-daa2-4687da6fdce8 -RemoveProtectionPolicy
Where $cluster is a PowerStore cluster instance. Removes the protection policy from the file system.
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
-Id
The file system ID.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Description
File system description.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Size
The new size in bytes to extend the file system to.
Type: Int64
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AccessPolicy
File system security access policies. Each file system uses its access policy to determine how to reconcile the differences between NFS and SMB access control. Selecting an access policy determines which mechanism is used to enforce file security on the particular file system.
- Native - Native Security.
- UNIX - UNIX Security.
- Windows - Windows Security.
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: Native, Unix, Windows
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FolderRenamePolicy
File system folder rename policies for the file system with multiprotocol access enabled. These policies control whether the directory can be renamed from NFS or SMB clients when at least one file is opened in the directory, or in one of its child directories.
- All_Allowed - All protocols are allowed to rename directories without any restrictions.
- SMB_Forbidden - A directory rename from the SMB protocol will be denied if at least one file is opened in the directory or in one of its child directories.
- All_Forbidden - Any directory rename request will be denied regardless of the protocol used, if at least one file is opened in the directory or in one of its child directories.
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: AllRenameAllowed, SMBRenameForbidden, AllRenameForbidden
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableAsyncMountTime
Enables async MTIME is on the file system or protocol snaps that are mounted writeable.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableSmbNoNotify
Disables notifications of changes to directory file structure.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableSmbNotifyOnAccess
Enables file access notifications on the file system.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableSmbNotifyOnWrite
Enables write notifications on the file system.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableSmbOpLocks
Enables opportunistic file locking on the file system.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableSmbSyncWrites
Enable synchronous writes.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LockingPolicy
File system locking policies. These policy choices control whether the NFSv4 range locks are honored. Because NFSv3 is advisory by design, this policy specifies that the NFSv4 locking feature behaves like NFSv3 (advisory mode), for backward compatiblity with applications expecting an advisory locking scheme.
- Advisory - No lock checking for NFS and honor SMB lock range only for SMB.
- Mandatory - Honor SMB and NFS lock range.
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: Advisory, Mandatory
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ProtectionPolicy
The name of the protection policy to assign to the file system.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveProtectionPolicy
Remove the current protection policy. Cannot be used when the -ProtectionPollicy option is used.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-SmbNotifyOnChangeDirDepth
Lowest directory level to which the enabled notifications apply, if any. Range 1-512.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableQuota
Indicates whether quota is enabled. Quotas are not supported for read-only file systems. Default value for the grace period is set to infinite=-1 to match Windows’ quota policy Values are:
- true - Start tracking usages for all users on a file system or a quota tree, and user quota limits will be enforced.
- false - Stop tracking usages for all users on a file system or a quota tree, and user quota limits will not be enforced.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DefaultHardLimit
Default hard limit of user quotas and tree quotas (bytes). The hard limit value is always rounded up to match the file system’s physical block size. 0 means ‘No limitation’. This value can be used to compute the amount of space consumed without limiting the space.
Type: Int64
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DefaultSoftLimit
Default soft limit of user quotas and tree quotas (bytes). Value is always rounded up to match the file system’s physical block size. 0 means ‘No limitation’.
Type: Int64
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GracePeriod
Grace period of soft limits (seconds):
- -1: default: Infinite grace (Windows policy).
- 0: Use system default of 1 week.
- Positive: Grace period after which the soft limit is treated as a hard limit (seconds)
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
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.