LanguagePackManagement CSP

重要提示

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

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

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

• ./Device/Vendor/MSFT/LanguagePackManagement
  • 安装
    • {Language ID}
      • CopyToDeviceInternationalSettings
      • EnableLanguageFeatureInstallations
      • ErrorCode
      • StartInstallation
      • 状态
  • InstalledLanguages
    • {Language ID}
      • LanguageFeatures
      • 供应商
  • LanguageSettings
    • SystemPreferredUILanguages

安装

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

./Device/Vendor/MSFT/LanguagePackManagement/Install

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

描述框架属性:

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

安装/{语言 ID}

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

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

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

描述框架属性:

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

Install/{Language ID}/CopyToDeviceInternationalSettings

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

./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 [99.9.9999]

./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 [99.9.9999]

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

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

描述框架属性:

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

Install/{Language ID}/StartInstallation

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

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

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

描述框架属性:

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

安装/{Language ID}/Status

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

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

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

描述框架属性:

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

InstalledLanguages

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

./Device/Vendor/MSFT/LanguagePackManagement/InstalledLanguages

设备上当前安装的语言。

描述框架属性:

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

InstalledLanguages/{Language ID}

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

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

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

描述框架属性:

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

InstalledLanguages/{Language ID}/LanguageFeatures

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

./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 [99.9.9999]

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

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

描述框架属性:

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

LanguageSettings

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

./Device/Vendor/MSFT/LanguagePackManagement/LanguageSettings

设备的语言设置。

描述框架属性:

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

LanguageSettings/SystemPreferredUILanguages

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

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

设备的系统首选 UI 语言。

描述框架属性:

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

示例

1. 在“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

2. 在语言的 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，可帮助诊断安装是否失败或部分失败。

3. 使用已安装语言标记上的 DELETE 命令删除已安装的语言。 delete 命令是一个触发和忘记操作。 删除将在后台运行。 IT 管理员可以稍后查询安装的语言，并根据需要重新发送命令。 下面是删除 zh-CN 语言的示例命令。

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

   注意

   删除将忽略未使用语言包的块清理策略。

4. 在“SystemPreferredUILanguages”节点上使用 GET 或 REPLACE 命令获取/设置系统首选 UI 语言

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

相关文章

配置服务提供程序参考