tabcmd 命令

注意: tabcmd 命令行实用程序版本 2.0 可从 Tableau tabcmd(链接在新窗口中打开) 获取。这个新版本允许您在 MacOS 和 Linux 上运行 tabcmd 命令并使用个人访问令牌 (PAT) 进行身份验证。版本 2.0 构建在基于 Python 的 Tableau Server 客户端 (TSC) 中可用的公共端点之上。此最新版本对 Tableau Server 的支持有限。

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

addusers group-name

将用户添加到指定的组。

示例

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

选项

--users

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

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

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

--[no-]complete

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

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

createextracts

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

选项

-d, --datasource

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

--embedded-datasources

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

--encrypt

创建加密数据提取

--include-all

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

--parent-project-path

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

--project

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

-u, -url

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

-w, -workbook

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

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

creategroup group-name

创建一个组。创建组后,使用 addusers(适用于本地组)来添加用户。使用 syncgroup(适用于 Active Directory 组)创建 Tableau Server 组并将其与 Active Directory 组同步。

示例

tabcmd creategroup "Development"

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

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

为项目指定说明。

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

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 阻止用户手动运行任务。有关详细信息,请参见服务器设置(常规和自定义)

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

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\usernameusername@domain.com;但是,我们建议使用 domain\username 格式。有关详细信息,请参见使用外部身份存储的部署中的用户管理

示例

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

选项

--admin-type

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

--auth-type

.csv 文件中的所有用户设置身份验证类型(LocalSAML)。如果未指定,则默认值为 Local

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

--[no-]complete

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

--no-publisher

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

--nowait

不等待异步作业完成。

--publisher

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

--role

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

有效的值包括:ServerAdministratorSiteAdministratorCreatorSiteAdministratorExplorerSiteAdministratorCreatorExplorerCanPublishPublisherExplorerInteractorViewerUnlicensed

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

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

--silent-progress

不显示命令的进度消息。

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

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\usernameusername@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 文件。

有效的值包括:ServerAdministratorSiteAdministratorCreatorSiteAdministratorExplorerSiteAdministratorCreatorExplorerCanPublishPublisherExplorerInteractorViewerUnlicensed

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

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

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

--silent-progress

不显示命令的进度消息。

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

decryptextracts

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

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

示例

tabcmd decryptextracts "West Coast Sales"

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

delete workbook-namedatasource-name

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

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

示例

tabcmd delete "Sales_Analysis"

选项

-r, --project

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

--parent-project-path

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

--workbook

要删除的工作簿的名称。

--datasource

要删除的数据源的名称。

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

deleteextracts

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

选项

-d, --datasource

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

--embedded-datasources

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

--encrypt

创建加密数据提取

--include-all

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

--parent-project-path

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

--project

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

-u, -url

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

-w, -workbook

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

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

deletegroup group-name

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

示例

tabcmd deletegroup "Development"

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

deleteproject project-name

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

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

示例

tabcmd deleteproject "Designs"

选项

--parent-project-path

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

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

deletesite site-name

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

示例

tabcmd deletesite "Development"

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

deletesiteusers filename.csv

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

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

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

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

示例

tabcmd deletesiteusers "users.csv"

改善大型 CSV 文件的性能

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

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

deleteusers filename.csv

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

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

示例

tabcmd deleteusers "users.csv"

选项

--[no-]complete

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

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

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

域的新昵称。

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

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 阻止用户手动运行任务。有关详细信息,请参见服务器设置(常规和自定义)

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

encryptextracts

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

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

示例

tabcmd encryptextracts "West Coast Sales"

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

export

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

使用此命令时,请注意以下问题:

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

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

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

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

      例如,“Superstore”(超市)工作簿中的 Tableau 示例视图“Order Details”(订单详细信息)具有类似于如下的 URL:<server_name>/#/views/Superstore/OrderDetails?:iid=2

      若要导出“Order Details”(订单详细信息)视图,请使用字符串 Superstore/OrderDetails

      不要使用 Superstore/Order DetailsSuperstore/OrderDetails?:iid=2

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

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

      在上面的示例中,若要导出“Superstore”(超市)工作簿,请使用字符串 Superstore/OrderDetails

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

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

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

      ?<filter_name>=value

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

      ?Parameters.<filter_name>=value

  • 已保存文件的格式:格式选项取决于所导出的内容。只能使用 --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 的页面方向(landscapeportrait)。如果不指定,则将使用其 Tableau Desktop 设置。

--pagesize

将导出的 PDF 的页面大小设置为以下各项之一:unspecifiedletterlegalnote foliotabloidledgerstatementexecutivea3a4a5b4b5quarto。默认值为 letter

--width

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

--height

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

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

get url

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

使用此命令时,请注意以下问题:

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

  • 指定要获取的视图或工作簿:使用 "/views/<workbookname>/<viewname>.<extension>" 字符串指定要获取的视图,并使用 "/workbooks/<workbookname>.<extension>" 字符串指定要获取的工作簿。将 <workbookname> <viewname> 替换为当您在浏览器打开视图时工作簿和视图在 URL 中的显示名称,并将 <extension> 替换为想要保存的文件类型。不要在 URL 的末尾使用会话 ID (?:iid=<n>),也不要使用工作簿或视图的“友好”名称。

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

    /views/MetricsSummary_1/RegionalTotals?:iid=1

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

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

    Tableau Server 下载工作簿和视图时,.twb 或 .twbx 文件的内容以纯文本形式存储。打开文件的任何人都可以读取所有数据,包括可能为数据提供语义线索的筛选器值。

  • 文件扩展名: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"

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

initialuser

在未定义初始管理用户的服务器上创建初始 Server 管理用户。这将创建一个 Server 管理员。这不会创建 TSM 管理员。

注意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

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

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

listdomains

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

示例

tabcmd listdomains

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

listsites

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

示例

tabcmd listsites --username adam --password mypassword

选项

--get-extract-encryption-mode

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

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

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.comhttp://bigbox

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

对于 Tableau Cloud,指定完整 URL,包括您的站点部署到的 Pod。例如:https://prod-useast-b.online.tableau.com

-t, --site

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

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

-u, --username

登录用户的用户名。对于 Tableau Cloud,用户名是用户的电子邮件地址。

-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 秒。

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

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

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

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

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"

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

reencryptextracts

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

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

示例

tabcmd reencryptextracts "Default"

tabcmd reencryptextracts "West Coast Sales"

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

refreshextracts workbook-namedatasource-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 在刷新操作进行时保持实时连接到服务器,并且每秒钟进行一次轮询,直到后台作业完成为止。

注意:--synchronous 选项不适用于使用 Tableau Bridge 刷新的数据源。

--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 结合使用可移除以前实现的计算。将操作添加到后台程序进程使用的查询中。如果后台程序进程可用,操作将立即运行。此操作出现在数据提取后台任务 管理视图中。

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

reset_openid_sub

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

示例

tabcmd reset_openid_sub --target-username jsmith

选项

--target-username

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

--all

为所有用户清除子值。

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

removeusers group-name

从指定的组中移除用户。

示例

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

选项

--users

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

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

--[no-]complete

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

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

runschedule schedule-name

为您当前登录的站点运行指定计划中的任务。您不能使用 tabcmd 为所有站点运行此命令。若要为所有站点运行计划中的任务,请登录 Web 界面,从“计划”页面中选择“所有站点”,然后按计划中“立即运行”

此命令采用服务器上指定的计划名称。

此命令不可用于 Tableau Cloud。

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

示例

tabcmd runschedule "5AM Sales Refresh"

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

set setting

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

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

  • allow_scheduling

  • embedded_credentials

  • remember_passwords_forever

示例

tabcmd set embedded_credentials

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

syncgroup group-name

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

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

示例

tabcmd syncgroup "Development"

tabcmd syncgroup "Dev\0x40West"

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

选项

--grant-license-mode <grant-license-mode>

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

--no-publisher

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

--overwritesiterole

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

--publisher

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

-r, --role

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

有效的值包括:SiteAdministratorCreatorSiteAdministratorExplorerSiteAdministratorCreatorExplorerCanPublishPublisherExplorerInteractorViewerUnlicensed

--silent-progress

不显示命令的进度消息。

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

upgradethumbnails

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

示例

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

tabcmd upgradethumbnails --server <serverURL>

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

tabcmd upgradethumbnails --server <serverURL> --stop

选项

--stop

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

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

validateidpmetadata

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

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

选项

--digest-algorithms <ALGORITHMS>

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

--min-allowed-elliptic-curve-size <SIZE>

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

--min-allowed-rsa-key-size <SIZE>

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

--site-names <SITENAMES>

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

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

version

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

示例

tabcmd version

全局选项

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

-h, --help

显示命令帮助。

-c, --use-certificate

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

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

-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/Sheet1export 命令的必需值。

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

提示:有关可用于 Tableau Cloud 的 Tabcmd 1.0 命令,请参见 tabcmd 命令(链接在新窗口中打开)
感谢您的反馈!您的反馈已成功提交。谢谢!