banner

[GuiUnattended] (Unattend.txt)

Answer File = Unattend.txt

The [GuiUnattended] section for Unattend.txt contains entries for preparing the graphical user interface (GUI) for unattended Setup.

For the Sysprep.inf version, see [GuiUnattended] (Sysprep.inf).

Entry Description
AdminPassword Sets the Administrator account password.
Arguments Indicates that arguments or entries accompany the custom program that runs concurrently with the Setup program.
AutoLogon Configures the computer to log on once with the Administrator account.
AutoLogonCount Specifies the number of times that the computer automatically logs on with the specified Administrator account and password.
DetachedProgram Indicates the path of the custom program that runs concurrently with the Setup program.
EMSBlankPassword Enables the use of a blank administrator password in unattended installations to EMS servers.
EMSSkipUnattendProcessing Prevents Windows Setup from processing Unattend.txt or Sysprep.inf during an unattended installation to an EMS server.
EncryptedAdminPassword Enables Setup to install encrypted passwords for the Administrator account.
OEMSkipRegional Enables unattended Setup to skip the Regional and Language Options page in GUI-mode Setup and Mini-Setup.
OEMSkipWelcome Enables unattended Setup to skip the Welcome page in GUI-mode Setup and Mini-Setup.
ProfilesDir Specifies the location of Microsoft® Windows® XP or Windows Server 2003 family profiles.
ServerWelcome Specifies whether to install the Web UI for Remote Administration at first logon on a member of the Windows Server 2003 family.
TimeZone Specifies the time zone of the computer.

Sample

This sample demonstrates one use of the [GuiUnattended] section of Unattend.txt.

[GuiUnattended]
AdminPassword = "YhJ##3"
Arguments = /n/s
AutoLogon = Yes
AutoLogonCount = 5
DetachedProgram = "%SYSTEMDRIVE%\extras\install.exe"
EMSBlankPassword = Yes
EMSSkipUnattendProcessing = 1
EncryptedAdminPassword = Yes
OEMSkipRegional = 0
OEMSkipWelcome = 0
OEMPreinstall = Yes
ProfilesDir = "%SYSTEMROOT%\Profiles"
ServerWelcome = Yes
TimeZone = 030

AdminPassword

Sets the Administrator account password.

Syntax AdminPassword = "password" | *
Values password

The password may contain as many as 127 characters. Passwords are case-sensitive and must be enclosed in quotation marks. End users cannot change or specify their own passwords in Mini-Setup. You can enter a new password in the appropriate dialog box, but the password does not change.

*

The administrator password is blank (null).

Example
AdminPassword = "YhJ##3"
Registry subkey HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\
CurrentVersion\WinLogon\DefaultPassword
Dependencies If AdminPassword is set to blank, null, or not set, the registry subkey HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\
CurrentVersion\WinLogon\AutoAdminLogon
(controlled by the AutoLogon entry) is set to 0 (false), which disables the automatic Administrator account logon feature.
Comments If you specify a password in the Administrator account, you cannot use the AdminPassword entry in the Sysprep.inf file to change it; the administrator password remains the same. However, if the administrator password was initially blank (either manually or through unattended Setup), you can use AdminPassword to change it to a non-blank password.

Important

  • Security breaches can occur if you use a common, non-blank administrator password for all computers provided to end users. We recommend that you use an automation process to set the administrator password to blank before you run Sysprep. End users can then specify their own passwords after receiving the computers.
  • In an unattended installation, Windows Setup will force any password string that begins with an asterisk to null.

icon Return to top

Arguments

Indicates that arguments or entries accompany the custom program that runs concurrently with the Setup program.

Syntax Arguments = string
Value string
Example
Arguments = /n/s
Comments This entry is required if you are using DetachedProgram.

icon Return to top

AutoLogon

Configures the computer to log on once with the Administrator account.

Syntax AutoLogon = Yes | No
Values Yes

Configures the computer to log on once with the Administrator account.

No

Does not automatically log on to the computer.

Default Value No
Example
AutoLogon = Yes
Registry subkey HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\
CurrentVersion\WinLogon\AutoAdminLogon
Dependencies If AdminPassword is set to blank, null, or not set, the registry subkey HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\
CurrentVersion\WinLogon\AutoAdminLogon
(controlled by AutoLogon) is set to 0 (false) which disables the automatic Administrator account logon feature.
Comments The entry is not valid on upgrades.

When you set AutoLogon to Yes, you cannot log off. If you try to log off, you will be logged back on automatically. The only way to log off is to reboot, which decrements the value of AutoLogonCount.

If you specify a password in the AdminPassword entry, Setup uses that password when you log on automatically to the computer. After the installation finishes, Setup deletes the password from the copy of the answer file left on the computer.

Important

  • Encrypting the Administrator password in the EncryptedAdminPassword entry disables AutoLogon.
  • To skip Windows Welcome, set UnattendSwitch to Yes in the [Unattended] section of Unattend.txt.
  • If you wish to log on automatically after running Sysprep in Factory mode, set AuditAdminAutoLogon to Yes in the [ComputerSettings] section of Winbom.ini.

icon Return to top

AutoLogonCount

Specifies the number of times that the computer automatically logs on with the specified Administrator account and password.

Syntax AutoLogonCount = integer
Value integer
Example
AutoLogonCount = 5
Registry subkey HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\
CurrentVersion\WinLogon\AutoLogonCount
Comments The value decrements after each logon, and WinLogon disables the feature after the specified number of logon attempts.

Requires AutoLogon = Yes and AdminPassword = password in Unattend.txt. If AutoLogon = Yes, WinLogon checks the value of AutoLogonCount. If the number for AutoLogonCount is greater than 0, WinLogon decrements the count and then checks AdminPassword. If AdminPassword = password, WinLogon uses this password to log on automatically. If AdminPassword = *, the user must enter a password.

If AutoLogonCount = 0, then WinLogon deletes AutoAdminLogon, AutoLogonCount, and DefaultPassword from the registry. During the next reboot, the user must log on manually.

Important

  • The function of this entry has changed slightly between Windows 2000 and Windows XP. Please review this entry carefully before using it in your answer file.
  • Make sure that the password for the master installation (that you plan to duplicate onto one or more destination computers) is blank.
  • You must reboot the computer to decrement the value of AutoLogonCount.

icon Return to top

DetachedProgram

Indicates the path of the custom program that runs concurrently with the Setup program.

Syntax DetachedProgram = detached_program_string
Value detached_program_string
Example
DetachedProgram = "%SYSTEMDRIVE%\extras\install.exe"
Comments If the program requires any arguments, you must specify them in the Arguments entry.

icon Return to top

EMSBlankPassword

Enables the use of a blank administrator password in unattended installations to EMS servers.

Syntax EMSBlankPassword = Yes | No
Values Yes

Enables the use of "*" with AdminPassword when preinstalling to EMS servers.

No

Disables the use of "*" with AdminPassword when preinstalling to EMS servers.

Default Value No
Example
EMSBlankPassword = Yes
Comments Applies only to the Windows Server 2003 family. By default, blank administrator passwords (AdminPassword = "*") are not allowed in unattended installations of any member of the Windows Server 2003 family to EMS servers.

icon Return to top

EMSSkipUnattendProcessing

Prevents Windows Setup from processing Unattend.txt or Sysprep.inf during an unattended installation to an EMS server.

Syntax EMSSkipUnattendProcessing = 0 | 1
Values 0

Does not prevent Windows Setup from processing Unattend.txt or Sysprep.inf during an unattended installation to an EMS server.

1

Prevents Windows Setup from processing Unattend.txt or Sysprep.inf during an unattended installation to an EMS server.

Default Value 0
Example
EMSSkipUnattendProcessing = 0
Comments Applies only to the Windows Server 2003 family.

icon Return to top

EncryptedAdminPassword

Enables Setup to install encrypted passwords for the Administrator account.

Syntax EncryptedAdminPassword = Yes | No
Values Yes

Instructs Setup to install the encrypted Administrator account password.

No

Instructs Setup to keep the Administrator account password as clean text.

Default Value No
Example
EncryptedAdminPassword = Yes
Comments To encrypt your Administrator passwords, use Setup Manager on the Windows OPK CD (in Tools) and in Deploy.cab.

Important

  • If you use this key to install an encrypted Administrator password during an unattended installation, Setup disables Autologon.

icon Return to top

OEMSkipRegional

Enables unattended Setup to skip the Regional and Language Options page in GUI-mode Setup and Mini-Setup.

Syntax OEMSkipRegional = 0 | 1
Values 0

Displays the Regional and Language Options page in GUI-mode Setup and Mini-Setup.

1

Skips the Regional and Language Options page in GUI-mode Setup and Mini-Setup.

Example
OEMSkipRegional = 0
Dependency
OEMPreinstall = Yes
Comments If, in the [Unattended] section, you set OemPreinstall to Yes and provide values for the [RegionalSettings] section, set the value of the OEMSkipRegional entry equal to 1 to ensure that Setup completes without prompting the end user for regional information.

icon Return to top

OEMSkipWelcome

Enables unattended Setup to skip the Welcome page in GUI-mode Setup and Mini-Setup.

Syntax OEMSkipWelcome = 0 | 1
Values 0

Displays the Welcome page in GUI-mode Setup and Mini-Setup.

1

Skips the Welcome page in GUI-mode Setup and Mini-Setup.

Example
OEMSkipWelcome = 0
Dependency
OEMPreinstall = Yes
Comments

Important

  • If OemPreinstall in the [Unattended] section of Unattend.txt is set to Yes, unattended Setup automatically stops on the Welcome page. To avoid this pause in your factory or testing environment, set OEMSkipWelcome = 1. Do not ship any computer with OEMSkipWelcome = 1. Instead, change OEMSkipWelcome in the [GuiUnattended] section of Sysprep.inf to 0 before delivering the computer to the customer.

icon Return to top

ProfilesDir

Specifies the location of Windows XP or Windows Server 2003 family profiles.

Syntax ProfilesDir = path_to_profile_folder
Value path_to_profile_folder
Default Value "%SYSTEMDRIVE%\Documents and Settings"
Example
ProfilesDir = "%SYSTEMROOT%\Profiles"
Comments This entry is useful if you require new installations to use the same profile folder as Windows NT 4.0 or Windows 2000. This entry is valid only on clean installations of Windows XP or Windows Server 2003 family. Setup ignores this entry during upgrades.

The specified directory can contain an environment variable such as %SYSTEMDRIVE% or %SYSTEMROOT%. Enclose path_to_profile_folder in quotation marks if it is a long file name or if it contains an environment variable.

icon Return to top

ServerWelcome

Specifies whether to install the Web UI for Remote Administration at first logon on a member of the Windows Server 2003 family.

Syntax ServerWelcome = Yes | No
Value Yes | No
Default Value Yes
Example
ServerWelcome = Yes
Comments On the Windows Server 2003, Web Edition, if this entry is set to Yes, then on first logon, Sasetup.msi will be run from the hard drive, the Web UI for Web server administration will be added to the Startup program group for the Administrator account, and the Web UI will be launched.

On Windows Server 2003, Standard Edition, Windows Server 2003, Enterprise Edition, Microsoft Small Business Server, and Windows Server 2003, Datacenter Edition, if this entry is set to Yes, then the Configure Your Server wizard will be run on first user logon. If this parameter is set to No, then the Configure Your Server Wizard will not be run.

This parameter will not be utilized during a Sysprep (Sysprep.inf) installation.

icon Return to top

TimeZone

Specifies the time zone of the computer.

Syntax TimeZone = index
Value index

Index values corresponding to each time zone - Click here to see a table listing the numeric values corresponding to the time zones.

This table lists the numeric values corresponding to the time zones.

Index Time Zone Display
000 Dateline Standard Time (GMT-12:00) International Date Line West
001 Samoa Standard Time (GMT-11:00) Midway Island, Samoa
002 Hawaiian Standard Time (GMT-10:00) Hawaii
003 Alaskan Standard Time (GMT-09:00) Alaska
004 Pacific Standard Time (GMT-08:00) Pacific Time (US and Canada); Tijuana
010 Mountain Standard Time (GMT-07:00) Mountain Time (US and Canada)
013 Mexico Standard Time 2 (GMT-07:00) Chihuahua, La Paz, Mazatlan
015 U.S. Mountain Standard Time (GMT-07:00) Arizona
020 Central Standard Time (GMT-06:00) Central Time (US and Canada)
025 Canada Central Standard Time (GMT-06:00) Saskatchewan
030 Mexico Standard Time (GMT-06:00) Guadalajara, Mexico City, Monterrey
033 Central America Standard Time (GMT-06:00) Central America
035 Eastern Standard Time (GMT-05:00) Eastern Time (US and Canada)
040 U.S. Eastern Standard Time (GMT-05:00) Indiana (East)
045 S.A. Pacific Standard Time (GMT-05:00) Bogota, Lima, Quito
050 Atlantic Standard Time (GMT-04:00) Atlantic Time (Canada)
055 S.A. Western Standard Time (GMT-04:00) Caracas, La Paz
056 Pacific S.A. Standard Time (GMT-04:00) Santiago
060 Newfoundland and Labrador Standard Time (GMT-03:30) Newfoundland and Labrador
065 E. South America Standard Time (GMT-03:00) Brasilia
070 S.A. Eastern Standard Time (GMT-03:00) Buenos Aires, Georgetown
073 Greenland Standard Time (GMT-03:00) Greenland
075 Mid-Atlantic Standard Time (GMT-02:00) Mid-Atlantic
080 Azores Standard Time (GMT-01:00) Azores
083 Cape Verde Standard Time (GMT-01:00) Cape Verde Islands
085 GMT Standard Time (GMT) Greenwich Mean Time : Dublin, Edinburgh, Lisbon, London
090 Greenwich Standard Time (GMT) Casablanca, Monrovia
095 Central Europe Standard Time (GMT+01:00) Belgrade, Bratislava, Budapest, Ljubljana, Prague
100 Central European Standard Time (GMT+01:00) Sarajevo, Skopje, Warsaw, Zagreb
105 Romance Standard Time (GMT+01:00) Brussels, Copenhagen, Madrid, Paris
110 W. Europe Standard Time (GMT+01:00) Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna
113 W. Central Africa Standard Time (GMT+01:00) West Central Africa
115 E. Europe Standard Time (GMT+02:00) Bucharest
120 Egypt Standard Time (GMT+02:00) Cairo
125 FLE Standard Time (GMT+02:00) Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius
130 GTB Standard Time (GMT+02:00) Athens, Istanbul, Minsk
135 Israel Standard Time (GMT+02:00) Jerusalem
140 South Africa Standard Time (GMT+02:00) Harare, Pretoria
145 Russian Standard Time (GMT+03:00) Moscow, St. Petersburg, Volgograd
150 Arab Standard Time (GMT+03:00) Kuwait, Riyadh
155 E. Africa Standard Time (GMT+03:00) Nairobi
158 Arabic Standard Time (GMT+03:00) Baghdad
160 Iran Standard Time (GMT+03:30) Tehran
165 Arabian Standard Time (GMT+04:00) Abu Dhabi, Muscat
170 Caucasus Standard Time (GMT+04:00) Baku, Tbilisi, Yerevan
175 Transitional Islamic State of Afghanistan Standard Time (GMT+04:30) Kabul
180 Ekaterinburg Standard Time (GMT+05:00) Ekaterinburg
185 West Asia Standard Time (GMT+05:00) Islamabad, Karachi, Tashkent
190 India Standard Time (GMT+05:30) Chennai, Kolkata, Mumbai, New Delhi
193 Nepal Standard Time (GMT+05:45) Kathmandu
195 Central Asia Standard Time (GMT+06:00) Astana, Dhaka
200 Sri Lanka Standard Time (GMT+06:00) Sri Jayawardenepura
201 N. Central Asia Standard Time (GMT+06:00) Almaty, Novosibirsk
203 Myanmar Standard Time (GMT+06:30) Yangon (Rangoon)
205 S.E. Asia Standard Time (GMT+07:00) Bangkok, Hanoi, Jakarta
207 North Asia Standard Time (GMT+07:00) Krasnoyarsk
210 China Standard Time (GMT+08:00) Beijing, Chongqing, Hong Kong SAR, Urumqi
215 Singapore Standard Time (GMT+08:00) Kuala Lumpur, Singapore
220 Taipei Standard Time (GMT+08:00) Taipei
225 W. Australia Standard Time (GMT+08:00) Perth
227 North Asia East Standard Time (GMT+08:00) Irkutsk, Ulan Bator
230 Korea Standard Time (GMT+09:00) Seoul
235 Tokyo Standard Time (GMT+09:00) Osaka, Sapporo, Tokyo
240 Yakutsk Standard Time (GMT+09:00) Yakutsk
245 A.U.S. Central Standard Time (GMT+09:30) Darwin
250 Cen. Australia Standard Time (GMT+09:30) Adelaide
255 A.U.S. Eastern Standard Time (GMT+10:00) Canberra, Melbourne, Sydney
260 E. Australia Standard Time (GMT+10:00) Brisbane
265 Tasmania Standard Time (GMT+10:00) Hobart
270 Vladivostok Standard Time (GMT+10:00) Vladivostok
275 West Pacific Standard Time (GMT+10:00) Guam, Port Moresby
280 Central Pacific Standard Time (GMT+11:00) Magadan, Solomon Islands, New Caledonia
285 Fiji Islands Standard Time (GMT+12:00) Fiji Islands, Kamchatka, Marshall Islands
290 New Zealand Standard Time (GMT+12:00) Auckland, Wellington
300 Tonga Standard Time (GMT+13:00) Nuku'alofa
Example
TimeZone = 030
Registry subkey HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\
Control\TimeZoneInformation\DaylightName
Comments If the entry is not present, the end user must select a time zone.

Note

  • If you do not configure a specific time zone setting, the default time zone depends on the language version of Windows that is installed. For example, in the Japanese version, the default time zone is "GMT+9 (Osaka, Sapporo, Tokyo)."

icon Return to top