CSP WindowsLicensing

O provedor de serviços de configuração WindowsLicensing foi projetado para cenários de gerenciamento relacionados ao licenciamento.

A lista a seguir mostra os nós do provedor de serviços de configuração do WindowsLicensing:

• ./Vendor/MSFT/WindowsLicensing
  • ChangeProductKey
  • CheckApplicability
  • DeviceLicensingService
    • DeviceLicensingLastError
    • DeviceLicensingLastErrorDescription
    • DeviceLicensingStatus
    • LicenseType
  • Edição
  • LicenseKeyType
  • SMode
    • Status
    • SwitchFromSMode
    • Política de comutação
  • Status
  • Assinaturas
    • {SubscriptionId}
      • Nome
      • Status
    • DisableSubscription
    • RemoveSubscription
    • SubscriptionLastError
    • SubscriptionLastErrorDescription
    • Status da Assinatura
    • SubscriptionType
  • UpgradeEditionWithLicense
  • UpgradeEditionWithProductKey

ChangeProductKey

./Vendor/MSFT/WindowsLicensing/ChangeProductKey

Instala uma chave de produto (Product Key) para dispositivos desktop com Windows 10. Não reinicia.

Propriedades da estrutura de descrição:

CheckApplicability

./Vendor/MSFT/WindowsLicensing/CheckApplicability

retorna VERDADEIRO se a chave do produto (Product Key) inserida puder ser usada para um upgrade de edição de dispositivos da área de trabalho do Windows 10.

Propriedades da estrutura de descrição:

Exemplo:

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

DeviceLicensingService

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService

Assinatura baseada em dispositivo.

Propriedades da estrutura de descrição:

DeviceLicensingService/DeviceLicensingLastError

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingLastError

Retorna o último código de erro da operação Atualizar/Remover Licença de Dispositivo. O valor seria empty(0) na ausência de erro.

Propriedades da estrutura de descrição:

DeviceLicensingService/DeviceLicensingLastErrorDescription

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingLastErrorDescription

Retorna a última descrição de erro do Licenciamento de Dispositivo. O valor estaria vazio, se a descrição do erro não pudesse ser avaliada.

Propriedades da estrutura de descrição:

DeviceLicensingService/DeviceLicensingStatus

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingStatus

Retorna o status da operação Atualizar/Remover Licença de Dispositivo.

Propriedades da estrutura de descrição:

DeviceLicensingService/LicenseType

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/LicenseType

Tipo de licença: assinatura baseada em usuário ou assinatura baseada em dispositivo.

Propriedades da estrutura de descrição:

Valores Permitidos:

Edição

./Vendor/MSFT/WindowsLicensing/Edition

Retorna um valor que corresponde à edição do Windows 10 em execução em desktop ou dispositivos móveis. Pegue o valor, converta-o em seu equivalente hexadecimal e pesquise a página da função GetProductInfo no MSDN para obter informações de edição.

Propriedades da estrutura de descrição:

Exemplo:

<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

./Vendor/MSFT/WindowsLicensing/LicenseKeyType

Retorna o tipo de parâmetro usado por dispositivos Windows 10 para uma atualização de edição. Os dispositivos de área de trabalho do Windows 10 exigem uma chave do produto (Product Key) para uma atualização de edição. Os dispositivos Windows 10 Mobile exigem uma licença para uma atualização de edição.

Propriedades da estrutura de descrição:

Exemplo:

<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

./Vendor/MSFT/WindowsLicensing/SMode

Nó interno para gerenciar o modo S.

Propriedades da estrutura de descrição:

SMode/Status

./Vendor/MSFT/WindowsLicensing/SMode/Status

Retorna o status da solicitação de conjunto SwitchFromSMode ou SwitchingPolicy mais recente.

Valores possíveis:

• A solicitação falha com o código de erro 404: nenhuma solicitação SwitchFromSMode foi feita.
• 0: O dispositivo saiu com sucesso do modo S.
• 1: o dispositivo está processando a solicitação para sair do modo S.
• 3: O dispositivo já foi desligado do modo S.
• 4: O dispositivo não conseguiu sair do modo S.

Propriedades da estrutura de descrição:

Exemplo:

<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

./Vendor/MSFT/WindowsLicensing/SMode/SwitchFromSMode

Alterna um dispositivo para fora do modo S, se possível. Não reinicia.

Propriedades da estrutura de descrição:

Exemplo:

<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

./Vendor/MSFT/WindowsLicensing/SMode/SwitchingPolicy

Política que determina se um consumidor pode tirar o dispositivo do modo S.

Essa configuração só é aplicável a dispositivos disponíveis no modo S.

Propriedades da estrutura de descrição:

Valores Permitidos:

Exemplos:

• Adicionar SwitchingPolicy de Modo S

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

• Obter política de alternância do 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>
  

• Substituir SwitchingPolicy do modo S

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

• Excluir SwitchingPolicy do modo S

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

Status

./Vendor/MSFT/WindowsLicensing/Status

Retorna o status de uma atualização de edição no Windows 10 para desktop e em dispositivos móveis. Status: 0 = Com falha, 1 = Pendente, 2 = Em andamento, 3 = Concluído, 4 = Desconhecido.

Propriedades da estrutura de descrição:

Exemplo:

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

Assinaturas

./Vendor/MSFT/WindowsLicensing/Subscriptions

Nó para assinaturas.

Propriedades da estrutura de descrição:

Subscriptions/{SubscriptionId}

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

Nó para IDs de assinatura.

Propriedades da estrutura de descrição:

Subscriptions/{SubscriptionId}/Name

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

Retorna o nome da assinatura.

Propriedades da estrutura de descrição:

Subscriptions/{SubscriptionId}/Status

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

Retorna o status da assinatura.

Propriedades da estrutura de descrição:

Subscriptions/DisableSubscription

./Vendor/MSFT/WindowsLicensing/Subscriptions/DisableSubscription

Desabilite ou habilite a ativação de assinatura em um dispositivo.

Propriedades da estrutura de descrição:

Valores Permitidos:

Subscriptions/RemoveSubscription

./Vendor/MSFT/WindowsLicensing/Subscriptions/RemoveSubscription

Remover assinatura, desinstalar licença de assinatura. Ele também redefiniu o tipo de assinatura para Assinatura Baseada no Usuário.

Propriedades da estrutura de descrição:

Subscriptions/SubscriptionLastError

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionLastError

Código de erro da última operação de assinatura. O valor seria empty(0) na ausência de erro.

Propriedades da estrutura de descrição:

Subscriptions/SubscriptionLastErrorDescription

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionLastErrorDescription

Descrição do erro da última operação de assinatura. O valor estaria vazio se a descrição do erro não pudesse ser avaliada.

Propriedades da estrutura de descrição:

Assinaturas/SubscriptionStatus

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionStatus

Status da última operação de assinatura.

Propriedades da estrutura de descrição:

Subscriptions/SubscriptionType

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionType

Defina o dispositivo como Assinatura Baseada em Dispositivo ou Assinatura Baseada no Usuário. Para a Assinatura Baseada em Dispositivo, essa ação adquirirá automaticamente a assinatura no dispositivo. Para a Assinatura Baseada em Usuário, o processo existente de logon do usuário será necessário.

Propriedades da estrutura de descrição:

Valores Permitidos:

UpgradeEditionWithLicense

./Vendor/MSFT/WindowsLicensing/UpgradeEditionWithLicense

Forneça uma licença para uma atualização de edição de dispositivos móveis do Windows 10. Não requer reinicialização.

Propriedades da estrutura de descrição:

UpgradeEditionWithProductKey

./Vendor/MSFT/WindowsLicensing/UpgradeEditionWithProductKey

Insira uma chave do produto para uma atualização de edição de dispositivos de área de trabalho do Windows 10. Requer reinicialização.

Quando uma chave do produto é enviada por push de um servidor MDM para o dispositivo de um usuário, o executa changepk.exe usando a chave do produto. Após a conclusão, uma notificação é mostrada ao usuário informando que uma nova edição do Windows está disponível. 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 reiniciado, o processo de upgrade de edição será reiniciado. O usuário receberá uma notificação de upgrade bem-sucedido.

Se uma chave do produto (Product Key) 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 dizendo que o sistema será reiniciado para a conclusão da instalação do pacote. Após o consentimento explícito do usuário para continuar, o pacote continua a instalação e changepk.exe é executado usando a chave do produto. O usuário receberá uma notificação de lembrete 30 segundos antes do reinício automático.

Depois que o dispositivo for reiniciado, o processo de upgrade de edição será reiniciado. O usuário receberá uma notificação de upgrade bem-sucedido.

Esse nó também pode ser usado para ativar ou alterar uma chave do produto (Product Key) em uma edição específica do dispositivo da área de trabalho do Windows 10, inserindo uma chave do produto. A ativação ou alteração de uma chave do produto não exige uma reinicialização e é um processo silencioso para o usuário.

A seguir estão os caminhos de upgrade de edição válidos ao usar esse nó por meio de um MDM:

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

A ativação ou a alteração de uma chave do produto pode ser realizada nas seguintes edições:

• Windows 10/11 Education
• Windows 10/11 Enterprise
• Página Inicial do Windows 10/11
• Windows 10/11 Pro

Propriedades da estrutura de descrição:

Exemplo:

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

Artigos relacionados

Referência de provedor de serviços de configuração