Share via


CreateShare method of the MSFT_NfsServerTasks class

Creates a new NFS share to be exported by a Windows NFS server.

Syntax

uint32 CreateShare(
  [in]  string                  Name,
  [in]  string                  Path,
  [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[],
  [out] MSFT_NfsShare           Share
);

Parameters

Name [in]

Type: string

The name (alias) for the share exported by the Windows NFS server. This share name is used when mounting the share from client computers.

Path [in]

Type: string

The local path to the exported share on the Windows NFS server.

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 permissions that apply to the 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.

Share [out]

Type: MSFT_NfsShare

An embedded MSFT_NfsShare that represents the newly created 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_NfsServerTasks

MSFT_NfsShare