Gets properties for a single domain or all managed domains.
Get-DRADomain [-Domain <String>] [-Attributes <String[]>] [-DRAHostServer <String>] [-DRAHostPort <Int32>] [-DRARestServer <String>] [-DRARestPort <Int32>] [-IgnoreCertificateErrors <SwitchParameter>] [-Force <SwitchParameter>] [-Timeout <Int32>] [<CommonParameters>]
The Get-DRADomain cmdlet returns the properties of domains. You can specify a specific domain. If you do not specify a domain, the server will return the first 250 domains managed by DRA. To filter the domain list, use the Find-DRAObjects command. The server will only return domains for which the requesting user has the View All Domain Properties power. You can view the default list of properties or request specific properties. See the examples for information on how to view specific properties.
|
Attribute / Description |
Parameters / Values |
||||
|---|---|---|---|---|---|
|
Required |
Position |
Default Value |
Accept Pipeline input? |
Accept wildcard characters? |
|
|
Domain [<String>] The domain of the object in fqdn format. For example: mydomain.corp |
true |
named |
|
true (ByPropertyName) |
false |
|
Attributes [<String[]>] An array of attributes to retrieve values for. If this parameter is missing, a default list of properties is returned. |
false |
named |
|
true (ByPropertyName) |
false |
|
DRAHostServer [<String>] The name of the computer running the DRA Host Service. The requested DRA operation will execute on this server. If the parameter is not specified, the value defaults to 'localhost'. |
false |
named |
|
true (ByPropertyName) |
false |
|
DRAHostPort [<Int32>] The port where the DRA Host Service listens for requests. If the parameter is not specified, the value defaults to 11192. |
false |
named |
11192 |
true (ByPropertyName) |
false |
|
DRARestServer [<String>] The name of the computer running the DRA Rest Service. The requested DRA operation will execute on this server. If the parameter is not specified, the value defaults to 'localhost'. |
false |
named |
|
true (ByPropertyName |
false |
|
DRARESTPort [<Int32>] The port where the DRA REST Service listens for requests. If the parameter is not specified, the value defaults to 8755. |
false |
named |
8755 |
true (ByPropertyName |
false |
|
IgnoreCertificateErrors [<SwitchParameter>] Allows the request to bypass any SSL certificate errors, such as the InvalidOperation error that occurs when the REST Service is bound to a self-signed certificate. |
false |
named |
false |
false |
|
|
Force [<SwitchParameter>] Suppresses any request for user input and supplies a 'yes' response. For example: -Force with a delete request will perform the delete without presenting the confirmation request to the user. |
false |
named |
|
false |
false |
|
Timeout [<Int32>] The number of seconds to wait before the request to the DRA REST server times out. To specify an infinite timeout, you can set this parameter to -1. |
false |
named |
100 seconds |
true (ByPropertyName) |
false |
|
<CommonParameters> Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see About CommonParameters. |
|
|
|
|
|
NOTE:For more information, type "Get-Help Get-DRADomain -detailed". For technical information, type "Get-Help Get-DRADomain -full".
Example 11-1 1
PS C:\>Get-DRADomain -Attributes "dnsFlatName","distinguishedName"
This example requests two specific properties for all managed domains: dnsFlatName and distinguishedName. The results will contain the first 250 domains where the requesting user has the View All Domain Properties power. To filter the list or to see more than 250 domains, use the Find-DRAObjects command.
Example 11-2 2
PS C:\>Get-DRADomain -Domain MyDomain.corp
This example requests the default list of properties for the domain MyDomain.corp.