Edit

Share via

Set-WinSystemLocale

  • Reference
Module:
International

Sets the system locale for the current computer.

Syntax

Set-WinSystemLocale
   [-SystemLocale] <CultureInfo>
   [<CommonParameters>]

Description

The Set-WinSystemLocale cmdlet sets the system locale for the current computer. The System-locale setting determines which code pages, which include ANSI, DOS, and Macintosh, the computer uses by default. If you change the System-locale setting, the necessary bitmap font files are installed to support legacy applications in the selected language.

This is a system setting. It can only be changed by a user who has Administrator permissions. Changes take effect after the computer is restarted.

Examples

Example 1: Set the system locale

PS C:\> Set-WinSystemLocale -SystemLocale ja-JP

This command sets the system locale to Japanese (Japan).

Parameters

-SystemLocale

Specifies a system locale.

Type:CultureInfo
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Inputs

CultureInfo

An object that contains a BCP-47 tag to specify the system locale for the current computer. For more information about the CultureInfo object, see CultureInfo Class.

Notes

Please note that the System Locale setting on the computer is primarily used for legacy code page selection and font fallback. This setting is primarily used by applications that do not support Unicode. It should not be viewed from the sense of a traditional locale or culture info, and should not be confused with the user locale (Regional Format) setting.

When changing the System Locale setting it is highly recommended to also change the Windows Display Language or UI language setting for the computer so that it matches the System Locale. In some cases, the UI language may depend on the code page and/or the font to render properly. Failure to do so can result in configurations where non-Unicode applications don't work as intended.