Answer File = Unattend.txt
The [DCInstall] section contains entries for installing a domain controller after the initial setup of the Microsoft® Windows® operating system finishes. The entries in this section apply only to the Windows Server 2003 family.
You can create an answer file that contains only this section, and run it after Setup completes and an end user logs on to the system. The command for this is dcpromo /answer:answer_file
Entry | Description |
---|---|
AdministratorPassword | Sets the local administrator password for the computer during the demotion of a domain controller. |
AllowAnonymousAccess | Specifies whether any pre-Windows 2000 server authenticates end users from this domain or any trusting domain. |
AutoConfigDNS | Specifies whether Dcpromo.exe configures Domain Name Service (DNS) for the new domain if it detects that the DNS dynamic update protocol is not available. |
ChildName | Specifies whether to append the DNS label at the beginning of the name of an existing directory service domain when installing a child domain. |
ConfirmGc | Specifies whether the replica is also a global catalog. |
CreateOrJoin | Specifies whether the new tree domain is part of an existing forest of domains. |
CriticalReplicationOnly | Specifies whether the promotion operation performs only critical replication, and then continues, skipping the noncritical (and potentially lengthy) portion of replication. |
DatabasePath | Specifies the fully qualified, non-UNC path to a directory on a fixed disk of the local computer that contains the domain database. |
DisableCancelForDnsInstall | Specifies whether to disable the Cancel button during a DNS installation. |
DNSOnNetwork | Specifies whether to set DNS server addresses automatically. |
DomainNetBiosName | Assigns a network basic input/output system (NetBIOS) name to the new domain. |
IsLastDCInDomain | Specifies whether the computer on which Dcpromo.exe is running is the last domain controller in the domain. |
LogPath | Specifies the fully qualified, non-UNC path to a directory on a fixed disk of the local computer that contains the domain log files. |
NewDomain | Indicates the type of a new domain: whether a new domain is in a new forest, the root of a new tree in an existing forest, or a child of an existing domain. |
NewDomainDNSName | Specifies the required name of a new tree in an existing domain or when Setup installs a new forest of domains. |
ParentDomainDNSName | Specifies the DNS domain name of an existing directory service domain when installing a child domain. |
Password | Specifies the password for the user name (account credentials) to use for promoting the member server to a domain controller. |
RebootOnSuccess | Specifies whether to restart the computer upon successful completion. |
RemoveApplicationPartitions | Specifies whether to remove application partitions during the demotion of a domain controller. |
ReplicaDomainDNSName | Specifies the DNS domain name of the domain to replicate. |
ReplicaOrMember | Specifies whether to convert an upgraded Windows NT 3.51 or Windows NT 4.0 backup domain controller (BDC) to a domain controller or demote it to a regular member server in the domain. |
ReplicaOrNewDomain | Specifies whether to install a new domain controller as the first domain controller in a new directory service domain or to install it as a replica directory service domain controller. |
ReplicationSourceDC | Indicates the full DNS name of the domain controller from which you replicate the domain information. |
ReplicationSourcePath | Indicates the location of the files used to create a new domain controller. |
SafeModeAdminPassword | Supplies the password for the administrator account when starting the computer in safe mode or a variant of safe mode, such as directory service restore mode. |
SetForestVersion | Indicates the functional level for a new forest. |
SiteName | Specifies the name of an existing site where you can place the new domain controller. |
Syskey | Indicates that the end user must supply the system key. |
SysVolPath | Specifies the fully qualified, non-UNC path to a directory on a fixed disk of the local computer. |
TreeOrChild | Specifies that the new domain is the root of a new tree or a child of an existing domain. |
UserDomain | Specifies the domain name for the user name (account credentials) used for promoting the member server to a domain controller. |
UserName | Specifies the user name (account credentials) used for promoting the member server to a domain controller. |
This sample demonstrates one use of the [DCInstall] section of Unattend.txt.
[DCInstall] AdministratorPassword = YH3$GJ AllowAnonymousAccess = No AutoConfigDNS = Yes ChildName = childdom.parentdom.fabrikam.com ConfirmGc = Yes CreateOrJoin = Create CriticalReplicationOnly = Yes DatabasePath =%SYSTEMROOT% \Data DisableCancelForDnsInstall = Yes DNSOnNetwork = Yes DomainNetBiosName = MY_DOMAIN IsLastDCInDomain = Yes LogPath = $SYSTEMROOT%\Logs NewDomain = Tree NewDomainDNSName = newdom.fabrikam.com ParentDomainDNSName = fabrikam.com Password = YH3$GJ RebootOnSuccess = NoAndNoPromptEither RemoveApplicationPartitions = Yes ReplicaDomainDNSName = fab_2.com ReplicaOrMember = Replica ReplicaOrNewDomain = Replica ReplicationSourceDC = fabrikam.com ReplicationSourcePath =%SYSTEMDRIVE% \Source SafeModeAdminPassword = XHJ3$G SetForestVersion = Yes SiteName = FirstSite Syskey = 12345 SysVolPath =%SYSTEMDRIVE% \Sysvol TreeOrChild = Tree UserDomain = mydomain.com UserName = PatC
Sets the local administrator password for the computer during the demotion of a domain controller to a member server.
Syntax | AdministratorPassword = admin_password |
---|---|
Values | admin_password Default: <blank> |
Example | AdministratorPassword = YH3$GJ |
Comments | This entry is valid only during a demotion. If you do not specify a value, Setup uses a blank administrator password.
Setup deletes the value from the answer file after the demotion operation finishes. |
Specifies whether any pre-Windows 2000 server authenticates end users from this domain or any trusting domain.
Syntax | AllowAnonymousAccess = Yes | No |
---|---|
Values | Yes Enables anonymous access to end user and group information. Used with pre-Windows 2000 servers. NoMakes the default permissions more restrictive. Used with Windows 2000 servers. |
Default Value | Yes |
Example | AllowAnonymousAccess = No |
Specifies whether Dcpromo.exe configures DNS for the new domain if it detects that the DNS dynamic update protocol is not available.
Syntax | AutoConfigDNS = Yes | No |
---|---|
Values | Yes Default. Configures DNS for the new domain if the DNS dynamic update protocol is not available. NoDoes not configure DNS for the domain. |
Example | AutoConfigDNS = Yes |
Specifies whether to append the DNS label at the beginning of the name of an existing directory service domain when installing a child domain.
Syntax | ChildName = child_domain_name |
---|---|
Values | child_domain_name |
Example | ChildName = childdom.parentdom.fabrikam.com |
Comments | For example, if the parent name is "parentdom.fabrikam.com" and the ChildName is "childdom," then the name of the new domain is "childdom.parentdom.fabrikam.com." This new domain name must not already be in use and you must properly configure DNS services on the computer. This entry is required. For more information, see TreeOrChild. |
Specifies whether the replica is also a global catalog.
Syntax | ConfirmGc = Yes | No |
---|---|
Values | Yes Makes the replica a global catalog if the backup was a global catalog. NoDoes not make the replica a global catalog. |
Default Value | Yes |
Example | ConfirmGc = Yes |
Comments | Only applies if you specify ReplicationSourcePath. If you create the restored files from a backup of a global catalog, then the replica can also be a global catalog of those files. |
Specifies whether the new tree domain is part of an existing forest of domains.
Syntax | CreateOrJoin = Create | Join |
---|---|
Values | Create Creates a new forest of domains. JoinDefault. Places the new domain at the root of a new domain tree in an existing forest of domains. |
Example | CreateOrJoin = Create |
Comments | Setup supports CreateOrJoin for backward compatibility with Windows 2000 unattended Setup. For unattended Setup of a member of the Windows Server 2003 family, use NewDomain instead. |
Specifies whether the promotion operation performs only critical replication, and then continues, skipping the noncritical (and potentially lengthy) portion of replication.
Syntax | CriticalReplicationOnly = Yes | No |
---|---|
Values | Yes Skips noncritical replication. NoDoes not skip any replication steps. |
Default Value | <none> |
Example | CriticalReplicationOnly = Yes |
Comments | If Setup skips noncritical replication, replication automatically and silently resumes when you reboot the computer. The computer assumes its new role as a domain controller. |
Specifies the fully qualified, non-UNC path to a directory on a fixed disk of the local computer that contains the domain database.
Syntax | DatabasePath = path_to_database_files |
---|---|
Values | path_to_database_files |
Default Value | |
Example | DatabasePath = |
Comments | Enclose path_to_database_files in quotation marks if it is a long file name.
If the directory exists, it must be empty. If the directory does not exist, Setup creates it. The disk must have enough free disk space available (new domains require at least 20 MB) and must have room to grow if you plan to add numerous objects to the domain. For replica domains, you must specify the space required in the domain size. Note
|
Specifies whether to disable the Cancel button during a DNS installation.
Syntax | DisableCancelForDnsInstall = Yes | No |
---|---|
Values | Yes Does not display the Cancel button. During the DNS installation, the Displays the Cancel button. |
Default Value | No |
Example | DisableCancelForDnsInstall = Yes |
Comments | Note
|
Specifies whether to set DNS server addresses automatically.
Syntax | DNSOnNetwork = Yes | No |
---|---|
Values | Yes Sets the DNS server addresses manually for the computer. Important
Installs the DNS service, creates a valid DNS configuration, and creates a zone for the new domain with that service. |
Default Value | Yes |
Example | DNSOnNetwork = Yes |
Comments | Used when installing the first domain in a new forest and the Transmission Control Protocol/Internet Protocol (TCP/IP) configuration has missing or incorrect DNS server addresses. Before the computer can become a domain controller, its TCP/IP stack must have a valid DNS configuration. |
Assigns a network basic input/output system (NetBIOS) name to the new domain.
Syntax | DomainNetBiosName = domain_NetBIOS_name |
---|---|
Values | domain_NetBIOS_name |
Example | DomainNetBiosName = MY_DOMAIN |
Comments | Required
The value is required, and the name specified must not already be in use as a domain or computer name. Setup ignores this entry when upgrading pre-Windows 2000 primary domain controllers. |
Specifies whether the computer on which Dcpromo.exe runs is the last domain controller in the domain.
Syntax | IsLastDCInDomain = Yes | No |
---|---|
Values | Yes Indicates that this computer is the last domain controller in the domain. NoIndicates that this computer is not the last domain controller in the domain. |
Default Value | No |
Example | IsLastDCInDomain = Yes |
Comments | This entry is valid only when demoting an existing domain controller to a member server. |
Specifies the fully qualified, non-UNC path to a directory on a fixed disk of the local computer that contains the domain log files.
Syntax | LogPath = path_to_log_files |
---|---|
Values | path_to_log_files |
Default Value | |
Example | LogPath = |
Comments | Enclose path_to_log_files in quotation marks if it is a long file name.
If the directory exists, it must be empty. If the directory does not exist, Setup creates it. The disk must have enough free disk space available (new domains require at least 10 MB) and must have room to expand if you plan to add numerous objects to the domain. For replica domains, you must specify the space required in the domain size. Note
|
Indicates the type of a new domain: whether a new domain is in a new forest, the root of a new tree in an existing forest, or a child of an existing domain.
Syntax | NewDomain = Tree | Child | Forest |
---|---|
Values | Tree The new domain is the root of a new tree in an existing forest. ChildThe new domain is a child of an existing domain. Forest (or any other value)The new domain is the first domain in a new forest of domain trees. |
Default Value | Forest |
Example | NewDomain = Tree |
Specifies the required name of a new tree in an existing domain or when Setup installs a new forest of domains.
Syntax | NewDomainDNSName = DNS_name_of_domain |
---|---|
Values | DNS_name_of_domain |
Example | NewDomainDNSName = newdom.fabrikam.com. |
Comments | For example, this DNS name could be "newdom.fabrikam.com." |
Specifies the DNS domain name of an existing directory service domain when installing a child domain.
Syntax | ParentDomainDNSName = DNS_name_of_domain |
---|---|
Values | DNS_name_of_domain |
Example | ParentDomainDNSName = fabrikam.com |
Comments | When specifying this entry, make sure that the current end user has administrative user rights to the specified domain, and that you properly configure the DNS services. The domain name must refer to an existing directory service domain.
For more information, see TreeOrChild. |
Specifies the password for the user name (account credentials) to use for promoting the member server to a domain controller.
Syntax | Password = password |
---|---|
Values | password |
Example | Password = YH3$GJ |
Comments | The Unattend.txt file deletes the value after the promotion operation finishes. |
Specifies whether to restart the computer upon successful completion.
Syntax | RebootOnSuccess = Yes | No | NoAndNoPromptEither |
---|---|
Values | Yes Restarts upon successful completion. NoDoes not restart, but prompts the user to restart. NoAndNoPromptEitherDoes not restart and does not prompt the user to restart. |
Default Value | No |
Example | RebootOnSuccess = NoAndNoPromptEither |
Comments | You must restart the server to start the directory services. |
Specifies whether to remove application partitions during the demotion of a domain controller.
Syntax | RemoveApplicationPartitions = Yes | No |
---|---|
Values | Yes Removes application partitions on the domain controller. NoDoes not remove application partitions on the domain controller. If the domain controller hosts the last replica of any application directory partition, you must manually confirm that you must remove these partitions. |
Default Value | No |
Example | RemoveApplicationPartitions = Yes |
Comments | Important
|
Specifies the DNS domain name of the domain to replicate.
Syntax | ReplicaDomainDNSName = DNS_name_of_domain |
---|---|
Values | DNS_name_of_domain |
Example | ReplicaDomainDNSName = fab_2.com |
Comments | This entry is valid only for backup domain controller (BDC) upgrades and domain controller installations. In such situations, you must specify a value or the installation fails.
Normally, the end user who is currently logged on has administrative privileges to the specified domain, and Setup properly configures DNS services. The domain name must refer to an existing directory service domain. |
Specifies whether to convert an upgraded Windows NT 3.51 or Windows NT 4.0 BDC to a domain controller or demote it to a regular member server in the domain.
Syntax | ReplicaOrMember = Replica | Member |
---|---|
Values | Replica Installs the server as a domain controller. MemberInstalls the new domain controller as a member server in a domain. |
Default Value | Member |
Example | ReplicaOrMember = Replica |
Comments | This entry is valid only when upgrading a BDC. |
Specifies whether to install a new domain controller as the first domain controller in a new directory service domain or to install it as a replica directory service domain controller.
Syntax | ReplicaOrNewDomain = Replica | Domain |
---|---|
Values | Replica Installs the new domain controller as a replica directory service domain controller. DomainInstalls the new domain controller as the first domain controller in a new directory service domain. You must specify the TreeOrChild entry with a valid value. |
Default Value | Replica |
Example | ReplicaOrNewDomain = Replica |
Indicates the full DNS name of the domain controller from which you replicate the domain information.
Syntax | ReplicationSourceDC = DNS_name_of_DC |
---|---|
Values | DNS_name_of_DC Indicates the full DNS name of the domain controller from which you replicate the domain information. Applies only in new replica or BDC upgrade cases. <none>Selects the closest domain controller for the domain it replicates. |
Default Value | <none> |
Example | ReplicationSourceDC = fabrikam.com |
Indicates the location of the files used to create a new domain controller.
Syntax | ReplicationSourcePath = replication_source_path |
---|---|
Value | replication_source_path |
Default Value | <none> |
Example | ReplicationSourcePath = |
Comments | The value must be the fully qualified path to a folder on the local computer where you copied the files.
Used to indicate that the bulk of the directory data replication came from backup files that you restored to a volume on the server, rather from another domain controller. However, you cannot perform complete replication entirely from copied files. You need to access another domain controller. (See ReplicationSourceDC.) If this value is present and non-empty, then you can perform data replication using the restored files. If this value is not present or is empty, then perform replication from another domain controller on the network. If the value refers to a valid set of restored backup files, then Setup ignores any value for the ReplicaDomainDNSName entry. The domain name to which the restored files belong takes precedence. |
Supplies the password for the administrator account when starting the computer in safe mode or a variant of safe mode, such as directory service restore mode.
Syntax | SafeModeAdminPassword = password | None |
---|---|
Value | password Specifies the password for the administrator account that you use when the computer is in safe mode. NoneDoes not supply a password for the administrator account. |
Default Value | None |
Example | SafeModeAdminPassword = XHJ3$G |
Indicates the functional level for a new forest.
Syntax | SetForestVersion = Yes | No |
---|---|
Values | Yes Sets forest functional level to Windows Server 2003 interim. Important
Sets forest functional level to Windows 2000. |
Default Value | No |
Example | SetForestVersion = Yes |
Comments | Set the value of SetForestVersion to Yes if:
You must set the value of SetForestVersion to No if:
Note
|
Specifies the name of an existing site where you can place the new domain controller.
Syntax | SiteName = site_name |
---|---|
Value | site_name |
Default Value | default_first_site |
Example | SiteName = FirstSite |
Comments | If you do not specify a site, Setup selects a suitable site using the current site and subnet configuration of the forest. |
Indicates that the end user must supply the system key.
Syntax | Syskey = <none> | system key |
---|---|
Default Value | <none> |
Example | Syskey = 12345 |
Comments | Only applies if you specify ReplicationSourcePath. Setup uses this value if the restored files that are used to install a replica indicate that the end user must supply the system key.
If the restored files indicate that the end user must supply the system key on a floppy disk, then the system looks for the key on drive A. |
Specifies the fully qualified, non-UNC path to a directory on a fixed disk of the local computer.
Syntax | SysVolPath = path_to_database_file |
---|---|
Value | path_to_database_file |
Default Value | |
Example | SysVolPath = |
Comments | Enclose path_to_database_file in quotation marks if it is a long file name.
If the directory exists, it must be empty. If the directory does not exist, Setup creates it. You must format the disk with NTFS version 5.0. |
Specifies that the new domain is the root of a new tree or a child of an existing domain.
Syntax | TreeOrChild = Tree | Child |
---|---|
Values | Tree Specifies that the new domain is the root of a new tree. You must specify the CreateOrJoin or NewDomain entries with a valid value. ChildSpecifies that the new domain is a child of an existing domain. |
Default Value | Child |
Example | TreeOrChild = Tree |
Comments | Setup supports TreeOrChild for backward compatibility with Windows 2000 unattended Setup. For unattended Setup of a member of the Windows Server 2003 family, use NewDomain instead. |
Specifies the domain name for the user name (account credentials) used for promoting the member server to a domain controller.
Syntax | UserDomain = domain_name |
---|---|
Value | domain_name |
Example | UserDomain = mydomain.com |
Specifies the user name (account credentials) used for promoting the member server to a domain controller.
Syntax | UserName = user_name |
---|---|
Value | user_name |
Example | UserName = PatC |