CSP WindowsLicensing

Artigo
08/08/2024

Logótipo do Windows Insider.

Importante

Esse CSP contém algumas configurações que estão em desenvolvimento e só se aplicam Windows Insider Preview builds. Essas configurações estão sujeitas a alterações e podem ter dependências de outros recursos ou serviços em versão prévia.

O fornecedor de serviços de configuração do WindowsLicensing foi concebido para cenários de gestão relacionados com o licenciamento.

A lista seguinte mostra os nós do fornecedor de serviços de configuração WindowsLicensing:

./Vendor/MSFT/WindowsLicensing

ChangeProductKey

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1703 [10.0.15063] e posterior

./Vendor/MSFT/WindowsLicensing/ChangeProductKey

Instala uma chave de produto para dispositivos de ambiente de trabalho windows 10. Não reinicia.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia)
Tipo de acesso	Executivo

CheckApplicability

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1511 [10.0.10586] e posterior

./Vendor/MSFT/WindowsLicensing/CheckApplicability

Devolve VERDADEIRO se a chave de produto introduzida puder ser utilizada para uma atualização de edição de dispositivos de ambiente de trabalho windows 10.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia)
Tipo de acesso	Executivo

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>

Observação

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX na etiqueta Dados deve ser substituída pela sua chave de produto.

DeviceLicensingService

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 11, versão 21H2 com KB5018483 [10.0.22000.1165] e posterior ✅ Windows 11, versão 22H2 [10.0.22621] e posterior

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService

Subscrição Baseada em Dispositivos.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter

DeviceLicensingService/DeviceLicensingLastError

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 11, versão 21H2 com KB5018483 [10.0.22000.1165] e posterior ✅ Windows 11, versão 22H2 [10.0.22621] e posterior

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingLastError

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

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Obter

DeviceLicensingService/DeviceLicensingLastErrorDescription

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 11, versão 21H2 com KB5018483 [10.0.22000.1165] e posterior ✅ Windows 11, versão 22H2 [10.0.22621] e posterior

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingLastErrorDescription

Devolve a descrição do último erro do Licenciamento de Dispositivos. O valor estaria vazio se não fosse possível avaliar a descrição do erro.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia)
Tipo de acesso	Obter

DeviceLicensingService/DeviceLicensingStatus

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 11, versão 21H2 com KB5018483 [10.0.22000.1165] e posterior ✅ Windows 11, versão 22H2 [10.0.22621] e posterior

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/DeviceLicensingStatus

Devolve o estado da operação Atualizar/Remover Licença de Dispositivo.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Obter

DeviceLicensingService/LicenseType

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 11, versão 21H2 com KB5018483 [10.0.22000.1165] e posterior ✅ Windows 11, versão 22H2 [10.0.22621] e posterior

./Vendor/MSFT/WindowsLicensing/DeviceLicensingService/LicenseType

Tipo de Licença: Subscrição Baseada no Utilizador ou Subscrição Baseada em Dispositivos.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Obter, Substituir

Valores Permitidos:

Valor	Descrição
0	Subscrição Baseada no Utilizador.
1	Subscrição Baseada em Dispositivos.

Edição

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1511 [10.0.10586] e posterior

./Vendor/MSFT/WindowsLicensing/Edition

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

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Obter

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

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1511 [10.0.10586] e posterior

./Vendor/MSFT/WindowsLicensing/LicenseKeyType

Devolve o tipo de parâmetro utilizado pelos dispositivos Windows 10 para uma atualização de edição. Os dispositivos de ambiente de trabalho do Windows 10 necessitam de uma chave de produto para uma atualização de edição. Os dispositivos móveis windows 10 necessitam de uma licença para uma atualização de edição.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia)
Tipo de acesso	Obter

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

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1809 [10.0.17763] e posterior

./Vendor/MSFT/WindowsLicensing/SMode

Nó interior para gerir o modo S.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter

SMode/Estado

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1809 [10.0.17763] e posterior

./Vendor/MSFT/WindowsLicensing/SMode/Status

Devolve o estado do pedido mais recente do conjunto SwitchFromSMode ou SwitchingPolicy.

Valores possíveis:

O pedido falha com o código de erro 404: não foi feito nenhum pedido SwitchFromSMode.
0: O dispositivo saiu com êxito do modo S.
1: O dispositivo está a processar o pedido para sair do modo S.
3: O dispositivo já tinha saído do modo S.
4: O dispositivo não conseguiu sair do modo S.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Obter

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

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1809 [10.0.17763] e posterior

./Vendor/MSFT/WindowsLicensing/SMode/SwitchFromSMode

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

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`null`
Tipo de acesso	Executivo

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

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1809 [10.0.17763] e posterior

./Vendor/MSFT/WindowsLicensing/SMode/SwitchingPolicy

Política que determina se um consumidor pode mudar o dispositivo para fora do modo S.

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

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Adicionar, Excluir, Obter, Substituir

Valores Permitidos:

Valor	Descrição
0	Sem Restrições: o utilizador tem permissão para mudar o dispositivo para fora do modo S.
1	Utilizador Bloqueado: o administrador bloqueou o utilizador de mudar o dispositivo para fora do modo S. Apenas o administrador pode mudar o dispositivo para fora do modo S através do nó SMode/SwitchFromSMode.

Exemplos:

Adicionar Modo S 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>

Obter Política de Mudança 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 o 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>

Eliminar Modo S 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>

Status

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1511 [10.0.10586] e posterior

./Vendor/MSFT/WindowsLicensing/Status

Devolve o estado de uma atualização de edição em dispositivos móveis e de ambiente de trabalho windows 10. Estado: 0 = Com falhas, 1 = Pendente, 2 = Em curso, 3 = Concluído, 4 = Desconhecido.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Obter

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

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1607 [10.0.14393] e posterior

./Vendor/MSFT/WindowsLicensing/Subscriptions

Nó para subscrições.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter

Subscrições/{SubscriptionId}

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1607 [10.0.14393] e posterior

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

Nó para IDs de subscrição.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter
Nomenclatura de Nó Dinâmico	ClientInventory

Subscrições/{SubscriptionId}/Name

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1607 [10.0.14393] e posterior

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

Devolve o nome da subscrição.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia)
Tipo de acesso	Obter

Subscrições/{SubscriptionId}/Status

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1607 [10.0.14393] e posterior

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

Devolve o estado da subscrição.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Obter

Subscrições/DisableSubscription

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows Insider Preview

./Vendor/MSFT/WindowsLicensing/Subscriptions/DisableSubscription

Desative ou ative a ativação da subscrição num dispositivo.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Substituir

Valores Permitidos:

Valor	Descrição
0	Ative a Subscrição.
1	Desative a Subscrição. Também remove qualquer subscrição existente no dispositivo.

Subscrições/RemoveSubscription

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows Insider Preview

./Vendor/MSFT/WindowsLicensing/Subscriptions/RemoveSubscription

Remova a licença de subscrição de desinstalação. Também repõe o tipo de subscrição para a Subscrição Baseada no Utilizador.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`null`
Tipo de acesso	Executivo

Subscrições/SubscriptionLastError

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows Insider Preview

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionLastError

Código de erro da última operação de subscrição. O valor estaria vazio(0) na ausência de erro.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Obter

Subscrições/SubscriptionLastErrorDescription

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows Insider Preview

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionLastErrorDescription

Descrição do erro da última operação de subscrição. O valor estaria vazio se não fosse possível avaliar a descrição do erro.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia)
Tipo de acesso	Obter

Subscrições/SubscriptionStatus

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows Insider Preview

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionStatus

Estado da última operação de subscrição.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Obter

Subscrições/SubscriptionType

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows Insider Preview

./Vendor/MSFT/WindowsLicensing/Subscriptions/SubscriptionType

Defina o dispositivo como Subscrição Baseada no Dispositivo ou Subscrição Baseada no Utilizador. Para a Subscrição Baseada em Dispositivos, esta ação adquirirá automaticamente a subscrição no dispositivo. Para a Subscrição Baseada no Utilizador, será necessário o processo de início de sessão do utilizador existente.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Obter, Substituir

Valores Permitidos:

Valor	Descrição
0	Subscrição Baseada no Utilizador.
1	Subscrição Baseada em Dispositivos.

UpgradeEditionWithLicense

Observação

Esta política foi preterida e poderá ser removida numa versão futura.

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1511 [10.0.10586] e posterior

./Vendor/MSFT/WindowsLicensing/UpgradeEditionWithLicense

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

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`xml`
Tipo de acesso	Executivo

UpgradeEditionWithProductKey

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ❌ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅ Windows 10, versão 1511 [10.0.10586] e posterior

./Vendor/MSFT/WindowsLicensing/UpgradeEditionWithProductKey

Introduza uma chave de produto para uma atualização de edição de dispositivos de ambiente de trabalho windows 10. Requer reinício.

Quando uma chave de produto é enviada de um servidor MDM para o dispositivo de um utilizador, changepk.exe é executada com a chave de produto. Após a conclusão, é apresentada uma notificação ao utilizador de que está disponível uma nova edição do Windows. Em seguida, o utilizador pode reiniciar o sistema manualmente ou após duas horas. O dispositivo será reiniciado automaticamente para concluir a atualização. O utilizador receberá uma notificação de lembrete 10 minutos 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.

Observação

Se outra política exigir um reinício do sistema que ocorra quando changepk.exe está em execução, a atualização da edição falhará.

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 utilizador para continuar, o pacote continua a instalação e changepk.exe é executado com a chave de 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.

Este nó também pode ser utilizado para ativar ou alterar uma chave de produto numa edição específica do dispositivo de ambiente de trabalho windows 10 ao introduzir uma chave de produto. A ativação ou alteração de uma chave de produto não requer um reinício e é um processo silencioso para o utilizador.

Importante

A chave de produto introduzida tem de ter 29 carateres (ou seja, deve incluir travessões), caso contrário, a ativação, a atualização de edição ou a alteração da chave de produto nos dispositivos de ambiente de trabalho do Windows 10 falharão. A chave de produto é adquirida no Centro de Serviços de Licenciamento em Volume da Microsoft. A sua organização tem de ter um contrato de Licenciamento em Volume com a Microsoft para aceder ao portal.

Seguem-se caminhos de atualização de edição válidos ao utilizar este nó através de uma MDM:

Windows 10/11 Enterprise para Windows 10/11 Education
Windows 10/11 Home to 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 alteração de uma chave de produto pode ser realizada nas seguintes edições:

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

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia)
Tipo de acesso	Executivo
Comportamento de Reinício	Automático

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>

Observação

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX na etiqueta Dados deve ser substituída pela sua chave de produto.

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

Compartilhar via

CSP WindowsLicensing

ChangeProductKey

CheckApplicability

DeviceLicensingService

DeviceLicensingService/DeviceLicensingLastError

DeviceLicensingService/DeviceLicensingLastErrorDescription

DeviceLicensingService/DeviceLicensingStatus

DeviceLicensingService/LicenseType

Edição

LicenseKeyType

SMode

SMode/Estado

SMode/SwitchFromsMode

SMode/SwitchingPolicy

Status

Assinaturas

Subscrições/{SubscriptionId}

Subscrições/{SubscriptionId}/Name

Subscrições/{SubscriptionId}/Status

Subscrições/DisableSubscription

Subscrições/RemoveSubscription

Subscrições/SubscriptionLastError

Subscrições/SubscriptionLastErrorDescription

Subscrições/SubscriptionStatus

Subscrições/SubscriptionType

UpgradeEditionWithLicense

UpgradeEditionWithProductKey

Comentários

Recursos adicionais

Compartilhar via

CSP WindowsLicensing

ChangeProductKey

CheckApplicability

DeviceLicensingService

DeviceLicensingService/DeviceLicensingLastError

DeviceLicensingService/DeviceLicensingLastErrorDescription

DeviceLicensingService/DeviceLicensingStatus

DeviceLicensingService/LicenseType

Edição

LicenseKeyType

SMode

SMode/Estado

SMode/SwitchFromsMode

SMode/SwitchingPolicy

Status

Assinaturas

Subscrições/{SubscriptionId}

Subscrições/{SubscriptionId}/Name

Subscrições/{SubscriptionId}/Status

Subscrições/DisableSubscription

Subscrições/RemoveSubscription

Subscrições/SubscriptionLastError

Subscrições/SubscriptionLastErrorDescription

Subscrições/SubscriptionStatus

Subscrições/SubscriptionType

UpgradeEditionWithLicense

UpgradeEditionWithProductKey

Artigos relacionados

Comentários

Recursos adicionais