mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-06-18 20:03:40 +00:00
Updated again as per review comments
This commit is contained in:
@ -13,7 +13,7 @@ ms.date: 06/22/2021
|
||||
|
||||
# Language Pack Management CSP
|
||||
|
||||
The Language Pack Management CSP allows a direct way to provision language packs remotely in Windows 10 and Windows 10 X. MDMs like Intune can use management commands remotely to devices to configure language-related settings.
|
||||
The Language Pack Management CSP allows a direct way to provision languages remotely in Windows. MDMs like Intune can use management commands remotely to devices to configure language-related settings for System and new users.
|
||||
|
||||
1. Enumerate installed languages and features with GET command on the "InstalledLanguages" node. Below are the samples:
|
||||
|
||||
@ -23,13 +23,13 @@ The Language Pack Management CSP allows a direct way to provision language packs
|
||||
**GET./Device/Vendor/MSFT/LanguagePackManagement/InstalledLanguages/ja-JP/Providers**
|
||||
**GET./Device/Vendor/MSFT/LanguagePackManagement/InstalledLanguages/ja-JP/LanguageFeatures**
|
||||
|
||||
The nodes under **InstalledLanguages** are the language tags of the installed languages. The **providers** node under language tag is an integer representation of either language pack (features) or [LXPs](https://www.microsoft.com/store/collections/localexperiencepacks?cat0=devices&rtc=1).
|
||||
The nodes under **InstalledLanguages** are the language tags of the installed languages. The **providers** node under language tag is an integer representation of either [language pack](/windows-hardware/manufacture/desktop/available-language-packs-for-windows?view=windows-11&preserve-view=true) or [LXPs](https://www.microsoft.com/store/collections/localexperiencepacks?cat0=devices&rtc=1).
|
||||
|
||||
- **1**- Indicates the language pack installed is a System Language Pack (non-LXP)
|
||||
- **2**- Indicates that the LXP is installed.
|
||||
- **1**- Indicates that only the Language Pack cab is installed.
|
||||
- **2**- Indicates that only the LXP is installed.
|
||||
- **3**- Indicates that both are installed.
|
||||
|
||||
The **LanguageFeatures** node is a bitmap representation of what Language Features are installed on a device:
|
||||
The **LanguageFeatures** node is a bitmap representation of what [Language Features](/windows-hardware/manufacture/desktop/features-on-demand-language-fod?view=windows-11&preserve-view=true) are installed for a language on a device:
|
||||
|
||||
- Basic Typing = 0x1
|
||||
- Fonts = 0x2
|
||||
@ -40,22 +40,26 @@ The Language Pack Management CSP allows a direct way to provision language packs
|
||||
- LocaleData = 0x40
|
||||
- SupplementFonts = 0x80
|
||||
|
||||
2. Install language pack and features with the EXECUTE command on the **StartInstallation** node of the language.
|
||||
2. Install language pack and features with the EXECUTE command on the **StartInstallation** node of the language. The language installation will try to install the best matched language packs and features for the provided language.
|
||||
|
||||
> [!NOTE]
|
||||
> If not previously set, installation will set the policy to block cleanup of unused language packs and features on the device to prevent unexpected deletion.
|
||||
|
||||
- Admins can optionally set the language as the System Preferred UI Language immediately after installation by using the REPLACE command on the "CopyToDeviceInternationalSettings" node of the language. 0 (default) will take no action; 1 will set the following international settings to reflect the newly installed language:
|
||||
- Admins can optionally copy the language to the device’s international settings immediately after installation by using the REPLACE command on the "CopyToDeviceInternationalSettings" node of the language. false (default)- will take no action; true- will set the following international settings to reflect the newly installed language:
|
||||
- System Preferred UI Language
|
||||
- System Locale
|
||||
- Default settings for new users, such as Input Method (keyboard), Locale, Speech Recognizer, User Preferred Language List
|
||||
- Admins can optionally configure whether they want to install all available language features during installation using the REPLACE command on the "EnableLanguageFeatureInstallations" node of the language. 0 will install only required features; 1 (default) will install all available features.
|
||||
- Default settings for new users
|
||||
- Input Method (keyboard)
|
||||
- Locale
|
||||
- Speech Recognizer
|
||||
- User Preferred Language List
|
||||
- Admins can optionally configure whether they want to install all available language features during installation using the REPLACE command on the "EnableLanguageFeatureInstallations" node of the language. false- will install only required features; true (default)- will install all available features.
|
||||
|
||||
Here are the sample commands to install French language with required features and copy to the devices international settings:
|
||||
Here are the sample commands to install French language with required features and copy to the device's international settings:
|
||||
|
||||
1. **ADD ./Device/Vendor/MSFT/LanguagePackManagement/Install/fr-FR/**
|
||||
2. **REPLACE ./Device/Vendor/MSFT/LanguagePackManagement/Install/fr-FR/CopyToDeviceInternationalSettings(1)**
|
||||
3. **REPLACE ./Device/Vendor/MSFT/LanguagePackManagement/Install/fr-FR/EnableLanguageFeatureInstallations (0)**
|
||||
2. **REPLACE ./Device/Vendor/MSFT/LanguagePackManagement/Install/fr-FR/CopyToDeviceInternationalSettings (true)**
|
||||
3. **REPLACE ./Device/Vendor/MSFT/LanguagePackManagement/Install/fr-FR/EnableLanguageFeatureInstallations (false)**
|
||||
4. **EXECUTE ./Device/Vendor/MSFT/LanguagePackManagement/Install/fr-FR/StartInstallation**
|
||||
|
||||
The installation is an asynchronous operation. You can query the **Status** or **ErrorCode** nodes by using the following commands:
|
||||
@ -63,7 +67,9 @@ The Language Pack Management CSP allows a direct way to provision language packs
|
||||
**GET./Device/Vendor/MSFT/LanguagePackManagement/Install/fr-FR/Status**
|
||||
**GET./Device/Vendor/MSFT/LanguagePackManagement/Install/fr-FR/ErrorCode**
|
||||
|
||||
Status: 0 – not started; 1 – in process; 2 – succeeded; 3 – failed; 4 - partial success (A partial success indicates features may have gotten installed but there was an error installing the language pack or vice versa). ErrorCode is an HRESULT that could help diagnosis if the installation failed.
|
||||
Status: 0 – not started; 1 – in progress; 2 – succeeded; 3 – failed; 4 - partial success (A partial success indicates not all the provisioning operations succeeded, for example, there was an error installing the language pack or features).
|
||||
|
||||
ErrorCode: An HRESULT that could help diagnosis if the installation failed or partially failed.
|
||||
|
||||
3. Delete installed Language with the DELETE command on the installed language tag. The delete command is a fire and forget operation. The deletion will run in background. IT admin can query the installed language later and resend the command if needed. Below is a sample command to delete the zh-CN language.
|
||||
|
||||
|
Reference in New Issue
Block a user