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