New-WinUserLanguageList

Applies To: Windows 8, Windows Server 2012

New-WinUserLanguageList

Instantiates a new language list object.

Syntax

Parameter Set: Default
New-WinUserLanguageList [-Language] <String> [ <CommonParameters>]

Detailed Description

The New-WinUserLanguageList cmdlet creates a new user language list object. The object 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

-Language<String>

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

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

Outputs

The output type is the type of the objects that the cmdlet emits.

  • List<WinUserLanguage>

    A list of WinUserLanguage objects that contain one or more languages and associated properties from the current user account’s language list. For more information about the Generic.List object, see System.Collections.Generic.List(Of T).

    The generic list object supports the following methods:

    Add(“BCP-47”)

    Insert(index, “BCP-47”)

    Remove(Index)

    The LanguageList is a list of language objects in the current user account's list. The language list object contains the following methods:

    Add(“BCP-47”)

    Insert(BCP-47, index)

    Remove(BCP-47)

    Remove(Index)

    The language list 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

This command creates and sets a new user language list that contains English (United States) and French (France).

PS C:\> $1 = New-WinUserLanguageList en-US

PS C:\> $1.Add("fr-FR")

PS C:\> Set-WinUserLanguageList $1

Get-WinUserLanguageList

Set-WinUserLanguageList