Get-AdSite
Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3
Use the Get-AdSite cmdlet to display configuration information about one or more Active Directory directory service sites.
Syntax
Get-AdSite [-Identity <AdSiteIdParameter>] [-DomainController <Fqdn>]
Detailed Description
In Microsoft Exchange Server 2007, computers that have the Hub Transport server role installed use Active Directory sites and the costs that are assigned to the Active Directory site links to determine the least cost routing path from each Hub Transport server in the organization to every other Hub Transport server in the organization. Exchange Organization Administrators can use tasks to modify Exchange-specific properties of the Active Directory sites.
You use the Get-AdSite cmdlet to display the configuration details of an Active Directory site. If you do not provide an identity with this cmdlet, configuration information for all Active Directory sites is displayed.
To run the Get-AdSite cmdlet, the account you use must be delegated the following:
- Exchange Organization Administrator role
For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Use the DomainController parameter to specify the host name or fully qualified domain name (FQDN) of the domain controller that will process your query of Active Directory. |
Identity |
Optional |
Microsoft.Exchange.Configuration.Tasks.AdSiteIdParameter |
Use the Identity parameter to specify the identity of the Active Directory site for which you want to view configuration details. The identity can be expressed as a GUID or by using the Active Directory site name. If the site name includes spaces, enclose the entry in double quotation marks. |
Input Types
Return Types
Errors
| Error | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Example
The following example displays the configuration details for an Active Directory site that is named Default-First-Site-Name.
Get-AdSite -Identity Default-First-Site-Name