Oobe.xml Settings
3/21/2011
This topic describes the settings that can be set in Oobe.xml. A sample of Oobe.xml is provided with Windows Embedded Standard 7 Toolkit in the \Samples directory. This sample uses the fictitious company Fabrikam and Fabrikam graphics and offers throughout the XML.
For more information about how to view the sample of Oobe.xml, see Viewing a Sample of Oobe.xml.
Windows Welcome
The following table shows the available Oobe.xml settings and their allowed values for the <oem> section of Oobe.xml.
| Setting | Description | Value |
|---|---|---|
name |
Name of the manufacturer. |
String. |
logopath |
Absolute path of the OEM logo. |
Absolute path of logo file, a 32-bit .png file. 240x100 pixels. |
eulafilename |
Language and location-specific version of manufacturer Software License Terms. |
Absolute path of a named .rtf file. |
wallpaper |
Absolute path of the wallpaper file. Can include up to three for display. |
Absolute path of up to three named 32-bit .png files. 128x128 pixels. .gif "Ff795013.note(en-US,WinEmbedded.1001).gif") Note:
Lower color depths, such as 8-bit, will fail.
|
offerheader |
Initial description of OEM offer. |
String with a maximum of 40 characters. |
title |
Title of OEM offer. |
String. |
imagepath |
Absolute path of .bmp file. |
Absolute path of 32-bit .bmp or .gif file. 32x32 pixels. Portable Network Graphics (.png) files are not supported. |
details |
Fuller description of OEM offer. |
String with a maximum of 128 characters. |
detailsfilename |
File that contains details about the OEM offer. |
Absolute path of .rtf file. Embedded graphics cannot be displayed. |
shellexecute |
Path of the executable file for the OEM offer. |
Absolute path of Setup program for offer. |
The following table shows the available Oobe.xml settings and their enabled values for the <defaults> section of Oobe.xml.
| Setting | Description | Value |
|---|---|---|
language |
Decimal identifier of the default language. |
For possible values, see topic Supported Language Packs. |
location |
The location is specified by using a GEOID value that is converted to its decimal value. |
For a full list of GEOIDs in the Table of Geographical Locations, see this Microsoft Web site. |
Locale |
The locale is specified by using a LCID value. Note:
If users change system locale from a U.S. English or Western European locale to an East Asian locale or the reverse, the computer restarts after Windows Welcome.
|
For a full list of LCIDs on the Microsoft Global Development and Computing Portal, see this Microsoft Web site. |
keyboard |
The keyboard layout is specified by the input locale identifier (formerly known as "keyboard layout") format, a combination of the hexadecimal value of the language identifier and a device identifier. |
Use the keyboard value that is listed in the registry under HKEY_LOCAL_MACHINE \SYSTEM\ControlSet001\Control\Keyboard Layouts and prepend the LCID appropriate for the keyboard. If you are unsure of which LCID to use with a specific keyboard identifier, contact your account manager. These are also listed in topic Supported Language Packs. |
timezone |
The time zone is specified by a string that specifies the time zone for the computer. The maximum length is 256 characters. New time zones may appear in future releases. If you want to add support for a new time zone, you must enter the exact time zone string. |
String. For possible values, see the "Time Zones" section. |
glass |
Boolean to determine use of glass settings. |
0 or 1. 0 determines no use of glass. |
Language
There are many more LCIDs than available languages. A select few map to languages that can be were included with Standard 7. For more information about which languages release with Standard 7, at what level of localization, and their decimal identifiers, see topic Supported Language Packs.
Time Zones
The following table shows the time zones that are valid for the Standard 7 operating system, the UTC offsets for every time that zone, and the resource that is displayed for every time that zone.
| Time Zone | Display |
|---|---|
Afghanistan Standard Time |
(UTC+04:30) Kabul |
Alaskan Standard Time |
(UTC-09:00) Alaska |
Arab Standard Time |
(UTC+03:00) Kuwait, Riyadh |
Arabian Standard Time |
(UTC+04:00) Abu Dhabi, Muscat |
Arabic Standard Time |
(UTC+03:00) Baghdad |
Atlantic Standard Time |
(UTC-04:00) Atlantic Time (Canada) |
AUS Central Standard Time |
(UTC+09:30) Darwin |
AUS Eastern Standard Time |
(UTC+10:00) Canberra, Melbourne, Sydney |
Azores Standard Time |
(UTC-01:00) Azores |
Canada Central Standard Time |
(UTC-06:00) Saskatchewan |
Cape Verde Standard Time |
(UTC-01:00) Cape Verde Islands |
Caucasus Standard Time |
(UTC+04:00) Baku, Tbilisi, Yerevan |
Cen. Australia Standard Time |
(UTC+09:30) Adelaide |
Central America Standard Time |
(UTC-06:00) Central America |
Central Asia Standard Time |
(UTC+06:00) Astana, Dhaka |
Central Europe Standard Time |
(UTC+01:00) Belgrade, Bratislava, Budapest, Ljubljana, Prague |
Central European Standard Time |
(UTC+01:00) Sarajevo, Skopje, Warsaw, Zagreb |
Central Pacific Standard Time |
(UTC+11:00) Magadan, Solomon Islands, New Caledonia |
Central Standard Time |
(UTC-06:00) Central Time (US and Canada) |
China Standard Time |
(UTC+08:00) Beijing, Chongqing, Hong Kong SAR, Urumqi |
Dateline Standard Time |
(UTC-12:00) International Date Line West |
E. Africa Standard Time |
(UTC+03:00) Nairobi |
E. Australia Standard Time |
(UTC+10:00) Brisbane |
E. Europe Standard Time |
(UTC+02:00) Bucharest |
E. South America Standard Time |
(UTC-03:00) Brasilia |
Eastern Standard Time |
(UTC-05:00) Eastern Time (US and Canada) |
Egypt Standard Time |
(UTC+02:00) Cairo |
Ekaterinburg Standard Time |
(UTC+05:00) Ekaterinburg |
Fiji Islands Standard Time |
(UTC+12:00) Fiji Islands, Kamchatka, Marshall Islands |
FLE Standard Time |
(UTC+02:00) Helsinki, Kiev, Riga, Sofia, Tallinn, Vilnius |
Coordinated Universal Time (Greenwich Mean Time) |
(UTC) Coordinated Universal Time : Dublin, Edinburgh, Lisbon, London |
Greenland Standard Time |
(UTC-03:00) Greenland |
Greenwich Standard Time |
(UTC) Casablanca, Monrovia |
GTB Standard Time |
(UTC+02:00) Athens, Istanbul, Minsk |
Hawaiian Standard Time |
(UTC-10:00) Hawaii |
India Standard Time |
(UTC+05:30) Chennai, Kolkata, Mumbai, New Delhi |
Iran Standard Time |
(UTC+03:30) Tehran |
Israel Standard Time |
(UTC+02:00) Jerusalem |
Korea Standard Time |
(UTC+09:00) Seoul |
Mexico Standard Time |
(UTC-06:00) Guadalajara, Mexico City, Monterrey |
Mexico Standard Time 2 |
(UTC-07:00) Chihuahua, La Paz, Mazatlan |
Mid-Atlantic Standard Time |
(UTC-02:00) Mid-Atlantic |
Mountain Standard Time |
(UTC-07:00) Mountain Time (US and Canada) |
Myanmar Standard Time |
(UTC+06:30) Yangon (Rangoon) |
N. Central Asia Standard Time |
(UTC+06:00) Almaty, Novosibirsk |
Nepal Standard Time |
(UTC+05:45) Kathmandu |
New Zealand Standard Time |
(UTC+12:00) Auckland, Wellington |
Newfoundland Standard Time |
(UTC-03:30) Newfoundland and Labrador |
North Asia Standard Time |
(UTC+07:00) Krasnoyarsk |
North Asia East Standard Time |
(UTC+08:00) Irkutsk, Ulaanbaatar |
Pacific SA Standard Time |
(UTC-04:00) Santiago |
Pacific Standard Time |
(UTC-08:00) Pacific Time (US and Canada); Tijuana |
Romance Standard Time |
(UTC+01:00) Brussels, Copenhagen, Madrid, Paris |
Russian Standard Time |
(UTC+03:00) Moscow, St. Petersburg, Volgograd |
SA Eastern Standard Time |
(UTC-03:00) Buenos Aires, Georgetown |
SA Western Standard Time |
(UTC-04:00) Caracas, La Paz |
SA Pacific Standard Time |
(UTC-05:00) Bogota, Lima, Quito |
Samoa Standard Time |
(UTC-11:00) Midway Island, Samoa |
SE Asia Standard Time |
(UTC+07:00) Bangkok, Hanoi, Jakarta |
Singapore Standard Time |
(UTC+08:00) Kuala Lumpur, Singapore |
South Africa Standard Time |
(UTC+02:00) Harare, Pretoria |
Sri Lanka Standard Time |
(UTC+06:00) Sri Jayawardenepura |
Taipei Standard Time |
(UTC+08:00) Taipei |
Tasmania Standard Time |
(UTC+10:00) Hobart |
Tokyo Standard Time |
(UTC+09:00) Osaka, Sapporo, Tokyo |
Tonga Standard Time |
(UTC+13:00) Nuku'alofa |
US Eastern Standard Time |
(UTC-05:00) Indiana (East) |
US Mountain Standard Time |
(UTC-07:00) Arizona |
Vladivostok Standard Time |
(UTC+10:00) Vladivostok |
W. Australia Standard Time |
(UTC+08:00) Perth |
W. Central Africa Standard Time |
(UTC+01:00) West Central Africa |
W. Europe Standard Time |
(UTC+01:00) Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna |
West Asia Standard Time |
(UTC+05:00) Islamabad, Karachi, Tashkent |
West Pacific Standard Time |
(UTC+10:00) Guam, Port Moresby |
Yakutsk Standard Time |
(UTC+09:00) Yakutsk |
Welcome Center
The following table shows the available Oobe.xml settings for the <oemStrip> section of Oobe.xml and their allowed values.
| Setting | Description | Value |
|---|---|---|
oemLogo |
Path of the OEM logo to appear in the Computer Details preview pane. This setting must contain the namespace, xmlns="https://schemas.microsoft.com/windows/oobetasks/v1". |
Path of a .png file. Maximum size is 250 x 30 pixels. |
name |
Name of OEM offer. Appears in the title section of the preview pane. |
String with a maximum length of 255 characters. |
icon |
Absolute path of offer icon. |
Absolute path of an .ico file. Required. |
description |
Short description of the offer. |
String with a maximum length of 255 characters. |
command |
Path of executable file. |
Absolute path of executable file. |
sortPriority |
Numeric value to determine order of OEM offer. Higher numbers have higher priority. Therefore, an item with a higher sortPriority number (such as 94) appears before an item with a lower number (such as 7). |
Numeric value between 1 and 99 inclusive. Default is 1. |
infotip |
Short description of OEM offer that is displayed on mouse pause. |
String with a maximum length of 255 characters. |
keywords |
Keywords used for search purposes. |
String delimited by semicolon (;). |
previewPicture |
Path of .png file for OEM offer. |
Absolute path of .png file. 128x128 pixels. If this value is omitted, the .ico file specified for the <icon> value for the offer will be displayed in its place (if the .ico can be scaled to 126x126). |
previewBackground |
Path of .png file for OEM offer background. |
Absolute path of .png file. Maximum size is 800x178 pixels. |
startText |
Short description of getting started task. |
String with a maximum length of 64 characters. |
title |
Title text for OEM offer. |
String with a maximum length of 255 characters. |
bullet |
Creates a bullet in front of the paragraph of text. |
Absolute path of a .png file. |
text |
Text that describes offer. |
String with a maximum length of 255 characters. |
Conditions
Each task can be displayed or hidden to users by setting certain conditional parameters. Conditions are interpreted every time that the Welcome Center is started. If no condition is expressed, then the Welcome Center displays the task by default. Conditions are cumulative. This means that the sum of all conditions expressed is used as display logic.
Conditions are expressed by a name and can contain a set of parameters. Each condition belongs to the shcond://v1 namespace. They are therefore expressed as <condition name="shcond://v1#%conditionName%">.
Each condition can also be inverted by using the invert="true" attribute. For example, to display a task, use the following condition.
<condition name="shcond://v1#SkuEquals" invert="true">
<param name="Sku" value="Windows Embedded Standard 7" />
</condition>
The following table shows available condition names, parameters, values, and descriptions.
| Condition Name | Parameters | Values | Description |
|---|---|---|---|
RegvalEquals |
Regkey Regval RegvalExpected |
Registry key path Registry value name Expected registry value |
Registry value is the expected value. |
RegvalExists |
Regkey Regval |
Registry key path Registry value name |
Registry value exists. |
RegkeyExists |
Regkey |
Registry key path |
Registry key exists. |
IsMachineOnDomain |
None |
None |
Computer is on a network domain. |
IsUserAdmin |
None |
None |
User is an administrator. |
IsAuxDisplayConnected |
None |
None |
An auxiliary display (Standard 7 SideShow) is connected. |
IsMobilePC |
None |
None |
Computer is portable. |
IsOfflineFilesEnabled |
None |
None |
Offline Files has been enabled. |
SkuEquals |
1. Sku |
1. Sku Name. |
When you are setting this condition, do not use the full SKU name. Instead, use the values that correspond to the desired SKU. Standard 7 |
IsTabletPC |
None |
None |
Computer is a Tablet PC. |
IsTouchAvailable |
None |
None |
Computer has a touch-enabled digitizer. |
DateInRange |
1. Before 2. After |
1. Date and time 2. Date When they are combined, these two make an offer valid for a certain range. |
Set up a date range. Use an invariant local date format (for example, 1/1/1977 5:00a.m.). |
ISP Signup Offers
The following table shows the available Oobe.xml settings and their enabled values for the <oem> section of Oobe.xml as they are used for ISP Signup offers.
| Setting | Description | Value |
|---|---|---|
name |
Name of the manufacturer. This is used as the title of the offer. |
String. |
offer type |
Must be list type for ISP offers. |
List. |
showin |
Parameter that determines where the offer is displayed. |
both. |
details |
Fuller description of OEM offer. |
String with a maximum of 60 characters. |
imagepath |
Absolute path of .bmp file. |
Absolute path of 32-bit .bmp or .gif file. 32x32 pixels. .png and .ico files are not supported. |
detailsfilename |
File that contains details about the OEM offer. If this tag is omitted, the contents of the <details> tag are re-displayed on the details page. |
Absolute path of .rtf file. Embedded graphics cannot be displayed. |
shellexecute |
Path of the executable file for the OEM offer. |
Absolute path of Setup program for offer. |