tabcmd

Tableau 提供了 tabcmd 命令行实用工具，您可以使用它在 Tableau Server 站点上自动完成站点管理任务。例如，创建或删除用户、项目和组。

注意：tabcmd 实用工具随 Tableau Server 一起提供，并将自动安装在服务器节点上。但未包括其安装程序，因此，如果要在不是 Tableau Server 安装一部分的计算机上运行 tabcmd，您需要从 Tableau 网站下载安装程序。有关详细信息，请参见下面的安装 tabcmd。

安装 tabcmd

将 Tableau Server 或 Tableau Online 升级到新版本时，如果需要 tabcmd 的更新版本，您可以从 Tableau 网站上“Tableau Server 版本”页面下载该版本。

对于 Tableau Server：我们建议下载择与您的服务器版本匹配的版本。对于 Tableau Online，我们建议您始终下载最新版本，以避免版本不兼容导致的问题。在任一情况下，使用 tabcmd 的过时版本可能会导致错误和不可预知的结果。

1. 打开 Web 浏览器并转到 Tableau Server 版本(链接在新窗口中打开)页面。即使您使用 Tableau Online，也转到此页面。

2. 如果您使用的是：

   在任一情况下，如果展开的信息显示维护版本，请选择最新维护版本，或选择与您的服务器版本匹配的维护版本。

   

   这将带您进入发行说明页面（名为“已解决问题”），您可以在其中阅读有关安全改进和已解决问题的信息。

• Tableau Online：请选择最新的 Tableau Server 版本。

• Tableau Server（Windows 或 Linux）：请选择与您的服务器版本匹配的版本。

3. 滚动到已解决问题下的“下载文件”部分，选择与您将从中运行 tabcmd 命令的计算机兼容的 tabcmd 下载链接。

   

   其余步骤将此计算机称为“tabcmd 计算机”。

4. 将安装程序保存到 tabcmd 计算机，或保存到可从该计算机访问的位置。

5. 完成适合于 tabcmd 计算机操作系统的安装步骤：

   若要从 Linux 计算机中卸载 tabcmd，请参见适用于正在运行的 Linux 版本的文档。

• 在类似于 RHEL 的分发（包括 CentOS）上，运行以下命令：

  sudo yum install tableau-tabcmd-

• 在 Ubuntu 和 Debian 上，运行以下命令：

  sudo apt-get install ./tableau-tabcmd-

• 双击安装程序，按照 UI 中的步骤进行操作：

• 从命令提示符中运行安装程序：

• Windows

  默认情况下，tabcmd 安装到 C:\Program Files\Tableau\Tableau Server\。您可以在安装过程中更改此项，并建议将 tabcmd 安装到 C:\ 驱动器 (C:\tabcmd) 根目录处名为 tabcmd 的文件夹中。这可以使查找和运行更加容易，并且如果将 tabcmd 目录添加到 Windows PATH，则它适应 Windows 操作系统的一些限制。

  注意 tabcmd 安装程序不会向 Windows PATH 变量添加 tabcmd 目录。您可以手动添加它，也可以在每次调用 tabcmd 时包含其完整路径。

  您可以通过两种方式在 Windows 上安装 tabcmd：

  Tabcmd 安装程序会在 C:\Users\ 中创建日志，如果安装 tabcmd 时出现问题，您可以使用这些日志。日志使用命名约定 Tableau_Server_Command_Line_Utility_(。

• Linux

  注意：若要在 Linux 计算机上运行 tabcmd，您必须安装 Java 11。在类似 RHEL 的系统上，Java 11 将在您安装 tabcmd 时作为依赖项安装。在类似 Debian 的系统上，如果 Java 11 尚未安装，则需要单独安装。

1. 以具有 sudo 访问权限的用户身份登录到 tabcmd 计算机。

2. 导航到您将所下载的 .rpm 或 .deb 软件包复制到的目录。

3. 接受许可协议。

4. 如果要安装到非默认位置，请单击“自定义”，并键入或浏览到要将 tabcmd 安装到的位置。

5. 单击“安装”。

   如果 Windows Defender 防火墙或用户帐户控制提示，请单击“允许访问”。

6. 在 tabcmd 计算机上以管理员身份打开命令提示符。

7. 导航到在其中复制了 tabcmd 安装程序的目录。

8. 安装 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)。

6. （可选）将安装 tabcmd 的完全限定位置添加到系统路径中，以允许您运行 tabcmd 命令，而无需更改到该位置，或为每个命令指定位置。执行此操作的步骤取决于操作系统的类型和版本。有关详细信息，请参见 PATH（变量）。

如何使用 tabcmd

使用 tabcmd 的基本步骤如下：

1. 以管理员身份打开命令提示符。

2. 在 Windows 计算机上，如果在不是初始节点的计算机上安装了 tabcmd，请切换到安装了 tabcmd 的目录。

   在 Linux 计算机上，您无需切换到安装目录。

3. 运行 tabcmd 命令。

在使用 tabcmd 时，您必须建立经过身份验证的服务器会话。会话会识别服务器或 Tableau Online 站点以及运行该会话的用户。您可以先启动会话，然后指定命令，或者在启动会话的同时执行命令。

重要信息：如果您要使用 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 命令。

状态消息和日志

当命令成功执行时，tabcmd 将返回零状态代码。对于非零状态代码，将向 stderr 打印完整错误消息。此外，还可向 stdout 打印信息性消息或进度消息。

会将一个名为 tabcmd.log 并包括调试、进度和错误消息的完整日志写入 C:\Users\。

此部分中的其他文章

• tabcmd 命令

您可以通过 tabcmd 命令行工具使用以下命令：

addusers（至组）
createextracts
creategroup
createproject
createsite
createsiteusers
createusers
decryptextracts
delete workbook-name 或 datasource-name
deleteextracts
deletegroup
deleteproject
deletesite
deletesiteusers
deleteusers
editdomain
editsite
encryptextracts
export
get url
initialuser
listdomains
listsites
login
logout
publish
publishsamples
reencryptextracts
refreshextracts
removeusers
reset_openid_sub
runschedule
set
syncgroup
upgradethumbnails
validateidpmetadata
version

addusers group-name

将用户添加到指定的组。

示例

tabcmd addusers "Development" --users "users.csv"

选项

• --users

• 将给定 .csv 文件中的用户添加到指定组中。该文件应是每行一个用户名的简单列表。用户名不区分大小写。用户应已在 Tableau Server 上创建。

  如果在 Tableau Server 上将此命令用于大型 .csv 文件，则服务器管理员可启用帮助改善性能的设置。

  有关详细信息，请参见 CSV 导入文件准则。

• --[no-]complete

• 当设置为 complete 时，此选项要求所有行都必须有效，更改才能成功。如果未指定，则使用 --complete。

全局选项

createextracts

为已发布工作簿或数据源创建数据提取

选项

• -d, --datasource

• 数据提取创建的目标数据源的名称。

• --embedded-datasources

• 目标工作簿内嵌入的数据源名称的空格分隔列表。如果数据源名称包含空格，请用双引号括起来。仅在为工作簿创建数据提取时可用。

• --encrypt

• 创建加密数据提取

• --include-all

• 在目标工作簿内包括所有嵌入数据源仅在为工作簿创建数据提取时可用。

• --parent-project-path

• 作为包含目标资源的项目的父级的项目的路径。必须使用 -project 指定项目名称。

• --project

• 包含目标资源的项目的名称。仅当指定了 --workbook 或 --datasource 时才需要。如果未指定，则使用默认项目“默认”。

• -u, -url

• 显示在 URL 中的资源的规范名称。

• -w, -workbook

• 用于创建数据提取的目标工作簿的名称。

全局选项

creategroup group-name

创建一个组。使用 addusers 命令（适用于本地组）和 syncgroup（适用于 Active Directory 组）在创建组之后添加用户。

示例

tabcmd creategroup "Development"

全局选项

createproject project-name

创建一个项目。

示例

tabcmd createproject -n "Quarterly_Reports" -d "Workbooks showing quarterly sales reports."

选项

• -n, --name

• 指定要创建的项目的名称。

• --parent-project-path

• 指定使用 -n 选项指定的嵌套项目的父项目的名称。例如，若要指定“Main”项目中名为“Nested”的项目，请使用以下语法： --parent-project-path "Main" -n "Nested"。

• -d, --description

• 为项目指定说明。

全局选项

createsite site-name

创建一个站点。

示例

创建名为“West Coast Sales”的站点。系统会自动创建站点 ID WestCoastSales，该站点没有存储配额限制，且站点管理员可以添加和移除用户：

tabcmd createsite "West Coast Sales"

使用 wsales 的站点 ID 创建名为 West Coast Sales 的站点：

tabcmd createsite "West Coast Sales" -r "wsales"

阻止站点管理员向站点添加用户：

tabcmd createsite "West Coast Sales" --no-site-mode

设置存储配额（以 MB 为单位）：

tabcmd createsite "West Coast Sales" --storage-quota 100

选项

• -r, --url

• 在网址中使用以指定站点。不同于站点名称。

• --user-quota

• 添加到该站点的用户的最大数量。

• --[no-]site-mode

• 允许或拒绝站点管理员向站点添加用户或从中移除用户。

• --storage-quota

• 站点上可存储的工作簿、数据提取和数据源的数量，以 MB 为单位。

• --extract-encryption-mode

• 站点的数据提取加密模式可以为“强制”、“已启用”或“已禁用”。有关详细信息，请参见静态数据提取加密。

• --run-now-enabled

• 允许或拒绝用户手动运行数据提取刷新、流程或计划。设置为 true 以允许用户手动运行任务，或设置为 false 以防止用户手动运行任务。 有关详细信息，请参见服务器设置（常规和自定义）。

全局选项

createsiteusers filename.csv

根据逗号分隔值 (CSV) 文件中提供的信息将用户添加到站点。如果尚未在服务器上创建用户，该命令会在将用户添加到站点之前创建该用户。

CSV 文件必须包含一个或多个用户名，还可（为每个用户）包括一个密码、全名、许可证类型、管理员级别、发布者（是/否），以及电子邮件地址。有关 CSV 文件的格式的信息，请参见CSV 导入文件准则。

作为在 CSV 文件中包括管理员级别和发布者权限的替代方法，您可以通过包括 --role 选项并指定要为 CSV 文件中列出的用户分配的站点角色来传递访问级别信息。

默认情况下，用户将添加到您登录到的站点。若要将用户添加到其他站点，请包括全局 --site 选项并指定该站点。（您必须具有在指定的站点上创建用户的权限。）

如果服务器包含多个站点，则无法通过 createsiteusers 命令添加服务器（系统）管理员。请改用 createusers。如果为 --role 选项指定 ServerAdministrator 站点角色，则命令将返回错误。如果 CSV 文件包括 System 作为 administrator 的值，则该值将被忽略，并且会为用户分配 Unlicensed 许可证类型。

如果服务器只包含一个站点（默认站点），您可以为用户的 administrator 值指定 system，或者，如果希望 CSV 文件中的所有用户都成为服务器管理员，您甚至可以使用 --role 选项分配 ServerAdministrator 站点角色。

默认情况下，此命令使用同步操作创建用户（它将等待所有操作完成才会继续）。您可以使用 --no-wait 选项指定异步操作。

改善大型 CSV 文件的性能

服务器管理员可以使用 tabadmin set 命令启用设置，帮助改善大型 CSV 文件的性能。有关详细信息，请参见“CSV 导入文件准则”主题中的提高通过 tabcmd 传递的大型 CSV 文件的性能。

本地身份验证

如果服务器配置为使用本地身份验证，则使用 CSV 文件中的信息创建用户。

Active Directory 身份验证

如果服务器配置为使用 Active Directory 身份验证，则会从 Active Directory 导入用户信息，并忽略 CSV 文件中的密码和友好名称信息。此外，如果 CSV 文件中指定了用户，但 Active Directory 中没有相应的用户，则不会将该用户添加到 Tableau Server。对于 Active Directory 用户，由于不能保证用户名在域之间的唯一性，因此必须包括域作为用户名的一部分。您可以将此项指定为 domain\username 或 username@domain.com；但是，我们建议使用 domain\username 格式。有关详细信息，请参见使用外部身份存储的部署中的用户管理。

示例

tabcmd createsiteusers "users.csv" --role "Explorer"

选项

• --admin-type

• 已弃用。请改用 --role 选项。

• --auth-type

• 为 .csv 文件中的所有用户设置身份验证类型（Local 或 SAML）。如果未指定，则默认值为 Local。

  注意：若要使用 SAML 身份验证，必须在 Tableau Server 设置中针对特定于站点的 SAML 配置站点。有关信息，请参见配置特定于站点的 SAML。

• --[no-]complete

• 已弃用。默认错误行为：如果在十行范围内有 3 个以上的错误，则命令将失败。

• --no-publisher

• 已弃用。请改用 --role 选项。

• --nowait

• 不等待异步作业完成。

• --publisher

• 已弃用。请改用 --role 选项。

• --role

• 为 .csv 中的所有用户指定站点角色。如果要使用 --role 选项分配站点角色，请为每个站点角色创建单独的 CSV 文件。

  有效的值包括：ServerAdministrator、SiteAdministratorCreator、SiteAdministratorExplorer、SiteAdministrator、Creator、ExplorerCanPublish、Publisher、Explorer、Interactor、Viewer 和 Unlicensed。

  对于新用户，默认值为 Unlicensed，对于现有用户，默认值不变。如果有基于用户的服务器安装，并且在 createsiteusers 命令创建新用户的情况下您已达到用户许可证数的限制，则会以未许可用户的形式添加该用户。

  注意：在多站点 Tableau Server 上，如果要使用 --role 选项分配 ServerAdministrator 站点角色，请使用 createusers 命令，而不是 createsiteusers。

• --silent-progress

• 不显示命令的进度消息。

全局选项

createusers filename.csv

基于逗号分隔值 CSV 文件中提供的信息在 Tableau Server 中创建用户。

CSV 文件必须包含一个或多个用户名，还可（为每个用户）包括一个密码、全名、许可证类型、管理员级别、发布者（是/否），以及电子邮件地址。有关 CSV 文件的格式的信息，请参见CSV 导入文件准则。

作为在 CSV 文件中包括管理员级别和发布者权限的替代方法，您可以通过包括 --role 选项并指定要为 CSV 文件中列出的用户分配的站点角色来传递访问级别信息。

如果服务器只有一个站点（默认站点），则会创建用户并将其添加到站点。如果服务器有多个站点，则会创建用户，但不会将其添加到任何站点。若要将用户添加到站点，请使用 createsiteusers。

如果有基于用户的服务器安装，并且在命令创建新用户的情况下您已达到用户许可证数的限制，则会在未许可用户的形式添加该用户。

本地身份验证

如果服务器配置为使用本地身份验证，则使用 CSV 文件中的信息创建用户。

Active Directory 身份验证

如果服务器配置为使用 Active Directory 身份验证，则会从 Active Directory 导入用户信息，并忽略 CSV 文件中的密码和友好名称信息。此外，如果 CSV 文件中指定了用户，但 Active Directory 中没有相应的用户，则不会将该用户添加到 Tableau Server。对于 Active Directory 用户，由于不能保证用户名在域之间的唯一性，因此必须包括域作为用户名的一部分。您可以将此项指定为 domain\username 或 username@domain.com；但是，我们建议使用 domain\username 格式。有关详细信息，请参见使用外部身份存储的部署中的用户管理。

示例

tabcmd createusers "users.csv" --role "ServerAdministrator"

tabcmd createusers "users.csv"

选项

• --admin-type

• 已弃用。请改用 --role 选项。

• --[no-]complete

• 已弃用。默认错误行为：如果在十行范围内有 3 个以上的错误，则命令将失败。

• --no-publisher

• 已弃用。请改用 --role 选项。

• --nowait

• 不等待异步作业完成。

• --publisher

• 已弃用。请改用 --role 选项。

• -r, --role

• 为 .csv 中的所有用户指定站点角色。如果要使用 --role 选项分配站点角色，请为每个站点角色创建单独的 CSV 文件。

  有效的值包括：ServerAdministrator、SiteAdministratorCreator、SiteAdministratorExplorer、SiteAdministrator、Creator、ExplorerCanPublish、Publisher、Explorer、Interactor、Viewer 和 Unlicensed。

  在多站点服务器上，该命令不会将用户分配到站点。因此，该命令可成功分配的唯一站点角色是 ServerAdministrator 和 Unlicensed。如果指定任何其他站点角色，则该命令会分配 Unlicensed 角色。

  在单站点服务器上，将使用您指定的角色创建用户并将其添加到默认站点。

  如果有基于用户的服务器安装，并且在命令创建新用户的情况下您已达到用户许可证数的限制，则会在未许可用户的形式添加该用户。

• --silent-progress

• 不显示命令的进度消息。

全局选项

decryptextracts

对站点上的所有数据提取进行解密。如果未指定任何站点，则将对默认站点上的数据提取进行解密。有关详细信息，请参见静态数据提取加密。

根据数据提取的数量和大小，此操作可能会消耗大量服务器资源。请考虑在正常工作时间之外运行此命令。

示例

tabcmd decryptextracts "West Coast Sales"

全局选项

delete workbook-name 或 datasource-name

从服务器中删除指定工作簿或数据源。

此命令按原样使用服务器上的工作簿或数据源的名称，而不是发布时的文件名。

示例

tabcmd delete "Sales_Analysis"

选项

• -r, --project

• 包含您要删除的工作簿或数据源的项目的名称。如果未指定，则使用“Default”项目。

• --parent-project-path

• 指定使用 -r 选项指定的嵌套项目的父项目的名称。例如，若要指定“Main”项目中名为“Nested”的项目，请使用以下语法： --parent-project-path "Main" -r "Nested"。

• --workbook

• 要删除的工作簿的名称。

• --datasource

• 要删除的数据源的名称。

全局选项

deleteextracts

为已发布工作簿或数据源删除数据提取。

选项

• -d, --datasource

• 用于数据提取删除的目标数据源的名称。

• --embedded-datasources

• 目标工作簿内嵌入的数据源名称的空格分隔列表。如果数据源名称包含空格，请用双引号括起来。仅在删除工作簿的数据提取时可用。

• --encrypt

• 创建加密数据提取

• --include-all

• 在目标工作簿内包括所有嵌入数据源

• --parent-project-path

• 作为包含目标资源的项目的父级的项目的路径。必须使用 -project 指定项目名称。

• --project

• 包含目标资源的项目的名称。仅当指定了 --workbook 或 --datasource 时才需要。如果未指定，则使用默认项目“默认”。

• -u, -url

• 显示在 URL 中的资源的规范名称。

• -w, -workbook

• 用于数据提取删除的目标工作簿的名称。

全局选项

deletegroup group-name

从服务器中删除指定的组。

示例

tabcmd deletegroup "Development"

全局选项

deleteproject project-name

从服务器中删除指定的项目。

使用 tabcmd，您可以仅指定项目分层结构中的顶层项目。若要自动执行想要对父项目内的项目执行的任务，请使用等效的 Tableau REST API(链接在新窗口中打开) 调用。

示例

tabcmd deleteproject "Designs"

选项

• --parent-project-path

• 指定使用命令指定的嵌套项目的父项目的名称。例如，若要指定“Main”项目中名为“Designs”的项目，请使用以下语法： --parent-project-path "Main" "Designs"。

全局选项

deletesite site-name

从服务器中删除指定的站点。

示例

tabcmd deletesite "Development"

全局选项

deletesiteusers filename.csv

从您登录到的站点中移除用户。要移除的用户在一个文件中指定，该文件包含每行一个用户名的简单列表。（除用户名之外不需要其他信息。）

默认情况下，如果服务器只有一个站点，或者用户只属于一个站点，则还会从服务器中移除用户。在 Tableau Server Enterprise 安装上，如果服务器包含多个站点，则会从站点中移除分配了“服务器管理员”站点角色的用户，但不会从服务器中移除这些用户。

如果用户拥有内容，则用户的角色将变为“未许可”，但不会从服务器或站点中移除用户。内容仍然由该用户拥有。若要完全移除用户，您必须更改内容的所有者，然后再次尝试移除用户。

如果用户是从 Active Directory 导入的，则会从站点中移除用户，并可能会从服务器中将其移除。但是，不会将用户从 Active Directory 中删除。

示例

tabcmd deletesiteusers "users.csv"

改善大型 CSV 文件的性能

服务器管理员可以使用 tabadmin set 命令启用设置，帮助改善大型 CSV 文件的性能。有关详细信息，请参见“CSV 导入文件准则”主题中的提高通过 tabcmd 传递的大型 CSV 文件的性能。

全局选项

deleteusers filename.csv

删除指定逗号分隔值 (.csv) 文件中列出的用户。

.csv 文件应包含每行一个用户名的简单列表。

示例

tabcmd deleteusers "users.csv"

选项

• --[no-]complete

• 当设置为 --complete 时，此选项要求所有行都必须有效，更改才能成功。如果未指定，则使用 --complete。

全局选项

editdomain

注意：作为最佳做法，在编辑域之前，您应该备份 Tableau Server。该域保存在 Tableau 存储库中，如果更改不正确，管理员可能无法登录。

更改服务器上 Active Directory 域的昵称或完整域名。域“昵称”是 Windows NetBIOS 域名。

您可以修改服务器正在使用的任何域的昵称。通常，除了您用来登录的域外，您可以修改任何域的完整域名。但是，如果您当前用来登录的用户名同时存在于当前域以及新域中，则可以修改当前域的完整域名。

为了确保 Tableau Server 可以连接到其他 Active Directory 域，您还必须通过使用 TSM 设置 wgserver.domain.whitelist 选项来指定 Tableau Server 连接到的辅助域。有关辅助域和配置连接的详细信息，请参见wgserver.domain.whitelist。

查看使用外部身份存储的部署中的用户管理，以了解多个域、域名映射和用户名与 Tableau Server 的交互方式。

若要查看域的列表，请使用 listdomains。

示例

tabcmd editdomain --id 2 --nickname "new-nickname"

tabcmd editdomain --id 3 --name "new-name"

选项

• --id

• 要更改的域的 ID。若要获取域 ID 的列表，请使用 listdomains。

• --name

• 域的新名称。

• --nickname

• 域的新昵称。

全局选项

editsite site-name

更改站点名称或其 Web 文件夹名称。还可使用此命令允许或拒绝站点管理员添加和移除用户的能力，或防止用户手动运行某些任务。如果站点管理员拥有用户管理权限，则您可指定他们可向一个站点添加的用户数量。

示例

tabcmd editsite wc_sales --site-name "West Coast Sales"

tabcmd editsite wc_sales --site-id "wsales"

tabcmd editsite wsales --status ACTIVE

tabcmd editsite wsales --user-quota 50

选项

• --site-name

• 显示的站点名称。

• --site-id

• 在网址中使用以特别标识站点。

• --user-quota

• 可成为该站点成员的用户的最大数量。

• --[no-]site-mode

• 允许或阻止站点管理员向站点添加用户。

• --status

• 设置为 ACTIVE 以激活站点，或设置为 SUSPENDED 以挂起站点。

• --storage-quota

• 站点上可存储的工作簿、数据提取和数据源的数量，以 MB 为单位。

• --extract-encryption-mode

• 站点的数据提取加密模式可以为“强制”、“已启用”或“已禁用”。有关详细信息，请参见静态数据提取加密。根据数据提取的数量和大小，此操作可能会消耗大量服务器资源。

• --run-now-enabled

• 允许或拒绝用户手动运行数据提取刷新、流程或计划。设置为 true 以允许用户手动运行任务，或设置为 false 以防止用户手动运行任务。有关详细信息，请参见服务器设置（常规和自定义）。

全局选项

encryptextracts

对站点上的所有数据提取进行加密。如果未指定任何站点，则将对默认站点上的数据提取进行加密。有关详细信息，请参见静态数据提取加密。

根据数据提取的数量和大小，此操作可能会消耗大量服务器资源。请考虑在正常工作时间之外运行此命令。

示例

tabcmd encryptextracts "West Coast Sales"

全局选项

export

从 Tableau Server 导出视图或工作簿，并将其保存到文件。此命令还可导出恰好适用于视图的数据。视图数据在摘要级别导出。若要导出详细级别数据，您必须使用 Tableau Server UI。有关详细信息，请参见下载视图和工作簿(链接在新窗口中打开)。

使用此命令时，请注意以下问题：

• 权限：若要导出，您必须拥有“导出图像”权限。虽然可针对每个工作簿或视图设置权限，但默认情况下，所有角色均会获得或继承此权限。

• 导出数据：若要导出恰好适用于视图的数据，请使用 --csv 选项。这会将视图中使用的摘要数据导出为 .csv 文件。

• 指定要导出的视图、工作簿或数据：

• 使用 URL 的一部分标识要导出的内容，特别是工作簿或视图的 URL 中显示的 "workbook/view" 字符串。不要使用“友好名称”，并且不要包括 URL 末尾的 :iid= 会话 ID。

  例如，“Regional”（区域）工作簿中的 Tableau 示例视图“Global Temperatures”（全球温度）具有类似于如下的 URL：

  若要导出“Global Temperatures”（全球温度）视图，请使用字符串 Regional/GlobalTemperatures。

  不要使用 Regional/Global Temperatures 或 Regional/GlobalTemperatures?:iid=3。

• 如果服务器运行多个站点，并且视图或工作簿不在“默认”站点上，请使用 -t。

• 若要导出工作簿，请通过在工作簿中打开视图来获取 URL 字符串，并在使用的字符串中包括视图。

  在上面的示例中，若要导出“Regional”（区域）工作簿，请使用字符串 Regional/GlobalTemperatures。

• 若要导出工作簿，必须已在“Tableau Desktop 发布”对话框中选中“将工作表显示为标签”的情况下发布该工作簿。

  注意：无法导出包含管理视图(链接在新窗口中打开)的 Tableau 工作簿。

• 若要筛选下载的数据，请使用此格式添加参数筛选器：

  ?<filter_name>=value

  或者，如果对参数进行筛选且该参数具有与度量或维度的名称匹配的显示名称：

  ?Parameters.

• 已保存文件的格式：格式选项取决于所导出的内容。只能使用 --fullpdf 参数将工作簿导出为 PDF。可将视图导出为 PDF (--pdf) 或 PNG (--png)。

• 已保存文件的名称和位置（可选）：如果您不提供名称，则将从视图或工作簿名称得到名称。如果您不提供位置，则会将该文件保存到当前工作目录。否则，您可以指定完整路径或当前工作目录的相对路径。

  注意：您必须包括文件扩展名，例如 .csv 或 .pdf。命令不会自动向您提供的文件名中添加扩展名。

• PDF 导出中不包含仪表板网页对象：仪表板可以包含网页对象。如果要将包含网页对象的仪表板导出到 PDF，则 PDF 中将不包括该网页对象。

• 非 ASCII 和非标准 ASCII 字符及 PDF 导出：如果您导出的视图或工作簿名称所包含的字符不在 ASCII 字符集内，或包括非标准 ASCII 字符集，则您需要对字符进行 URL 编码（或百分号编码）。

  举例来说，如果您的命令包括城市 Zürich，则需要将其 URL 编码为 Z%C3%BCrich：

  tabcmd export "/Cities/Sheet1?locationCity=Z%C3%BCrich" -fullpdf

清除缓存以使用实时数据

您可以选择添加 URL 参数 ?:refresh=yes 强制刷新数据查询而不是从缓存中获取结果。如果将 tabcmd 与您自己的脚本结合使用，并且大量使用 refresh URL 参数，则可能会对性能造成负面影响。建议您仅当需要实时数据时才使用 refresh，例如，在单个仪表板上而不是整个工作簿上。

示例

视图

tabcmd export "Q1Sales/Sales_Report" --csv -f "Weekly-Report.csv"

tabcmd export -t Sales "Sales/Sales_Analysis" --pdf -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"

tabcmd export "Finance/InvestmentGrowth" --png

tabcmd export "Finance/InvestmentGrowth?:refresh=yes" --png

工作簿

tabcmd export "Q1Sales/Sales_Report" --fullpdf

tabcmd export "Sales/Sales_Analysis" --fullpdf --pagesize tabloid -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"

选项

• -f, --filename

• 使用给定文件名和扩展名保存文件。

• --csv

• 仅视图。以 .csv 格式导出视图的数据（摘要数据）。

• --pdf

• 仅视图。导出为 PDF。

• --png

• 仅视图。导出为 .png 格式的图像。

• --fullpdf

• 仅工作簿。导出为 PDF。必须已在“将工作表显示为标签”已启用的情况下发布该工作簿。

• --pagelayout

• 设置所导出的 PDF 的页面方向（landscape 或 portrait）。如果不指定，则将使用其 Tableau Desktop 设置。

• --pagesize

• 将导出的 PDF 的页面大小设置为以下各项之一：unspecified、letter、legal、note folio、tabloid、ledger、statement、executive、 a3、a4、a5、b4、b5 或 quarto。默认值为 letter。

• --width

• 以像素为单位设置宽度。默认值为 800 像素。

• --height

• 以像素为单位设置高度。默认值为 600 像素。

全局选项

get url

从指定（部分）URL 表示的 Tableau Server 中获取资源。结果以文件形式返回。

使用此命令时，请注意以下问题：

• 权限：若要获取文件，您必须拥有“下载/另存到 Web”权限。虽然可针对每个工作簿或视图设置权限，但默认情况下，所有角色均会获得或继承此权限。

• 指定要获取的视图或工作簿：使用 "/views/ 字符串指定要获取的视图，并使用 "/workbooks/ 字符串指定要获取的工作簿。将 和 替换为当您在浏览器打开视图时工作簿和视图在 URL 中的显示名称，并将

  例如，当您在名为 Metrics Summary 的工作簿中打开视图 Regional Totals 时，URL 将类似于如下：

  /views/MetricsSummary_1/RegionalTotals?:iid=1

  使用字符串 /views/MetricsSummary_1/RegionalTotals. 来获取视图。

  使用字符串 /workbooks/MetricsSummary_1. 来获取工作簿。

• 文件扩展名：URL 必须包括文件扩展名。扩展名确定返回的内容。可采用 PDF、PNG 或 CSV（仅限汇总数据）格式返回视图。Tableau 工作簿作为 TWB 返回（如果它连接到已发布的数据源或使用实时连接）或者作为 TWBX 返回（如果它连接到数据提取）。

  注意：如果要将视图下载到 PDF 或 PNG 文件，并且包括的 --filename 参数中包含 .pdf 或 .png 扩展名，则不必在 URL 中包括 .pdf 或 .png 扩展名。

• 已保存文件的名称和位置（可选）：用于 --filename 的名称应包含该文件扩展名。如果您不提供名称和文件扩展名，则这两个名称都将从 URL 字符串得到。如果您不提供位置，则会将该文件保存到当前工作目录。否则，您可以指定完整路径或当前工作目录的相对路径。

• PNG 大小（可选）：如果保存的文件是 PNG，您可以在 URL 中指定该大小（以像素为单位）。

清除缓存以使用实时数据

您可以选择添加 URL 参数 ?:refresh=yes 强制刷新数据查询而不是从缓存中获取结果。如果将 tabcmd 与您自己的脚本结合使用，则大量使用 refresh 参数可能会对性能造成负面影响。建议您仅当需要实时数据时才使用 refresh，例如，在单个仪表板上而不是整个工作簿上。

示例

视图

tabcmd get "/views/Sales_Analysis/Sales_Report.png" --filename "Weekly-Report.png"

tabcmd get "/views/Finance/InvestmentGrowth.pdf" -f "Q1Growth.pdf"

tabcmd get "/views/Finance/InvestmentGrowth" -f "Q1Growth.pdf"

tabcmd get "/views/Finance/InvestmentGrowth.csv"

tabcmd get "/views/Finance/InvestmentGrowth.png?:size=640,480" -f growth.png

tabcmd get "/views/Finance/InvestmentGrowth.png?:refresh=yes" -f growth.png

工作簿

tabcmd get "/workbooks/Sales_Analysis.twb" -f "C:\Tableau_Workbooks\Weekly-Reports.twb"

全局选项

initialuser

在未定义初始管理用户的服务器上创建初始管理用户。

注意：tabcmd initialuser 命令不要求向 Tableau Server 进行身份验证，但您必须在初始服务器节点上运行该命令。

注意：

• tabcmd initialuser 命令不要求向 Tableau Server 进行身份验证，但您必须在初始服务器节点上运行该命令。

• 除非用户名后缀与 Tableau Server 的主域匹配，否则 username 不能包含 at 符号 (@)。举例来说，如果 Tableau Server 连接到域“myco.com”，则不能使用用户名“user@example.com@myco.com”。

示例

tabcmd initialuser --username "admin" --password "password" --server http://localhost

tabcmd initialuser --username "admin" --password "password" --friendly "Tableau Admin" --server http://localhost

若要在 shell 中提示输入密码，请不要在命令中包括 --password 参数。例如：

tabcmd initialuser --username "admin" --server http://localhost

选项

• -f, --friendly

• 使用显示名称创建初始管理用户。

全局选项

listdomains

显示服务器正在使用的 Active Directory 域的列表，以及其昵称和 ID。如果服务器配置为使用本地身份验证，则该命令仅返回域名 local。

示例

tabcmd listdomains

全局选项

listsites

返回已登录用户所属站点的列表。

示例

tabcmd listsites --username adam --password mypassword

选项

• --get-extract-encryption-mode

• 站点的数据提取加密模式可以为“强制”、“已启用”或“已禁用”。有关详细信息，请参见静态数据提取加密。

全局选项

login

使 Tableau Server 用户登录。

可使用 --server、--site、--username、--password 全局选项来创建会话。

注意：使用 tabcmd login 命令时，将无法使用 SAML 站点登录 (SSO)，即使服务器配置为使用 SAML。若要登录，您必须传递在服务器上创建的用户的用户名和密码。您将具有您在登录时使用的 Tableau Server 用户的权限。有关详细信息，请参见设置用户的站点角色和权限。

如果要使用创建会话时使用的相同信息进行登录，只需指定 --password 选项。将使用存储在 Cookie 中的服务器和用户名。

如果服务器使用 80（默认值）之外的端口，您需要指定该端口。

仅当服务器运行多个站点，并且您登录的站点不是默认站点时，才需要使用 --site (-t) 选项。如果未提供密码，则会提示您输入密码。如果指定 --no-prompt 选项但未提供密码，则该命令将失败。

登录后，该会话将继续进行，直到其在服务器上过期或 logout 命令运行。

示例

使用户 jsmith 登录到本地计算机上运行的 Tableau Server：

tabcmd login -s http://localhost -u jsmith -p password

使管理员登录到 sales-server 上的“Sales”（销售额）站点：

tabcmd login -s http://sales-server -t Sales -u administrator -p password

tabcmd login -s http://sales-server:8000 -t Sales -u administrator -p password

使用 SSL 将管理员登录到 sales-server 上的“Sales”（销售额）站点，但不验证服务器的 SSL 证书：

tabcmd login --no-certcheck -s https://sales-server -t Sales -u administrator -p password

为 localhost 建立正向代理和端口：

tabcmd login --proxy myfwdproxyserver:8888 -s http://localhost -u jsmith -p password

使用户 jsmith 使用 SSL 登录到反向代理：

tabcmd login -s https://myreverseproxy -u jsmith -p password

选项

• -s, --server

• 如果从网络上的 Tableau Server 计算机中运行命令，您可以使用 http://localhost。否则，指定计算机的 URL，例如 http://bigbox.myco.com 或 http://bigbox。

  如果服务器使用 SSL，则需要在计算机的 URL 中指定 https://。

  对于 Tableau Online，请指定 URL https://online.tableau.com。

• -t, --site

• 当服务器具有多个站点，并且您登录的站点不是默认站点时，请使用此选项。

  在 URL 中使用站点 ID 以唯一地标识站点。例如，名为 West Coast Sales 的站点的 ID 可能为 west-coast-sales。

• -u, --username

• 登录用户的用户名。对于 Tableau Online，用户名是用户的电子邮件地址。

• -p, --password

• --username 所指定的用户的密码。如果未提供密码，则会提示您输入密码。

• --password-file

• 允许将密码存储在给定 filename.txt 文件中而不是命令行中以增加安全性。

• -x, --proxy

• 用于指定 tabcmd 请求的 HTTP 代理服务器和端口（主机:端口）。

• --no-prompt

• 不提示输入密码。如果未指定密码，则 login 命令将失败。

• --no-proxy

• 请勿使用 HTTP 代理服务器。

• --cookie

• 登录时保存会话 ID。后续命令将不需要登录名。此值是命令的默认值。

• --no-cookie

• 成功登录后不保存会话 ID 信息。后续命令将需要登录名。

• --timeout SECONDS

• 处理 login 命令前服务器应等待的秒数。默认值：30 秒。

全局选项

logout

退出服务器。

示例

tabcmd logout

publish filename.twb(x)、filename.tds(x) 或 filename.hyper

将指定的工作簿 (.twb(x))、数据源 (.tds(x)) 或数据提取 (.hyper) 发布到 Tableau Server。

如果发布工作簿，则默认情况下无需数据库用户名或密码即可发布工作簿中的所有工作表。

将从在其中发布文件的项目中复制最初分配给工作簿或数据源的权限。可在发布了文件后更改已发布资源的权限。

如果工作簿中包含用户筛选器，则必须指定一个缩略图选项。

示例

tabcmd publish "analysis.twbx" -n "Sales_Analysis" --db-username "jsmith" --db-password "secret-password"

tabcmd publish "analysis_sfdc.hyper" -n "Sales Analysis"
--oauth-username "user-name" --save-oauth

如果文件与 tabcmd 并不位于同一目录，请包含文件的完整路径。

示例

tabcmd publish "\\computer\volume\Tableau Workbooks\analysis.twbx" -n "Sales_Analysis" --db-username "jsmith" --db-password "secret-password"

tabcmd publish "\\computer\volume\Tableau Workbooks\analysis_sfdc.hyper" -n "Sales Analysis" --oauth-username "username" --save-oauth

选项

• -n, --name

• 服务器上工作簿或数据源的名称如果省略，则工作簿、数据源或数据提取将以文件名来命名。

• -o, --overwrite

• 如果服务器上已存在该工作簿、数据源或数据提取，则将其覆盖。

• -r, --project

• 将工作簿、数据源或数据提取发布到指定项目。如果未指定，则发布到“Default”项目。

• --parent-project-path

• 指定使用 -r 选项指定的嵌套项目的父项目的名称。例如，若要指定“Main”项目中名为“Nested”的项目，请使用以下语法： --parent-project-path "Main" -r "Nested"。

• --db-username

• 使用此选项可将数据库用户名与工作簿、数据源或数据提取一起发布。

• --db-password

• 使用此选项可将数据库密码与工作簿、数据源或数据提取一起发布。

• --save-db-password

• 将提供的数据库密码存储在服务器上。

• --oauth-username

• 用户帐户的电子邮件地址。如果用户对 --name 中指定的云端数据源已经有保存的访问令牌，则通过预先配置的 OAuth 连接来连接该用户。访问令牌在用户首选项中管理。

  对于数据源的现有 OAuth 连接，应使用该选项而不是 --db-username 和 --db-password。

• --save-oauth

• 将 --oauth-username 指定的凭据保存为已发布工作簿或数据源的嵌入式凭据。

  随后，当发布者或服务器管理员登录服务器并编辑该工作簿或数据源的连接时，连接设置将显示此 OAuth 凭据已嵌入到内容中。

  如果要安排在发布后刷新数据提取，则必须对 --oauth-username 使用该选项。这与对传统的数据库连接使用 --save-db-password 类似。

• --thumbnail-username

• 如果工作簿中包含用户筛选器，则将基于指定用户可看到的内容生成缩略图。设置 --thumbnail-group 选项后，无法指定此选项。

• --thumbnail-group

• 如果工作簿中包含用户筛选器，则将基于指定组可看到的内容生成缩略图。设置 --thumbnail-username 选项后，无法指定此选项。

• --tabbed

• 发布带有选项卡式视图的工作簿时，每个工作表都成为一个选项卡，Viewer（查看者）可以使用这些选项卡在工作簿中导航。请注意，此设置将替代任何工作表级安全设置。

• --append

• 将数据提取文件附加到现有的数据源中。

• --replace

• 使用数据提取文件替换现有的数据源。

• --disable-uploader

• 禁用增量文件上传器。

• --restart

• 重新启动文件上载过程。

• --encrypt-extracts

• 在将工作簿、数据源或数据提取发布到服务器时对数据提取进行加密。有关详细信息，请参见静态数据提取加密。

全局选项

publishsamples

描述

将 Tableau 示例工作簿发布到指定项目。任何现有示例将被覆盖。

语法

tabcmd publishsamples -n [project name] [Global options]

示例

以用户 jsmith 身份将示例发布到“Default”站点上的“Inside Sales”项目。

tabcmd publishsamples -n "Inside Sales" -t "" -s localhost --username "jsmith" --password "secret-password"

选项

• -n, --name

• 必需。将 Tableau 示例发布到指定项目中。如果项目名称包括空格，请用引号将整个名称括起来。

• --parent-project-path

• 指定使用 -n 选项指定的嵌套项目的父项目的名称。例如，若要指定“Main”项目中名为“Nested”的项目，请使用以下语法： --parent-project-path "Main" -n "Nested"。

全局选项

reencryptextracts

使用新的加密密钥对站点上的所有数据提取进行重新加密。此命令将重新生成密钥加密密钥和数据加密密钥。您必须指定站点。有关详细信息，请参见静态数据提取加密。

根据数据提取的数量和大小，此操作可能会消耗大量服务器资源。请考虑在正常工作时间之外运行此命令。

示例

tabcmd reencryptextracts "Default"

tabcmd reencryptextracts "West Coast Sales"

全局选项

refreshextracts workbook-name 或 datasource-name

对属于指定工作簿或数据源的数据提取执行完全或增量刷新。

此命令使用服务器上显示的工作簿或数据源的名称，而不使用发布时的文件名。仅允许管理员或者工作簿或数据源的所有者执行此操作。

注意：如果服务器管理员为站点禁用了“立即运行”设置，此方法将失败并导致错误。有关详细信息，请参见 Tableau Server 设置(链接在新窗口中打开)。

示例

tabcmd refreshextracts --datasource sales_ds

tabcmd refreshextracts --project "Sales External" --datasource sales_ds

tabcmd refreshextracts --project "Sales External" --parent-project-path "Main" --project "Sales External" --datasource sales_ds

tabcmd refreshextracts --workbook "My Workbook"

tabcmd refreshextracts --url SalesAnalysis

tabcmd refreshextracts --workbook "My Workbook" --addcalculations

tabcmd refreshextracts --datasource sales_ds --removecalculations

选项

• --incremental

• 运行增量刷新操作。

• --synchronous

• 将完全刷新操作添加至后台程序进程所使用的队列，以在后台程序进程可用时立即运行。如果后台程序进程可用，则立即运行此操作。刷新操作会出现在“后台任务”报告中。

  在同步刷新期间，tabcmd 在刷新操作进行时保持实时连接到服务器，并且每秒钟进行一次轮询，直到后台作业完成为止。

• --workbook

• 包含要刷新的数据提取的工作簿的名称。如果工作簿名称中含有空格，请将名称放入引号内。

• --datasource

• 包含要刷新的数据提取的数据源的名称。

• --project

• 与 --workbook 或 --datasource 结合使用可确定 Default 以外的项目中的工作簿或数据源。如果未指定，则使用“Default”项目。

• --parent-project-path

• 指定使用 --project 选项指定的嵌套项目的父项目的名称。

  例如：

  • 若要指定“Main”项目中名为“Nested”的项目，请使用以下语法：

  • --parent-project-path "Main" --project "Nested"

  • 指定在“Nested”项目中嵌套的名为“Nested2”的项目：

  • --parent-project-path "Main/Nested" --project "Nested2"

• --url

• 显示在 URL 中的工作簿的名称。发布为“Sales Analysis”工作簿的 URL 名称为“SalesAnalysis”。

• --addcalculations

• 与 --workbook 结合使用以在工作簿的嵌入式数据提取中实现计算，或与 --datasource 结合使用以在数据提取数据源中实现计算。将操作添加到后台程序进程使用的查询中。如果后台程序进程可用，操作将立即运行。此操作出现在数据提取后台任务 管理视图中。

• --removecalculations

• 与 --workbook 或 --datasource 结合使用可移除以前实现的计算。将操作添加到后台程序进程使用的查询中。如果后台程序进程可用，操作将立即运行。此操作出现在数据提取后台任务 管理视图中。

全局选项

reset_openid_sub

清除已与 Tableau Server 身份关联的 COpenID Connect 标识符（子值）。请参见针对 OpenID Connect 更改 Tableau Server 中的 IdP。

示例

tabcmd reset_openid_sub --target-username jsmith

选项

• --target-username

• 为指定的单个用户清除子值。

• --all

• 为所有用户清除子值。

全局选项

removeusers group-name

从指定的组中移除用户。

示例

tabcmd removeusers "Development" --users "users.csv"

选项

• --users

• 从指定的组删除给定 .csv 文件中的用户。该文件应是每行一个用户名的简单列表。

  如果在 Tableau Server 上将此命令用于大型 .csv 文件，则服务器管理员可启用帮助改善性能的设置。有关信息，请参见提高通过 tabcmd 传递的大型 CSV 文件的性能

• --[no-]complete

• 要求所有行都必须有效，更改才能成功。如果未指定，则使用 --complete。

全局选项

runschedule schedule-name

运行指定的计划。

此命令按原样使用服务器上的计划名称。

此命令不可用于 Tableau Online。

注意：如果服务器管理员为站点禁用了“立即运行”设置，此方法将失败并导致错误。有关详细信息，请参见 Tableau Server 设置(链接在新窗口中打开)。

示例

tabcmd runschedule "5AM Sales Refresh"

全局选项

set setting

在服务器上启用指定设置。服务器的“维护”页面上提供了有关各项设置的详细信息。

在设置名称前使用感叹号可禁用该设置。可启用或禁用以下设置：

• allow_scheduling

• embedded_credentials

• remember_passwords_forever

示例

tabcmd set embedded_credentials

全局选项

syncgroup group-name

将 Tableau Server 组与 Active Directory 组同步。如果 Tableau Server 组尚未存在，则会创建该组并将其与指定的 Active Directory 组同步。

如果组名称本身包括“@”（而不是作为域分隔符），则您需要使用十六进制格式引用该符号“\0x40”

示例

tabcmd syncgroup "Development"

tabcmd syncgroup "Dev\0x40West"

注意： 如果同步您是其成员的组，则使用此命令所做的更改不会应用于您的用户。举例来说，如果您使用此命令移除您是其成员的组中用户的管理员权限，则在命令完成时您仍然是管理员。

选项

• --grant-license-mode

• 指定是否应在登录时授予角色。默认值为 on-sync。有效的值包括 on-login、on-sync。如果未指定值，则会假定使用了 on-sync，并在组同步时授予默认角色。有关详细信息，请参见使用“登录时授予角色”修改用户角色。

• --no-publisher

• 已弃用。请改用 --role 选项。

• --overwritesiterole

• 使用 --role 时，允许用权限较低的角色覆盖用户的站点角色。默认情况下，在使用 --role 时，用户站点角色可能会收到提示，但无法降级。由于 --overwritesiterole 选项会使用户站点角色降级，因此请小心使用。

• --publisher

• 已弃用。请改用 --role 选项。

• -r, --role

• 为组中的用户指定站点角色。默认值为 Unlicensed。

  有效的值包括：SiteAdministratorCreator、SiteAdministratorExplorer、SiteAdministrator、Creator、ExplorerCanPublish、Publisher、Explorer、Interactor、Viewer、Unlicensed。

• --silent-progress

• 不显示命令的进度消息。

全局选项

upgradethumbnails

启动和停止“升级缩略图”作业。若要了解详细信息，请参见“升级缩略图”作业。

示例

启动“升级缩略图”作业：

tabcmd upgradethumbnails --server

停止正在执行的“升级缩略图”作业：

tabcmd upgradethumbnails --server

选项

• --stop

• 指定后，停止正在执行的“升级缩略图”作业。如果未指定此选项，则将启动“升级缩略图”作业。

全局选项

validateidpmetadata

使用不安全的摘要算法 SHA-1 标识配置了 IdP 的 Tableau Server 站点。此命令还标识所使用证书 RSA 密钥大小或椭圆曲线大小不足的 IdP。

注意：此命令仅可用于特定于站点的 SAML。有关详细信息，请参见配置特定于站点的 SAML。

选项

• --digest-algorithms

• 用空格分隔的摘要算法列表。合法值包括 sha1 和 sha256。如果未指定，则服务器使用服务器配置设置 wgserver.saml.blocklisted_digest_algorithms 中的值。

• --min-allowed-elliptic-curve-size

• 如果未指定，则服务器使用服务器配置设置 wgserver.saml.min_allowed.elliptic_curve_size 中的值。

• --min-allowed-rsa-key-size

• 如果未指定，则服务器使用服务器配置设置 wgserver.saml.min_allowed.rsa_key_size 中的值。

• --site-names

• 要对其执行证书验证的站点名称的空格分隔列表。如果未指定，则将检查所有站点。

全局选项

version

显示 tabcmd 实用工具的当前安装的版本信息。

示例

tabcmd version

全局选项

所有 tabcmd 命令都使用以下选项。若要开始一个会话，至少需要使用一次 --server、--user 和 --password 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

• -h, --help

• 显示命令帮助。

• -c, --use-certificate

• 使用客户端证书登录。启用相互 SSL 时需要。

  有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始：

• Windows：配置相互 SSL(链接在新窗口中打开)

• Linux：配置相互 SSL(链接在新窗口中打开)

• -s, --server

• Tableau Server URL，至少需要使用一次才能开始会话。

• -u, --user

• Tableau Server 用户名，至少需要使用一次才能开始会话。

• -p, --password

• Tableau Server 密码，至少需要使用一次才能开始会话。

• --password-file

• 允许将密码存储在给定 .txt 文件中而不是命令行中以增加安全性。

• -t, --site

• 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

• -x, --proxy

• Host:Port

  使用指定的 HTTP 代理。

• --no-prompt

• 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

• --no-proxy

• 指定后，将不使用 HTTP 代理。

• --no-certcheck

• 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。

• --[no-]cookie

• 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 no- 前缀。默认情况下，将保存会话。

• --timeout

• 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

• --

• 指定命令行上的选项结尾。您可以使用 -- 向 tabcmd 指明不应将 -- 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 tabcmd 命令中使用 --，在该命令中，-430105/Sheet1 是 export 命令的必需值。

  tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

• tabcmd 的安装开关和属性 (Windows)

通过 Windows 上的命令行安装 Tableau Server 命令行实用程序 (tabcmd) 版本 2019.4.0 或更高版本时，可以使用以下开关。

注意：对于 Tabcmd 安装程序的 Linux 版本，没有等效的开关。