Unattended Installation Return Codes

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. Unused numbers are reserved for future use.

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 syntax that is not valid.

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, Windows Server 2008, or Windows Server 2008 R2 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 (a full installation or a Server Core 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 Remote Desktop 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

The default password replication policy cannot be determined.

76

ExitInvalidPasswordReplicationPolicy

Specified Allowed and Denied security groups for the password replication policy 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

An RODC 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) master for the specified domain is offline.

90

ExitDNMasterOffline

The domain naming 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.