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 Using a graphical user interface
  1. Open the Active Directory Sites and Services snap-in.

  2. In the left pane, expand Sites Inter-Site Transports.

  3. Click either the IP or SMTP folder depending where the site link is stored.

  4. In the right pane, double-click on the link you want to modify.

  5. Under the General tab, you can add and remove sites that are associated with the site link.

  6. Click OK. 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 
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 Using VBScript
' This code adds a site to an existing site link
strSite = "<SiteName>" ' e.g. Burlington
strLink = "<LinkName>" ' e.g. DEFAULTIPSITELINK
' ------ END CONFIGURATION ---------


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," & _
objLink.PutEx ADS_PROPERTY_APPEND, "siteList", Array(strSiteDN)

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.

11.9.4 See Also

Recipe 11.8 for finding the links associated with a site

    Chapter 3. Domain Controllers, Global Catalogs, and FSMOs
    Chapter 6. Users
    Appendix A. Tool List