11.27. Triggering the KCC
Problem
You want to trigger the KCC.
Solution
Using a graphical user interface
Open the Active Directory Sites and Services snap-in.
In the left pane, browse to the
NTDS
Settings
object for the server you want to trigger the KCC for.Right-click on
NTDS Settings
, select All Tasks, and Check Replication Topology.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 ...
Get Active Directory Cookbook now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.