---
schema_version: "1"
id: 150b2a7537bf81906242ce7aa6352c78ed37974d02576b5df01b0179b0d80ac7
title: 自动执行许可任务
collection: tableau
version: current
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/current/zh-cn/server/license_automating.md
canonical_url: https://help.tableau.com/current/server/zh-cn/license_automating.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 93c22094227b624ecf874e44a16df3adbfb8ae4c49ba5d90970291cea22f54ab
description: Automate Tableau Server licensing tasks using command line tools and scripts.
---
[跳转到主要内容](#main-content)

# 自动执行许可任务

一些命令行选项允许您使用自动脚本执行常见的 Tableau Server 许可任务。

如果要使用自动脚本执行这些 Tableau Desktop 许可任务，请参阅《桌面部署指南》中的[部署 Tableau Desktop](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_automate.htm)。

## 命令行工具选项和更好的脚本自动化

您可以使用名为 `tabinstallck.exe` 的实用程序对服务器产品密钥的激活、刷新和停用编写脚本。`tabinstallck.exe` 安装在初始节点上的 Tableau Server \\bin 目录中。默认情况下，此目录为：

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

您也可以使用 `tsm licenses` 来执行许可任务，例如联机或脱机激活或停用 Tableau Server 产品密钥，以及获取关联文件以进行脱机激活或停用。但是，Tableau Server 必须已部署和配置。您可以使用 [Tableau 服务管理器 API](http://onlinehelp.tableau.com/v0.0/api/tsm_api/zh-cn/index.htm) 来自动执行这些许可任务。此外，`tabinstallck.exe` 提供了一种方法来为未完全配置的新 Tableau Server 安装的许可步骤编写脚本。

若要使用 `tabinstallck.exe`，需要在主 Tableau Server 节点上以管理员身份运行命令或脚本。

**注意**：`tabinstallck.exe` 不支持脱机激活和停用。若要了解详细信息，请参见[脱机激活 Tableau Server](https://help.tableau.com/current/server/zh-cn/activate_off.htm)。

## 转发代理服务器的产品密钥操作

如果已将运行 Tableau Server 的计算机配置为通过转发代理连接到 Internet，请按照[使用转发代理配置产品密钥操作](https://help.tableau.com/current/server/zh-cn/activate_proxy.htm)主题的过程进行操作，然后再尝试激活、刷新或停用产品密钥。

## 激活

使用 `-activate` 选项激活 Tableau Server 许可证：

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

## 刷新

使用 `-refresh` 选项刷新 Tableau Server 许可证：

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

## 停用

使用 `-return` 选项停用 Tableau Server 许可证：

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

## 示例

用于激活 Tableau Server 的脚本的示例可能如下所示：

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

## 错误处理

使用 `tabinstallck.exe` 自动执行 Tableau Server 许可任务时，状态信息将作为 ERRORLEVEL 环境变量中的退出代码返回。如果激活成功，退出代码为 `0`（零）。下表列出了激活过程中的退出代码及其含义。您也可以在 `tabinstallck.log` 文件中找到错误信息。默认情况下，此日志文件位于 Tableau Server \\logs 文件夹中：

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

ProgramData 文件夹默认情况下处于隐藏状态。

此示例脚本显示了如何激活 Tableau Server 并检查特定错误，例如无效的产品密钥 (536871018) 和一般许可问题 (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>退出代码</th><th>消息</th><th>值</th></tr><tr><td><code>536871012</code></td><td><code>TABLEAU_ERROR_LICENSING_GENERAL</code></td><td>许可操作过程中发生未知错误。</td></tr><tr><td><code>536871013</code></td><td><code>TABLEAU_ERROR_LICENSING_INTERNAL</code></td><td>产品由于内部许可错误而无法启动。</td></tr><tr><td><code>536871014</code></td><td><code>TABLEAU_ERROR_LICENSING_SETUP</code></td><td>产品由于内部许可错误而无法启动。</td></tr><tr><td><code>536871015</code></td><td><code>TABLEAU_ERROR_LICENSING_CONNECT</code></td><td>与 Tableau 许可证服务器联系时出错。</td></tr><tr><td><code>536871017</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_ASR</code></td><td>激活 ASR 时出错。</td></tr><tr><td><code>536871016</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_GENERAL</code></td><td>激活失败，请重试。</td></tr><tr><td><code>536871018</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_KEY</code></td><td>产品密钥无效。</td></tr><tr><td><code>536871019</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_OFFLINE</code></td><td>无法完成脱机激活。</td></tr><tr><td><code>536871020</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_MODEL</code></td><td>许可服务器返回了错误。请检查 Tableau 日志文件以了解详细信息。</td></tr><tr><td><code>536871021</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_REHOSTS</code></td><td>由于已达到此许可证的停用次数限制，因此未能停用许可证。</td></tr><tr><td><code>536871033</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_EXTRA_ACTIVATIONS</code></td><td>由于已达到此许可证的激活次数限制，因此未能激活许可证。</td></tr><tr><td><code>536871022</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_GENERAL</code></td><td>取消许可操作过程中发生未知错误。请检查产品密钥或与支持人员联系。</td></tr><tr><td><code>536871023</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_NONE_FOUND</code></td><td>找不到许可证。</td></tr><tr><td><code>536871024</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED</code></td><td>只找到过期的产品密钥。</td></tr><tr><td><code>536871025</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_TRIAL</code></td><td>此版本的试用期已结束。</td></tr><tr><td><code>536871026</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_SUBSCRIPTION</code></td><td>产品密钥已过期。</td></tr><tr><td><code>536871027</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_MAINTENANCE</code></td><td>维护已过期。</td></tr><tr><td><code>536871028</code></td><td><code>TABLEAU_ERROR_LICENSING_RESYNC_GENERAL</code></td><td>无法同步产品密钥。</td></tr><tr><td><code>536871029</code></td><td><code>TABLEAU_ERROR_LICENSING_REGISTRATION_GENERAL</code></td><td>产品注册过程中出错。</td></tr><tr><td><code>536871030</code></td><td><code>TABLEAU_ERROR_LICENSING_SERVICE_INSTALL</code></td><td>许可操作过程中发生未知错误。</td></tr><tr><td><code>536871031</code></td><td><code>TABLEAU_ERROR_LICENSING_SERVICE_UNINSTALL</code></td><td>许可操作过程中发生未知错误。</td></tr><tr><td><code>536871032</code></td><td><code>TABLEAU_ERROR_LICENSING_SERVICE_NOT_PRESENT</code></td><td>系统中不存在 FLEXnet 许可服务。</td></tr></tbody></table>