Set-WinUserLanguageList

Set-WinUserLanguageList

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

Syntax

Parameter Set: Default
Set-WinUserLanguageList [-LanguageList] <0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed 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.

Parameters

-Force

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-LanguageList<0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]>

Specifies a language list.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

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


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • List<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.
    -- Handwriting recognition input mode (READ/WRITE). This value is either 0 (freehand) or 1 (write each character separately).


Examples

Example 1: Add a language to an existing language list

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.


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

Example 2: Change a value in a language

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.


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

Related topics

Community Additions

ADD
Show: