MSFT_NfsMappingStore class

Article
05/31/2018

Represents a user account mapping store on a Windows NFS client or server.

This class can be used to configure Active Directory Domain Services (AD DS), a User Name Mapping (UNM) server, or an LDAP RFC 2307 based store as a mapping source to be used by the NFS client or server.

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

This class supersedes the legacy MSNFS_UserNameMapping class.

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

Syntax

[ClassVersion("1.0"), dynamic, provider("nfscimprov"), AMENDMENT]
class MSFT_NfsMappingStore
{
  string  Name;
  boolean UNMLookupEnabled;
  string  UNMServer;
  boolean ADLookupEnabled;
  string  ADDomain;
  boolean LdapLookupEnabled;
  string  LdapServer;
  string  LdapNamingContext;
  boolean PasswdFileLookupEnabled;
};

Members

The MSFT_NfsMappingStore class has these types of members:

Properties

Properties

The MSFT_NfsMappingStore class has these properties.

ADDomain

Data type: string
Access type: Read/write

The domain name of an Active Directory domain that NFS services will use when retrieving user account mapping information. This property is used only if the ADLookupEnabled property is TRUE.

ADLookupEnabled

Data type: boolean
Access type: Read/write

If TRUE, NFS services must use AD DS or an LDAP RFC 2307 based store as the source for user name mapping information. NFS services will use the domain name specified by the ADDomain property when retrieving user account mapping information.

LdapLookupEnabled

Data type: boolean
Access type: Read/write

If TRUE, NFS services must use Active Directory Lightweight Directory Services (AD LDS) or an LDAP RFC 2307 based store as the source for user name mapping information. The AD LDS or LDAP server name is specified in the LdapServer property.

LdapNamingContext

Data type: string
Access type: Read/write

The naming context within the specified AD LDS that is to be used when retrieving mapped identities. This property is used only if the LdapLookupEnabled property is TRUE.

LdapServer

Data type: string
Access type: Read/write

The AD LDS or RFC 2307 compliant LDAP store that NFS services will use when retrieving user account mapping information. This property is used only if the LdapLookupEnabled property is TRUE.

Name

Data type: string
Access type: Read-only
Qualifiers: key

This property is not used.

PasswdFileLookupEnabled

Data type: boolean
Access type: Read/write

If TRUE, the Windows NFS server or client uses its local passwd file as the identity mapping store. The location of the passwd or group mapping files should be %windir%\system32\drivers\etc so that the Windows NFS server can use it for identity mapping lookup.

Note

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

UNMLookupEnabled

Data type: boolean
Access type: Read/write

If TRUE, a UNM server hosts the identity mapping store. The UNM server name is specified in the UnmServer property.

UNMServer

Data type: string
Access type: Read/write

The name of the UNM server. This property is used only if the UNMLookupEnabled property is TRUE.

Remarks

A domain-joined computer can be configured to use a passwd or group mapping file, AD LDS, AD DS, or UNM.

Only one of AD DS, UNM and AD LDS can be enabled on a Windows NFS server.

The Windows NFS server will look up available identity mapping stores first using the local passwd or group mapping file, then in AD DS, UNM or AD LDS.

Requirements


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

Share via