Unattended Installation Return Codes
Applies To: Windows Server 2008, Windows Server 2008 R2
When the unattended installation of Active Directory Domain Services (AD DS) completes, Dcpromo returns one of the following codes to indicate the status of the operation to the user. Unused numbers are reserved for future use.
1-10 = success return codes
11-100 = failure return codes
Success return codes
The codes in the following table indicate successful completion of an AD DS installation or removal operation.
| Value | Case | Description |
|---|---|---|
1 |
ExitSuccess |
The operation succeeded. |
2 |
ExitSuccessNeedReboot |
The operation succeeded, and the server must be restarted manually. |
3 |
ExitSuccessWithNonCriticalFailure |
The operation succeeded, but there has been a failure, such as a failure with Domain Name System (DNS) installation or delegation configuration. Check Dcpromoui log files, and investigate further. |
4 |
ExitSuccessWithNonCriticalFailureNeedReboot |
The operation succeeded, but there has been a failure, such as a failure with DNS installation or delegation configuration, and the server must be restarted manually. Check Dcpromoui log files, and investigate further. |
Failure return codes
The codes in the following table indicate failed completion of an AD DS installation or removal operation.
| Value | Case | Description |
|---|---|---|
11 |
ExitAlreadyRunning |
Dcpromo is already running. |
12 |
ExitMustBeAdministrator |
The user must be a local administrator on the computer. |
13 |
ExitCertSvcInstalled |
Active Directory Certificate Services (AD CS) is installed. |
14 |
ExitInSafeBootMode |
The server is running in Safe Mode. |
15 |
ExitRoleChangePending |
A role change is in progress or requires that the server be restarted. |
16 |
ExitIncorrectPlatform |
The server is running on the wrong platform. |
17 |
ExitNeedNTFS5Drive |
No drives are formatted for NTFS 5. |
18 |
ExitInsufficientWinDirSpace |
%windir% does not have enough space. |
19 |
ExitNameChangeNeedsReboot |
A name change is pending, and the computer must be restarted. |
20 |
ExitBadComputerName |
The computer name uses invalid syntax. |
21 |
ExitHoldsFSMOs |
This domain controller holds an operations master (also known as flexible single master operations or FSMO) role, is a global catalog server, or is a DNS server. |
22 |
ExitNeedToInstallTcpIp |
TCP/IP must be installed or is not functioning. |
23 |
ExitNeedToConfigDnsFirst |
The DNS client must be configured first. |
24 |
ExitBadCredentials |
The supplied credentials are not valid or are missing required elements. |
25 |
ExitDcNotFound |
A domain controller for the specified domain could not be located. |
26 |
ExitUnableReadDomainList |
The list of domains could not be read from the forest. |
27 |
ExitMustSpecifyDomain |
A domain name is missing (parent, child, tree, or forest). |
28 |
ExitBadDomainName |
The domain name is not valid. |
29 |
ExitParentDomainNotExists |
The parent domain does not exist. |
30 |
ExitDomainNotInForest |
The specified domain is not found in the forest. |
31 |
ExitChildDomainExists |
The child domain already exists. |
32 |
ExitBadNetbiosDomainName |
The NetBIOS name is not valid. |
33 |
ExitBadIFMPath |
The path to the install from media (IFM) files is not valid. |
34 |
ExitBadIFMDatabase |
The IFM database is bad. |
35 |
ExitNoSyskeyForIFM |
A system key is required for the IFM database. |
37 |
ExitBadDBPath |
The database path or database log path is not valid. |
38 |
ExitInsuffSpaceForDB |
The volume does not have enough space for the database or the database log. |
39 |
ExitBadSysVolPath |
The SYSVOL path is not valid. |
40 |
ExitBadSiteName |
The site name is not valid. |
41 |
ExitMustSpecifySafeModePwd |
You must specify a password for Safe Mode. |
42 |
ExitBadSafeModePwd |
The Safe Mode password does not meet password complexity criteria. |
43 |
ExitBadAdminPwd |
The administrator password does not meet criteria. |
44 |
ExitBadForestName |
The specified forest name is not valid. |
45 |
ExitForestExists |
A forest with the specified name already exists. |
46 |
ExitBadTreeName |
The specified name for the tree is not valid. |
47 |
ExitTreeExists |
A tree with the specified name already exists. |
48 |
ExitTreeNotFitInForest |
The tree name does not fit into the forest structure. |
49 |
ExitDomainNotExists |
The specified domain does not exist. |
50 |
ExitLastDcMismatch |
This is not the last domain controller although it was indicated to be the last domain controller. Or, this is the last domain controller although it was not indicated to be the last domain controller. |
51 |
ExitUnconfirmedAppPartitions |
Application partitions that have not been approved for removal exist on this domain controller. |
52 |
ExitRequiredParameterMissing |
An answer file or command-line unattended installation parameters were not provided. |
53 |
ExitPromoDemotFailedNeedReboot |
The installation or removal failed, and the server must be restarted. |
54 |
ExitPromoDemotFailed |
The installation or removal failed. |
55 |
ExitPromoDemoteFailedBecauseUserCancelled |
The installation or removal failed because it was canceled by the user. |
56 |
ExitPromoDemotFailedBecauseUserCancelledNeedReboot |
The installation or removal failed because it was canceled by the user. The computer must be restarted to return to the previous state. |
57 |
ExitDomainReadOnlyReplicaGroupNotSpecified |
The operator failed to specify one of the required read-only domain controller (RODC) groups (Allowed/Denied). |
58 |
ExitDomainReadOnlyReplicaSiteNotSpecified |
The operator failed to specify the site name for an RODC. |
59 |
ExitLastDnsServer |
The domain controller is the last DNS server for one of its Active Directory–integrated zones. |
61 |
ExitInstallDNSNotAllowed |
You cannot install AD DS with DNS in an existing domain that does not already host DNS. |
62 |
ExitAnswerFileMissingSectionName |
The answer file does not have a [DCInstall] section. |
63 |
ExitInsufficientForestFunctionalLevelForRodc |
The forest functional level is less than Windows Server 2003. The forest functional level must be Windows Server 2003 or higher to add an RODC to the forest. |
64 |
ExitPromoFailedBecauseComponentBinaryDetectionFailed |
The installation failed because the installation of the AD DS binaries on the server could not be determined. |
65 |
ExitPromoFailedBecauseComponentBinaryInstallationFailed |
The installation failed because the AD DS binaries could not be installed. |
66 |
ExitPromoFailedBecauseOSDetectionFailed |
The installation failed because the operating system installation option (whether it is a Server Core installation or a full installation) could not be determined. |
68 |
ExitInvalidReplicationPartner |
The replication partner is not valid. |
69 |
ExitRequiredPortInUse |
The required port is already in use by some other application. |
70 |
ExitForestRootDcMustBeGc |
The first forest root domain controller must be a global catalog server. |
71 |
ExitDnsAlreadyInstalled |
The DNS Server service is already installed. |
72 |
ExitIsAppServer |
The installation failed because the server is a Terminal Services application server. |
73 |
ExitInvalidForestFunctionalLevel |
The specified forest functional level is not valid. |
74 |
ExitInvalidDomainFunctionalLevel |
The specified domain functional level is not valid. |
75 |
ExitDefaultPasswordReplicationPolicyCannotBeDetermined |
Unable to determine the default password replication policy (PRP). |
76 |
ExitInvalidPasswordReplicationPolicy |
Specified allowed and denied security groups for the PRP are not valid. |
77 |
ExitInvalidArgument |
The specified argument is not valid. |
78 |
ExitForestCheckFailed |
The installation failed because the Active Directory forest could not be examined. |
79 |
ExitRodcNDNCNotPrepped |
An RODC cannot be installed because adprep /rodcprep has not been performed. |
80 |
ExitDomainNotPrepped |
The installation failed because adprep/domainprep has not been performed. |
81 |
ExitForestNotPrepped |
The installation failed because adprep/forestprep has not been performed. |
82 |
ExitForestSchemaMismatch |
The installation failed because there is a forest schema mismatch. |
83 |
ExitUnsupportedSku |
The installation failed because the operating system edition does not support AD DS. |
84 |
ExitDcAccountDetectionFailed |
Unable to detect a domain controller account. |
85 |
ExitDcAccountSelectionFailed |
Unable to select a domain controller account to which this server can be attached. |
86 |
ExitStage2Required |
You must attach the server to an existing account. |
87 |
ExitDcAccountConflictingType |
A read-only or writable domain controller account in the domain exists, but it does not match the type of domain controller that you want to install. Installation cannot continue. |
88 |
ExitServerAdminInvalid |
The specified RODC server administrator is not valid. |
89 |
ExitRidMasterOffline |
The relative ID (RID) operations master for the specified domain is offline. |
90 |
ExitDNMasterOffline |
The domain naming operations master is offline. |
91 |
ExitWow64ProcessDetectionFailed |
Failed to detect if the process is Wow64. |
92 |
ExitWow64ProcessNotSupported |
The Wow64 process is not supported. |
93 |
ExitDcServiceNotRunningForRegularDemotion |
The removal of AD DS failed because the AD DS service is not running. |
94 |
ExitBadLocalAdminPwd |
The local administrator password does not meet complexity requirements. It could be that the password is either blank or not required. |
95 |
ExitCannotDemoteLastLHDC |
Cannot demote the last domain controller that runs Windows Server 2008 or Windows Server 2008 R2 in a domain where an operational RODC exists. |
96 |
ExitComponentBinaryUninstallFailed |
The AD DS binaries failed to uninstall. |
97 |
ExitFFLNotSupported |
The operating system of the server on which you are installing AD DS is not supported for domain controllers at the current forest functional level. |
98 |
ExitPromoFailedBecauseComponentBinaryInstallInProgress |
Dcpromo failed because Active Directory binaries are being installed or uninstalled. |