Condividi tramite


classe MDM_WindowsLicensing

[Alcune informazioni riguardano il prodotto non rilasciato che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non fornisce garanzie, esplicite o implicite, relativamente alle informazioni fornite qui.

La classe MDM_WindowsLicensing è progettata per scenari di gestione correlati alle licenze. Attualmente l'ambito è limitato agli aggiornamenti dell'edizione dei dispositivi windows 10 desktop e mobili, ad esempio Windows 10 Pro a Windows 10 Enterprise. Inoltre, questo provider di servizi di configurazione offre la possibilità di attivare o modificare il codice Product Key dei dispositivi desktop Windows 10.

La sintassi seguente è semplificata dal codice MOF e include tutte le proprietà ereditate.

Sintassi

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

Membri

La classe MDM_WindowsLicensing include questi tipi di membri:

Metodi

La classe MDM_WindowsLicensing dispone di questi metodi.

Metodo Descrizione
ChangeProductKeyMethod Installa un codice Product Key per i dispositivi desktop Windows 10. Non viene riavviato.
CheckApplicabilityMethod Metodo per verificare se il codice Product Key immesso può essere usato per un aggiornamento dell'edizione, l'attivazione o la modifica di un codice Product Key di Windows 10 per i dispositivi desktop.
UpgradeEditionWithLicenseMethod Fornire una licenza per un aggiornamento dell'edizione dei dispositivi mobili Windows 10.
Nota: questo processo di aggiornamento non richiede un riavvio del sistema.
Il tipo di data è XML.
L'operazione supportata è Execute.
Importante:
Il contenuto del file di licenza XML deve essere preceduto correttamente da un carattere di escape (ovvero non deve essere semplicemente un file XML copiato), altrimenti l'aggiornamento dell'edizione nei dispositivi mobili Windows 10 avrà esito negativo. Per altre informazioni sull'escape corretto del file di licenza XML, vedere la sezione 2.4 della specifica XML W3C. Il file di licenza XML viene acquisito da Microsoft Volume Licensing Service Center. L'organizzazione deve avere un contratto multilicenza con Microsoft per accedere al portale.
Di seguito sono riportati i percorsi di aggiornamento dell'edizione validi quando si usa questo nodo tramite un pacchetto MDM o di provisioning:
- Windows 10 Mobileto Windows 10 Mobile Enterprise
UpgradeEditionWithProductKeyMethod Attiva il dispositivo per accettare il codice Product Key e aggiornare l'edizione del client.
[!Nota]
Questo processo di aggiornamento richiede un riavvio del sistema.


L'operazione supportata è Execute.
Quando viene eseguito il push di un codice Product Key da un server MDM al dispositivo di un utente, changepk.exe viene eseguito usando il codice Product Key. Al termine, viene visualizzata una notifica all'utente che è disponibile una nuova edizione di Windows 10. L'utente può quindi riavviare il sistema manualmente o, dopo due ore, il dispositivo verrà riavviato automaticamente per completare l'aggiornamento. L'utente riceverà una notifica di promemoria 10 minuti prima del riavvio automatico.
Dopo il riavvio del dispositivo, il processo di aggiornamento dell'edizione viene completato. L'utente riceverà una notifica dell'aggiornamento riuscito.
[! Importante]
Se un altro criterio richiede un riavvio del sistema che si verifica quando changepk.exe è in esecuzione, l'aggiornamento dell'edizione avrà esito negativo.


Se un codice Product Key viene immesso in un pacchetto di provisioning e l'utente inizia l'installazione del pacchetto, viene visualizzata una notifica all'utente che il sistema riavvierà per completare l'installazione del pacchetto. Dopo il consenso esplicito dell'utente per continuare, il pacchetto continua l'installazione e changepk.exe viene eseguito usando il codice Product Key. L'utente riceverà una notifica di promemoria 30 secondi prima del riavvio automatico.
Dopo il riavvio del dispositivo, il processo di aggiornamento dell'edizione viene completato. L'utente riceverà una notifica dell'aggiornamento riuscito.
Questo nodo può essere usato anche per attivare o modificare un codice Product Key in una determinata edizione del dispositivo desktop Windows 10 immettendo un codice Product Key. L'attivazione o la modifica di un codice Product Key non richiede un riavvio ed è un processo invisibile all'utente.
[! Importante]
Il codice Product Key immesso deve essere di 29 caratteri (ovvero deve includere trattini), altrimenti l'attivazione, l'aggiornamento dell'edizione o la modifica del codice Product Key nei dispositivi desktop Windows 10 avranno esito negativo. Il codice Product Key viene acquisito da Microsoft Volume Licensing Service Center. L'organizzazione deve avere un contratto multilicenza con Microsoft per accedere al portale.

Di seguito sono riportati i percorsi di aggiornamento dell'edizione validi quando si usa questo nodo tramite un mdm:
  • Da Windows 10 Enterprise a Windows 10 Education
  • Windows 10 Home to Windows 10 Education
  • Da Windows 10 Pro a Windows 10 Education
  • Da Windows 10 Pro a Windows 10 Enterprise

L'attivazione o la modifica di un codice Product Key possono essere eseguite nelle edizioni seguenti:
  • Windows 10 Education
  • Windows 10 Enterprise
  • Windows 10 Home
  • Windows 10 Pro

Proprietà

La classe MDM_WindowsLicensing dispone di queste proprietà.

Edizione

Tipo di dati: sint32

Tipo di accesso: lettura/scrittura

InstanceID

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: chiave

Identifica il nome del nodo padre.

LicenseKeyType

Tipo di dati: string

Tipo di accesso: lettura/scrittura

Parentid

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: chiave

Descrive il percorso completo del nodo padre. Per questa classe, la stringa è "./Vendor/MSFT/"

Stato

Tipo di dati: sint32

Tipo di accesso: lettura/scrittura

Requisiti

Requisito Valore
Client minimo supportato
Windows 10 [solo app desktop]
Server minimo supportato
Nessuna supportata
Spazio dei nomi
Root\CIMv2\MDM\DMMap
MOF
DMWmiBridgeProv.mof
DLL
DMWmiBridgeProv.dll

Vedi anche

Uso di script di PowerShell con il provider bridge WMI