Share via


Ksetup:addkdc

Updated: April 17, 2012

Applies To: Windows Server 2008 R2

Adds a Key Distribution Center (KDC) address for the given Kerberos realm. For examples of how this command can be used, see Examples.

Syntax

ksetup /addkdc <RealmName> [<KDCName>] 

Parameters

Parameter Description

<RealmName>

The realm name is stated as an uppercase DNS name, such as CORP.CONTOSO.COM, and it is listed as the default realm when ksetup is run. It is to this realm that you are attempting to add the other KDC.

<KDCName>

The KDC name is stated as a case insensitive fully qualified domain name, such as mitkdc.microsoft.com. If the KDC name is omitted, DNS will locate KDCs.

Remarks

These mappings are stored in the registry under \HKLM\System\CurrentControlSet\Control\LSA\Kerberos\Domains. To deploy Kerberos realm configuration data to multiple computers, use the Security Configuration Template snap-in and policy distribution instead of using ksetup explicitly on individual computers.

The computer must be restarted before the new realm setting will be used.

To verify the default realm name for the computer, or to verify that this command worked as intended, run ksetup at the command prompt and verify the output for the added KDC.

Examples

Configure a non-Windows KDC server and the realm that the workstation should use:

ksetup /addkdc CORP.CONTOSO.COM mitkdc.contoso.com

Run the Ksetup tool at the command line of the same computer as in the preceding command to set the local computer account password to “p@sswrd1%”. Then restart the computer.

Ksetup /setcomputerpassword p@sswrd1%

Additional references