LanguagePackManagement CSP

Windows 測試人員的標誌。

重要

此 CSP 包含一些正在開發且僅適用于 Windows Insider Preview 組建 的設定。 這些設定可能會變更,而且可能相依于預覽中的其他功能或服務。

語言套件管理 CSP 可讓您輕鬆地新增語言和相關語言功能,以及管理系統慣用 UI 語言、系統地區設定、輸入方法 (鍵盤) 、地區設定、語音辨識器、使用者慣用語言清單等設定。 您可以使用新的 LanguagePackManagement PowerShell 模組來存取此 CSP。

下列清單顯示 LanguagePackManagement 設定服務提供者節點:

安裝

領域 版本 適用的作業系統
✅ 裝置
❌ 使用者
✅ 專業版
✅ 企業版
✅ 教育版
✅ Windows SE
✅ IoT 企業版 / IoT 企業版 LTSC
✅Windows Insider Preview [99.9.9999]
./Device/Vendor/MSFT/LanguagePackManagement/Install

要安裝或安裝的語言。

描述架構屬性:

屬性名稱 屬性值
格式 node
存取類型 [取得]

安裝/{語言標識符}

領域 版本 適用的作業系統
✅ 裝置
❌ 使用者
✅ 專業版
✅ 企業版
✅ 教育版
✅ 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

將語言複製到國際設定 (,也就是,如果值為 true,則為裝置的區域設置、輸入配置、語音辨識器、裝置的慣用 UI 語言) 。 默認值為 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

安裝/{語言標識符}/狀態

領域 版本 適用的作業系統
✅ 裝置
❌ 使用者
✅ 專業版
✅ 企業版
✅ 教育版
✅ 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
存取類型 Delete、Get
動態節點命名 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
    • 字型 = 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

    安裝是異步操作。 您可以使用下列命令來查詢 StatusErrorCode 節點:

    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 命令刪除已安裝的 Language。 delete 命令是「引發並忘記」作業。 刪除作業會在背景執行。 IT 系統管理員稍後可以查詢已安裝的語言,並視需要重新傳送命令。 以下是刪除 zh-CN 語言的範例命令。

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

    注意

    刪除將會忽略封鎖清除未使用語言套件的原則。

  4. 在 「SystemPreferredUILanguages」 節點上使用 GET 或 REPLACE 命令取得/設定系統慣用 UI 語言

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

設定服務提供者參考