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.
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.
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.
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:
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 Supported Language Packs and Default Settings. 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:
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 Supported Language Packs and Default Settings. 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]:
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.
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 [auth_7_tech_ref]. 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
- What Is Deployment Image Servicing and Management?How Windows 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