New-FileSystemSnapshot
SYNOPSIS
Creates snapshots of file systems and clones.
SYNTAX
New-FileSystemSnapshot [-Cluster] <Cluster> [-FileSystemId] <String> [-Name <String>] [-Description <String>]
[-ExpirationTimestamp <DateTime>] [-EnableAutoDelete] [-AccessType <String>] [-AccessPolicy <String>]
[-LockingPolicy <String>] [-FolderRenamePolicy <String>] [-SmbNotifyOnChangeDirDepth <Int32>]
[-EnableSmbSyncWrites] [-EnableSmbNoNotify] [-EnableSmbOpLocks] [-EnableSmbNotifyOnAccess]
[-EnableSmbNotifyOnWrite] [-EnableAsyncMountTime] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Creates snapshots of file systems and clones. Optionally provide description, access policy, access notifications, or expiration timestamp.
EXAMPLES
Example 1
PS C:\> New-FileSystemSnapshot $cluster -FileSystemId 62699f2e-b7bb-47f5-d7ae-e6646b20cc4e -Name fsSnap1
Where $cluster is a PowerStore cluster. Creates a new file system snapshot of the source file system whose ID is 62699f2e-b7bb-47f5-d7ae-e6646b20cc4e. The new file system snapshot has a name of fsSnap1.
Example 2
PS C:\> New-FileSystemSnapshot $cluster -FileSystemId 62699f2e-b7bb-47f5-d7ae-e6646b20cc4e -ExpirationTimestamp '2030/11/11 12:12:12'
Where $cluster is a PowerStore cluster. Creates a new file system snapshot of the source file system whose ID is 62699f2e-b7bb-47f5-d7ae-e6646b20cc4e. The new file system snapshot has a system generated name and expiration as ‘2030/11/11 12:12:12’.
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
-FileSystemId
The ID of the source file system or clone.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Name
The name of the new file system snapshot. If not provided, system generates a name with date and time when the snapshot is taken.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
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.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableAutoDelete
Indicates whether the snapshot can be automatically deleted per threshold settings.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AccessType
Indicates whether the snapshot directory or protocol access is granted to the file system snapshot.
- Snapshot - Snapshot access is via the .snapshot folder in the file system.
- Protocol - Protocol access is via normal file shares. Protocol access is not provided by default - the NFS and/or SMB share must be created explicitly for the snapshot.
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: Snapshot, Protocol
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: SwitchParameter
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: SwitchParameter
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: SwitchParameter
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: SwitchParameter
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: SwitchParameter
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: SwitchParameter
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.