Type the ID of an NFS share to change.
View NFS share settings explains how to view the IDs of the NFS network shares on the system.
-name
Type the name of an NFS share to change.
Action qualifiers
Qualifier
Description
-async
Run the operation in asynchronous mode.
-descr
Type a brief description of the share.
-defAccess
Specify the default share access settings for host configurations and for unconfigured hosts who can reach the share. Value is one of the following:
ro—Hosts have read-only access to primary storage and snapshots that are associated with the share.
rw—Hosts have read/write access to primary storage and snapshots that are associated with the share.
roroot—Hosts have read-only root access to primary storage and snapshots that are associated with the share.
root—Hosts have read/write root access to primary storage and snapshots that are associated with the share. This value includes the ability to set access controls that restrict the permissions for other login accounts.
na—Hosts have no access to the share or its snapshots.
-advHostMgmtEnabled
Specifies whether the hosts that are specified in the hosts lists are defined using /remote/host objects as their identifier (advanced host management). Values are (case insensitive):
yes (default)—Hosts lists contain the IDs of registered hosts.
no—Host lists contain comma-separated strings, with each string defining a host name, IP, subnet, netgroup, or DNS domain.
This setting may be updated only if the five hosts list below are empty.
-roHosts
Specifies the comma-separated list of identifiers of hosts that are allowed to read the NFS share. It overwrites the existing read-only hosts.
-rwHosts
Specifies the comma-separated list of identifiers of hosts that are allowed to read and write the NFS share. It overwrites the existing read/write hosts.
-roRootHosts
Specifies the comma-separated list of identifiers of hosts with read-only root permissions to the NFS share. It overwrites the existing read-only root hosts.
-rootHosts
Specifies the comma-separated list of identifiers of hosts with root permissions to the NFS share. It overwrites the existing read/write root hosts.
-naHosts
Specifies the comma-separated list of identifiers of hosts without access to the NFS share. It overwrites the existing no access hosts.
-addRoHosts
Specifies the comma-separated list of hosts to be added with read-only access to the NFS share. This option allows you to incrementally add hosts with read-only access to NFS share. It does not overwrite all existing read-only hosts.
-addRwHosts
Specifies the comma-separated list of hosts to be added with read/write access to the NFS share. This option allows you to incrementally add hosts with read/write access to the NFS share. It does not overwrite all existing read/write hosts.
-addRoRootHosts
Specifies the comma-separated list of hosts to be added with read-only root access to the NFS share. This option allows you to incrementally add hosts with read-only root access to the NFS share. It does not overwrite all existing read-only root hosts.
-addRootHosts
Specifies the comma-separated list of hosts to be given read/write root access to the NFS share. This option allows you to incrementally add hosts with read/write root access to the NFS share. It does not overwrite all existing read/write hosts with read/write root access.
-addNaHosts
Specifies the comma-separated list of hosts that have no access to the NFS share. This option allows you to incrementally specify hosts that will have no access to the NFS share. It does not overwrite all existing no-access hosts.
-removeHosts
Specifies the comma-separated list of hosts for which access to the NFS share will be removed. This option allows you to incrementally remove host access to the NFS share.
-minSecurity
Specifies a minimal security option that must be provided by the client for an NFS mount operation. The value is one of the following, from lower to higher security level. All higher security levels are supported, and can be enforced by the client at negotiations for secure NFS access.
sys—No server-side authentication (server relies on NFS client authentication)
This option is also known as
AUTH_SYS security.
krb5—Kerberos v5 authentication
krb5i—Kerberos v5 authentication and integrity
krb5p—Kerberos v5 authentication and integrity; encryption is enabled
-allowSuid
Specifies whether to allow users to set the
setuid
and
setgid UNIX permission bits. Values are (case insensitive):
yes
(default)—Users can set the
setuid and
setgid—UNIX permission bits. This value allows users to run the executable with the privileges of the file owner.
no—Users cannot set the
setuid and
setgid—UNIX permission bits.
-anonUid
Specify the UID of the anonymous account.
-anonGid
Specify the GID of the anonymous account.
Example 1
The following command changes NFS share NFSShare_1 to block access to the share and its snapshots for host HOST_1:
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
ID = NFSShare_1
Operation completed successfully.
Example 2
The following command changes NFS share NFSShare_1 to add read-only access to the share and its snapshots for host HOST_3.
NOTE:HOST_2, HOST_4, and HOST_5 already have ready-only access to the share, but the entire list of current read-only hosts must be specified whenever you remove or add a new read-only host.
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
ID = NFSShare_1
Operation completed successfully.
Example 3
The following example shows host access changes to NFSShare_2. Host_2 is added as a read-only host, Host_3 is added as a read/write host, and access is removed for Host_1: