---
schema_version: "1"
id: 2a61cdca64b8e92cb50453fd9899ff238f8893f2ebf23dda5eac9bbefeaa8f66
title: Automatizar tarefas de licenciamento
collection: tableau
version: current
locale: pt-br
portal_url: https://docs.salesforce.com/tableau/current/pt-br/server/license_automating.md
canonical_url: https://help.tableau.com/current/server/pt-br/license_automating.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 606ef2a3d09eeee91fdad22850a7995b8db9c1bcd5f69095465ea12523aa35dc
description: Automate Tableau Server licensing tasks using command line tools and scripts.
---
[Pular para o conteúdo principal](#main-content)

# Automatizar tarefas de licenciamento

Várias opções de linha de comando permitem realizar as tarefas comuns de licenciamento do Tableau Server com scripts automatizados.

Se você desejar executar essas tarefas de licenciamento do Tableau Desktop com scripts automatizados, consulte [Implantar o Tableau Desktop](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_automate.htm) no Guia de implantação do Desktop.

## Opções da ferramenta de linha de comando e uma melhor automação do script

É possível usar um utilitário chamado `tabinstallck.exe` para criar scripts de ativação, atualização e desativação das chaves do produto do servidor. `tabinstallck.exe` é instalado no diretório \\bin do Tableau Server no nó inicial. Por padrão, ele é:

`C:\Program Files\Tableau\Tableau Server\packages\bin.<version_code>`

Também é possível usar `tsm licenses` para executar tarefas de licenciamento, como ativar ou desativar uma chave do produto do Tableau Server on-line ou off-line e obter arquivos relacionados para ativação ou desativação off-line. No entanto, Tableau Server já deve estar implantado e configurado. Automatize essas tarefas de licenciamento usando a [API do Gerenciador de serviços do Tableau](http://onlinehelp.tableau.com/v0.0/api/tsm_api/pt-br/index.htm). Além disso, `tabinstallck.exe` oferece uma maneira de fazer o script da etapa de licenciamento de uma nova instalação do Tableau Server que não está totalmente configurada.

Para usar `tabinstallck.exe`, execute os comandos ou crie scripts como um administrador no nó do Tableau Server primário.

**Observação**: o `tabinstallck.exe` não é compatível com ativação e desativação off-line. Para saber mais, consulte [Ativar o Tableau Server off-line](https://help.tableau.com/current/server/pt-br/activate_off.htm).

## Operações da chave do produto com servidores proxy de encaminhamento

Se o computador onde estiver executando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm), antes de tentar ativar, atualizar ou desativar chaves do produto.

## Ativar

Ative uma licença do Tableau Server com a opção `-activate`:

start/wait tabinstallck.exe -activate <product\_key>

## Atualizar

Atualize uma licença do Tableau Server com a opção `-refresh`:

start/wait tabinstallck.exe -refresh <product\_key>

## Desativar

Desative uma licença do Tableau Server com a opção `-return`:

start/wait tabinstallck.exe -return <product\_key>

## Exemplo

Veja o exemplo de um script para ativar o Tableau Server:

@echo off
start/wait tabinstallck.exe -activate <product\_key>
if %errorlevel% EQU 0 (ECHO SUCCESS) ELSE (ECHO FAILED)

## Solução do Erro

Quando você usa `tabinstallck.exe` para automatizar tarefas de licenciamento do Tableau Server, as informações de status são retornadas como um código de saída na variável de ambiente ERRORLEVEL. Se a ativação tiver êxito, o código de saída será `0` (zero). A tabela abaixo lista os códigos de saída do processo de ativação e os respectivos significados. Você também pode encontrar informações de erros no arquivo `tabinstallck.log`. Esse arquivo de log está na pasta \\logs do Tableau Server, por padrão:

`C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\`

A pasta ProgramData fica oculta por padrão.

Este script de exemplo mostra como ativar o Tableau Server e verificar se há erros específicos, como uma chave de produto inválida (536871018) e problemas de licenciamento gerais (536871012).

@echo off
start/wait tabinstallck.exe -activate  _<product\_key>_
if %errorlevel% EQU 536871018 (ECHO TABLEAU\_ERROR\_LICENSING\_INVALID\_KEY)
if %errorlevel% EQU 536871012 (ECHO TABLEAU\_ERROR\_LICENCING\_GENERAL)
if %errorlevel% EQU 0 (ECHO SUCCESS)

<table class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><th>Código de saída</th><th>Mensagem</th><th>Valor</th></tr><tr><td><code>536871012</code></td><td><code>TABLEAU_ERROR_LICENSING_GENERAL</code></td><td>Ocorreu um erro desconhecido durante a operação de licenciamento.</td></tr><tr><td><code>536871013</code></td><td><code>TABLEAU_ERROR_LICENSING_INTERNAL</code></td><td>O produto não pode ser iniciado devido a um erro de licenciamento interno.</td></tr><tr><td><code>536871014</code></td><td><code>TABLEAU_ERROR_LICENSING_SETUP</code></td><td>O produto não pode ser iniciado devido a um erro de licenciamento interno.</td></tr><tr><td><code>536871015</code></td><td><code>TABLEAU_ERROR_LICENSING_CONNECT</code></td><td>Erro ao entrar em contato com o servidor de licenças do Tableau.</td></tr><tr><td><code>536871017</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_ASR</code></td><td>Erro ao ativar o ASR.</td></tr><tr><td><code>536871016</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_GENERAL</code></td><td>Falha na ativação, tente novamente.</td></tr><tr><td><code>536871018</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_KEY</code></td><td>Chave do produto inválida.</td></tr><tr><td><code>536871019</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_OFFLINE</code></td><td>Não é possível concluir a ativação offline.</td></tr><tr><td><code>536871020</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_MODEL</code></td><td>Um erro foi retornado do servidor de licenças. Verifique o arquivo de registro do Tableau para obter mais informações.</td></tr><tr><td><code>536871021</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_REHOSTS</code></td><td>Falha ao desativar a licença porque você chegou ao limite de desativações dessa licença.</td></tr><tr><td><code>536871033</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_EXTRA_ACTIVATIONS</code></td><td>Falha ao ativar a licença porque você chegou ao limite de ativações dessa licença.</td></tr><tr><td><code>536871022</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_GENERAL</code></td><td>Ocorreu um erro desconhecido durante a operação de desativação do licenciamento. Verifique sua chave de produto ou entre em contato com o suporte.</td></tr><tr><td><code>536871023</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_NONE_FOUND</code></td><td>Nenhuma licença encontrada.</td></tr><tr><td><code>536871024</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED</code></td><td>Somente chaves de produto expiradas foram encontradas.</td></tr><tr><td><code>536871025</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_TRIAL</code></td><td>Sua avaliação dessa versão terminou.</td></tr><tr><td><code>536871026</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_SUBSCRIPTION</code></td><td>A chave de produto expirou.</td></tr><tr><td><code>536871027</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_MAINTENANCE</code></td><td>A manutenção expirou.</td></tr><tr><td><code>536871028</code></td><td><code>TABLEAU_ERROR_LICENSING_RESYNC_GENERAL</code></td><td>Não foi possível sincronizar suas chaves de produto.</td></tr><tr><td><code>536871029</code></td><td><code>TABLEAU_ERROR_LICENSING_REGISTRATION_GENERAL</code></td><td>Ocorreu um erro durante o registro do produto.</td></tr><tr><td><code>536871030</code></td><td><code>TABLEAU_ERROR_LICENSING_SERVICE_INSTALL</code></td><td>Ocorreu um erro desconhecido durante as operações de licenciamento.</td></tr><tr><td><code>536871031</code></td><td><code>TABLEAU_ERROR_LICENSING_SERVICE_UNINSTALL</code></td><td>Ocorreu um erro desconhecido durante as operações de licenciamento.</td></tr><tr><td><code>536871032</code></td><td><code>TABLEAU_ERROR_LICENSING_SERVICE_NOT_PRESENT</code></td><td>O serviço de licenciamento FLEXnet não está presente no sistema.</td></tr></tbody></table>