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