Share via


SetNamespaceServerConfig method of the MSFT_DFSNamespaceServerConfig class

Modifies the configuration of a DFS namespace (DFS-N) server.

Syntax

uint32 SetNamespaceServerConfig(
  [in]  string                        NamespaceServer,
  [in]  uint32                        LdapTimeout,
  [in]  boolean                       PreferLogonDC,
  [in]  boolean                       EnableSiteCostedReferrals,
  [in]  boolean                       EnableInsiteReferrals,
  [in]  uint32                        SyncInterval,
  [in]  boolean                       UseFullyQualifiedDomainNames,
  [out] MSFT_DFSNamespaceServerConfig cmdletOutput
);

Parameters

NamespaceServer [in]

The DFS-N server for which to modify the configuration settings.

LdapTimeout [in]

The timeout interval, in seconds, to be enforced by the DFS-N server for Lightweight Directory Access Protocol (LDAP) calls. This value can be between 3 and 300 seconds.

PreferLogonDC [in]

True to place the logon server at the top of the referral list; otherwise, false.

EnableSiteCostedReferrals [in]

True to enable site-costed referrals; otherwise, false.

When site costing is enabled, SYSVOL and NETLOGON referrals sort domain controllers in the order of the the lowest cost. Domain controllers from the client's site are at the top of the referral list, followed by domain controllers from the server that are sorted by the lowest cost. When site costing is disabled, SYSVOL and NETLOGON referrals contain randomly ordered domain controllers from the client's site, followed by randomly ordered domain controllers from the server.

EnableInsiteReferrals [in]

True to enable in-site referrals; otherwise, false. When this setting is enabled, the DFS-N server provides referrals that belong to the same site as the client.

SyncInterval [in]

The interval time, in seconds, between attempts by domain-based root servers and domain controllers to poll the primary domain controller (PDC) emulator master to obtain the updated DFS metadata.

UseFullyQualifiedDomainNames [in]

True to use fully qualified domain names (FQDN) in referrals; false to use NetBIOS in referrals.

cmdletOutput [out]

When this method returns, contains output from the Set-DFSNamespaceServerConfig cmdlet. This parameter is passed uninitialized.

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2012
Namespace
Root\Microsoft\Windows\dfsn
MOF
DfsNCimProv.mof
DLL
DfsNCimProv.dll

See also

MSFT_DFSNamespaceServerConfig