New-FileSystem
SYNOPSIS
Creates a new file system.
CAUTION: There can be more than one file system on a cluster with the same name. This could lead to unexpected results when piping the output to cmdlets that remove file systems.
SYNTAX
New-FileSystem [-Cluster] <Cluster> [-NasServer] <String> [-Name] <String> [-Size] <Int64> [-Description <String>] [-ConfigType {General | VMware}] [-AccessPolicy {Native | Unix | Windows}]
[-FolderRenamePolicy {AllRenameAllowed | SMBRenameForbidden | AllRenameForbidden}] [-LockingPolicy {Advisory | Mandatory}] [-ProtectionPolicy <String>] [-SmbNotifyOnChangeDirDepth <Int32>]
[-EnableSmbNoNotify] [-EnableSmbNotifyOnAccess] [-EnableSmbNotifyOnWrite] [-EnableSmbOpLocks] [-EnableSmbSyncWrites] [-EnableAsyncMountTime] [-HostIoSize {VMware8K | VMware16K | VMware32K | Vmware64K}]
[-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
Creates a new file system.
EXAMPLES
Example 1
PS C:\> New-FileSystem $cluster NasServer01 fs01 512GB
Where $cluster is a PowerStore cluster instance. Creates a new file system on NAS server NasServer01 with name fs01 and size 512GB.
Example 2
PS C:\> New-FileSystem $cluster NasServer01 fs02 512GB -AccessPolicy Windows
Where $cluster is a PowerStore cluster instance. Creates a new file system fs02 on NAS server NasServer01 with name fs02 and size 512GB. The file system will use Windows security as the security access policy.
Example 3
PS C:\> New-FileSystem $cluster NasServer01 fs03 512GB
Where $cluster is a PowerStore cluster instance. Creates a new file system fs03 on NAS server NasServer01 with name fs03 and size 512GB.
Example 4
PS C:\> New-FileSystem $cluster NasServer01 fs04 512GB -ProtectionPolicy HourlySnapshots
Where $cluster is a PowerStore cluster instance. Creates a new file system fs03 on NAS server NasServer01 with name fs04 and size 512GB. The protection policy with name HourlySnapshots is applied to 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
-NasServer
The NAS server name.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
The name of the file system.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Size
The size in bytes. The minimum value is 3221225472 (3GB) and the maximum value is 281474976710656 (256TB). Size that the file system presents to the host or end user. (Bytes) Value is always rounded up to the next MB.
Type: Int64
Parameter Sets: (All)
Aliases:
Required: True
Position: 3
Default value: None
Accept pipeline input: False
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
-ConfigType
Indicates the file system type.
- General - General purpose use case file system.
- VMware - Vmware datastore purpose use case file system.
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: General, VMware
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
-ProtectionPolicy
The protection policy to apply 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
-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: False
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: False
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: False
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: False
Accept pipeline input: False
Accept wildcard characters: False
-EnableSmbSyncWrites
Enable synchronous writes.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
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: False
Accept pipeline input: False
Accept wildcard characters: False
-HostIoSize
Typical size of writes from the server or other computer using the VMware file system to the storage system.
- VMware_8K - Host I/O size is 8K for vmware datastore purpose.
- VMware_16K - Host I/O size is 16K for vmware datastore purpose.
- VMware_32K - Host I/O size is 32K for vmware datastore purpose.
- Vmware_64K - Host I/O size is 64K for vmware datastore purpose.
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: VMware8K, VMware16K, VMware32K, Vmware64K
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.