Share via


NewNamespace method of the MSFT_DFSNamespace class

Creates a new DFS namespace (DFS-N).

Syntax

uint32 NewNamespace(
  [in]  uint32            Type,
  [in]  string            Description,
  [in]  uint32            Flags,
  [in]  uint32            TimeToLive,
  [in]  uint32            State,
  [in]  string            GrantAdminAccess[],
  [in]  string            NamespaceRootTarget,
  [in]  string            NamespaceRoot,
  [in]  uint32            TargetState,
  [in]  uint32            ReferralPriorityRank,
  [in]  sint32            ReferralPriorityClass,
  [out] MSFT_DFSNamespace cmdletOutput
);

Parameters

Type [in]

The type of namespace to create.

Stand-alone (0)

A stand-alone namespace.

Domain v1 (1)

A domain namespace of Windows 2000 Server mode.

Domain v2 (2)

A domain namespace of Windows Server 2008 mode.

Description [in]

A short description of the purpose of the namespace.

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 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.

TimeToLive [in]

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

State [in]

The state of the DFS-N root.

OFFLINE (3)

Not online.

ONLINE (4)

Online.

GrantAdminAccess [in]

An array that represents the list of user and group accounts that have been delegated administrative access to this namespace.

NamespaceRootTarget [in]

The default root target of the namespace. The root target is a Universal Naming Convention (UNC) path of the format \\ServerName\ShareName, where the ServerName component represents the host name of a DFS root target server, and the ShareName component represents the share name that corresponds to a namespace on the DFS root target server.

NamespaceRoot [in]

The UNC path of the root of the 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. The Type parameter specifies whether the namespace is stand-alone or domain-based.

TargetState [in]

The state of the DFS-N root target.

OFFLINE (3)

Not online. Referrals are disabled.

ONLINE (4)

Online. Referrals are enabled.

ReferralPriorityRank [in]

The priority rank of the namespace.

ReferralPriorityClass [in]

The priority class of the namespace.

Invalid (-1)

Invalid priority.

Normal (0)

Site cost, normal priority.

global-high (1)

Global, high priority.

sitecost-high (2)

Site cost, high priority.

sitecost-low (3)

Site cost, low priority.

global-low (4)

Global, low priority.

cmdletOutput [out]

When this method returns, contains output from the New-DFSNamespace 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_DFSNamespace