Languages and International Servicing 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 commands can be used to change international settings in Windows® 7 and Windows® Preinstallation Environment (Windows PE) images. You can also query existing settings in an offline or online Windows image.

The base syntax for servicing a Windows image using the Deployment Image Servicing and Management (DISM.exe) tool is:

DISM.exe {/Image:<path_to_offline_image_directory> | /Online} [dism_options] {servicing_command} [<servicing_argument>]

There are three types of international servicing commands:

  • Get commands. Retrieves a report of the international settings for an offline image or a running operating system.

  • Set commands. Sets the different international settings for an offline image.

  • Gen-LangIni commands. Generates the Lang.ini file that is used during Setup.

The following international servicing options are available for an offline image:

DISM.exe /Image:<path_to_offline_image_directory> [/Get-Intl] [/Set-UILang | /Set-UILangFallback | /Set-SysLocale | /Set-UserLocale | /Set-InputLocale | /Set-AllIntl | /Set-Timezone | /Set-SKUIntlDefaults | /Set-LayeredDriver] [/Gen-Langini | /Set-SetupUILang | /Distribution]

The following international servicing options are available for a running operating system:

DISM.exe /Online/Get-Intl

The following table provides a description of how each international servicing option can be used. These options are not case sensitive.

Option Argument Description

/Get-Help

/?

When used immediately after an international servicing command-line option, information about the option and the arguments is displayed. Additional topics might become available when an image is specified.

Examples:

Dism /image:C:\test\offline /Set-UILang /?
Dism /online /Get-intl /?

/Get-Intl

Displays information about international settings and languages.

Use the /Online option to display information about international settings and languages in the running operating system.

Use the /Image:<path_to_offline_image_directory> option to display information about international settings and languages in the offline image.

When used with the /Distribution options, information about international settings and languages in the distribution is displayed. The name of the folder in the distribution share is not validated. It will be reported as …\Langpacks\<locale_name>\Lp.cab. Where <locale_name> is the name of the folder.

Note
The user locale is reported only for offline images. The report does not include this setting for running operating systems.

Examples:

Dism /online /Get-Intl
Dism /image:C:\test\offline /Get-Intl
Dism /image:C:\test\offline /distribution:C:\windows_distribution /Get-Intl

/Set-UILang:

<language_name>

Sets the default system user interface (UI) language. If the language is not installed in the Windows image, the command will fail.

<language_name> specifies the name of the language to set as the default; for example, ja-JP.

> [!NOTE] > If you install a Language Interface Pack (LIP) and specify its language as the default UI language, the LIP language will be set as the system default UI language (or Install language) and the parent language will be set as the default UI language.

Example:

Dism /image:C:\test\offline /Set-UILang:fr-FR

/Set-UILangFallback:

<language_name>

Sets the fallback default language for the system UI in the offline Windows image. This setting is used only when the language specified by the /Set-UILang option is a partially localized language.

<language_name> specifies the name of the language to set as the default fallback; for example, en-US.

Example:

Dism /image:C:\test\offline /Set-UILangFallBack:fr-FR

/Set-Syslocale:

<locale_name>

Sets the language for non-Unicode programs (also called 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 language for non-Unicode; for example, en-US.

> [!IMPORTANT] > You cannot set Unicode-only languages as the system locale. If you try, the /Set-SysLocale option will fail and the language for non-Unicode programs will not be changed.

Example:

Dism /image:C:\test\offline /Set-SysLocale:fr-FR

/Set-UserLocale:

<locale_name>

Sets the "standards and formats" language (also called user locale) in the offline Windows image. The "standards and formats" language is a per-user setting that determines default sort order and the default settings for formatting dates, times, currency, and numbers.

Example:

Dism /image:C:\test\offline /Set-UserLocale:fr-FR

/Set-InputLocale:

<input_locale>:<keyboard_layout>

Sets the input locales and keyboard layouts to use in the offline Windows image.

The value of the <input_locale>:<keyboard_layout> pair can be one of the following:

  • <language_id:keyboard_layout>

    For example, 0409:00000409

  • <locale_name>

    For example, if you specify en-US as the local name, The Set-InputLocale: option also sets the default keyboard layout defined for this locale.

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 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\CurrentControlSet\Control\Keyboard Layouts

For a list of the default input locale values, see Understanding Language Packs.

Use the hexadecimal value of the language ID and keyboard layout that you intend to configure.

This parameter is optional.

Example:

Dism /image:C:\test\offline /Set-InputLocale:0410:00010410

/Set-AllIntl:

<language_name>

Sets the default system UI language, the language for non-Unicode programs, the "standards and formats" language, and the input locales and keyboard layouts to the specified language in the offline Windows image. This option specifies the language value for the following:

  • UI Language

  • System Locale

  • User Locale

  • Input Locale

If used with any of the options that 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.

Example:

Dism /image:C:\test\offline /Set-AllIntl:fr-FR

/Set-TimeZone:

<timezone_name>

Sets the default time zone in a Windows image. Before setting the time zone, DISM verifies that the specified time zone string is valid for the image.

<timezone_name> 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. On a computer running Windows 7 you can use the tzutil command-line tool to list the time zone for that computer. The tzutil tool is installed by default on Windows 7.

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.

Example:

Dism /image:C:\test\offline /Set-TimeZone:"W. Europe Standard Time"

/Set-SKUIntlDefaults:

<language_name>

Sets the default system UI language, the language for non-Unicode programs, the "standards and formats" language, and the input locales, keyboard layouts and time zone values in an offline Windows image to the Windows 7 default value specified by <language_name>. The /Set-SKUIntlDefaults option does not change the keyboard driver for Japanese and Korean keyboards. You must use the /Set-LayeredDriver option to change this.

Use / Set-SKUIntlDefaults to change all the international settings in an 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.

This parameter is optional. If combined with one of the settings above, the individual setting takes priority.

If the language passed matches a Unicode only locale setting, the system locale will not be changed but the command will not fail.

Example:

Dism /image:C:\test\offline /Set-SKUIntlDefaults:fr-FR

/Set-LayeredDriver:

<1-6>

Specifies a keyboard driver to use for Japanese or Korean keyboards.

In Japan, many retail users have 106-key keyboards, while others have 101- or 102-key keyboards. In Korea, there are several different types of keyboards, some with different numbers of keys.

The possible values for these settings are [1-6]:

  1. Specifies the PC/AT Enhanced Keyboard (101/102-Key).

  2. Specifies the Korean PC/AT 101-Key Compatible Keyboard/MS Natural Keyboard (Type 1).

  3. Specifies the Korean PC/AT 101-Key Compatible Keyboard/MS Natural Keyboard (Type 2).

  4. Specifies the Korean PC/AT 101-Key Compatible Keyboard/MS Natural Keyboard (Type 3).

  5. Specifies the Korean Keyboard (103/106 Key).

  6. Specifies the Japanese Keyboard (106/109 Key).

Example:

Dism /image:C:\test\offline / Set-LayeredDriver:1

/Gen-LangINI:

Generates a new Lang.ini file, which is used by Setup to define the language packs inside the image and outside in the distribution. It also defines the default UI language for Setup.

The new Lang.ini file will be added to the Sources folder of the Windows distribution.

> [!NOTE] > You will not be prompted for permission to overwrite an existing Lang.ini file. The existing Lang.ini file will be overwritten automatically.

You must specify an offline Windows image (/Image:<path_to_offline_image.wim> and a distribution (/Distribution:<path_to_distribution_directory>).

Example:

Dism /image:C:\test\offline /Gen-LangINI /distribution:C:\windows_distribution

/Set-SetupUILang:

<language_name>

Defines the default language that will be used by Setup. If this language cannot be used, Setup automatically uses English.

This is an optional command. If not used, the default UI language in the image will be used. If the language is not present, the first language in the list of present languages will be used.

Example:

Dism /image:C:\test\offline /Set-SetupUILang:fr-FR /distribution:C:\windows_distribution

/Distribution:

<path_to-distribution_directory>

Specifies the path to the Windows distribution. The Windows distribution is a copy of the content that releases on the Windows product DVD. This option is to be used only with the /Get-Intl and /Gen-LangINI option if there are external language packs.

Example:

Dism /image:C:\test\offline /Gen-LangINI /distribution:C:\windows_distribution

Limitations

  • The DISM International servicing commands cannot be used on a Windows Vista® or a Windows Server® 2008 image. The international commands can be used to change international settings only in Windows® 7 and Windows PE 3.0 images. The Intlcfg.exe tool is deprecated in this release but is still available for configuring international settings in Windows Vista® and Windows Server® 2008. For command-line syntax, see Intlcfg Command-Line Options. For information about using Intlcfg.exe, see the Windows Vista SP1 release of the Windows OEM Preinstallation Kit (Windows OPK) or Windows Automated Installation Kit (Windows AIK).

  • You cannot use other servicing commands on the same command line with international servicing commands.

  • You cannot set a Unicode-only language as the system locale.

    The following languages are Unicode-only (Languages are listed in the table in the format: Language - Country/Region):

Amharic - Ethiopia

Kazakh - Kazakhstan

Oriya - India (Oriya Script)

Armenian - Armenia

Khmer - Cambodia

Pashto - Afghanistan

Assamese - India

Konkani - India

Punjabi - India (Gurmukhi Script)

Bengali - Bangladesh

Lao - Lao PDR

Sanskrit - India

Bengali - India (Bengali Script)

Malayalam - India (Malayalam Script)

Sinhala - Sri Lanka

Divehi - Maldives

Maltese - Malta

Syriac - Syria

Georgian - Georgia

Maori - New Zealand

Tamil - India

Gujarati - India (Gujarati Script)

Marathi - India

Telugu - India (Telugu Script)

Hindi - India

Mongolian (Mongolian) - PRC

Tibetan - PRC

Inuktitut (Syllabics) - Canada

Nepali - Nepal

Yi - PRC

Kannada - India (Kannada Script)

  • Do not install a language pack after an update.

    If you install an update (hotfix, general distribution release [GDR], or service pack [SP]) that contains language-dependent resources before you install a language pack, the language-specific changes contained in the update are not applied. Always install language packs before installing updates.

  • When specifying a time zone by using /Set-TimeZone:<timezone_name> you must use straight quotation marks for multiple words. For example, /Set-TimeZone:"Pacific Standard Time". If you copy and paste the time zone name, including quotation marks, from a Microsoft Word document, the quotation marks might not be recognized and the command line might fail.

  • If you are servicing an international image, and your host environment does not support the language in that image, you might not be able to read an error message that originates from the international image.

See Also

Concepts

What Is Deployment Image Servicing and Management?
How Deployment Image Servicing and Management Works
Deployment Image Servicing and Management Command-Line Options
Windows PE Servicing Command-Line Options
Driver Servicing Command-Line Options
Operating System Package Servicing Command-Line Options
Windows Edition-Servicing Command-Line Options