tabcmd 命令

您可以通过 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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

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

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

creategroup group-name

创建一个组。使用 addusers 命令(适用于本地组)和 syncgroup(适用于 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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 为单位。

全局选项

所有 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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 格式。有关详细信息,请参见Active Directory 部署中的用户管理

示例

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

选项

--admin-type

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

--complete

要求所有行都必须有效,更改才能成功。这是默认设置。

--no-complete

指定即使在并非所有行都包含有效信息的情况下命令也应在服务器上进行更改。将跳过包含无效信息的行。

--no-publisher

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

--nowait

不等待异步作业完成。

--publisher

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

--role

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

有效的值包括 ServerAdministratorSiteAdministratorCreatorSiteAdministratorExplorerCreatorExplorerCanPublishExplorerViewerReadOnlyUnlicensed

对于新用户,默认值为 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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 格式。有关详细信息,请参见Active Directory 部署中的用户管理

示例

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

tabcmd createusers "users.csv"

选项

--admin-type

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

--complete

要求所有行都必须有效,更改才能成功。这是默认设置。

--no-complete

指定即使在并非所有行都包含有效信息的情况下命令也应在服务器上进行更改。将跳过包含无效信息的行。

--no-publisher

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

--nowait

不等待异步作业完成。

--publisher

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

-r, --role

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

有效的值包括 ServerAdministratorSiteAdministratorCreatorSiteAdministratorExplorerCreatorExplorerCanPublishExplorerViewerReadOnlyUnlicensed

在多站点服务器上,该命令不会将用户分配到站点。因此,该命令可成功分配的唯一站点角色是 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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

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

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

editdomain

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

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

查看Active Directory 部署中的用户管理,以了解多个域、域名映射和用户名与 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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 为单位。

全局选项

所有 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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

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

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

export

Tableau Server 导出视图或工作簿,并将其保存到文件。此命令还可导出恰好适用于视图的数据。

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

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

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

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

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

      例如,“Regional”(区域)工作簿中的 Tableau 示例视图“Global Temperatures”(全球温度)具有类似于如下的 URL:<server_name>/#/views/Regional/GlobalTemperatures?:iid=3

      若要导出“Global Temperatures”(全球温度)视图,请使用字符串 Regional/GlobalTemperatures

      不要使用 Regional/Global TemperaturesRegional/GlobalTemperatures?:iid=3

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

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

      在上面的示例中,若要导出“Regional”(区域)工作簿,请使用字符串 Regional/GlobalTemperatures

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

  • 已保存文件的格式:格式选项取决于所导出的内容。只能使用 --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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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> 来获取工作簿。

  • 文件扩展名: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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

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

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

initialuser

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

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

示例

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

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

全局选项

所有 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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

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

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

listsites

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

示例

tabcmd listsites --username adam --password mypassword

全局选项

所有 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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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

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

全局选项

所有 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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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

重新启动文件上载过程。

全局选项

所有 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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

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

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

refreshextracts workbook-namedatasource-name

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

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

示例

tabcmd refreshextracts --datasource sales_ds

tabcmd refreshextracts --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"

--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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

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

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

runschedule schedule-name

运行指定的计划。

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

对于 Tableau Online,命令可使用站点管理员权限在单一站点的范围内运行。

示例

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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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"

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

选项

--no-publisher

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

--overwritesiterole

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

--publisher

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

-r, --role

为组中的用户指定站点角色。默认值为 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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

指定命令行上的选项结尾。您可以使用 --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 指定的站点。如果不指定站点,将假定为默认站点。仅适用于具有多个站点的服务器。

-x, --proxy

Host:Port

使用指定的 HTTP 代理。

--no-prompt

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

--no-proxy

指定后,将不使用 HTTP 代理。

--no-certcheck

在指定时,tabcmd(客户端)不会验证服务器的 SSL 证书。

--[no-]cookie

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

--timeout

等待指定秒数以使服务器完成命令处理。默认情况下,该进程将在 30 秒后超时。

--

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

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

感谢您提供反馈! 提交反馈时出错。请重试或向我们发送消息