WindowsLicensing CSP

아티클
08/08/2024

Windows 참가자의 로고입니다.

중요

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

WindowsLicensing 구성 서비스 공급자는 라이선스 관련 관리 시나리오용으로 설계되었습니다.

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

./Vendor/MSFT/WindowsLicensing

ChangeProductKey

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1703 [10.0.15063] 이상

./Vendor/MSFT/WindowsLicensing/ChangeProductKey

Windows 10 데스크톱 디바이스용 제품 키를 설치합니다. 다시 부팅하지 않습니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	`chr` (문자열)
액세스 유형	Exec

CheckApplicability

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1511 [10.0.10586] 이상

./Vendor/MSFT/WindowsLicensing/CheckApplicability

입력한 제품 키를 Windows 10 데스크톱 디바이스의 버전 업그레이드에 사용할 수 있으면 TRUE를 반환합니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	`chr` (문자열)
액세스 유형	Exec

예:

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Exec>
    <CmdID>$CmdID$</CmdID>
    <Item>
      <Target>
        <LocURI>./Device/Vendor/MSFT/WindowsLicensing/CheckApplicability</LocURI>
      </Target>
      <Meta>
        <Format xmlns="syncml:metinf">chr</Format>
      </Meta>
      <Data>XXXXX-XXXXX-XXXXX-XXXXX-XXXXX</Data>
    </Item>
   </Exec>
   <Final/>
  </SyncBody>
</SyncML>

참고

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX 에서 데이터 태그를 제품 키로 바꿔야 합니다.

DeviceLicensingService

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 11 버전 21H2 및 KB5018483 [10.0.22000.1165] 이상 ✅ Windows 11 버전 22H2 [10.0.22621] 이상

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService

디바이스 기반 구독.

설명 프레임워크 속성:

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

DeviceLicensingService/DeviceLicensingLastError

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 11 버전 21H2 및 KB5018483 [10.0.22000.1165] 이상 ✅ Windows 11 버전 22H2 [10.0.22621] 이상

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingLastError

디바이스 라이선스 새로 고침/제거 작업의 마지막 오류 코드를 반환합니다. 오류가 없으면 값이 비어 있습니다(0).

설명 프레임워크 속성:

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

DeviceLicensingService/DeviceLicensingLastErrorDescription

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 11 버전 21H2 및 KB5018483 [10.0.22000.1165] 이상 ✅ Windows 11 버전 22H2 [10.0.22621] 이상

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingLastErrorDescription

디바이스 라이선스에서 마지막 오류 설명을 반환합니다. 오류 위반을 평가할 수 없는 경우 값은 비어 있습니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	`chr` (문자열)
액세스 유형	가져오기

DeviceLicensingService/DeviceLicensingStatus

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 11 버전 21H2 및 KB5018483 [10.0.22000.1165] 이상 ✅ Windows 11 버전 22H2 [10.0.22621] 이상

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingStatus

디바이스 라이선스 새로 고침/제거 작업의 상태를 반환합니다.

설명 프레임워크 속성:

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

DeviceLicensingService/LicenseType

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 11 버전 21H2 및 KB5018483 [10.0.22000.1165] 이상 ✅ Windows 11 버전 22H2 [10.0.22621] 이상

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/LicenseType

라이선스 유형: 사용자 기반 구독 또는 디바이스 기반 구독.

설명 프레임워크 속성:

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

허용되는 값:

값	설명
0	사용자 기반 구독.
1	디바이스 기반 구독.

버전

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1511 [10.0.10586] 이상

./Vendor/MSFT/WindowsLicensing/Edition

데스크톱 또는 모바일 디바이스에서 실행되는 Windows 10 버전에 매핑되는 값을 반환합니다. 값을 가져와서 해당 16진수로 변환하고 MSDN의 GetProductInfo 함수 페이지에서 버전 정보를 검색합니다.

설명 프레임워크 속성:

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

예:

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Get>
      <CmdID>$CmdID$</CmdID>
        <Item>
          <Target>
            <LocURI>./Device/Vendor/MSFT/WindowsLicensing/Edition</LocURI>
          </Target>
        </Item>
    </Get>
    <Final/>
  </SyncBody>
</SyncML>

LicenseKeyType

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1511 [10.0.10586] 이상

./Vendor/MSFT/WindowsLicensing/LicenseKeyType

버전 업그레이드를 위해 Windows 10 디바이스에서 사용하는 매개 변수 형식을 반환합니다. Windows 10 데스크톱 디바이스에는 버전 업그레이드를 위한 제품 키가 필요합니다. Windows 10 모바일 디바이스에는 버전 업그레이드를 위한 라이선스가 필요합니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	`chr` (문자열)
액세스 유형	가져오기

예:

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Get>
      <CmdID>$CmdID$</CmdID>
        <Item>
          <Target>
            <LocURI>./Device/Vendor/MSFT/WindowsLicensing/LicenseKeyType</LocURI>
          </Target>
        </Item>
    </Get>
    <Final/>
  </SyncBody>
</SyncML>

SMode

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1809 [10.0.17763] 이상

./Vendor/MSFT/WindowsLicensing/SMode

S 모드를 관리하기 위한 내부 노드입니다.

설명 프레임워크 속성:

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

SMode/Status

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1809 [10.0.17763] 이상

./Vendor/MSFT/WindowsLicensing/SMode/Status

최신 SwitchFromSMode 또는 SwitchingPolicy 집합 요청의 상태를 반환합니다.

가능한 값:

오류 코드 404로 인해 요청이 실패합니다. SwitchFromSMode 요청이 수행되지 않았습니다.
0: 디바이스가 S 모드에서 성공적으로 전환되었습니다.
1: 디바이스가 S 모드에서 전환 요청을 처리하고 있습니다.
3: 디바이스가 이미 S 모드에서 전환되었습니다.
4: 디바이스가 S 모드에서 전환하지 못했습니다.

설명 프레임워크 속성:

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

예:

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Get>
      <CmdID>6</CmdID>
      <Item>
        <Target>
          <LocURI>
            ./Vendor/MSFT/WindowsLicensing/SMode/Status
          </LocURI>
        </Target>
      </Item>
    </Get>
    <Final/>
  </SyncBody>
</SyncML>

SMode/SwitchFromSMode

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1809 [10.0.17763] 이상

./Vendor/MSFT/WindowsLicensing/SMode/SwitchFromSMode

가능하면 디바이스를 S 모드에서 전환합니다. 다시 부팅하지 않습니다.

설명 프레임워크 속성:

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

예:

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Exec>
      <CmdID>5</CmdID>
      <Item>
        <Target>
          <LocURI>
            ./Vendor/MSFT/WindowsLicensing/SMode/SwitchFromSMode
          </LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">null</Format>
          <Type>text/plain</Type>
        </Meta>
        <Data></Data>
      </Item>
    </Exec>
    <Final/>
  </SyncBody>
</SyncML>

SMode/SwitchingPolicy

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1809 [10.0.17763] 이상

./Vendor/MSFT/WindowsLicensing/SMode/SwitchingPolicy

소비자가 디바이스를 S 모드에서 전환할 수 있는지 여부를 결정하는 정책입니다.

이 설정은 S 모드에서 사용할 수 있는 디바이스에만 적용됩니다.

설명 프레임워크 속성:

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

허용되는 값:

값	설명
0	제한 없음: 사용자가 디바이스를 S 모드에서 전환할 수 있습니다.
1	사용자 차단: 관리자가 사용자가 S 모드에서 디바이스를 전환하지 못하도록 차단했습니다. 관리자만 SMode/SwitchFromSMode 노드를 통해 디바이스를 S 모드에서 전환할 수 있습니다.

예:

S 모드 SwitchingPolicy 추가

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Add>
      <CmdID>4</CmdID>
      <Item>
        <Target>
          <LocURI>
            ./Vendor/MSFT/WindowsLicensing/SMode/SwitchingPolicy
          </LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">int</Format>
          <Type>text/plain</Type>
        </Meta>
        <Data>1</Data>
      </Item>
    </Add>
    <Final/>
  </SyncBody>
</SyncML>

S 모드 전환 정책 가져오기

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Get>
      <CmdID>2</CmdID>
      <Item>
        <Target>
          <LocURI>
            ./Vendor/MSFT/WindowsLicensing/SMode/SwitchingPolicy
          </LocURI>
        </Target>
      </Item>
    </Get>
    <Final/>
  </SyncBody>
</SyncML>

S 모드 SwitchingPolicy 바꾸기

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Replace>
      <CmdID>1</CmdID>
      <Item>
        <Target>
          <LocURI>
            ./Vendor/MSFT/WindowsLicensing/SMode/SwitchingPolicy
          </LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">int</Format>
          <Type>text/plain</Type>
        </Meta>
        <Data>1</Data>
      </Item>
    </Replace>
    <Final/>
  </SyncBody>
</SyncML>

S 모드 SwitchingPolicy 삭제

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Delete>
      <CmdID>3</CmdID>
      <Item>
        <Target>
          <LocURI>
            ./Vendor/MSFT/WindowsLicensing/SMode/SwitchingPolicy
          </LocURI>
        </Target>
      </Item>
    </Delete>
    <Final/>
  </SyncBody>
</SyncML>

상태

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1511 [10.0.10586] 이상

./Vendor/MSFT/WindowsLicensing/Status

Windows 10 데스크톱 및 모바일 디바이스에서 버전 업그레이드의 상태를 반환합니다. 상태: 0 = 실패, 1 = 보류 중, 2 = 진행 중, 3 = 완료됨, 4 = 알 수 없음.

설명 프레임워크 속성:

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

예:

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Get>
      <CmdID>$CmdID$</CmdID>
        <Item>
          <Target>
            <LocURI>./Device/Vendor/MSFT/WindowsLicensing/Status</LocURI>
          </Target>
        </Item>
    </Get>
    <Final/>
  </SyncBody>
</SyncML>

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1607 [10.0.14393] 이상

./Vendor/MSFT/WindowsLicensing/Subscriptions

구독에 대한 노드입니다.

설명 프레임워크 속성:

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

구독/{SubscriptionId}

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1607 [10.0.14393] 이상

./Vendor/MSFT/WindowsLicensing/Subscriptions/{SubscriptionId}

구독 ID의 노드입니다.

설명 프레임워크 속성:

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

구독/{SubscriptionId}/Name

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1607 [10.0.14393] 이상

./Vendor/MSFT/WindowsLicensing/Subscriptions/{SubscriptionId}/Name

구독의 이름을 반환합니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	`chr` (문자열)
액세스 유형	가져오기

구독/{SubscriptionId}/Status

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1607 [10.0.14393] 이상

./Vendor/MSFT/WindowsLicensing/Subscriptions/{SubscriptionId}/Status

구독의 상태를 반환합니다.

설명 프레임워크 속성:

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

구독/DisableSubscription

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 참가자 미리 보기

./Vendor/MSFT/WindowsLicensing/Subscriptions/DisableSubscription

디바이스에서 구독 활성화를 사용하지 않도록 설정하거나 사용하도록 설정합니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	`int`
액세스 유형	바꾸기

허용되는 값:

값	설명
0	구독을 사용하도록 설정합니다.
1	구독을 사용하지 않도록 설정합니다. 또한 디바이스의 기존 구독도 제거합니다.

구독/RemoveSubscription

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 참가자 미리 보기

./Vendor/MSFT/WindowsLicensing/Subscriptions/RemoveSubscription

구독 제거 구독 라이선스를 제거합니다. 또한 구독 유형을 사용자 기반 구독으로 다시 설정합니다.

설명 프레임워크 속성:

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

Subscriptions/SubscriptionLastError

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 참가자 미리 보기

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionLastError

마지막 구독 작업의 오류 코드입니다. 오류가 없으면 값이 비어 있습니다(0).

설명 프레임워크 속성:

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

Subscriptions/SubscriptionLastErrorDescription

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 참가자 미리 보기

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionLastErrorDescription

마지막 구독 작업에 대한 오류 설명입니다. 오류 설명을 평가할 수 없는 경우 값은 비어 있습니다.

설명 프레임워크 속성:

속성 이름	속성 값
형식	`chr` (문자열)
액세스 유형	가져오기

Subscriptions/SubscriptionStatus

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 참가자 미리 보기

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionStatus

마지막 구독 작업의 상태입니다.

설명 프레임워크 속성:

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

Subscriptions/SubscriptionType

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 참가자 미리 보기

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionType

디바이스 기반 구독 또는 사용자 기반 구독으로 디바이스를 설정합니다. 디바이스 기반 구독의 경우 이 작업은 디바이스에서 구독을 자동으로 획득합니다. 사용자 기반 구독의 경우 기존 사용자 로그온 프로세스가 필요합니다.

설명 프레임워크 속성:

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

허용되는 값:

값	설명
0	사용자 기반 구독.
1	디바이스 기반 구독.

UpgradeEditionWithLicense

참고

이 정책은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 수 있습니다.

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1511 [10.0.10586] 이상

./Vendor/MSFT/WindowsLicensing/UpgradeEditionWithLicense

Windows 10 모바일 디바이스의 버전 업그레이드에 대한 라이선스를 제공합니다. 다시 부팅할 필요가 없습니다.

설명 프레임워크 속성:

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

UpgradeEditionWithProductKey

범위	에디션	적용 가능한 OS
✅ 장치 ❌ 사용자	✅ 프로 ✅ Enterprise ✅ Education ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10 버전 1511 [10.0.10586] 이상

./Vendor/MSFT/WindowsLicensing/UpgradeEditionWithProductKey

Windows 10 데스크톱 디바이스의 버전 업그레이드를 위한 제품 키를 입력합니다. 다시 부팅해야 합니다.

제품 키가 MDM 서버에서 사용자의 디바이스 changepk.exe 로 푸시되면 제품 키를 사용하여 를 실행합니다. 완료되면 사용자에게 새 버전의 Windows를 사용할 수 있다는 알림이 표시됩니다. 그러면 사용자가 수동으로 또는 2시간 후에 시스템을 다시 시작할 수 있으며, 디바이스가 자동으로 다시 시작하여 업그레이드를 완료합니다. 사용자는 자동 다시 시작 10분 전에 미리 알림 알림을 받게 됩니다.

디바이스가 다시 시작한 후 버전 업그레이드 프로세스가 완료됩니다. 사용자는 성공적인 업그레이드에 대한 알림을 받게 됩니다.

참고

다른 정책이 실행 중일 때 changepk.exe 발생하는 시스템 재부팅이 필요한 경우 버전 업그레이드가 실패합니다.

프로비저닝 패키지에서 제품 키를 입력하고 사용자가 패키지 설치를 시작하면 패키지 설치를 완료하기 위해 시스템을 다시 시작해야 한다는 알림이 표시됩니다. 계속 진행하기 위해 사용자의 명시적 동의가 있으면 패키지는 설치 changepk.exe 를 계속하고 제품 키를 사용하여 실행됩니다. 사용자는 자동으로 다시 시작하기 30초 전에 미리 알림을 받게 됩니다.

디바이스가 다시 시작한 후 버전 업그레이드 프로세스가 완료됩니다. 사용자는 성공적인 업그레이드에 대한 알림을 받게 됩니다.

이 노드를 사용하여 제품 키를 입력하여 특정 버전의 Windows 10 데스크톱 디바이스에서 제품 키를 활성화하거나 변경할 수도 있습니다. 제품 키를 활성화하거나 변경해도 다시 부팅할 필요가 없으며 사용자에 대한 자동 프로세스입니다.

중요

입력한 제품 키는 29자여야 합니다(즉, 대시를 포함해야 함). 그렇지 않으면 Windows 10 데스크톱 디바이스에서 정품 인증, 버전 업그레이드 또는 제품 키 변경이 실패합니다. 제품 키는 Microsoft 볼륨 라이선싱 서비스 센터에서 가져옵니다. 포털에 액세스하려면 조직에 Microsoft와 볼륨 라이선싱 계약이 있어야 합니다.

MDM을 통해 이 노드를 사용할 때 유효한 버전 업그레이드 경로는 다음과 같습니다.

Windows 10/11 Enterprise에서 Windows 10/11 Education으로
Windows 10/11 Home to Windows 10/11 Education
Windows 10/11 Pro에서 Windows 10/11 Education으로
Windows 10/11 Pro에서 Windows 10/11 Enterprise로

제품 키 정품 인증 또는 변경은 다음 버전에서 수행할 수 있습니다.

Windows 10/11 Education
Windows 10/11 Enterprise
Windows 10/11 Home
Windows 10/11 Pro

설명 프레임워크 속성:

속성 이름	속성 값
형식	`chr` (문자열)
액세스 유형	Exec
다시 부팅 동작	자동

예:

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Exec>
    <CmdID>$CmdID$</CmdID>
    <Item>
      <Target>
        <LocURI>./Device/Vendor/MSFT/WindowsLicensing/UpgradeEditionWithProductKey</LocURI>
      </Target>
      <Meta>
        <Format xmlns="syncml:metinf">chr</Format>
      </Meta>
      <Data>XXXXX-XXXXX-XXXXX-XXXXX-XXXXX</Data>
    </Item>
   </Exec>
   <Final/>
  </SyncBody>
</SyncML>

참고

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX 에서 데이터 태그를 제품 키로 바꿔야 합니다.

구성 서비스 공급자 참조

다음을 통해 공유

WindowsLicensing CSP

ChangeProductKey

CheckApplicability

DeviceLicensingService

DeviceLicensingService/DeviceLicensingLastError

DeviceLicensingService/DeviceLicensingLastErrorDescription

DeviceLicensingService/DeviceLicensingStatus

DeviceLicensingService/LicenseType

버전

LicenseKeyType

SMode

SMode/Status

SMode/SwitchFromSMode

SMode/SwitchingPolicy

상태

구독

구독/{SubscriptionId}

구독/{SubscriptionId}/Name

구독/{SubscriptionId}/Status

구독/DisableSubscription

구독/RemoveSubscription

Subscriptions/SubscriptionLastError

Subscriptions/SubscriptionLastErrorDescription

Subscriptions/SubscriptionStatus

Subscriptions/SubscriptionType

UpgradeEditionWithLicense

UpgradeEditionWithProductKey

피드백

추가 리소스

다음을 통해 공유

WindowsLicensing CSP

ChangeProductKey

CheckApplicability

DeviceLicensingService

DeviceLicensingService/DeviceLicensingLastError

DeviceLicensingService/DeviceLicensingLastErrorDescription

DeviceLicensingService/DeviceLicensingStatus

DeviceLicensingService/LicenseType

버전

LicenseKeyType

SMode

SMode/Status

SMode/SwitchFromSMode

SMode/SwitchingPolicy

상태

구독

구독/{SubscriptionId}

구독/{SubscriptionId}/Name

구독/{SubscriptionId}/Status

구독/DisableSubscription

구독/RemoveSubscription

Subscriptions/SubscriptionLastError

Subscriptions/SubscriptionLastErrorDescription

Subscriptions/SubscriptionStatus

Subscriptions/SubscriptionType

UpgradeEditionWithLicense

UpgradeEditionWithProductKey

관련 문서

피드백

추가 리소스