Set-WinUserLanguageList

  • Reference
Module:
International

Sets the language list and associated properties for the current user account.

Syntax

Set-WinUserLanguageList
   [-LanguageList] <System.Collections.Generic.List`1[Microsoft.InternationalSettings.Commands.WinUserLanguage]>
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Set-WinUserLanguageList cmdlet sets the current user language settings. These settings include input method, spelling setting, text prediction setting, and handwriting input mode. For more information, see CultureInfo Class and Configurable Language and Cultural Settings.

Examples

Example 1: Add a language to an existing language list

PS C:\> $OldList = Get-WinUserLanguageList
PS C:\> $OldList.Add("fr-FR")
PS C:\> Set-WinUserLanguageList -LanguageList $OldList

This example adds the language French (France) to the language list of the user.

The first command gets the user language list by using the Get-WinUserLanguageList cmdlet. The command stores the result in the $OldList variable.

The second command adds a language to the object in $OldList.

The final command sets the language list of the current user to the revised value of $OldList.

Example 2: Change a value in a language

PS C:\> $UserLanguageList = New-WinUserLanguageList -Language en-US
PS C:\> $UserLanguageList[0].Handwriting = $True
PS C:\> Set-WinUserLanguageList -LanguageList $UserLanguageList

This example changes the handwriting setting for a language in the user language list.

The first command creates a language list for US English that has default values, and then stores it in the $UserLanguageList variable.

The second command modifies the Handwriting property of the first member of the language list in $UserLanguageList.

The final command sets the language list of the current user to the revised value of $UserLanguageList.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LanguageList

Specifies a language list.

Type:List<T>[Microsoft.InternationalSettings.Commands.WinUserLanguage]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

System.Collections.Generic.List<Microsoft.InternationalSettings.Commands.WinUserLanguage>

You can pipe a list of WinUserLanguage objects that contain one or more languages and associated properties from the current user account's language list. The language object contains the following properties:

  • BCP-47 (READ). A standard language tag that is used to identify languages. For more information, see the Internet Engineering Task Force (IETF) BCP 47 RFC.
  • Autonym (LP database) (READ). The name of the language in the language itself.
  • English name (LP database) (READ). The name of the language in English.
  • Localized name (LP database) (READ). The name of the language in the current Windows display language.
  • Script (LP database) (READ). The writing system of the language.
  • Input methods (READ/WRITE). A list of input method Tablet Input Panel (TIP) strings that are enabled for this language. The enabled input methods are listed in the format Language ID:Keyboard layout ID. See Default input profiles (input locales) in Windows.
  • Handwriting recognition input mode (READ/WRITE). This value is either 0 (freehand) or 1 (write each character separately).