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.