Adprep
Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2008
Extends the Active Directory® schema and updates permissions as necessary to prepare a forest and domain for a domain controller that runs the Windows Server® 2008 operating system.
Adprep.exe is a command-line tool that is available on the Windows Server 2008 installation disc in the \sources\adprep folder, and it is available on the Windows Server 2008 R2 installation disk in the \support\adprep folder. You must run adprep from an elevated command prompt. To open an elevated command prompt, click Start, right-click Command Prompt, and then click Run as administrator.
In Windows Server 2008 R2, Adprep is available in a 32-bit version and a 64-bit version. The 64-bit version runs by default. If you need to run Adprep on a 32-bit computer, run the 32-bit version (Adprep32.exe).
For more information about running Adprep.exe and how to resolve errors that can occur when you run it, see Running Adprep.exe (https://go.microsoft.com/fwlink/?LinkID=142597).
To download Adprep.exe without purchasing Windows Server, you can download a trial version of Windows Server 2008 R2 with Service Pack 1.
For more information about the Windows Server 2012 version of Adprep.exe, see Adprep.
For examples of how this command can be used, see Examples.
For more information about running adprep /forestprep, see Prepare a Windows 2000 or Windows Server 2003 Forest Schema for a Domain Controller That Runs Windows Server 2008 or Windows Server 2008 R2 (https://go.microsoft.com/fwlink/?LinkID=93242).
For more information about running adprep /domainprep /gpprep, see Prepare a Windows 2000 or Windows Server 2003 Domain for a Domain Controller That Runs Windows Server 2008 or Windows Server 2008 R2 (https://go.microsoft.com/fwlink/?LinkID=93243).
For more information about running adprep /rodcprep, see Prepare a Forest for a Read-Only Domain Controller (https://go.microsoft.com/fwlink/?LinkID=93244).
Syntax
adprep {/forestprep | /domainprep | /domainprep /gpprep | /rodcprep | /wssg | /silent }
Parameters
| Parameter | Description |
|---|---|
/forestprep |
Prepares a forest for the introduction of a domain controller that runs Windows Server 2008. You run this command only once in the forest. You must run this command on the domain controller that holds the schema operations master role (also known as flexible single master operations or FSMO) for the forest. You must be a member of all the following groups to run this command:
|
/domainprep |
Prepares a domain for the introduction of a domain controller that runs Windows Server 2008. You run this command after the forestprep command finishes and after the changes replicate to all the domain controllers in the forest. Run this command in each domain where you plan to add a domain controller that runs Windows Server 2008. You must run this command on the domain controller that holds the infrastructure operations master role for the domain. You must be a member of the Domain Admins group to run this command. |
/domainprep /gpprep |
Performs similar updates as domainprep. However, this command also provides updates that are necessary to enable Resultant Set of Policy (RSOP) Planning Mode functionality. In Active Directory environments that run Microsoft Windows® 2000, this command performs updates during off-peak hours. This minimizes replication traffic that is created in those environments by updates to file system permissions and Active Directory permissions on existing Group Policy objects (GPOs). This command is also available on Microsoft Windows Server 2003 with Service Pack 1 (SP1) or later. Run this command after the forestprep command finishes and after the changes replicate to all domain controllers in the forest. You must run this command on the infrastructure master for the domain. For more information about running this command in Windows 2000 Active Directory environments, see Prepare Your Infrastructure for Upgrade (https://go.microsoft.com/fwlink/?LinkId=94798). |
/rodcprep |
Updates permissions on application directory partitions to enable replication of the partitions to read-only domain controllers (RODCs). This operation runs remotely; it contacts the infrastructure master in each domain to update the permissions. You need to run this command only once in the forest. However, you can rerun this command any time if it fails to complete successfully because an infrastructure master is not available. You can run this command on any computer in the forest. You must be a member of the Enterprise Admins group to run this command. |
/wssg |
Returns an expanded set of exit codes, instead of just 0 (Success) and 1 (Failure). |
/silent |
Specifies that no standard output is returned from an operation. This parameter can be used only if /wssg is also used. |
quit |
Returns to the prior menu. |
Help |
Displays Help for this command. |
? |
Displays Help for this command. |
Remarks
To prepare an existing Windows 2000 or Windows Server 2003 Active Directory environment for a Windows Server 2008 domain controller, be sure to run the version of Adprep that is included in the Windows Server 2008 installation media.
If you run Adprep on a domain controller running Windows 2000 Server, the domain controller must be running Windows 2000 Server Service Pack 4 (SP4) or later.
You can also perform verification steps before and after you run the adprep command to help ensure that the operations complete successfully. For more information, see Steps for Extending the Schema (https://go.microsoft.com/fwlink/?LinkId=94799).
Exit Codes
The following table lists exit codes that Adprep can return after an operation completes.
| Return Code | Description |
|---|---|
0 |
Success |
1 |
Failure |
2 |
Schema conflict error |
3 |
FSMO role error |
4 |
Connection error |
5 |
Schema upgrade error |
6 |
Unable to modify error |
7 |
Server busy error |
8 |
Permission error |
9 |
Unable to initialize log file error |
10 |
Not a domain controller |
11 |
In nonnative mode |
12 |
Need to run forest update first |
13 |
Forest update already done |
14 |
Domain update already done |
15 |
GPO update already done |
16 |
Forest update wait replication |
Examples
The following example prepares a forest for a domain controller that runs Windows Server 2008:
adprep /forestprep
The following example prepares a domain for a domain controller that runs Windows Server 2008:
adprep /domainprep
The following example prepares a domain for an RODC:
adprep /rodcprep