Active Directory Cookbook

11.27. Triggering the KCC

Problem

You want to trigger the KCC.

Solution

Using a graphical user interface

1. Open the Active Directory Sites and Services snap-in.

2. In the left pane, browse to the NTDS Settings object for the server you want to trigger the KCC for.

3. Right-click on NTDS Settings, select All Tasks, and Check Replication Topology.

4. Click OK.

Using a command-line interface

> repadmin /kcc <DomainControllerName>

Using VBScript

' This code triggers the KCC on a DC.
' ------ SCRIPT CONFIGURATION ------
strDC = "<DomainControllerName>"  ' e.g. dc01
' ------ END CONFIGURATION ---------

set objIadsTools = CreateObject("IADsTools.DCFunctions")
intRes = objIadsTools.TriggerKCC(Cstr(strDC),0)

if intRes = -1 then
   Wscript.Echo objIadsTools.LastErrorText
else
   Wscript.Echo "KCC successfully triggered"
end if

Discussion

The KCC runs every 15 minutes by default on all domain controllers to generate the intra-site topology connections. The KCC that runs on the server that is selected as the ISTG generates inter-site topology connections to other sites from the bridgehead servers in its site. In some situations, such as when you create new site, siteLink, or subnet objects, you may want to run the KCC immediately so that any new connections between domain controllers get created.

See Also

Recipe 11.28 for determining if the KCC is completing successfully, for more information on IADsTools see iadstools.doc that is installed with the Support Tools, and MS KB 224815 (The Role of the Inter-Site Topology ...