Ferramentas para gerenciar a ativação de volume do Office

Aplica-se a:Versões licenciadas por volume de Office LTSC 2021, Office 2019 e Office 2016 (incluindo Project e Visio)

O script da Plataforma de Proteção de Software do Office (ospp.vbs), o script do Gerenciador de Licenças de Software (slmgr.vbs) e o Ferramenta de Gerenciamento de Ativação de Volume (VAMT) podem ajudá-lo a configurar e testar versões licenciadas por volume do Office, incluindo Project e Visio. Antes de ler este artigo, recomendamos que você leia os seguintes artigos:

O script ospp.vbs

O script da Plataforma de Proteção de Software do Office (ospp.vbs) permite configurar versões licenciadas por volume de produtos do Office, incluindo Project e Visio. O script ospp.vbs está localizado na pasta Arquivos do Programa\Microsoft Office\Office16. Se você instalou a versão de 32 bits do Office em um sistema operacional de 64 bits, acesse a pasta Arquivos de Programa (x86)\Microsoft Office\Office16.

Observação

O script ospp.vbs não funciona para versões de Microsoft 365 Apps ou assinatura do Project e do Visio. Em vez disso, você pode usar um script do PowerShell chamado vnextdiag.ps1. Para obter mais informações, consulte Verificar o status de licença e ativação para obter Microsoft 365 Apps.

A execução do ospp.vbs requer o mecanismo de script cscript.exe. Para ver o arquivo de Ajuda, digite o seguinte comando e pressione ENTER:

 cscript ospp.vbs /?

A sintaxe geral é a seguinte:

cscript ospp.vbs [Option:Value] [ComputerName] [User] [Password]

Opção Especifica a opção e o valor a serem usados para ativar um produto, instalar ou desinstalar uma chave do produto, instalar e exibir informações de licença, definir o nome e a porta do host KMS e remover o nome e a porta do host KMS. As opções e os valores estão listados nas tabelas nesta seção.

Computername Nome do computador remoto. Se um nome de computador não for fornecido, o computador local será usado.

Usuário Conta que tem a permissão necessária no computador remoto.

Senha Senha da conta. Se uma conta de usuário e uma senha não forem fornecidas, as credenciais atuais serão usadas.

Importante

Antes de executar o ospp.vbs, verifique se:

  • Se você deseja executar o script em um computador remoto, o firewall do Windows permite o tráfego da Instrumentação de Gerenciamento do Windows (WMI) no computador remoto.
  • A conta de usuário usada é um membro do grupo Administradores do computador no qual você está realizando o procedimento.
  • Execute o o script ospp.vbs em um prompt de comando com privilégios elevados.

Opções globais para ospp.vbs

Opção Global Descrição
/act Ativa as chaves de produto do Office instaladas.
/inpkey:value Instala uma chave do produto (substitui a chave existente) com um chave de produto fornecida pelo usuário. A opção Value é necessária.
/unpkey:value Desinstala uma chave de produto instalada com os últimos cinco dígitos da chave do produto para desinstalar (conforme exibido pela opção /dstatus). O parâmetro Value é necessário.
/inslic:value Instala uma licença com o caminho fornecido pelo usuário da licença .xrm-ms. O parâmetro Value é obrigatório.
/dstatus Exibe informações de licença para chaves de produto instaladas.
/dstatusall Exibe informações para todas as licenças instaladas.
/dhistoryacterr Exibe o histórico de falhas para a ativação MAK/Retail.
/dinstid Exibe a ID de instalação para ativação offline.
/actcid:value Ativa o produto com a ID de Confirmação fornecida pelo usuário. O parâmetro Value é obrigatório.
/rearm Redefine o status de licenciamento para todas as chaves de produto do Office instaladas.
/rearm:value Redefine o status de licenciamento de uma licença do Office com um valor de ID de SKU fornecido pelo usuário. O parâmetro Value é necessário.

Use essa opção com o valor da ID de SKU especificado usando a opção /dstatus se você tiver esgotado os rearmes e tiver ativado o Office por meio de KMS ou ativação baseada no Active Directory para obter um rearm adicional.
/ddescr:value Exibe a descrição de um código de erro fornecido pelo usuário. O parâmetro Value é obrigatório.

A seguinte tabela descreve as opções do ospp.vbs para configurar o cliente KMS.

Opções do cliente KMS para ospp.vbs

Opção de cliente KMS Descrição
/dhistorykms Exibe o histórico da ativação cliente KMS.
/dcmid Exibe o ID do computador do cliente KMS (CMID).
/sethst:value Define um nome de host KMS com um nome de host fornecido pelo usuário. O parâmetro Value é necessário.

Isto define o HKLM\Software\Microsoft\OfficeSoftwareProtectionPlatform\KeyManagementServiceName (REG_SZ).
/setprt:value Define uma porta KMS com um número de porta fornecido pelo usuário. O numero padrão da porta é 1688. O parâmetro Value é necessário.

Isto define o HKLM\Software\Microsoft\OfficeSoftwareProtectionPlatform\KeyManagementServicePort (REG_SZ).
/remhst Remove o nome do host KMS e define a porta como padrão. A porta padrão é 1688.
/cachst:value Permite ou nega cache de host KMS. O parâmetro Value é obrigatório (TRUE ou FALSE).
/actype:value (somente versões Windows 8.1 e posteriores) Define o tipo de ativação de volume. O parâmetro Value é necessário.

Valores: 1 (para baseado no Active Directory), 2 (para KMS), 0 (para ambos).
/skms-domain:value (somente versões Windows 8.1 e posteriores) Define o domínio DNS específico no qual todos os registros KMS SRV podem ser encontrados. Essa configuração não terá efeito se o nome do host kms único específico for definido pela opção /sethst. O parâmetro Value é o Nome de Domínio Totalmente Qualificado (FQDN) e é necessário.
/ckms-domain (somente versões Windows 8.1 e posteriores) Limpa o domínio DNS específico no qual todos os registros KMS SRV podem ser encontrados. O host KMS específico será usado se ele for definido pela opção /sethst. Caso contrário, a descoberta automática do host KMS será usada.

Cenários que usam ospp.vbs

Os cenários a seguir pressupõem que você esteja executando ospp.vbs em um prompt de comando elevado.

Observação

Todas as alterações feitas afetam apenas os produtos cliente do Office. Você precisa configurar o cliente Windows separadamente usando o scriptslmgr.vbs.

Para alterar a chave de produto para uma chave MAK em um computador remoto

  1. Se o computador remoto se chamar contoso1, execute o comando a seguir para inserir a chave do produto. Isso pressupõe que você tenha credenciais de administrador no computador remoto. Se as suas credenciais no computador remoto forem diferentes do nome de logon e da senha, digite o nome de logon e a senha na linha de comando e pressione ENTER:
cscript ospp.vbs /inpkey:xxxxx-xxxxx-xxxxx-xxxxx-xxxxx contoso1
  1. Para ativar o computador remoto, digite o seguinte comando e pressione ENTER:
cscript ospp.vbs /act contoso1

Para diagnosticar os erros de ativação do KMS

  1. Se o computador tiver a chave do cliente KMS instalada, verifique o status do licenciamento. Para isso, digite o seguinte comando e pressione ENTER:
cscript ospp.vbs /dstatusall
  1. Para verificar o histórico de ativação do KMS, digite o seguinte comando e pressione ENTER:
cscript ospp.vbs /dhistorykms
  1. Para disparar a ativação, digite o seguinte comando e pressione ENTER:
cscript ospp.vbs /act
  1. Verifique a mensagem de erro referente ao código de erro 0xC004F042. Se nas caixas de diálogo de notificação você vir um código de erro mostrado para os usuários, também poderá usar esse código para verificar a mensagem de erro. Para isso, digite o seguinte comando e pressione ENTER:
cscript ospp.vbs /ddescr:0xC004F042

Para ativar ou desativar o host KMS em cache no cliente KMS

  1. No computador cliente KMS, para ativar o cache, digite o seguinte comando e pressione ENTER:
cscript ospp.vbs /cachst:TRUE
  1. No computador cliente KMS, para desativar o cache, digite o seguinte comando e pressione ENTER:
cscript ospp.vbs /cachst:FALSE

Para testar o nome de host KMS e, depois, definir para a descoberta automática

  1. Se você estiver testando um host KMS chamado kmstest.contoso.com e quiser especifique-o no cliente KMS, digite o seguinte comando e pressione ENTER:
cscript ospp.vbs /sethst:kmstest.contoso.com

Observação

Se você alterar a porta padrão no computador host KMS, deverá executar ospp.vbs com a opção /setprt. Por exemplo: cscript ospp.vbs /setprt:1750

  1. Para disparar a ativação, digite o seguinte comando e pressione ENTER:
cscript ospp.vbs /act
  1. Para verificar o histórico de ativação do KMS de modo a saber se o host foi contatado com êxito, digite o seguinte comando e pressione ENTER:
cscript ospp.vbs /dhistorykms
  1. Agora, você deseja que esse cliente KMS use o DNS (Sistema de Nomes de Domínios) para descoberta automática do host KMS de produção. Para remover o nome do host KMS, digite o seguinte comando e pressione ENTER:
cscript ospp.vbs /remhst

Script slmgr.vbs

O script do Gerenciador de Licenças de Software (slmgr.vbs), localizado na pasta Windows\system32, é usado para configurar e recuperar informações de ativação de volume para o host do Office KMS e o host do Windows. Saiba mais no artigo sobre como configurar os hosts KMS no Windows.

Você pode executar o script localmente no computador de destino ou remotamente de outro computador. Você precisa ser administrador para usar o script. Se um usuário padrão executar slmgr.vbs, alguns dados da licença poderão não existir ou estar incorretos, e muitas operações serão proibidas.

O script slmgr.vbs pode usar o host de script baseado no Windows, wscript.exe ou o host de script baseado em comandos, cscript.exe, e os administradores poderão especificar qual mecanismo de script usar. Se nenhum mecanismo de script for especificado, slmgr.vbs será executado usando o mecanismo de script padrão, wscript.exe. Recomendamos o mecanismo de script cscript.exe.

É preciso reiniciar o Serviço de Licenciamento de Software para que as alteração entrem em vigor. Para reiniciar o Serviço de Licenciamento de Software, use o snap-in de Serviços do Console de Gerenciamento Microsoft (MMC) ou execute o seguinte comando:

net stop sppsvc && net start sppsvc

O script slmgr.vbs requer pelo menos um parâmetro. Se você executar o script sem parâmetros, ele exibirá as informações de Ajuda. A tabela a seguir lista as opções da linha de comando do slmgr.vbs e uma descrição de cada uma delas. A maioria dos parâmetros na tabela configura o computador host KMS. Porém, os parâmetros /sai e /sri são transmitidos para os clientes KMS depois que eles entrarem em contato com o computador host KMS. A sintaxe geral do slmgr.vbs é a seguinte (supondo que você esteja usando o cscript.exe como o mecanismo de script):

 cscript slmgr.vbs [ComputerName] [User] [Password] [Option]

Computername Nome do computador remoto. Se você não fornecer um nome de computador, o computador local será usado.

Usuário Conta com permissão necessária no computador remoto.

Senha Senha da conta. Se você não fornecer uma conta de usuário e senha, as credenciais atuais serão usadas.

Opção As opções são mostradas na tabela a seguir.

Slmgr.vbs opções de comando

Opção Descrição
/ ipk ProductKey Instala a chave do produto para o Windows (padrão) ou outro aplicativo identificado pela chave do produto key.
/ ato ActivationID Ativa o host KMS para o Windows (padrão) ou para o aplicativo que é identificado quando sua ID de Ativação é fornecida.
/ dti ActivationID Exibe a ID de instalação usada para a ativação do telefone do computador host KMS para o Windows (padrão) ou para o aplicativo identificado quando a ID de ativação é fornecida. Você digita a ID de Instalação no telefone para receber a ID de Confirmação, que é usada para ativar o computador host KMS usando o parâmetro /atp.
/ atp ConfirmationIDActivationID Depois que a ID de Confirmação é recebida, ativa o host KMS para o Windows (padrão) ou para o aplicativo que é identificado quando sua ID de Ativação é fornecida.
/ dlv ActivationID Exibe informações de licença detalhadas para o Windows (padrão) ou para o aplicativo que é identificado quando sua ID de Ativação é fornecida.

Por exemplo, execute o seguinte comando no prompt de comando elevado na pasta Windows\system32 para obter o status do host do Office KMS:

cscript slmgr.vbs /dlv 70512334-47B4-44DB-A233-BE5EA33B914C
/ dli ActivationID Exibe informações de licença para o Windows (padrão) ou para o aplicativo que é identificado quando sua ID de Ativação é fornecida.
/upk ActivationID Desinstala a chave de produto do Windows (padrão) ou do aplicativo que é identificado quando sua ID de Ativação é fornecida.

CUIDADO: Se você pretende desinstalar a chave do produto para o Office, por exemplo, e esquecer de inserir a ID de Ativação, todas as chaves de produto instaladas serão desinstaladas. Isso inclui a chave do produto para o Windows.
/ xpr ActivationID Exibe a data de expiração do estado da licença atual.
/ sprt PortNumber Define a porta de comunicações TCP em um computador host KMS. Ele substitui PortNumber pelo número da porta TCP a ser usado. A configuração padrão é 1688.
/Cdns Desativa a publicação DNS automática com um computador host KMS.
/ sdns Ativa a publicação DNS automática com o computador host KMS.
/ cpri Reduz a prioridade dos processos do computador host KMS.
/ sai ActivationInterval Altera a frequência com que um cliente KMS tenta se ativar quando não consegue encontrar um computador host KMS. Ele substitui ActivationInterval por um valor expresso em minutos. A configuração padrão é 120 minutos.
/ sri RenewalInterval Altera com que frequência um cliente KMS tenta renovar sua ativação contatando um computador host KMS. Ele substitui RenewalInterval por um valor expresso em minutos. A configuração padrão é 10080 minutos (7 dias). Esta configuração anula as configurações locais do cliente KMS.

Observação

  • ID de ativação para Office LTSC 2021: 47F3B983-7C53-4D45-ABC6-BCD91E2DD90A
  • ID de ativação do Office 2019: 70512334-47B4-44DB-A233-BE5EA33B914C
  • ID de ativação do Office 2016: 98EBFE73-2084-4C97-932C-C0CD1643BEA7

Slmgr.vbs opções de comando (ativação baseada no Active Directory)

A tabela a seguir mostra as opções de comando para ativar uma floresta do AD DS usando a ativação baseada no Active Directory.

Opção Descrição
/ ad-activation-online ProductKey Ativa uma floresta do AD DS por meio da chave do produto fornecida pelo usuário.
/ ad-activation-apply-get-iid ProductKey Exibe a ID de instalação da floresta do AD DS.
/ ad-activation-apply-cid ProductKeyConfirmationID Ativa uma floresta do AD DS por meio da chave do produto fornecida pelo usuário e a ID de Confirmação.

Ferramenta de Gerenciamento de Ativação por Volume (VAMT)

Ferramenta de Gerenciamento de Ativação de Volume (VAMT) fornece uma interface gráfica do usuário para gerenciar a ativação de volume. Para obter mais informações, consulte referência técnica Ferramenta de Gerenciamento de Ativação de Volume (VAMT).

Observação

Office LTSC 2021 e Office 2019 exigem pelo menos VAMT 3.1.