New-FileSystemClone
SYNOPSIS
Creates clones of file systems and file system snapshots.
SYNTAX
New-FileSystemClone [-Cluster] <Cluster> [-SourceId] <String> [-Name] <String> [-Description <String>]
[-AccessPolicy <String>] [-LockingPolicy <String>] [-FolderRenamePolicy <String>]
[-SmbNotifyOnChangeDirDepth <Int32>] [-EnableSmbSyncWrites] [-EnableSmbNoNotify] [-EnableSmbOpLocks]
[-EnableSmbNotifyOnAccess] [-EnableSmbNotifyOnWrite] [-EnableAsyncMountTime] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
Creates clones of file systems and file system snapshots. The options are similar to that of creating a new file system.
EXAMPLES
Example 1
PS C:\> New-FileSystemClone $cluster 62699f2e-b7bb-47f5-d7ae-e6646b20cc4e fsclone1
Where $cluster is a PowerStore cluster. Creates a new file system which is a clone of the source file system whose ID is 62699f2e-b7bb-47f5-d7ae-e6646b20cc4e. The new file system has a name of fsclone1. The command will return a FileSystem object representing the new clone.
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
-SourceId
The ID of the source file system or file system snapshot.
Type: String
Parameter Sets: (All)
Aliases: SnapshotId, FileSystemId
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 clone.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Description
File system clone description.
Type: String
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
-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
-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
-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
-EnableSmbNotifyOnAccess
Enables file access notifications on the file system.
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.
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.
Type: SwitchParameter
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
-EnableAsyncMountTime
Enables async MTIME is on the file system or 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.