Get-QADRootDSE
From PowerGUI Wiki
Retrieve the rootDSE object from the current directory server (domain controller).
This cmdlet is part of the Quest ActiveRoles Server product. Use Get-QARSProductInfo to view information about ActiveRoles Server.
Contents |
Syntax
Get-QADRootDSE [-Connection <ArsConnection>] [-ConnectionAccount <string>] [-ConnectionPassword <SecureString>] [-Credential <PSCredential>] [-Proxy] [-Service <string>] [-UseGlobalCatalog] [<CommonParameters>]
Detailed Description
This cmdlet returns the rootDSE object containing data about the directory server. The rootDSE object is retrieved from a domain controller that is specific to the current connection. Thus, if connection parameters are supplied to choose a certain domain controller, the cmdlet retrieves the rootDSE object from that domain controller.
The cmdlet has connection parameters that determine the server and the security context for the operation. The connection parameters could be omitted as a connection to a server is established prior to using this cmdlet. In this case, the server and the security context are determined by the Connect-QADService cmdlet.
If you do not use Connect-QADService and have no connection established prior to using a cmdlet, then the connection settings, including the server and the security context, are determined by the connection parameters of the first cmdlet you use. Subsequent cmdlets will use those settings by default.
You can use the rootDSE object to get distinguished names of the domain, schema, and configuration containers, and other data about the directory server and the contents of its directory data tree. For information about attributes supported by rootDSE, refer to the "RootDSE" topic in the Active Directory Schema documentation in the MSDN Library (http://msdn.microsoft.com).
When connected to ActiveRoles Server, the cmdled retrieves the rootDSE object containing information about the ActiveRoles Server namespaces. For information about attributes supported by the ActiveRoles Server rootDSE, refer to the ActiveRoles Server SDK and Resource Kit documentation (this documentation is normally installed with the ActiveRoles Server Administration Service).
Parameters
| Name | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|
| Connection | For parameter description, see help on the Connect-QADService cmdlet. | false | false | |
| ConnectionAccount | For parameter description, see help on the Connect-QADService cmdlet. | false | false | |
| ConnectionPassword | For parameter description, see help on the Connect-QADService cmdlet. | false | false | |
| Credential | For parameter description, see help on the Connect-QADService cmdlet. | false | false | |
| Proxy | For parameter description, see help on the Connect-QADService cmdlet. | false | false | |
| Service | For parameter description, see help on the Connect-QADService cmdlet. | false | false | |
| UseGlobalCatalog | For parameter description, see help on the Connect-QADService cmdlet. | false | false |
Examples
EXAMPLE 1
get-QADRootDSE |
Format-List {$_["defaultNamingContext"]},{$_["schemaNamingContext"]},{$_["configurationNamingContext"]}
Description
List the distinguished names of the domain, schema, and configuration containers for the current connection (this command displays the values of the defaultNamingContext, schemaNamingContext, and configurationNamingContext attributes retrieved from rootDSE).
EXAMPLE 2
(get-QADRootDSE)["serverName"]
Description
Identify the domain controller that is used by the current connection. The output of this command is the distinguished name of the server object for that domain controller in the configuration container (the command displays the value of the serverName attribute retrieved from rootDSE).
EXAMPLE 3
connect-QADService -proxy C:\PS>(get-QADRootDSE)["edsvaServiceFullDns"]
Description
Connect to any available ActiveRoles Server Administration Service and then retrieve the fully qualified domain name of the computer running the Administration Service to which you have connected.
