Verifies integrity of AD DS or AD LDS database files with respect to Active Directory semantics. At the semantic checker: prompt, type any of the parameters listed under Syntax.
Ntdsutil is a command-line tool that is built into Windows Server 2008. It is available if you have the Active Directory Domain Services (AD DS) or Active Directory Lightweight Directory Services (AD LDS) server role installed. To use ntdsutil, you must run the ntdsutil command from an elevated command prompt. To open an elevated command prompt, click Start, right-click Command Prompt, and then click Run as administrator.
For examples of how to use this command, see Examples.
Syntax
[get %d] [{go | go fixup}] [verbose %s] [{check quota | rebuild quota}]
Parameters
Parameter | Description |
---|---|
check quota |
Integrity-check quota-tracking table (object owner quotas). This command checks if the quota table is correct, by trying to open the quota-tracking table and getting column information for each pre-defined column name. |
get %d |
Retrieves record number %d from the Ntds.dit. |
go |
Starts the semantic analysis of the Ntds.dit or AD LDS instance with no fixup. A report is generated and written to a file named Dsdit.dmp.n, in the current directory, where n is an integer incremented each time that you carry out the command. |
go fixup |
Start semantic checker with fixup. |
verbose %s |
Toggles verbose mode on or off. |
rebuild quota |
Force asynchronous rebuild of quota-tracking table. |
%d |
A numeric variable, such as replication delay time periods. |
quit |
Takes you back to the previous menu or exits the utility. |
? |
Displays help at the command prompt. |
Help |
Displays help at the command prompt. |
Remarks
- Unlike the file management commands described earlier, which
test the integrity of the database with respect to the ESENT
database semantics, the semantic analysis analyzes the data with
respect to Active Directory semantics. It generates reports on the
number of records present, including deleted and phantom
records.
Note End users should not use this command except when Microsoft requests them to use it as an aid to fault diagnosis.
- Before you can run the semantic database analysis subcommand,
you need to set NTDS or an AD LDS instance as the active instance
for ntdsutil. For example, if the AD LDS instance that you
want to restore is named instance1, type the following command at
the ntdsutil prompt before you run the authoritative restore
subcommand:
ac in instance1
- You need to stop the AD DS or AD LDS service before
you can run the semantic database analysis subcommand. To stop
AD DS, click Start, click Server Manager. In the
console tree, double-click Configuration, and then click
Services. In the details pane, right-click Active
Directory Domain Services and then click Stop.
Examples
To turn on verbose mode logging, type:
semantic checker: verbose on
To start the semantic analysis of the Ntds.dit with no fixup, type:
semantic checker: go