ModifyShareByName method of the MSFT_NfsServerTasks class

Modifies the settings for an NFS share by name.

Syntax

uint32 ModifyShareByName(
  [in] string                  Name,
  [in] string                  NetworkName,
  [in] string                  Authentication[],
  [in] boolean                 UnmappedUserAccess,
  [in] boolean                 AnonymousAccess,
  [in] sint32                  AnonymousUid,
  [in] sint32                  AnonymousGid,
  [in] string                  LanguageEncoding,
  [in] boolean                 AllowRootAccess,
  [in] string                  Permission,
  [in] MSFT_NfsSharePermission ClientPermission[]
);

Parameters

Name [in]

Type: string

The name (alias) for the share.

NetworkName [in]

Type: string

The failover cluster client access point (network name) through which the highly available NFS share is exported.

Authentication [in]

Type: string[]

An array of strings that specify the permitted security/authentication flavors that are enabled for this share by the Windows NFS server. Each string can be one of the following:

"sys"

UNIX-style authentication

"krb5"

Kerberos 5 authentication

"krb5i"

Kerberos 5 authentication with integrity

"krb5p"

Kerberos 5 authentication with privacy

"default"

"sys", "krb5", and "krb5i"

"all"

"sys", "krb5", "krb5i", and "krb5p"

UnmappedUserAccess [in]

Type: boolean

If TRUE, the NFS share is configured to allow unmapped UNIX user access by UID or GID.

AnonymousAccess [in]

Type: boolean

If TRUE, the NFS share is configured to allow access by anonymous users.

AnonymousUid [in]

Type: sint32

The user identifier to be used for anonymous users accessing the share.

AnonymousGid [in]

Type: sint32

The group identifier to be used for anonymous users accessing the share.

LanguageEncoding [in]

Type: string

The type of language encoding that is configured for the NFS share. One of the following:

"euc-jp"

EUC-JP (Japanese)

"euc-tw"

EUC-TW (Traditional Chinese)

"euc-kr"

EUC-KR (Korean)

"shift-JIS"

Shift JIS (Japanese)

"big5"

Big-5 (Traditional Chinese)

"ksc5601"

KS C 5601 (Korean)

"gb2312-80"

GB2312 (1980) (Simplified Chinese)

"ansi"

ANSI

AllowRootAccess [in]

Type: boolean

If TRUE, the NFS share is configured to allow access by the UNIX root user.

Permission [in]

Type: string

The type of access to set for the NFS share. One of the following values:

"no-access"

Denied access to the share.

"readwrite"

Read/write access to the share.

"readonly"

Read-only access to the share.

ClientPermission [in]

Type: MSFT_NfsSharePermission[]

The client permissions that apply to the share. The value of this parameter replaces the existing share settings on the share.

Requirements

Minimum supported client
Windows 8
Minimum supported server
Windows Server 2012
Namespace
Root\Microsoft\Windows\NFS
MOF
NfsCimProv.mof
DLL
NfsCimProv.dll

See also

MSFT_NfsSharePermission

MSFT_NfsServerTasks