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

See also

MSFT_DFSNamespace