Get-AdSiteLink (RTM)
Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.
Applies to: Exchange Server 2007
Use the Get-AdSiteLink cmdlet to view configuration information about an Active Directory IP site link.
Syntax
Get-AdSiteLink [-Identity <AdSiteLinkIdParameter>] [-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 IP 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. After the least cost routing path is determined, the source Hub Transport servers relay messages to the target Hub Transport servers. By default, the Hub Transport servers that are located in Active Directory sites along the path between the source server and the target server don't process or relay the messages in any way.
However, you can configure an Active Directory site as a hub site so that messages are routed to the hub site to be processed before the messages are relayed to the target server. For this routing behavior to occur, the hub site must exist along the least cost routing path between two Hub Transport servers.
The least cost routing path is also used if a message cannot be delivered to the target site. In this case, message delivery queues at the Hub Transport servers in the closest reachable site along the least cost routing path of the target site.
By default, Exchange 2007 determines the least cost routing path by using the cost that is assigned to the Active Directory IP site links. You can use the Set-AdSiteLink cmdlet to configure an Exchange-specific cost to the Active Directory IP site link. The Exchange-specific cost is a separate attribute that is used instead of the Active Directory-assigned cost to determine the Exchange routing path. You can use the Get-AdSiteLink cmdlet to view the configuration information about an Active Directory IP site link. This configuration information includes the value of the Exchange-specific cost, the cost assigned to the Active Directory IP site link, and a list of the sites in the IP site link.
Use the Identity parameter to retrieve the configuration information about a specific IP site link. If you do not provide an Identity parameter, the configuration information about all IP site links is returned.
To run the Get-AdSiteLink 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 the fully qualified domain name (FQDN) of the domain controller that will process this query. |
Identity |
Optional |
Microsoft.Exchange.Configuration.Tasks.AdSiteLinkIdParameter |
Use the Identity parameter to specify the name or GUID of the IP site link for which you want to view configuration information. |
Input Types
Return Types
Errors
| Error | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Example
The following examples show two Get-AdSiteLink commands that display the configuration information about Active Directory IP site links.
The first example retrieves the configuration information about all the Active Directory IP site links and displays the information in a formatted list.
The second example retrieves the configuration information about the specified Active Directory IP site link and binds to the specified domain controller to process the query.
Get-AdSiteLink | format-list
Get-AdSiteLink -Identity DEFAULTIPSITELINK -DomainController dc1.contoso.com