Share via


GetNamespaces method of the MSFT_DFSNamespace class

Retrieves configuration settings for an existing DFS namespace (DFS-N) or enumerates namespaces by server, domain, or namespace path.

Syntax

uint32 GetNamespaces(
  [in]  string            NamespaceRoot,
  [in]  string            Domain,
  [in]  string            Server,
  [out] MSFT_DFSNamespace cmdletOutput[]
);

Parameters

NamespaceRoot [in]

The Universal Naming Convention (UNC) path to the root of a namespace. This value can be empty.

The UNC path can have 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 property determines whether the namespace is stand-alone or domain-based.

Domain [in]

The domain that contains the DFS namespace(s) on which to retrieve the configuration settings. This value can be empty.

Server [in]

The server that contains the DFS namespace(s) on which to retrieve the configuration settings. This value can be empty.

cmdletOutput [out]

When this method returns, contains an array that represents output from the Get-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