MSNFS_Server class

Article
05/31/2018

[The NFS Legacy WMI Classes are no longer available as of Windows Server 2012. Instead, use the NFS WMI Classes.]

Allows for configuration and initialization of the Server for NFS service.

This class is superseded by the MSFT_NfsServerConfig class.

The following syntax is simplified from Managed Object Format (MOF) code.

Syntax

[Dynamic, Provider("MSNFS_PROVIDER"), Singleton, AMENDMENT]
class MSNFS_Server
{
  uint32  State;
  uint32  PortmapProtocol;
  uint32  MountProtocol;
  uint32  NfsProtocol;
  uint32  NlmProtocol;
  uint32  NsmProtocol;
  uint32  MapsvrProtocol;
  uint32  NisProtocol;
  boolean EnableNFSV3;
  boolean RenewAuthEnabled;
  uint32  RenewAuthInterval;
  uint32  FsDirCacheHighWaterMark;
  string  CharactersTranslationFile;
  boolean DotFileHidden;
  boolean CaseSensitiveLookup;
  uint32  NtfsCase;
  uint32  NlmGracePeriod;
  uint32  ActivityLog;
  uint32  NetGroup;
  string  NisServer;
  string  NisDomain;
  string  LdapServer;
  string  LdapNamingContext;
};

Members

The MSNFS_Server class has these types of members:

Methods
Properties

Methods

The MSNFS_Server class has these methods.

Method	Description
StartService	Starts the Win32 Server for NFS service and kernel mode driver.
StopService	Stops the Win32 Server for NFS service and kernel mode driver.

Properties

The MSNFS_Server class has these properties.

ActivityLog

Data type: uint32
Access type: Read/write
Qualifiers: BitMap ("0", "1", "2", "3", "4", "5", "6", "7", "8"), BitValues ("Mount", "Unmount", "Read", "Write", "Create", "Delete", "Lock", "Unlock", "Unmapped Unix user access")

Gets or sets the bitmask that specifies a list of activities that will be logged by the Server for NFS service. Possible values include:

Bit	Meaning
0x1	Mount
0x2	Unmount
0x4	Read
0x8	Write
0x10	Create
0x20	Delete
0x40	Lock
0x80	Unlock

CaseSensitiveLookup

Data type: boolean
Access type: Read/write

When set TRUE, the Server for NFS service will perform case sensitive lookups using the NT Object Manager. Success of this operation depends on the global registry key of HKLM\SYSTEM\CurrentControlSet\SessionManager\kernel\obcasesensitive being set to 0.

CharactersTranslationFile

Data type: string
Access type: Read/write

Gets or sets the name of the file used for character translation.

DotFileHidden

Data type: boolean
Access type: Read/write

When set TRUE, the Server for NFS service creates files with names beginning in dot ('.') as hidden files.

EnableNFSV3

Data type: boolean
Access type: Read/write

When set TRUE, the Server for NFS will export shares over the NFS v3 protocol.

FsDirCacheHighWaterMark

Data type: uint32
Access type: Read/write

Gets or sets the size, in KBs, of the directory cache. Minimum allowed cache size is 4 KB, with a maximum range of 129 KB. By default, this value is set at 4 KB.

Note

Values must be expressed in multiples of 4.

LdapNamingContext

Data type: string
Access type: Read/write

Gets or sets an LDAP naming context (DN) to be used by the Server for NFS service when performing LDAP queries to retrieve netgroup information.

LdapServer

Data type: string
Access type: Read/write

Gets or sets the name of an LDAP server or an Active Directory domain name that is used by the Server for NFS service when querying for netgroup information.

MapsvrProtocol

Data type: uint32
Access type: Read/write
Qualifiers: BitMap ("0", "1"), BitValues ("Use TCP", "Use UDP")

A bitmask that specifies the preferred underlying transport protocol to be used by the Server for NFS service for the MAPSVR protocol. Possible values of this property are:

Bit	Meaning
0x1	TCP
0x2	UDP

MountProtocol

Data type: uint32
Access type: Read/write
Qualifiers: BitMap ("0", "1"), BitValues ("Use TCP", "Use UDP")

A bitmask that specifies the preferred underlying transport protocol to be used by the Server for NFS service for the Mount protocol. Possible values of this property are:

Bit	Meaning
0x1	TCP
0x2	UDP

NetGroup

Data type: uint32
Access type: Read/write

Gets or sets the source used for netgroup lookups. Possible values of this property are:

No netgroup support (0)

No netgroup support.

NIS server (1)

Netgroup source - NIS server.

LDAP server (2)

Netgroup source LDAP server.

NfsProtocol

Data type: uint32
Access type: Read/write
Qualifiers: BitMap ("0", "1"), BitValues ("Use TCP", "Use UDP")

A bitmask that specifies the preferred underlying transport protocol to be used by the Server for NFS service for the NFS protocol. Possible values of this property are:

Bit	Meaning
0x1	TCP
0x2	UDP

NisDomain

Data type: string
Access type: Read/write

Gets or sets the NIS domain name to be used when querying for netgroups.

NisProtocol

Data type: uint32
Access type: Read/write
Qualifiers: BitMap ("0", "1"), BitValues ("Use TCP", "Use UDP")

A bitmask that specifies the preferred underlying transport protocol to be used by the Server for NFS service for the NIS protocol. Possible values of this property are:

Bit	Meaning
0x1	TCP
0x2	UDP

NisServer

Data type: string
Access type: Read/write

Gets or sets the NIS server name to be used when querying for netgroups.

NlmGracePeriod

Data type: uint32
Access type: Read/write

Gets or sets the NLM grace period to be enforced by the Server for NFS service. Set at 45 seconds by default, with a maximum range of 3600 seconds.

NlmProtocol

Data type: uint32
Access type: Read/write
Qualifiers: BitMap ("0", "1"), BitValues ("Use TCP", "Use UDP")

A bitmask that specifies the preferred underlying transport protocol to be used by the Server for NFS service for the NLM protocol. Possible values of this property are:

Bit	Meaning
0x1	TCP
0x2	UDP

NsmProtocol

Data type: uint32
Access type: Read/write
Qualifiers: BitMap ("0", "1"), BitValues ("Use TCP", "Use UDP")

A bitmask that specifies the preferred underlying transport protocol to be used by the Server for NFS service for the NSM protocol. Possible values of this property are:

Bit	Meaning
0x1	TCP
0x2	UDP

NtfsCase

Data type: uint32
Access type: Read/write

Gets or sets the letter case for file names returned by the Server for NFS service in response to a READDIR operation. Possible values of this property are:

PRESERVE_CASE (0)

Preserve case.

LOWER_CASE (1)

Lower case.

UPPER_CASE (2)

Upper case.

PortmapProtocol

Data type: uint32
Access type: Read/write
Qualifiers: BitMap ("0", "1"), BitValues ("Use TCP", "Use UDP")

A bitmask that specifies the preferred underlying transport protocol to be used by the Server for NFS service for the Portmapper. Possible values of this property are:

Bit	Meaning
0x1	TCP
0x2	UDP

RenewAuthEnabled

Data type: boolean
Access type: Read/write

When set TRUE, Server for NFS will renew authentication when cached credentials expire.

RenewAuthInterval

Data type: uint32
Access type: Read/write

Gets or sets the interval, in seconds, at which Server for NFS service renews authentication. Minimum allowed value is 0, with a maximum range of 0xFFFFFFFF. By default, this value is set at 600 seconds.

State

Data type: uint32
Access type: Read-only

Indicates the current state of the Server for NFS service. Possible values of this property are:

NotInstalled (0)

The Server for NFS service is not installed.

Stopped (1)

The Server for NFS service is stopped.

Running (2)

The Server for NFS service is running.

Requirements


Minimum supported client	None supported
Minimum supported server	Windows Server 2008 R2
End of client support	None supported
End of server support	Windows Server 2008 R2
Namespace	Root\MSNFS
MOF	Nfswmi.mof
DLL	NfsCimProv.dll

Partager via