Share via


SetNamespace method of the MSFT_DFSNamespace class

Updates a property on a DFS namespace (DFS-N).

Syntax

uint32 SetNamespace(
  [in]  uint32            State,
  [in]  uint32            TimeToLive,
  [in]  uint32            Flags,
  [in]  string            Description,
  [in]  string            NamespaceRoot,
  [in]  string            GrantAdminAccess[],
  [in]  string            RevokeAdminAccess[],
  [out] MSFT_DFSNamespace cmdletOutput
);

Parameters

State [in]

The state of the DFS-N root.

OFFLINE (3)

Not online.

ONLINE (4)

Online.

TimeToLive [in]

The interval time, in seconds, of the time to live (TTL) of the referral.

Flags [in]

A bitwise combination of the enumeration values that represent the properties of the namespace.

InsiteReferrals (1 (0x1))

Enables in-site referrals for the namespace.

RootScalability (2 (0x2))

Enables namespace polling mode for the namespace.

SiteCosting (4 (0x4))

Enables cost-based site selection for the DFS namespace.

Site cost is a relative, numeric value that indicates the bandwidth or actual monetary cost of transmitting data between two sites, with the lower-cost site being preferred to a higher-cost site. Only a comparison between site costs is meaningful; a single site's cost value by itself does not provide any information.

TargetFailback (8 (0x8))

Enables target failback for the namespace.

AccessBasedEnumeration (32 (0x20))

Enables access-based enumeration for the namespace.

Description [in]

A short description of the purpose of the namespace.

NamespaceRoot [in]

The Universal Naming Convention (UNC) path of the root of the DFS namespace. The namespace root can take one of these two formats:

Server Format Domain Format
\\ServerName\DFSName \\DomainName\DFSName

where:

  • The ServerName component represents the host name of a DFS root target of a namespace.
  • The DomainName component represents the domain name of the domain that hosts the domain-based namespace.
  • The DFSName component represents the DFS-N name.

A stand-alone namespace must have a root with the format shown in the first column, as it must contain a server name. A domain-based namespace can have a root with the format from either column, although the second column's format (which contains a domain name instead of a server name) is the preferred format.

GrantAdminAccess [in]

An array that represents the list of user and group accounts to grant administrative access to on this namespace.

RevokeAdminAccess [in]

An array that represents the list of user and group accounts to revoke administrative access from on this namespace.

cmdletOutput [out]

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

Requirements

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

See also

MSFT_DFSNamespace