Set-NfsExport
SYNOPSIS
Modifies the properties of an existing NFS export.
SYNTAX
Set-NfsExport [-Cluster] <Cluster> [-Id] <string> [-Description] <string> [-DefaultAccess {NoAccess | ReadOnly | ReadWrite | Root | ReadOnlyRoot}]
[-MinSecurity {Sys | Kerberos | KerberosWithEncryption | KerberosWithIntegrity}] [-AddNoAccessHosts <string[]>] [-AddReadOnlyHosts <string[]>]
[-AddReadOnlyRootHosts <string[]>] [-AddReadWriteHosts <string[]>] [-AddReadWriteRootHosts <string[]>] [-RemoveNoAccessHosts <string[]>]
[-RemoveReadOnlyHosts <string[]>] [-RemoveReadOnlyRootHosts <string[]>] [-RemoveReadWriteHosts <string[]>] [-RemoveReadWriteRootHosts <string[]>]
[-AnonymousUid <int>] [-AnonymousGid <int>] [-NoSuid <boolean>]
DESCRIPTION
Modifies the properties of an existing NFS export. Name, path, and filesystem cannot be changed after creation, but all other properties can be edited using this cmdlet.
EXAMPLES
Example 1
PS C:\> Set-NfsExport -Cluster $cluster -Id uuid1 -Description "New description"
Where $cluster is a PowerStore cluster instance and uuid1 is the ID of the NFS export to edit. Sets the description of the NFS export to ‘New description’.
Example 2
PS C:\> Set-NfsExport -Cluster $cluster -Id uuid1 -MinSecurity Kerberos
Where $cluster is a PowerStore cluster instance and uuid1 is the ID of the NFS export to edit. Sets the minimum security on the export to require Kerberos for user authentication.
Example 3
PS C:\> Set-NfsExport -Cluster $cluster -Id uuid1 -AddNoAccessHosts host1,host2
Where $cluster is a PowerStore cluster instance and uuid1 is the ID of the NFS export to edit. Adds ‘host1’ and ‘host2’ to the list of hosts that have no access to the NFS export or its snapshots.
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
-Id
The UUID of the NFS export to edit.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
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 - 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 - 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
-AddNoAccessHosts
Adds hosts to the list of 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
-AddReadOnlyHosts
Adds hosts to the list of 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
-AddReadOnlyRootHosts
Adds hosts to the list of 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
-AddReadWriteHosts
Adds hosts to the list of 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
-AddReadWriteRootHosts
Adds hosts to the list of 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
-RemoveNoAccessHosts
Removes hosts from the list of 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
-RemoveReadOnlyHosts
Removes hosts from the list of 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
-RemoveReadOnlyRootHosts
Removes hosts from the list of 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
-RemoveReadWriteHosts
Removes hosts from the list of 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
-RemoveReadWriteRootHosts
Removes hosts from the list of 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 if set to true.
Type: Boolean
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.