Recipe 11.9 Modifying the Sites That Are Part of a Site Link

11.9.1 Problem

You want to modify the sites associated with a site link.

11.9.2 Solution

11.9.2.1 Using a graphical user interface

Open the Active Directory Sites and Services snap-in.
In the left pane, expand Sites Inter-Site Transports.
Click either the IP or SMTP folder depending where the site link is stored.
In the right pane, double-click on the link you want to modify.
Under the General tab, you can add and remove sites that are associated with the site link.
Click OK.

11.9.2.2 Using a command-line interface

Create an LDIF file called modify_site_link.ldf with the following contents. Replace <LinkName> with the name of the link and <SiteName> with the site to add to the link.

dn: cn=<LinkName>,cn=IP,cn=inter-site 
transports,cn=sites,cn=configuration,<ForestRootDN>
changetype: modify
add: siteList
siteList: cn=<SiteName>,cn=sites,cn=configuration,<ForestRootDN>
-

Then run the following command:

> ldifde -v -i -f modify_site_link.ldf

11.9.2.3 Using VBScript

' This code adds a site to an existing site link
' ------ SCRIPT CONFIGURATION ------
strSite = "<SiteName>" ' e.g. Burlington
strLink = "<LinkName>" ' e.g. DEFAULTIPSITELINK
' ------ END CONFIGURATION ---------

' Taken from ADS_PROPERTY_OPERATION_ENUM
const ADS_PROPERTY_APPEND = 3

set objRootDSE = GetObject("LDAP://RootDSE")
set objLink = GetObject("LDAP://cn=" & strLink & _
                        ",cn=IP,cn=Inter-site Transports,cn=sites," & _
                        objRootDSE.Get("configurationNamingContext") )
strSiteDN = "cn=" & strSite & ",cn=sites," & _
            objRootDSE.Get("configurationNamingContext")  
objLink.PutEx ADS_PROPERTY_APPEND, "siteList", Array(strSiteDN)
objLink.SetInfo

WScript.Echo "Successfully modified link: " & strLink

11.9.3 Discussion

To associate a site with a site link, add the DN of the site to the siteList attribute of the siteLink object that represents the link. To remove a site from a link, do the reverse. Remove the DN associated with the site from the siteList attribute.