Partager via


Intlcfg Command-Line Options

Applies To: Windows 7

Note

This content applies to Windows 7. For Windows 8 content, see Windows Deployment with the Windows ADK.

The International Settings Configuration Tool (Intlcfg.exe) is used to change the language and locale, fonts, and input settings for a Windows Vista® and Windows Server® 2008 images. Typically, you run Intlcfg.exe after applying one or more language packs to your Windows image.

Warning

The intlcfg tool is used to configure Windows Vista and Windows Server 2008 computers only. To change the international settings on Windows® 7 and Windows Server® 2008 R2, use the DISM tool. For more information, see Languages and International Servicing Command-Line Options.

You can run the intlcfg command on an offline Windows image or on a running Windows operating system.

The Intlcfg.exe tool is installed in the Tools folder of the Windows OEM Preinstallation Kit (Windows OPK) or Windows Automated Installation Kit (Windows AIK).

Intlcfg.exe Command-Line Options

The following command-line options are available for the International Settings Configuration Tool:

Update language and locale settings

intlcfg.exe [-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]
[
-image:path] [-dist:path] [-silent
] [**-skudefaults:**language]

Update the lang.ini file and set the default language

intlcfg.exe **-genlangini:filename [-defaultlang:language]
[
-dist:**path -image:path] [-f]

Report the languages and language settings

intlcfg -report [**-dist:path] [-image:**path]

Option Description

-all:language_name

Sets all language and locale values to the specified language in an offline Windows image. This option specifies the language value for the following:

  • UI Language

  • System Locale

  • User Locale

  • Input Locale

If the -all option is used with any of the options used to specify the individual language or locales, then 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 Lang.ini file. By default, the tool will ask for user confirmation before overwriting a file.

-image:path

Specifies the location of the mounted Windows 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 to the Windows distribution. The Windows distribution is the content that releases on the Windows product DVD. This option is required only if you have language packs copied to the Langpacks folder of your Windows distribution or if you report the default language to use during Windows Setup.

-genlangini

When this option is specified, the tool generates a new Lang.ini file based on the languages in a Windows image and a Windows distribution. The new Lang.ini file will be added to the sources folder of the Windows distribution.

You can specify an alternate location for the Lang.ini file with the -genlangini:filename option.

-inputlocale:default_keyboard_description; keyboard_description

Sets the default keyboard to use in the offline Windows image.

default_keyboard_description

Can be one of the following:

  • locale_name:keyboard_layout

    For example, 0409:00000409

  • language_name

    For example, en-US

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 will be 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 Understanding Language Packs.

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 Windows image.

If the -report option is used with the -image and -dist options, Intlcfg returns the settings and languages installed in the Windows image and the available language packs in the Windows distribution. Intlcfg also reports the default language specified in the Lang.ini in the Windows distribution. If Lang.ini does not exist, then this setting will be unavailable.

wimPath

Specifies the path to a mounted or applied Windows image.

distPath

Specifies the path to a Windows distribution.

-silent

Does not display any output text.

-skudefaults:language

Sets all language, locale, and time zone values in an offline Windows image to the Windows Vista 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 Windows image to match the default values that are set during retail installations. For more information about the default values of each language pack, see Understanding Language Packs.

-syshive:registry_path

Specifies the path to the system hive in the registry.

registry_path

Specifies the path to the registry hive.

-syslocale:locale_name

Sets the system locale and font settings in the offline Windows 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 Windows 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 the Windows® Unattended Setup Reference.

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 Windows image, Intlcfg will fail.

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 to 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 to the registry hive.

-userlocale:locale_name

Sets the user locale. User locale (also called "standards and formats") is a per-user variable that determines 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 Windows Setup in the Lang.ini file.

This setting applies only to Windows Setup. To change the UI language of the Windows installation, use the -uilang option.

If the language that is specified does not exist in the Windows image, Intlcfg returns an error. The language must be installed in the Windows 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 in the distribution. If the Lang.ini file is missing or the default that is specified is not installed in the image, the first language found in the Windows image is used as the default language. Languages are identified in alphabetical order. If a Windows 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 a lowercase ISO 639 language code and an uppercase ISO 3166-1 country or 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 Understanding Language Packs.

Examples

The following commands provide examples of using Intlcfg.exe.

Update all International Settings

The following command sets all of the settings (user, system, input locale, and UIlanguage) in the Windows image that is mounted at C:\Wim_mount to Japanese. The input locale will be set to the 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 in the Windows distribution at C:\Windows_distribution without requiring user confirmation. The default language will be set to en-US.

intlcfg.exe -genlangini -dist:C:\windows_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 Windows distribution at C:\Windows_distribution. The Lang.ini file will be created as C:\Windows_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 Windows image that exists in the sources directory of the Windows distribution.

The default language will be set to Japanese and all other international settings will be set to German.

intlcfg.exe -genlangini -dist:C:\windows_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 as well as the default language in the Windows image.

intlcfg.exe -report -dist:C:\windows_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 Windows 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:\Windows_distribution to en-US.

intlcfg.exe -dist:C:\windows_distribution -defaultlang:en-US -f 

See Also

Concepts

Command-Line Tools Technical Reference