Set-FileSystemSnapshot
SYNOPSIS
Changes properties of a file system snapshot.
SYNTAX
Set-FileSystemSnapshot [-Cluster] <Cluster> [-Id] <String> [-Description <String>]
[-ExpirationTimestamp <DateTime>] [-AccessPolicy <String>] [-LockingPolicy <String>]
[-FolderRenamePolicy <String>] [-SmbNotifyOnChangeDirDepth <Int32>] [-EnableSmbSyncWrites <Boolean>]
[-EnableSmbNoNotify <Boolean>] [-EnableSmbOpLocks <Boolean>] [-EnableSmbNotifyOnAccess <Boolean>]
[-EnableSmbNotifyOnWrite <Boolean>] [-EnableAsyncMountTime <Boolean>] [-Confirm] [-WhatIf]
[<CommonParameters>]
DESCRIPTION
Supports changing file system snapshot properties; description, access policy, access notifications, and expiration.
EXAMPLES
Example 1
PS C:\> Set-FileSystemSnapshot $cluster -Id 627411c4-1b81-548f-daa2-4687da6fdce8 -ExpirationTimestamp '2030/11/11 12:12:12'
Where $cluster is a PowerStore cluster instance. Sets the expiration to ‘2030/11/11 12:12:12’ on the file system snapshot.
Example 2
PS C:\> Set-FileSystemSnapshot $cluster -Id 627411c4-1b81-548f-daa2-4687da6fdce8 -AccessPolicy Windows -FolderRenamePolicy AllRenameForbidden
Where $cluster is a PowerStore cluster instance. Sets the security access policy as Windows and folder rename policy as AllRenameForbidden on the file system snapshot.
Example 3
PS C:\> Set-FileSystemSnapshot $cluster -Id 627411c4-1b81-548f-daa2-4687da6fdce8 -EnableSmbSyncWrites $True -EnableSmbNotifyOnWrite $False
Where $cluster is a PowerStore cluster instance. Enables synchronous writes and disables file write notifications on the file system snapshot.
PARAMETERS
-Cluster
The PowerStore cluster instance.
Type: Cluster
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Id
The file system snapshot 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 snapshot description.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExpirationTimestamp
Time when the snapshot will expire. Use 1970-01-01T00:00:00.000Z to set expiration timestamp to null.
Type: DateTime
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
-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
-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
-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
-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
-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
-EnableSmbOpLocks
Enables opportunistic file locking on the file system snapshot.
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 snapshot.
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 snapshot.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableAsyncMountTime
Enables async MTIME on the 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
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
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: 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.