tabcmd
注意：
Tableau 提供了 tabcmd 命令行实用工具，您可以使用它在 Tableau Server 站点上自动完成站点管理任务。例如，创建或删除用户、项目和组。
注意：在 2024.1 之前的 Tableau 版本中，tabcmd 版本 1 不适用于导出可视化项。
注意：tabcmd 实用工具随 Tableau Server 一起提供，并将自动安装在服务器节点上。但未包括其安装程序，因此，如果要在不是 Tableau Server 安装一部分的计算机上运行 tabcmd，您需要从 Tableau 网站下载安装程序。有关详细信息，请参见下面的安装 tabcmd。
安装 tabcmd
注意：这些说明用于安装 tabcmd 1.0 命令行实用程序。若要安装 tabcmd 2.0 命令行实用程序，请转到 Tableau tabcmd(链接在新窗口中打开)（新窗口）。
将 Tableau Server 或 Tableau Cloud 升级到新版本时，如果需要 tabcmd 的更新版本，您可以从 Tableau 网站上“Tableau Server 版本”页面下载该版本。
对于 Tableau Server：我们建议下载择与您的服务器版本匹配的版本。对于 Tableau Cloud，我们建议您始终下载最新版本，以避免版本不兼容导致的问题。在任一情况下，使用 tabcmd 的过时版本可能会导致错误和不可预知的结果。
打开 Web 浏览器并转到 Tableau Server 版本(链接在新窗口中打开)页面。即使您使用 Tableau Online，也转到此页面。
如果您使用的是：
- Tableau Cloud，请使用 Tableau tabcmd 2.0(链接在新窗口中打开)（新窗口）。
- Tableau Server（Windows 或 Linux）：请选择与您的服务器版本匹配的版本。
在任一情况下，如果展开的信息显示维护版本，请选择最新维护版本，或选择与您的服务器版本匹配的维护版本。
这将带您进入发行说明页面（名为“已解决问题”），您可以在其中阅读有关安全改进和已解决问题的信息。
滚动到已解决问题下的“下载文件”部分，选择与您将从中运行 tabcmd 命令的计算机兼容的 tabcmd 下载链接。
其余步骤将此计算机称为“tabcmd 计算机”。
将安装程序保存到 tabcmd 计算机，或保存到可从该计算机访问的位置。
完成适合于 tabcmd 计算机操作系统的安装步骤：
- Windows
默认情况下，tabcmd 安装到
C:\Program Files\Tableau\Tableau Server\<version>\extras\Command Line Utility。您可以在安装过程中更改此项，并建议将 tabcmd 安装到 C:\ 驱动器 (C:\tabcmd) 根目录处名为tabcmd的文件夹中。这可以使查找和运行更加容易，并且如果将 tabcmd 目录添加到 Windows PATH，则它适应 Windows 操作系统的一些限制。注意 tabcmd 安装程序不会向 Windows PATH 变量添加 tabcmd 目录。您可以手动添加它，也可以在每次调用 tabcmd 时包含其完整路径。
您可以通过两种方式在 Windows 上安装 tabcmd：
双击安装程序，按照 UI 中的步骤进行操作：
接受许可协议。
如果要安装到非默认位置，请单击“自定义”，并键入或浏览到要将 tabcmd 安装到的位置。
单击“安装”。
如果 Windows Defender 防火墙或用户帐户控制提示，请单击“允许访问”。
从命令提示符中运行安装程序：
在 tabcmd 计算机上以管理员身份打开命令提示符。
导航到在其中复制了 tabcmd 安装程序的目录。
安装 tabcmd：
tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1
安装到非默认位置：
tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="<path\to\install\directory>"
例如：
tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="C:\tabcmd"
有关可用于 tabcmd 安装程序的命令行选项的完整列表，请使用 a /? 运行安装程序。有关 tabcmd 安装程序命令行选项的详细信息，请参见tabcmd 的安装开关和属性 (Windows)。
Tabcmd 安装程序会在
C:\Users\<user>\AppData\Local\Temp中创建日志，如果安装 tabcmd 时出现问题，您可以使用这些日志。日志使用命名约定Tableau_Server_Command_Line_Utility_(<version_code>)_##############.log。 - Linux
注意：若要在 Linux 计算机上运行 tabcmd，您必须安装 Java 11。在类似 RHEL 的系统上，Java 11 将在您安装 tabcmd 时作为依赖项安装。在 Ubuntu 系统上，如果 Java 11 尚未安装，则需要单独安装。
自 2022 年 7 月起，不再支持 Debian 发行版。有关详细信息，请参见此 Tableau 社区(链接在新窗口中打开)。以具有 sudo 访问权限的用户身份登录到 tabcmd 计算机。
导航到您将所下载的
.rpm或.deb软件包复制到的目录。在类似于 RHEL 的分发（包括 CentOS）上，运行以下命令：
sudo yum install tableau-tabcmd-<version>.noarch.rpm在 Ubuntu 上，运行以下命令：
sudo apt-get install ./tableau-tabcmd-<version>_all.deb
若要从 Linux 计算机中卸载 tabcmd，请参见适用于正在运行的 Linux 版本的文档。
（可选）将安装 tabcmd 的完全限定位置添加到系统路径中，以允许您运行 tabcmd 命令，而无需更改到该位置，或为每个命令指定位置。执行此操作的步骤取决于操作系统的类型和版本。有关详细信息，请参见 PATH（变量）。
如何使用 tabcmd
使用 tabcmd 的基本步骤如下：
以管理员身份打开命令提示符。
注意：在 Windows 上，请勿使用 PowerShell 运行 tabcmd 命令。使用 PowerShell 可能会导致意外行为。
在 Windows 计算机上，如果在不是初始节点的计算机上安装了 tabcmd，请切换到安装了 tabcmd 的目录。
在 Linux 计算机上，您无需切换到安装目录。
运行 tabcmd 命令。
在使用 tabcmd 时，您必须建立经过身份验证的服务器会话。会话会识别服务器或 Tableau Cloud 站点以及运行该会话的用户。您可以先启动会话，然后指定命令，或者在启动会话的同时执行命令。
重要信息：如果您要使用 tabcmd 执行多项任务，则必须依次（连续）运行任务，而非同时（并行）运行。
命令（例如 login）和选项（例如 -s、-u 等）不区分大小写，但您提供的值（例如 User@Example.com）区分大小写。
示例
下面的命令演示了如何对名为 tabserver.mycompany.com 的 Tableau Server 启动会话：
tabcmd login -s http://tabserver.mycompany.com -u admin -p mypassword
下一个示例演示用于删除名为 Sales_Workbook 的工作簿的命令：
tabcmd delete "Sales_Workbook"
下面介绍了如何用一条命令完成上述所有操作，请注意此处不需要 login：
tabcmd delete "Sales_Workbook" -s http://tabserver.mycompany.com -u admin -p mypassword
一个 Tableau Server 可以运行多个站点。当工作簿运行在多站点服务器的 Default 站点上时，不需要指定 Default，上述命令已足够。但是，如果命令应用于 Default 之外的站点，则需要指定该站点的站点 ID（请参见login）。下面是用于 West Coast Sales 站点上的一个工作簿的命令（站点 ID wsales）：
tabcmd delete "Sales_Workbook" -s http://tabserver.mycompany.com -t wsales -u admin -p mypassword
选项 -s、-t、-u 和 -p 是 tabcmd 的全局变量，可与任何命令一起使用。
有关详细信息，请参见 tabcmd 命令。