New-NfsExport
SYNOPSIS
Creates a new NFS export.
SYNTAX
New-NfsExport [-Cluster] <Cluster> [-FileSystemId] <string> [Path] <string> [-Name] <string> [-Description] <string>
[-DefaultAccess {NoAccess | ReadOnly | ReadWrite | Root | ReadOnlyRoot}] [-MinSecurity {Sys | Kerberos | KerberosWithEncryption | KerberosWithIntegrity}]
[-NoAccessHosts <string[]>] [-ReadOnlyHosts <string[]>] [-ReadOnlyRootHosts <string[]>] [-ReadWriteHosts <string[]>] [-ReadWriteRootHosts <string[]>]
[-AnonymousUid <int>] [-AnonymousGid <int>] [-NoSuid]
DESCRIPTION
Creates a new NFS export.
EXAMPLES
Example 1
PS C:\> New-NfsExport -Cluster $cluster -FileSystemId uuid1 -Path /fsname1 -Name nfs1
Where $cluster is a PowerStore cluster instance. Creates a new NFS export named nfs1 on the file system with ID uuid1 and local path /fsname1.
Example 2
PS C:\> New-NfsExport -Cluster $cluster -FileSystemId uuid1 -Path /fsname1 -Name nfs1 -DefaultAccess ReadWrite
Where $cluster is a PowerStore cluster instance. Creates a new NFS export named nfs1 on the file system with ID uuid1 and local path /fsname1. Sets the default access level for hosts accessing the export to ReadWrite.
Example 3
PS C:\> New-NfsExport -Cluster $cluster -FileSystemId uuid1 -Path /fsname1 -Name nfs1 -NoSuid
Where $cluster is a PowerStore cluster instance. Creates a new NFS export named nfs1 on the file system with ID uuid1 and local path /fsname1. Configures the share to not allow access to setting the SUID.
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
-FileSystemId
The UUID of the file system to place the NFS export on.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Local path to the file system or any existing sub-folder of the file system that is shared over the network. This path is relative to the NAS Server and must start with the file system’s mountpoint path, which is the file system name. For example, to share the top-level of a file system named svr1fs1, which is on the /svr1fs1 mountpoint of the NAS Server, use /svr1fs1 in the path parameter. NFS exports allow you to create multiple network shares for the same local path.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
The name of the NFS export.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Description
NFS export description.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DefaultAccess
Default access level for all hosts that can access the Export.
- NoAccess - Default. Deny access to the Export for the hosts.
- ReadOnly - Allow read only access to the Export for the hosts.
- ReadWrite - Allow read write access to the Export for the hosts.
- Root - Allow read write access to the Export for the hosts. Allow access to the Export for root user.
- ReadOnlyRoot - Allow read only root access to the Export for the hosts.
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: NoAccess, ReadOnly, ReadWrite, Root, ReadOnlyRoot
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MinSecurity
Default access level for all hosts that can access the Export.
NFS enforced security type for users accessing an NFS Export.
- Sys - Default. Allow the user to authenticate with any NFS security types: UNIX, Kerberos, Kerberos with integrity, or Kerberos with encryption.
- Kerberos - Allow only Kerberos security for user authentication.
- KerberosWithIntegrity - Allow only Kerberos with integrity and Kerberos with encryption security for user authentication.
- KerberosWithEncryption - Allow only Kerberos with encryption security for user authentication.
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: Sys, Kerberos, KerberosWithIntegrity, KerberosWithEncryption
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NoAccessHosts
Hosts with no access to the NFS export or its snapshots. Hosts can be entered by Hostname, IP addresses (IPv4, IPv6, IPv4/PrefixLength, IPv6/PrefixLenght, or IPv4/subnetmask), or Netgroups prefixed with @.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ReadOnlyHosts
Hosts with read-only access to the NFS export and its snapshots. Hosts can be entered by Hostname, IP addresses (IPv4, IPv6, IPv4/PrefixLength, IPv6/PrefixLenght, or IPv4/subnetmask), or Netgroups prefixed with @.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ReadOnlyRootHosts
Hosts with read-only and ready-only for root user access to the NFS Export and its snapshots. Hosts can be entered by Hostname, IP addresses (IPv4, IPv6, IPv4/PrefixLength, IPv6/PrefixLenght, or IPv4/subnetmask), or Netgroups prefixed with @.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ReadWriteHosts
Hosts with read and write access to the NFS export and its snapshots.Hosts can be entered by Hostname, IP addresses (IPv4, IPv6, IPv4/PrefixLength, IPv6/PrefixLenght, or IPv4/subnetmask), or Netgroups prefixed with @.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ReadWriteRootHosts
Hosts with read and write and read and write for root user access to the NFS Export and its snapshots. Hosts can be entered by Hostname, IP addresses (IPv4, IPv6, IPv4/PrefixLength, IPv6/PrefixLenght, or IPv4/subnetmask), or Netgroups prefixed with @.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AnonymousUid
Specifies the user ID of the anonymous account.
Type: Integer
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AnonymousGid
Specifies the group ID of the anonymous account.
Type: Integer
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NoSuid
Disables access to set the SUID on the export.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
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.