Intlcfg Command-Line Options
3/21/2011
The International Settings Configuration Tool (Intlcfg.exe) is used to change the language and locale, fonts, and input settings to a Windows Embedded Standard 7 image. Typically, you run Intlcfg.exe after you apply one or more language packs to your Standard 7 image.
You can run the intlcfg command on an offline Standard 7 image or on a running Standard 7 operating system.
The Intlcfg.exe tool is installed in the Tools directory of Windows Embedded Standard 7 Toolkit.
Where to Find Intlcfg
In order to run the intlcfg command on a computer with Windows Embedded Standard 7 Toolkit installed, you must first open the Windows PE Tools Command Prompt. This will load the Standard 7 environment variables and allow you to use intlcfg from your command prompt.
Alternatively, to copy intlcfg to a storage device or a remote location, you can find intlcfg at the following locations, where C is the drive on which you installed Standard 7 and E is a DVD drive containing the Standard 7.installation media. Replace <device architecture> with x86 or AMD64, depending on your device architecture.
C:\Program Files\Windows Embedded Studio\Tools\<device architecture>
E:\Windows Embedded Studio\Program Files\Windows Embedded Studio\Tools\<device architecture>
Note If your development computer uses a 64-bit architecture, your installation location will change to C:\Program Files (x86)\Windows Embedded Studio.
Intlcfg.exe Command-Line Options
The following command-line options are available for Intlcfg.exe:
Update language and locale settings
intlcfg [-all:language_name] [-uilang:language_name] [-uilangfallback:language_name][-syslocale:language_name][-userlocale:language_name] [-inputlocale:default_keyboard_description; keyboard_description or locale_name] [-userhive:registry_path] [-syshive:registry_path] [-swhive:registry_path][-image:path] [-dist:path] [-silent] [**-skudefaults:**language]
Update the Lang.ini file and set the default language
**intlcfg -genlangini:**filename **[-defaultlang:**language] **[-dist:**path -image:path] [-f]
Report the languages and language settings
intlcfg -report [**-dist:path] [-image:**path]
Description of options
| Option | Description |
|---|---|
-all: language_name |
Sets all language and locale values to the specified language in an offline Standard 7 image. This option specifies the language value for the following:
If the -all option is used with any of the options that are used to specify the individual language or locales, the individual settings take precedence. language_name Specifies the language name and locale code; for example, en-US, es-ES, or fr-FR. |
-f |
Overwrites the Lang.ini file. By default, the tool asks for user confirmation before overwriting a file. |
-image: path |
Specifies the location of the mounted Standard 7 image. This option is required to update any of the settings in the image, to update the Lang.ini file, or to obtain a report of the settings and languages in the image. |
-dist: path |
Specifies the path of the Standard 7 distribution. The Standard 7 distribution is the content that releases on the Standard 7 product DVD. This option is required only if you have language packs copied to the Langpacks directory of your Standard 7 distribution, or if you report the default language to use with Image Builder. |
-genlangini |
When this option is specified, the tool generates a new Lang.ini file that is based on the languages in a Standard 7 image and a Standard 7 distribution. The new Lang.ini file will be added to the Sources folder of the Standard 7 distribution. You can specify an alternative location for the Lang.ini file that has the -genlangini:filename option. |
-inputlocale: default_keyboard_description; keyboard_description |
Sets the default keyboard to use in the offline Standard 7 image. default_keyboard_description You can specify more than one value by using semicolons (;) as separators. This is useful when you want to include support for multiple keyboards on a single computer. The first value for -inputlocale is set as the default keyboard. The valid keyboard layouts that can be configured on your computer are listed in the following registry key: HKEY_LOCAL_MACHINE \SYSTEM\ControlSet001\Control\Keyboard Layouts For a list of the default input-locale values, see Language Packages. Use the hexadecimal value of the keyboard layout that you intend to configure. |
-report [-image:wimpath] [-dist:distpath] |
Lists all installed and available language packs and default language settings. If the -report option is the only option passed, intlcfg reports the settings and languages installed to the current operating system. If the -report option is used with the –image option, intlcfg returns the settings and language installed to the Standard 7 image. If the -report option is used with the –image and –dist options, intlcfg returns the settings and languages installed in the Standard 7 image and the available language packs in the Standard 7 distribution. Intlcfg also reports the default language specified in the Lang.ini file in the Standard 7 distribution. If the Lang.ini file does not exist, this setting is unavailable. wimPath Specifies the path of a mounted or applied Standard 7 image. distPath Specifies the path of a Standard 7 distribution. |
-silent |
Displays no output text. |
-skudefaults: language |
Sets all language, locale, and time-zone values in an offline Standard 7 image to the Standard 7 default value specified by language. This option specifies the language value for the following settings: UI Language, System Locale, User Locale, Input Locale, and Timezone. Use the –skudefaults option to change all the international settings in the offline Standard 7 image to match the default values that are set during retail installations. For more information about the default values of each language pack, see Language Packages. |
-swhive: registry_path |
Specifies the path of the software hive in the registry. registry_path Specifies the path of the registry hive. |
-syshive: registry_path |
Specifies the path of the system hive in the registry. registry_path Specifies the path of the registry hive. |
-syslocale: locale_name |
Sets the system locale and font settings in the offline Standard 7 image. locale_name Specifies the name of the language and locale to set as the default system locale; for example, en-US. |
-timezone: timezoneName |
Sets the default time zone in a Standard 7 image. Before setting the time zone, intlcfg verifies that the specified time-zone string is valid for the image. timezoneName Specifies the name of the time zone to use; for example, "Pacific Standard Time". For a complete list of time zone strings, see Language Packages. The name of the time zone must exactly match the name of the time-zone settings in the registry in HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\TimeZones\. If you add a custom time zone to your computer, you can specify that custom time-zone string. |
-uilang: language_name |
Sets the default system user-interface (UI) language to use. If the language is not installed in the Standard 7 image, intlcfg fails. language_name Specifies the name of the language to set as default; for example, ja-JP. |
-uilangfallback: language_name |
Sets the fallback language for the system UI. This setting is used only when the language specified by UILanguage is a partially localized language. language_name Specifies the name of the language to set as the default fallback language; for example, en-US. |
-userhive: registry_path |
Specifies the path of a user hive in the registry. This option is optional. If the option is not specified, intlcfg updates the default user hives and default system account hives. registry_path Specifies the path of the registry hive. |
-userlocale: locale_name |
Sets the user locale. User locale (also known as "standards and formats") is a per-user variable that determines the default sort order and the default settings for formatting dates, times, currency, and numbers. locale_name Specifies the name of the language and locale to set as the default user locale; for example, en-US. |
-defaultlang: language_name |
Sets the default language to use during Image Builder in the Lang.ini file. This setting applies only to Image Builder. To change the UI language of the Standard 7 installation, use the -uilang option. If the language specified does not exist in the Standard 7 image, intlcfg returns an error. The language must be installed in the Standard 7 image by using Package Manager. If this option is not specified when the -genlangini option is used, the tool keeps the same default language in the existing Lang.ini file in the distribution. If the Lang.ini file is missing or the default specified is not installed in the image, the first language found in the Standard 7 image is used as the default language. Languages are identified in alphabetical order. If a Standard 7 image contained en-US and fr-FR, en-US is set to the default. language_name The default language to use; for example, en-US, es-ES, or fr-FR. This value can only be set to one of the supported UILanguage values. |
Values for language_name and locale_name are based on the language tagging conventions in RFC 3066. This parameter is written in a lowercase ISO 639 language code, and an uppercase ISO 3166-1 country/region identifier; for example, en-US (English, US), fr-CA (French, Canadian), and es-ES (Spanish, Spain).
For more information about the supported language name and locale name values, see Language Packages.
Examples
The following commands provide examples about how to use Intlcfg.exe.
Update all international settings
The following command sets all the settings (user, system, input locale, and UIlanguage) in the Standard 7 image mounted at C:\Wim_mount to Japanese. The input locale will be set to default Japanese keyboard.
intlcfg.exe –all:ja-JP –image: C:\wim_mount
Update specific international settings
The following command sets the user locale to en-US in the registry hive loaded at HKLM\Offline\Users\Default.
intlcfg.exe –userlocale:en-US –userhive:HKLM\offline\users\default –image: C:\wim_mount
Create a new Lang.ini file
The following command updates the Lang.ini file in the Standard 7 distribution at C:\MyDir_distribution without requiring user confirmation. The default language will be set to en-US.
intlcfg.exe –genlangini –dist:C:\MyDir_distribution -image:C:\wim_mount –defaultlang:en-US -f
Create a new Lang.ini file and update settings
The following command creates a Lang.ini file that describes the languages in the Standard 7 distribution at C:\MyDir_distribution. The Lang.ini file will be created as C:\MyDir_distribution\Lang.ini. If a Lang.ini file already exists in this location, the user will be prompted to overwrite the existing file.
The image specified by the -image option is assumed to be the same Standard 7 image that exists in the Sources folder of the Standard 7 distribution.
The default language will be set to Japanese and all other international settings are set to German.
intlcfg.exe -genlangini –dist:C:\MyDir_distribution -image: C:\wim_mount –defaultlang:ja-JP –all:de-DE
Report the languages available on a Windows image or distribution
The following command displays the languages that are installed and available and the default language in the Standard 7 image.
intlcfg.exe -report –dist:C:\MyDir_distribution –image:C:\wim_mount
Report the languages available on a running Windows installation
The following command displays the languages that are installed on an online Standard 7 installation.
intlcfg.exe -report
Update the default language
The following command changes the default language in the Lang.ini file of the distribution at C:\MyDir_distribution to en-US.
intlcfg.exe –dist:C:\MyDir_distribution –defaultlang:en-US -f