LanguagePackManagement CSP

项目
08/01/2024

Windows 预览体验成员的徽标。

重要提示

此云解决方案提供商包含一些正在开发中的设置，仅适用于 Windows Insider Preview 版本。这些设置可能会发生更改，并且可能依赖于预览版中的其他功能或服务。

语言包管理 CSP 允许轻松添加语言和相关语言功能并管理系统首选 UI 语言、系统区域设置、输入法 (键盘) 、区域设置、语音识别器、用户首选语言列表等设置。可以使用新的 LanguagePackManagement PowerShell 模块访问此 CSP。

以下列表显示了 LanguagePackManagement 配置服务提供程序节点：

./Device/Vendor/MSFT/LanguagePackManagement

安装

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/Install

要安装或正在安装的语言。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	“获取”

安装/{语言 ID}

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/Install/{Language ID}

要安装或正在安装的语言的语言标记。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	添加、删除、获取
动态节点命名	UniqueName：要安装或正在安装的语言的语言标记。

Install/{Language ID}/CopyToDeviceInternationalSettings

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/Install/{Language ID}/CopyToDeviceInternationalSettings

将语言复制到国际设置 (，即安装后设备的区域设置、输入布局、语音识别器、首选 UI 语言) （如果值为 true）。默认值为 false。

描述框架属性:

属性名	属性值
格式	`bool`
访问类型	添加、删除、获取、替换
默认值	false

允许的值:

值	说明
false (默认)	请勿在安装后立即将语言复制到国际设置。
true	安装后，立即将语言复制到国际设置。

Install/{Language ID}/EnableLanguageFeatureInstallations

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/Install/{Language ID}/EnableLanguageFeatureInstallations

当值为 true 时，启用所有可用语言功能的安装。默认值为 true。

描述框架属性:

属性名	属性值
格式	`bool`
访问类型	添加、删除、获取、替换
默认值	true

允许的值:

值	说明
true (默认)	安装所有可用的语言功能。
false	仅安装所需的语言功能。

Install/{Language ID}/ErrorCode

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/Install/{Language ID}/ErrorCode

排队语言安装的错误代码。如果没有错误，则为 0。

描述框架属性:

属性名	属性值
格式	`int`
访问类型	“获取”

Install/{Language ID}/StartInstallation

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/Install/{Language ID}/StartInstallation

执行节点，用于将语言排队以便在设备上进行安装。

描述框架属性:

属性名	属性值
格式	`null`
访问类型	Exec

安装/{Language ID}/Status

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/Install/{Language ID}/Status

排队等待安装的语言的状态。 0 - 未启动;1 - 正在进行中;2 - 成功;3 - 失败;4 - 部分成功。

描述框架属性:

属性名	属性值
格式	`int`
访问类型	“获取”

InstalledLanguages

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/InstalledLanguages

设备上当前安装的语言。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	“获取”

InstalledLanguages/{Language ID}

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/InstalledLanguages/{Language ID}

设备上已安装语言的语言标记。要卸载的删除。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	删除、获取
动态节点命名	ClientInventory

InstalledLanguages/{Language ID}/LanguageFeatures

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/InstalledLanguages/{Language ID}/LanguageFeatures

所安装语言功能的数值表示形式。基本键入 - 1 (0x1) ，字体 - 2 (0x2) ，手写 - 4 (0x4) ，语音 - 8 (0x8) ，TextToSpeech - 16 (0x10) ，OCR - 32 (0x20) ，LocaleData - 64 (0x40) ，SupplementFonts - 128 (0x80) 。

描述框架属性:

属性名	属性值
格式	`int`
访问类型	“获取”

InstalledLanguages/{Language ID}/Providers

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/InstalledLanguages/{Language ID}/Providers

语言安装方式的数值表示形式。 1 - 已安装系统语言包;2 - 已安装本地体验包;3 - 两者都已安装。

描述框架属性:

属性名	属性值
格式	`int`
访问类型	“获取”

LanguageSettings

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/LanguageSettings

设备的语言设置。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	“获取”

LanguageSettings/SystemPreferredUILanguages

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/LanguageSettings/SystemPreferredUILanguages

设备的系统首选 UI 语言。

描述框架属性:

属性名	属性值
格式	`chr` (字符串)
访问类型	获取、替换

示例

在“InstalledLanguages”节点上使用 GET 命令枚举已安装的语言和功能。下面是示例：

GET./Device/Vendor/MSFT/LanguagePackManagement/InstalledLanguagesGET./Device/Vendor/MSFT/LanguagePackManagement/InstalledLanguages/zh-CN/ProvidersGET./Device/Vendor/MSFT/LanguagePackManagement/InstalledLanguages/zh-CN/LanguageFeaturesGET./Device/Vendor/MSFT/LanguagePackManagement/InstalledLanguages/ja-JP/ProvidersGET./Device/Vendor/MSFT/LanguagePackManagement/InstalledLanguages/ja-JP/LanguageFeatures

InstalledLanguages 下的节点是已安装语言的语言标记。语言标记下的 提供程序 节点是语言包或 LXP 的整数表示形式。
- 1- 指示仅安装语言包 cab。
- 2- 指示仅安装 LXP。
- 3- 指示两者都已安装。
LanguageFeatures 节点是设备上为语言安装的语言功能的位图表示形式：
- 基本键入 = 0x1
- Fonts = 0x2
- 手写 = 0x4
- 语音 = 0x8
- TextToSpeech = 0x10
- OCR = 0x20
- LocaleData = 0x40
- SupplementFonts = 0x80
在语言的 StartInstallation 节点上使用 EXECUTE 命令安装语言包和功能。语言安装将尝试为提供的语言安装最匹配的语言包和功能。

注意

如果之前未设置，安装将设置策略以阻止清理设备上未使用的语言包和功能，以防止意外删除。
- 管理员可以选择在安装后立即使用语言的“CopyToDeviceInternationalSettings”节点上的 REPLACE 命令将语言复制到设备的国际设置。 false (默认) - 将不采取任何操作;true- 将设置以下国际设置以反映新安装的语言：
  - 系统首选 UI 语言
  - 系统区域设置
  - 新用户的默认设置
    - 输入法 (键盘)
    - 区域设置
    - 语音识别器
    - 用户首选语言列表
- 管理员可以选择在安装期间使用语言的“EnableLanguageFeatureInstallations”节点上的 REPLACE 命令来配置是否要安装所有可用的语言功能。 false - 将仅安装所需的功能;true (默认) - 将安装所有可用功能。
下面是安装具有所需功能的法语并复制到设备国际设置的示例命令：
1. ADD ./Device/Vendor/MSFT/LanguagePackManagement/Install/fr-FR/
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
安装是一个异步操作。可以使用以下命令查询 Status 或 ErrorCode 节点：

GET./Device/Vendor/MSFT/LanguagePackManagement/Install/fr-FR/StatusGET./Device/Vendor/MSFT/LanguagePackManagement/Install/fr-FR/ErrorCode

状态：0 – 未启动;1 – 正在进行中;2 - 成功;3 – 失败;4 - 部分成功 (部分成功表示并非所有预配操作都成功，例如，安装语言包或) 功能时出错。 ErrorCode：一个 HRESULT，可帮助诊断安装是否失败或部分失败。
使用已安装语言标记上的 DELETE 命令删除已安装的语言。 delete 命令是一个触发和忘记操作。删除将在后台运行。 IT 管理员可以稍后查询安装的语言，并根据需要重新发送命令。下面是删除 zh-CN 语言的示例命令。

DELETE./Device/Vendor/MSFT/LanguagePackManagement/InstalledLanguages/zh-CN

注意

删除将忽略未使用语言包的块清理策略。
在“SystemPreferredUILanguages”节点上使用 GET 或 REPLACE 命令获取/设置系统首选 UI 语言

./Device/Vendor/MSFT/LanguagePackManagement/LanguageSettings/SystemPreferredUILanguages

配置服务提供程序参考

通过

LanguagePackManagement CSP

安装

安装/{语言 ID}

Install/{Language ID}/CopyToDeviceInternationalSettings

Install/{Language ID}/EnableLanguageFeatureInstallations

Install/{Language ID}/ErrorCode

Install/{Language ID}/StartInstallation

安装/{Language ID}/Status

InstalledLanguages

InstalledLanguages/{Language ID}

InstalledLanguages/{Language ID}/LanguageFeatures

InstalledLanguages/{Language ID}/Providers

LanguageSettings

LanguageSettings/SystemPreferredUILanguages

示例

反馈

其他资源

通过

LanguagePackManagement CSP

安装

安装/{语言 ID}

Install/{Language ID}/CopyToDeviceInternationalSettings

Install/{Language ID}/EnableLanguageFeatureInstallations

Install/{Language ID}/ErrorCode

Install/{Language ID}/StartInstallation

安装/{Language ID}/Status

InstalledLanguages

InstalledLanguages/{Language ID}

InstalledLanguages/{Language ID}/LanguageFeatures

InstalledLanguages/{Language ID}/Providers

LanguageSettings

LanguageSettings/SystemPreferredUILanguages

示例

相关文章

反馈

其他资源