WindowsLicensing CSP

Artículo
08/08/2024

Logotipo de Windows Insider.

Importante

Este CSP contiene algunas configuraciones que están en desarrollo y que solo se aplican a las compilaciones de Windows Insider Preview. Esta configuración está sujeta a cambios y puede tener dependencias en otras características o servicios en versión preliminar.

El proveedor de servicios de configuración de licencias de Windows está diseñado para escenarios de administración relacionados con las licencias.

En la lista siguiente se muestran los nodos del proveedor de servicios de configuración de licencias de Windows:

./Vendor/MSFT/WindowsLicensing

ChangeProductKey

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1703 [10.0.15063] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/ChangeProductKey

Instala una clave de producto para dispositivos de escritorio de Windows 10. No se reinicia.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`chr` (cadena)
Tipo de acceso	Exec

CheckApplicability

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1511 [10.0.10586] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/CheckApplicability

Devuelve TRUE si la clave de producto especificada se puede usar para una actualización de edición de dispositivos de escritorio de Windows 10.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`chr` (cadena)
Tipo de acceso	Exec

Ejemplo:

<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>

Nota

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX en la etiqueta Datos debe reemplazarse por la clave de producto.

DeviceLicensingService

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 11, versión 21H2 con KB5018483 [10.0.22000.1165] y versiones posteriores ✅ Windows 11, versión 22H2 [10.0.22621] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService

Suscripción basada en dispositivos.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Obtener

DeviceLicensingService/DeviceLicensingLastError

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 11, versión 21H2 con KB5018483 [10.0.22000.1165] y versiones posteriores ✅ Windows 11, versión 22H2 [10.0.22621] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingLastError

Devuelve el último código de error de la operación Actualizar o quitar licencia de dispositivo. El valor estaría vacío(0) en ausencia de error.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`int`
Tipo de acceso	Obtener

DeviceLicensingService/DeviceLicensingLastErrorDescription

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 11, versión 21H2 con KB5018483 [10.0.22000.1165] y versiones posteriores ✅ Windows 11, versión 22H2 [10.0.22621] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingLastErrorDescription

Devuelve la descripción del último error de Licencias de dispositivos. El valor estaría vacío, si no se puede evaluar la decripción de errores.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`chr` (cadena)
Tipo de acceso	Obtener

DeviceLicensingService/DeviceLicensingStatus

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 11, versión 21H2 con KB5018483 [10.0.22000.1165] y versiones posteriores ✅ Windows 11, versión 22H2 [10.0.22621] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingStatus

Devuelve el estado de la operación Actualizar o quitar licencia de dispositivo.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`int`
Tipo de acceso	Obtener

DeviceLicensingService/LicenseType

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 11, versión 21H2 con KB5018483 [10.0.22000.1165] y versiones posteriores ✅ Windows 11, versión 22H2 [10.0.22621] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/LicenseType

Tipo de licencia: suscripción basada en usuario o suscripción basada en dispositivos.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`int`
Tipo de acceso	Obtener, reemplazar

Valores permitidos:

Valor	Descripción
0	Suscripción basada en usuario.
1	Suscripción basada en dispositivos.

Edición

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1511 [10.0.10586] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/Edition

Devuelve un valor que se asigna a la edición de Windows 10 que se ejecuta en dispositivos móviles o de escritorio. Tome el valor, conviértalo en su equivalente hexadecimal y busque información de edición en la página de la función GetProductInfo en MSDN.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`int`
Tipo de acceso	Obtener

Ejemplo:

<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

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1511 [10.0.10586] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/LicenseKeyType

Devuelve el tipo de parámetro usado por los dispositivos Windows 10 para una actualización de edición. Los dispositivos de escritorio de Windows 10 requieren una clave de producto para una actualización de edición. Los dispositivos móviles windows 10 requieren una licencia para una actualización de edición.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`chr` (cadena)
Tipo de acceso	Obtener

Ejemplo:

<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

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1809 [10.0.17763] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/SMode

Nodo interior para administrar el modo S.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Obtener

SMode/Status

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1809 [10.0.17763] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/SMode/Status

Devuelve el estado de la solicitud de conjunto SwitchFromSMode o SwitchingPolicy más reciente.

Valores posibles:

Se produce un error en la solicitud con el código de error 404: no se ha realizado ninguna solicitud SwitchFromSMode.
0: El dispositivo se ha desactivado correctamente del modo S.
1: El dispositivo está procesando la solicitud para salir del modo S.
3: El dispositivo ya se ha desconectado del modo S.
4: El dispositivo no pudo salir del modo S.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`int`
Tipo de acceso	Obtener

Ejemplo:

<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

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1809 [10.0.17763] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/SMode/SwitchFromSMode

Desactiva un dispositivo del modo S si es posible. No se reinicia.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`null`
Tipo de acceso	Exec

Ejemplo:

<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

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1809 [10.0.17763] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/SMode/SwitchingPolicy

Directiva que determina si un consumidor puede cambiar el dispositivo fuera del modo S.

Esta configuración solo se aplica a los dispositivos disponibles en modo S.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`int`
Tipo de acceso	Agregar, Eliminar, Obtener, Reemplazar

Valores permitidos:

Valor	Descripción
0	Sin restricción: el usuario puede cambiar el dispositivo fuera del modo S.
1	Usuario bloqueado: el administrador ha bloqueado al usuario para que no cambie su dispositivo del modo S. Solo el administrador puede cambiar el dispositivo fuera del modo S a través del nodo SMode/SwitchFromSMode.

Ejemplos:

Agregar S Mode 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>

Obtener la directiva de cambio de modo 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>

Reemplazar el modo 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>

Delete S mode 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>

Estado

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1511 [10.0.10586] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/Status

Devuelve el estado de una actualización de edición en dispositivos móviles y de escritorio de Windows 10. Estado: 0 = Error, 1 = Pendiente, 2 = En curso, 3 = Completado, 4 = Desconocido.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`int`
Tipo de acceso	Obtener

Ejemplo:

<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>

Suscripciones

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1607 [10.0.14393] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/Subscriptions

Nodo para suscripciones.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Obtener

Subscriptions/{SubscriptionId}

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1607 [10.0.14393] y versiones posteriores

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

Nodo para identificadores de suscripción.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Obtener
Nomenclatura dinámica de nodos	ClientInventory

Subscriptions/{SubscriptionId}/Name

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1607 [10.0.14393] y versiones posteriores

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

Devuelve el nombre de la suscripción.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`chr` (cadena)
Tipo de acceso	Obtener

Subscriptions/{SubscriptionId}/Status

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1607 [10.0.14393] y versiones posteriores

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

Devuelve el estado de la suscripción.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`int`
Tipo de acceso	Obtener

Suscripciones/DisableSubscription

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows Insider (versión preliminar)

./Vendor/MSFT/WindowsLicensing/Subscriptions/DisableSubscription

Deshabilite o habilite la activación de la suscripción en un dispositivo.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`int`
Tipo de acceso	Reemplazar

Valores permitidos:

Valor	Descripción
0	Habilitar suscripción.
1	Deshabilitar suscripción. También quita cualquier suscripción existente en el dispositivo.

Suscripciones/RemoveSubscription

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows Insider (versión preliminar)

./Vendor/MSFT/WindowsLicensing/Subscriptions/RemoveSubscription

Quite la licencia de suscripción de desinstalación de suscripción. También restablece el tipo de suscripción a Suscripción basada en usuario.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`null`
Tipo de acceso	Exec

Subscriptions/SubscriptionLastError

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows Insider (versión preliminar)

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionLastError

Código de error de la última operación de suscripción. El valor estaría vacío(0) en ausencia de error.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`int`
Tipo de acceso	Obtener

Suscripciones/SuscripciónLastErrorDescription

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows Insider (versión preliminar)

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionLastErrorDescription

Descripción del error de la última operación de suscripción. El valor estaría vacío, si no se puede evaluar la descripción del error.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`chr` (cadena)
Tipo de acceso	Obtener

Subscriptions/SubscriptionStatus

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows Insider (versión preliminar)

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionStatus

Estado de la última operación de suscripción.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`int`
Tipo de acceso	Obtener

Subscriptions/SubscriptionType

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows Insider (versión preliminar)

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionType

Establezca device en Device Based Subscription (Suscripción basada en dispositivos) o User Based Subscription (Suscripción basada en el usuario). En Suscripción basada en dispositivos, esta acción adquirirá automáticamente la suscripción en el dispositivo. Para la suscripción basada en usuarios, se necesitará el proceso existente de inicio de sesión de usuario.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`int`
Tipo de acceso	Obtener, reemplazar

Valores permitidos:

Valor	Descripción
0	Suscripción basada en usuario.
1	Suscripción basada en dispositivos.

UpgradeEditionWithLicense

Nota

Esta directiva está en desuso y puede quitarse en una versión futura.

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1511 [10.0.10586] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/UpgradeEditionWithLicense

Proporcione una licencia para una actualización de edición de dispositivos móviles Windows 10. No requiere reinicio.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`xml`
Tipo de acceso	Exec

UpgradeEditionWithProductKey

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ❌ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅ Windows 10, versión 1511 [10.0.10586] y versiones posteriores

./Vendor/MSFT/WindowsLicensing/UpgradeEditionWithProductKey

Escriba una clave de producto para una actualización de edición de dispositivos de escritorio de Windows 10. Requiere reinicio.

Cuando se inserta una clave de producto desde un servidor MDM en el dispositivo de un usuario, changepk.exe se ejecuta mediante la clave de producto. Una vez completado, se muestra al usuario una notificación de que hay disponible una nueva edición de Windows. A continuación, el usuario puede reiniciar el sistema manualmente o después de dos horas, el dispositivo se reiniciará automáticamente para completar la actualización. El usuario recibirá una notificación de recordatorio 10 minutos antes del reinicio automático.

Tras el reinicio del dispositivo, se completará el proceso de actualización de la edición. El usuario recibirá una notificación de la actualización correcta.

Nota

Si otra directiva requiere un reinicio del sistema que se produce cuando changepk.exe se está ejecutando, se producirá un error en la actualización de la edición.

Si se escribe una clave del producto en un paquete de aprovisionamiento y el usuario comienza la instalación del paquete, se muestra una notificación al usuario de que se reiniciará su sistema para completar la instalación del paquete. Tras el consentimiento explícito del usuario para continuar, el paquete continúa la instalación y changepk.exe se ejecuta mediante la clave de producto. El usuario recibirá una notificación de aviso 30 segundos antes del reinicio automático.

Tras el reinicio del dispositivo, se completará el proceso de actualización de la edición. El usuario recibirá una notificación de la actualización correcta.

Este nodo también se puede usar para activar o cambiar una clave de producto en una edición determinada del dispositivo de escritorio de Windows 10 escribiendo una clave de producto. La activación o el cambio de una clave de producto no requiere un reinicio y es un proceso silencioso para el usuario.

Importante

La clave de producto especificada debe tener 29 caracteres (es decir, debe incluir guiones), de lo contrario, se producirá un error en la activación, actualización de edición o cambio de clave de producto en dispositivos de escritorio de Windows 10. La clave de producto se adquiere en el Centro de servicios de licencias por volumen de Microsoft. Su organización debe tener un contrato de licencias por volumen con Microsoft para acceder al portal.

Las siguientes son rutas de actualización de edición válidas cuando se usa este nodo a través de una MDM:

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

La activación o el cambio de una clave de producto se pueden realizar en las siguientes ediciones:

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

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`chr` (cadena)
Tipo de acceso	Exec
Comportamiento de reinicio	Automático

Ejemplo:

<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>

Nota

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX en la etiqueta Datos debe reemplazarse por la clave de producto.

Referencia de proveedor de servicios de configuración

Compartir a través de

WindowsLicensing CSP

ChangeProductKey

CheckApplicability

DeviceLicensingService

DeviceLicensingService/DeviceLicensingLastError

DeviceLicensingService/DeviceLicensingLastErrorDescription

DeviceLicensingService/DeviceLicensingStatus

DeviceLicensingService/LicenseType

Edición

LicenseKeyType

SMode

SMode/Status

SMode/SwitchFromSMode

SMode/SwitchingPolicy

Estado

Suscripciones

Subscriptions/{SubscriptionId}

Subscriptions/{SubscriptionId}/Name

Subscriptions/{SubscriptionId}/Status

Suscripciones/DisableSubscription

Suscripciones/RemoveSubscription

Subscriptions/SubscriptionLastError

Suscripciones/SuscripciónLastErrorDescription

Subscriptions/SubscriptionStatus

Subscriptions/SubscriptionType

UpgradeEditionWithLicense

UpgradeEditionWithProductKey

Comentarios

Recursos adicionales

Compartir a través de

WindowsLicensing CSP

ChangeProductKey

CheckApplicability

DeviceLicensingService

DeviceLicensingService/DeviceLicensingLastError

DeviceLicensingService/DeviceLicensingLastErrorDescription

DeviceLicensingService/DeviceLicensingStatus

DeviceLicensingService/LicenseType

Edición

LicenseKeyType

SMode

SMode/Status

SMode/SwitchFromSMode

SMode/SwitchingPolicy

Estado

Suscripciones

Subscriptions/{SubscriptionId}

Subscriptions/{SubscriptionId}/Name

Subscriptions/{SubscriptionId}/Status

Suscripciones/DisableSubscription

Suscripciones/RemoveSubscription

Subscriptions/SubscriptionLastError

Suscripciones/SuscripciónLastErrorDescription

Subscriptions/SubscriptionStatus

Subscriptions/SubscriptionType

UpgradeEditionWithLicense

UpgradeEditionWithProductKey

Artículos relacionados

Comentarios

Recursos adicionales