LanguagePackManagement CSP

중요

이 CSP에는 개발 중인 일부 설정이 포함되어 있으며 Windows Insider Preview 빌드에만 적용됩니다. 이러한 설정은 변경될 수 있으며 미리 보기의 다른 기능 또는 서비스에 대한 종속성이 있을 수 있습니다.

언어 팩 관리 CSP를 사용하면 쉽게 언어 및 관련 언어 기능을 추가하고 시스템 기본 설정 UI 언어, 시스템 로캘, 입력 방법(키보드), 로캘, 음성 인식기, 사용자 기본 설정 언어 목록과 같은 설정을 관리할 수 있습니다. 이 CSP는 새 LanguagePackManagement PowerShell 모듈을 사용하여 액세스할 수 있습니다.

다음 목록에서는 LanguagePackManagement 구성 서비스 공급자 노드를 보여 줍니다.

• ./Device/Vendor/MSFT/LanguagePackManagement
  • 설치
    • {언어 ID}
      • CopyToDeviceInternationalSettings
      • EnableLanguageFeatureInstallations
      • Errorcode
      • StartInstallation
      • 상태
  • InstalledLanguages
    • {언어 ID}
      • LanguageFeatures
      • 공급자
  • LanguageSettings
    • SystemPreferredUILanguages

설치

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/Install

설치하거나 설치할 언어입니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	node
액세스 유형	가져오기

설치/{언어 ID}

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

설치하거나 설치할 언어의 언어 태그입니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	node
액세스 유형	추가, 삭제, 가져오기
동적 노드 명명	UniqueName: 설치하거나 설치할 언어의 언어 태그입니다.

Install/{Language ID}/CopyToDeviceInternationalSettings

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

값이 true인 경우 설치 직후 디바이스의 국가별 설정(즉, 로캘, 입력 레이아웃, 음성 인식기, 기본 UI 언어)에 언어를 복사합니다. 기본값은 false입니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	bool
액세스 유형	추가, 삭제, 가져오기, 바꾸기
기본 값	false

허용되는 값:

값	설명
false(기본값)	설치 직후 국가별 설정에 언어를 복사하지 마세요.
true	설치 직후 국가별 설정에 언어를 복사합니다.

Install/{Language ID}/EnableLanguageFeatureInstallations

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

값이 true이면 사용 가능한 모든 언어 기능을 설치할 수 있습니다. 기본값은 true입니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	bool
액세스 유형	추가, 삭제, 가져오기, 바꾸기
기본 값	true

허용되는 값:

값	설명
true(기본값)	사용 가능한 모든 언어 기능을 설치합니다.
false	필요한 언어 기능만 설치합니다.

설치/{언어 ID}/ErrorCode

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

큐에 대기된 언어 설치의 오류 코드입니다. 오류가 없으면 0입니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	int
액세스 유형	가져오기

설치/{언어 ID}/StartInstallation

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

디바이스에 설치할 언어를 큐에 대기하는 실행 노드입니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	null
액세스 유형	Exec

설치/{언어 ID}/상태

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

설치 대기 중 언어의 상태입니다. 0 - 시작되지 않음; 1 - 진행 중; 2 - 성공; 3 - 실패; 4 - 부분적으로 성공했습니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	int
액세스 유형	가져오기

InstalledLanguages

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/InstalledLanguages

현재 디바이스에 설치된 언어입니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	node
액세스 유형	가져오기

InstalledLanguages/{Language ID}

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

디바이스에 설치된 언어의 언어 태그입니다. 삭제하여 제거합니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	node
액세스 유형	삭제, 가져오기
동적 노드 명명	ClientInventory

InstalledLanguages/{Language ID}/LanguageFeatures

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise 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

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

언어를 설치하는 방법에 대한 숫자 표현입니다. 1 - 시스템 언어 팩이 설치됩니다. 2 - 로컬 환경 팩이 설치됩니다. 3 - 둘 다 설치됩니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	int
액세스 유형	가져오기

LanguageSettings

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/LanguagePackManagement/LanguageSettings

디바이스의 언어 설정입니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	node
액세스 유형	가져오기

LanguageSettings/SystemPreferredUILanguages

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

./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/InstalledLanguage 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
   • Speech = 0x8
   • TextToSpeech = 0x10
   • OCR = 0x20
   • LocaleData = 0x40
   • SupplementFonts = 0x80

2. 언어의 StartInstallation 노드에 EXECUTE 명령을 사용하여 언어 팩 및 기능을 설치합니다. 언어 설치는 제공된 언어에 가장 적합한 언어 팩 및 기능을 설치하려고 합니다.

   참고

   이전에 설정하지 않은 경우 설치는 예기치 않은 삭제를 방지하기 위해 디바이스에서 사용되지 않는 언어 팩 및 기능의 정리를 차단하는 정책을 설정합니다.

   • 관리자는 선택적으로 언어의 "CopyToDeviceInternationalSettings" 노드에서 REPLACE 명령을 사용하여 설치 직후 디바이스의 국가별 설정에 언어를 복사할 수 있습니다. false(기본값)- 아무 작업도 수행하지 않습니다. true- 새로 설치된 언어를 반영하도록 다음 국제 설정을 설정합니다.
     • 시스템 기본 설정 UI 언어
     • 시스템 로캘
     • 새 사용자에 대한 기본 설정
       • Input 메서드(키보드)
       • 로캘
       • Speech Recognizer
       • 사용자 기본 설정 언어 목록
   • 관리자는 언어의 "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

   설치는 비동기 작업입니다. 다음 명령을 사용하여 상태 또는 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 명령은 fire and forget 작업입니다. 삭제는 백그라운드에서 실행됩니다. IT 관리자는 나중에 설치된 언어를 쿼리하고 필요한 경우 명령을 다시 추가할 수 있습니다. 다음은 zh-CN 언어를 삭제하는 샘플 명령입니다.

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

   참고

   삭제는 사용되지 않는 언어 팩의 차단 정리 정책을 무시합니다.

4. "SystemPreferredUILanguages" 노드에서 GET 또는 REPLACE 명령을 사용하여 시스템 기본 설정 UI 언어 가져오기/설정

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

관련 문서

구성 서비스 공급자 참조