Clase MDM_WindowsLicensing

[Parte de la información hace referencia al producto de versión preliminar, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información que se ofrece aquí].

La clase MDM_WindowsLicensing está diseñada para escenarios de administración relacionados con licencias. Actualmente, el ámbito se limita a las actualizaciones de edición de dispositivos de escritorio y móviles con Windows 10, como Windows 10 Pro a Windows 10 Enterprise. Además, este CSP proporciona la capacidad de activar o cambiar la clave de producto de los dispositivos de escritorio de Windows 10.

La siguiente sintaxis es código MOF simplificado e incluye todas las propiedades heredadas.

Sintaxis

[InPartition("local-system"), dynamic, provider("DMWmiBridgeProv")]
class MDM_WindowsLicensing
{
  string InstanceID;
  string ParentID;
  sint32 Edition;
  sint32 Status;
  string LicenseKeyType;
};

Miembros

La clase MDM_WindowsLicensing tiene estos tipos de miembros:

Métodos

La clase MDM_WindowsLicensing tiene estos métodos.

Método Descripción
ChangeProductKeyMethod Instala una clave de producto para dispositivos de escritorio Windows 10. No se reinicia.
CheckApplicabilityMethod Método para comprobar si la clave de producto especificada se puede usar para una actualización de edición, activación o cambio de una clave de producto de Windows 10 para dispositivos de escritorio.
UpgradeEditionWithLicenseMethod Proporcione una licencia para una actualización de edición de dispositivos móviles con Windows 10.
Nota: Este proceso de actualización no requiere un reinicio del sistema.
El tipo de fecha es XML.
La operación admitida es Execute.
Importante:
El contenido del archivo de licencia XML debe escaparse correctamente (es decir, no debe ser simplemente un XML copiado), de lo contrario, se producirá un error en la actualización de edición en dispositivos móviles Windows 10. Para más información sobre el escape adecuado del archivo de licencia XML, consulte la sección 2.4 de la especificación XML W3C. El archivo de licencia XML se adquiere desde 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 al usar este nodo a través de un paquete MDM o de aprovisionamiento:
- Windows 10 Mobileto Windows 10 Mobile Enterprise
UpgradeEditionWithProductKeyMethod Desencadena el dispositivo para tomar la clave del producto y actualizar la edición del cliente.
[!Nota]
Este proceso de actualización requiere un reinicio del sistema.


La operación admitida es Execute.
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 completada, se muestra una notificación al usuario de que hay disponible una nueva edición de Windows 10. A continuación, el usuario puede reiniciar su 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.
Una vez reiniciado el dispositivo, se completa el proceso de actualización de la edición. El usuario recibirá una notificación de que la actualización se ha realizado correctamente.
[!Importante]
Si otra directiva requiere un reinicio del sistema que se produce cuando se ejecuta changepk.exe, se producirá un error en la actualización de la edición.


Si se escribe una clave de producto en un paquete de aprovisionamiento y el usuario comienza la instalación del paquete, se muestra una notificación al usuario de que su sistema se reiniciará 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 con la clave de producto. El usuario recibirá una notificación de recordatorio de 30 segundos antes del reinicio automático.
Una vez reiniciado el dispositivo, se completa el proceso de actualización de la edición. El usuario recibirá una notificación de que la actualización se ha realizado correctamente.
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 requieren 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 desde 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 al usar este nodo a través de una MDM:
  • Windows 10 Enterprise a Windows 10 Education
  • Windows 10 Home a Windows 10 Education
  • Windows 10 Pro a Windows 10 Education
  • Windows 10 Pro a Windows 10 Enterprise

La activación o el cambio de una clave de producto se pueden realizar en las siguientes ediciones:
  • Windows 10 Education
  • Windows 10 Enterprise
  • Windows 10 Home
  • Windows 10 Pro

Propiedades

La clase MDM_WindowsLicensing tiene estas propiedades.

Edición

Tipo de datos: sint32

Tipo de acceso: lectura/escritura

InstanceID

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: key

Identifica el nombre del nodo primario.

LicenseKeyType

Tipo de datos: cadena

Tipo de acceso: lectura/escritura

ParentID

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: key

Describe la ruta de acceso completa al nodo principal. Para esta clase, la cadena es "./Vendor/MSFT/"

Estado

Tipo de datos: sint32

Tipo de acceso: lectura/escritura

Requisitos

Requisito Valor
Cliente mínimo compatible
Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible
No se admite ninguno
Espacio de nombres
Root\CIMv2\MDM\DMMap
MOF
DMWmiBridgeProv.mof
Archivo DLL
DMWmiBridgeProv.dll

Consulte también

Uso del scripting de PowerShell con el proveedor de puente WMI