3. Viewing and Managing Active Directory Site Link Details
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.
Example 3
provides the syntax and usage, as well as sample output, for the
Get-AdSiteLink cmdlet. Use the –Identity parameter to retrieve the
configuration information about a specific IP site link. If you do not
provide an identity, the configuration information about all IP site
links is returned.
Example 3. Get-AdSiteLink cmdlet syntax and usage
Syntax
Get-AdSiteLink [-Identity 'SiteIdentity
']
[-DomainController 'DCName
']
Usage
Get-AdSiteLink -Identity 'PORTLANDSEATTLELINK' | fl
Output
Runspaceid :
Cost : 100
ADCost : 100
ExchangeCost :
MaxMessageSize : unlimited
Sites : {First-Seattle-Site}
AdminDisplayName :
ExchangeVersion : 0.0 (6.5.6500.0)
Name : PORTLANDSEATTLELINK
DistinguishedName : CN=PORTLANDSEATTLELINK,CN=IP,
CN=Inter-Site Transports,CN=Sites,
CN=Configuration,DC=cpandl,DC=com
Identity : cpandl.com/Configuration/Sites/
Inter-Site Transports/IP/PORTLANDSEATTLELINK
Guid : b304910a-4a2e-47af-8755-ac0e72653f9f
ObjectCategory : cpandl.com/Configuration/Schema/Site-Link
ObjectClass : {top, siteLink}
WhenChanged : 12/17/2009 8:36:00 PM
WhenCreated : 12/17/2009 8:36:00 PM
WhenChangedUTC : 12/17/2009 3:36:00 AM
WhenCreatedUTC : 12/17/2009 3:36:00 AM
OrganizationId :
OriginatingServer : MAILSERVER25.cpandl.com
IsValid : True
By default, Exchange Server 2010 determines the least-cost routing path by using the cost that is assigned to the Active Directory IP site links. You can change this behavior by using the Set-AdSiteLink
cmdlet to configure an Exchange-specific cost for Active Directory IP
site links. After you configure it, the Exchange-specific cost is used
instead of the Active Directory–assigned cost to determine the Exchange
routing path.
Example 4
provides the syntax and usage, as well as sample output, for the
Set-AdSiteLink cmdlet. When there are multiple wide area network (WAN)
paths between sites, you can set a higher site-link cost if you want to
reduce the likelihood that a link will be used. You can set a lower
site-link cost if you want to increase the likelihood that a link will
be used. You must have Enterprise Administrator rights to use the –Name
parameter to change the name of a site link.
You can use the –MaxMessageSize parameter to set the maximum size
for messages that are relayed across a specified link. The default
value is "unlimited," which allows messages of any size to be relayed.
You can specify the units for values using B for bytes, KB for
kilobytes, MB for megabytes, or GB for gigabytes. The valid range for
maximum size is from 64 KB to the largest value in bytes that can be
set using a 64-bit integer (9,223,372,036,854,775,807).
Example 4. Set-AdSiteLink cmdlet syntax and usage
Syntax
Set-AdSiteLink -Identity 'SiteIdentity
'
[-DomainController 'DCName
']
[-ExchangeCost Cost
]
[-MaxMessageSize <'Size
' | 'Unlimited'>]
[-Name 'NewSiteLinkName
']
Usage
Set-AdSiteLink -Identity 'PORTLANDSEATTLELINK'
-ExchangeCost 20
Set-AdSiteLink -Identity 'LASACRAMENTOLINK'
-MaxMessageSize 'Unlimited'
Set-AdSiteLink -Identity 'LASACRAMENTOLINK'
-MaxMessageSize '24MB'