MSFT_NfsServerConfig class

Represents configuration settings for a Windows NFS server.

MSFT_NfsServerConfig is a singleton class; there is only one instance.

This class supersedes the legacy MSNFS_Server class.

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

Syntax

[ClassVersion("1.0"), dynamic, provider("nfscimprov"), AMENDMENT]
class MSFT_NfsServerConfig
{
  string  Name;
  uint32  State;
  string  LogActivity[];
  string  CharacterTranslationFile;
  uint32  DirectoryCacheSize;
  boolean EnableAuthRenewal;
  uint32  AuthRenewalInterval;
  boolean EnableNFSV2;
  boolean EnableNFSV3;
  boolean EnableNFSV4;
  boolean HideFilesBeginningInDot;
  uint32  NlmGracePeriod;
  string  MapsvrProtocol[];
  string  MountProtocol[];
  string  NfsProtocol[];
  string  NisProtocol[];
  string  NlmProtocol[];
  string  NsmProtocol[];
  string  PortmapProtocol[];
  uint32  GracePeriod;
  uint32  NetgroupCacheTimeout;
  boolean PreserveInheritance;
  string  UnmappedUserAccount;
  string  WorldAccount;
  boolean AlwaysOpenByName;
  uint32  LeasePeriod;
  boolean ClearMappingCache;
  uint32  OnlineTimeoutInSeconds;
};

Members

The MSFT_NfsServerConfig class has these types of members:

• Properties

Properties

The MSFT_NfsServerConfig class has these properties.

AlwaysOpenByName

Data type: boolean

Access type: Read/write

If TRUE, the Windows NFS server tries to open files and directories by name, instead of by NTFS file ID, with the following limitations:

• In some cases, the server cannot open the file by name and must open it by file ID.
• If a file has multiple hard links, the server chooses one of them as the file name. It is not predictable which name the server will choose. As a result, the name used for the file open may or may not be the name that the application is attempting to watch for.

For performance reasons, this property is FALSE by default, and the Windows NFS server opens files and directories by file ID.

Set this property to TRUE if your application requires compatibility with file system filter drivers that intercept open by file names, or if it relies on directory change notifications to work against NFS shares.

AuthRenewalInterval

Data type: uint32

Access type: Read/write

The interval, in seconds, at which the Windows NFS Server renews authentication. The default value is 600. The minimum value is 1, and the maximum value is 0x7FFFFFFF.

CharacterTranslationFile

Data type: string

Access type: Read/write

The name of the file to use for character translation.

ClearMappingCache

Data type: boolean

Access type: Read/write

If TRUE, the Windows NFS server purges its mapping cache.

Note

Even though this property is declared as Read/write, it is in fact write-only.

DirectoryCacheSize

Data type: uint32

Access type: Read/write

The size, in KB, of the directory cache. This value must be a multiple of 4. The default value is 4. The minimum value is 4, and the maximum value is 128.

EnableAuthRenewal

Data type: boolean

Access type: Read/write

If TRUE, the Windows NFS server will renew authentication when cached credentials expire.

EnableNFSV2

Data type: boolean

Access type: Read/write

If TRUE, the Windows NFS server will export shares over the NFS version 2 protocol.

EnableNFSV3

Data type: boolean

Access type: Read/write

If TRUE, the Windows NFS server will export shares over the NFS version 3 protocol.

EnableNFSV4

Data type: boolean

Access type: Read/write

If TRUE, the Windows NFS server will export shares over the NFS version 4.1 protocol.

GracePeriod

Data type: uint32

Access type: Read/write

The NFS version 4.1 server lock recovery grace period, in seconds. The default value is 240. The minimum value is 10, and the maximum value is 600.

The value of the GracePeriod property must be at least twice as large as the value of the LeasePeriod property.

HideFilesBeginningInDot

Data type: boolean

Access type: Read/write

If TRUE, the Windows NFS server will create files with names beginning with a period (".") as hidden files.

LeasePeriod

Data type: uint32

Access type: Read/write

The NFS v4.1 server lease time, in seconds. The default value is 120. The minimum value is 5, and the maximum value is 300.

The value of the GracePeriod property must be at least twice as large as the value of the LeasePeriod property.

LogActivity

Data type: string array

Access type: Read/write

An array of strings that specify the activities that are to be logged by the Windows NFS server. Each string can be one of the following:

• "mount"
• "unmount"
• "read"
• "write"
• "create"
• "delete"
• "lock"
• "unlock"

In addition, the following values can be used to set or clear all activity logging:

"none"

Don't log any activity.

"all"

Log all activities (mount, unmount, read, write, create, delete, lock, unlock).

MapsvrProtocol

Data type: string array

Access type: Read/write

An array of strings that specify the preferred underlying transport protocols to be used by the Windows NFS server for the MAPSVR protocol. Possible values for this property are:

"tcp"

Use TCP.

"udp"

Use UDP.

Requirements