Share via


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