Classe MDM_WindowsLicensing
[Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não faz nenhuma garantia, expressa ou implícita, com relação às informações fornecidas aqui.]
A classe MDM_WindowsLicensing foi projetada para cenários de gerenciamento relacionados ao licenciamento. Atualmente, o escopo está limitado a atualizações de edição do Windows 10 para dispositivos móveis e área de trabalho, como o Windows 10 Pro para Windows 10 Enterprise. Além disso, esse CSP fornece a capacidade de ativar ou alterar a chave do produto (Product Key) de dispositivos da área de trabalho com Windows 10.
A sintaxe a seguir é simplificada do código MOF e inclui todas as propriedades herdadas.
Sintaxe
[InPartition("local-system"), dynamic, provider("DMWmiBridgeProv")]
class MDM_WindowsLicensing
{
string InstanceID;
string ParentID;
sint32 Edition;
sint32 Status;
string LicenseKeyType;
};
Membros
A classe MDM_WindowsLicensing tem estes tipos de membros:
Métodos
A classe MDM_WindowsLicensing tem esses métodos.
| Método | Descrição |
|---|---|
| ChangeProductKeyMethod | Instala uma chave do produto para dispositivos da área de trabalho com Windows 10. Não reinicializa. |
| CheckApplicabilityMethod | Método para verificar se a chave do produto inserida pode ser usada para uma atualização de edição, ativação ou alteração de uma chave do produto do Windows 10 para dispositivos da área de trabalho. |
| UpgradeEditionWithLicenseMethod | Fornece uma licença para uma atualização de edição do Windows 10 para dispositivos móveis. Observação: esse processo de atualização não requer uma reinicialização do sistema. O tipo de data é XML. A operação com suporte é Executar. Importante: O conteúdo do arquivo de licença XML deve ter o escape correto (ou seja, não deve ser simplesmente um XML copiado), caso contrário, a atualização de edição do Windows 10 para dispositivos móveis falhará. Para obter mais informações sobre o escape adequado do arquivo de licença XML, consulte a Seção 2.4 da especificação W3C XML. O arquivo de licença XML é adquirido do Centro de Serviços de Licenciamento por Volume da Microsoft. Sua organização deve ter um contrato de Licenciamento por Volume com a Microsoft para acessar o portal. A seguir estão os caminhos de atualização de edição válidos ao usar esse nó por meio de um MDM ou pacote de provisionamento: – Windows 10 Mobile para Windows 10 Mobile Enterprise |
| UpgradeEditionWithProductKeyMethod | Aciona o dispositivo para pegar a chave do produto e atualizar a edição do cliente.[!Observação] A operação com suporte é Executar. Quando uma chave do produto é enviada de um servidor MDM para o dispositivo de um usuário, changepk.exe é executado usando a chave do produto. Após a conclusão, uma notificação é mostrada ao usuário de que uma nova edição do Windows 10 está disponível. Em seguida, o usuário pode reiniciar o sistema manualmente ou, após duas horas, o dispositivo será reiniciado automaticamente para concluir a atualização. O usuário receberá uma notificação de lembrete 10 minutos antes da reinicialização automática. Depois que o dispositivo for reinicializado, o processo de atualização da edição será concluído. O usuário receberá uma notificação da atualização bem-sucedida. [Importante] Se uma chave do produto for inserida em um pacote de provisionamento e o usuário iniciar a instalação do pacote, uma notificação será mostrada ao usuário de que o sistema será reiniciado para concluir a instalação do pacote. Após o consentimento explícito do usuário para continuar, o pacote continuará a instalação e changepk.exe será executado usando a chave do produto. O usuário receberá uma notificação de lembrete 30 segundos antes da reinicialização automática. Depois que o dispositivo for reinicializado, o processo de atualização da edição será concluído. O usuário receberá uma notificação da atualização bem-sucedida. Esse nó também pode ser usado para ativar ou alterar uma chave do produto em uma edição específica do Windows 10 para dispositivo da área de trabalho inserindo uma chave do produto. A ativação ou alteração de uma chave do produto não requer uma reinicialização e é um processo silencioso para o usuário. [Importante] A seguir estão os caminhos de atualização de edição válidos ao usar esse nó por meio de um MDM:
A ativação ou alteração de uma chave do produto pode ser realizada nas seguintes edições:
|
Propriedades
A classe MDM_WindowsLicensing tem essas propriedades.
-
-
Tipo de dados: sint32
-
Tipo de acesso: leitura/gravação
-
-
InstanceID
-
-
Tipo de dados: string
-
Tipo de acesso: Somente leitura
-
Qualificadores: key
Identifica o nome do nó pai.
-
-
-
Tipo de dados: string
-
Tipo de acesso: leitura/gravação
-
-
ParentID
-
-
Tipo de dados: string
-
Tipo de acesso: Somente leitura
-
Qualificadores: key
Descreve o caminho completo até o nó pai. Para essa classe, a cadeia de caracteres é "./Vendor/MSFT/"
-
-
-
Tipo de dados: sint32
-
Tipo de acesso: leitura/gravação
-
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 10 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Nenhum compatível |
| Namespace |
Root\CIMv2\MDM\DMMap |
| MOF |
|
| DLL |
|