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

如果要使用自动脚本执行这些 Tableau Desktop 许可任务，请参阅《桌面部署指南》中的部署 Tableau Desktop(链接在新窗口中打开)。

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

您可以使用名为 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 来自动执行这些许可任务。此外，tabinstallck.exe 提供了一种方法来为未完全配置的新 Tableau Server 安装的许可步骤编写脚本。

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

注意：tabinstallck.exe 不支持脱机激活和停用。若要了解详细信息，请参见脱机激活 Tableau Server。

激活

使用 -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)