--- schema_version: "1" id: b346b7b10c5cad59d1ee70397d4c5729fb747d6def347e9045d9578f3cba1c1c title: tabcmd 命令 collection: tableau version: current locale: zh-cn portal_url: https://docs.salesforce.com/tableau/current/zh-cn/server-linux/tabcmd_cmd.md canonical_url: https://help.tableau.com/current/server-linux/zh-cn/tabcmd_cmd.htm source_site: help.tableau.com content_type: documentation content_hash: 22849b2a79fcc451fb003f33196e9825ebe2cf7785ab43288e7c4d059d65f1e6 description: Reference for tabcmd commands and their options. --- [跳转到主要内容](#main-content) # tabcmd 命令 **注意：** tabcmd 命令行实用程序版本 2.0 可从 [Tableau tabcmd](https://tableau.github.io/tabcmd) 获取。这个新版本允许您在 MacOS 和 Linux 上运行 tabcmd 命令并使用个人访问令牌 (PAT) 进行身份验证。版本 2.0 构建在基于 Python 的 Tableau Server 客户端 (TSC) 中可用的公共端点之上。此最新版本对 Tableau Server 的支持有限。 期望使用 Windows 版 Tableau Server？请参见 [tabcmd 命令](https://help.tableau.com/current/server/zh-cn/tabcmd_cmd.htm "在新浏览器选项卡中打开主题"). 您可以通过 tabcmd 命令行工具使用以下命令： [addusers](#id1999d76f-638e-47d4-86ac-fe8e206ed364)（至组） [createextracts](#id5a3316ed-45bb-4da4-b557-1111112d4ac8) [creategroup](#idbfa546df-2be7-444f-8bb8-07978b127783) [createproject](#id5a3316ed-45bb-4da4-b557-58492b2d4ac8) [createsite](#id6f434e96-89d1-4aa2-a935-4c22fa1e2506) [createsiteusers](#idd1b7729f-dd20-475a-96f6-17fcd2577894) [createusers](#ide42a948a-cd9c-4b73-9ef2-3a58eda2d095) [decryptextracts](#decryptextracts_tabcmd) [delete _workbook-name_ 或 _datasource-name_](#idfdf59712-84ed-4590-9471-541d316917a6) [deleteextracts](#id5a3316ed-45bb-4da4-b557-2222222d4ac8) [deletegroup](#id0d009916-bee3-4ef0-a6ac-22188c0e7f30) [deleteproject](#idfdf59712-84ed-4590-9471-541d316917a6) [deletesite](#id54a7f404-5d1b-452e-8273-0ab8396da641) [deletesiteusers](#deletesiteusers) [deleteusers](#id6a8ef3d6-d17b-4c31-be47-7b09437eeec0) [editdomain](#editdomain) [editsite](#id06d8e2e0-d7a1-4733-b0df-d1e02f66919b) [encryptextracts](#encryptextracts_tabcmd) [export](#id7cb8d032-a4ff-43da-9990-15bdfe64bcd0) [get _url_](#id7e0a0627-ad89-4135-a1c2-85b1d8472568) [initialuser](#initialuser) [listdomains](#listdomains) [listsites](#idc7467cb6-6cef-49bf-9358-a3e4addd5fa0) [login](#id5fba51c9-5608-4520-8ceb-2caf4846a2be) [logout](#id8f512aec-57a4-4ed4-94c4-86e91ea9cc9c) [publish](#iddf805b62-18ff-4497-9245-adc6905b2084) [publishsamples](#publishsamples) [reencryptextracts](#reencryptextracts_tabcmd) [refreshextracts](#id4cdb3410-1c41-4dad-b1d2-306542ac9b32) [removeusers](#id5cc30cba-44b8-48b0-93d6-5707938d157a) [reset\_openid\_sub](#reset_sub) [runschedule](#idd9d99c44-c9be-4191-9191-402341775a3d) [set](#idfe12acaf-ed64-4f0c-8eb8-b83c9de12382) [syncgroup](#ide6a39f29-77ff-44f6-b946-c2b56b31a2f9) [upgradethumbnails](#upgradethumbnails) [validateidpmetadata](#validateidp) [version](#id825f5d18-529c-408a-b876-57693195bbdd) ## addusers _group-name_ 将用户添加到指定的组。 **示例** `tabcmd addusers "Development" --users "users.csv"` ### 选项 `--users` 将给定 `.csv` 文件中的用户添加到指定组中。该文件应是每行一个用户名的简单列表。用户名不区分大小写。用户应已在 Tableau Server 上创建。 有关详细信息，请参见 [CSV 导入文件准则](https://help.tableau.com/current/server-linux/zh-cn/csvguidelines.htm)。 `--[no-]complete` 当设置为 `complete` 时，此选项要求所有行都必须有效，更改才能成功。如果未指定，则使用 `--complete`。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## 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 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## 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 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## 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 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## 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` 站点的数据提取加密模式可以为“**强制**”、“**已启用**”或“**已禁用**”。有关详细信息，请参见[静态数据提取加密](https://help.tableau.com/current/server-linux/zh-cn/security_ear.htm)。 `--run-now-enabled` 允许或拒绝用户手动运行数据提取刷新、流程或计划。**true** 允许用户手动运行任务，**false** 阻止用户手动运行任务。有关详细信息，请参见[服务器设置（常规和自定义）](https://help.tableau.com/current/server-linux/zh-cn/maintenance_set.htm)。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## createsiteusers _filename.csv_ 根据逗号分隔值 (CSV) 文件中提供的信息将用户添加到站点。如果尚未在服务器上创建用户，该命令会在将用户添加到站点之前创建该用户。 CSV 文件必须包含一个或多个用户名，还可（为每个用户）包括一个密码、全名、许可证类型、管理员级别、发布者（是/否），以及电子邮件地址。有关 CSV 文件的格式的信息，请参见[CSV 导入文件准则](https://help.tableau.com/current/server-linux/zh-cn/csvguidelines.htm)。 作为在 CSV 文件中包括管理员级别和发布者权限的替代方法，您可以通过包括 `--role` 选项并指定要为 CSV 文件中列出的用户分配的站点角色来传递访问级别信息。 默认情况下，用户将添加到您登录到的站点。若要将用户添加到其他站点，请包括全局 `--site` 选项并指定该站点。（您必须具有在指定的站点上创建用户的权限。） 如果服务器包含多个站点，则无法通过 `createsiteusers` 命令添加服务器（系统）管理员。请改用 `createusers`。如果为 `--role` 选项指定 `ServerAdministrator` 站点角色，则命令将返回错误。如果 CSV 文件包括 `System` 作为 administrator 的值，则该值将被忽略，并且会为用户分配 `Unlicensed` 许可证类型。 如果服务器只包含一个站点（默认站点），您可以为用户的 administrator 值指定 `system`，或者，如果希望 CSV 文件中的所有用户都成为服务器管理员，您甚至可以使用 `--role` 选项分配 `ServerAdministrator` 站点角色。 默认情况下，此命令使用同步操作创建用户（它将等待所有操作完成才会继续）。您可以使用 `--no-wait` 选项指定异步操作。 ### 本地身份验证 如果服务器配置为使用本地身份验证，则使用 CSV 文件中的信息创建用户。 ### Active Directory 身份验证 如果服务器配置为使用 Active Directory 身份验证，则会从 Active Directory 导入用户信息，并忽略 CSV 文件中的密码和友好名称信息。此外，如果 CSV 文件中指定了用户，但 Active Directory 中没有相应的用户，则不会将该用户添加到 Tableau Server。对于 Active Directory 用户，由于不能保证用户名在域之间的唯一性，因此必须包括域作为用户名的一部分。您可以将此项指定为 `domain\username` 或 `username@domain.com`；但是，我们建议使用 `domain\username` 格式。有关详细信息，请参见[使用外部身份存储的部署中的用户管理](https://help.tableau.com/current/server-linux/zh-cn/users_manage_ad.htm)。 **示例** `tabcmd createsiteusers "users.csv" --role "Explorer"` ### 选项 `--admin-type` 已弃用。请改用 `--role` 选项。 `--auth-type` 为 `.csv` 文件中的所有用户设置身份验证类型（`Local` 或 `SAML`）。如果未指定，则默认值为 `Local`。 **注意：**若要使用 SAML 身份验证，必须在 Tableau Server 设置中针对特定于站点的 SAML 配置站点。有关信息，请参见[配置特定于站点的 SAML](https://help.tableau.com/current/server-linux/zh-cn/saml_site_specific.htm)。 `--[no-]complete` 已弃用。默认错误行为：如果在十行范围内有 3 个以上的错误，则命令将失败。 `--no-publisher` 已弃用。请改用 `--role` 选项。 `--nowait` 不等待异步作业完成。 `--publisher` 已弃用。请改用 `--role` 选项。 `--role` 为 `.csv` 中的所有用户指定站点角色。如果要使用 --role 选项分配站点角色，请为每个站点角色创建单独的 CSV 文件。 有效的值包括：`ServerAdministrator`、`SiteAdministratorCreator`、`SiteAdministratorExplorer`、`SiteAdministrator`、`Creator`、`ExplorerCanPublish`、`Publisher`、`Explorer`、`Interactor`、`Viewer` 和 `Unlicensed`。 对于新用户，默认值为 `Unlicensed`，对于现有用户，默认值不变。如果有基于用户的服务器安装，并且在 `createsiteusers` 命令创建新用户的情况下您已达到用户许可证数的限制，则会以未许可用户的形式添加该用户。 **注意：**在多站点 Tableau Server 上，如果要使用 `--role` 选项分配 `ServerAdministrator` 站点角色，请使用 [`createusers`](#createusers) 命令，而不是 `createsiteusers`。 `--silent-progress` 不显示命令的进度消息。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## createusers _filename.csv_ 基于逗号分隔值 CSV 文件中提供的信息在 Tableau Server 中创建用户。 CSV 文件必须包含一个或多个用户名，还可（为每个用户）包括一个密码、全名、许可证类型、管理员级别、发布者（是/否），以及电子邮件地址。有关 CSV 文件的格式的信息，请参见[CSV 导入文件准则](https://help.tableau.com/current/server-linux/zh-cn/csvguidelines.htm)。 作为在 CSV 文件中包括管理员级别和发布者权限的替代方法，您可以通过包括 `--role` 选项并指定要为 CSV 文件中列出的用户分配的站点角色来传递访问级别信息。 如果服务器只有一个站点（默认站点），则会创建用户并将其添加到站点。如果服务器有多个站点，则会创建用户，但不会将其添加到任何站点。若要将用户添加到站点，请使用 [`createsiteusers`](#createsiteusers)。 如果有基于用户的服务器安装，并且在命令创建新用户的情况下您已达到用户许可证数的限制，则会在未许可用户的形式添加该用户。 ### 本地身份验证 如果服务器配置为使用本地身份验证，则使用 CSV 文件中的信息创建用户。 ### Active Directory 身份验证 如果服务器配置为使用 Active Directory 身份验证，则会从 Active Directory 导入用户信息，并忽略 CSV 文件中的密码和友好名称信息。此外，如果 CSV 文件中指定了用户，但 Active Directory 中没有相应的用户，则不会将该用户添加到 Tableau Server。对于 Active Directory 用户，由于不能保证用户名在域之间的唯一性，因此必须包括域作为用户名的一部分。您可以将此项指定为 `domain\username` 或 `username@domain.com`；但是，我们建议使用 `domain\username` 格式。有关详细信息，请参见[使用外部身份存储的部署中的用户管理](https://help.tableau.com/current/server-linux/zh-cn/users_manage_ad.htm)。 **示例** `tabcmd createusers "users.csv" --role "ServerAdministrator"` `tabcmd createusers "users.csv"` ### 选项 `--admin-type` 已弃用。请改用 `--role` 选项。 `--[no-]complete` 已弃用。默认错误行为：如果在十行范围内有 3 个以上的错误，则命令将失败。 `--no-publisher` 已弃用。请改用 `--role` 选项。 `--nowait` 不等待异步作业完成。 `--publisher` 已弃用。请改用 `--role` 选项。 `-r`, `--role` 为 `.csv` 中的所有用户指定站点角色。如果要使用 --role 选项分配站点角色，请为每个站点角色创建单独的 CSV 文件。 有效的值包括：`ServerAdministrator`、`SiteAdministratorCreator`、`SiteAdministratorExplorer`、`SiteAdministrator`、`Creator`、`ExplorerCanPublish`、`Publisher`、`Explorer`、`Interactor`、`Viewer` 和 `Unlicensed`。 在多站点服务器上，该命令不会将用户分配到站点。因此，该命令可成功分配的唯一站点角色是 `ServerAdministrator` 和 `Unlicensed`。如果指定任何其他站点角色，则该命令会分配 `Unlicensed` 角色。 在单站点服务器上，将使用您指定的角色创建用户并将其添加到默认站点。 如果有基于用户的服务器安装，并且在命令创建新用户的情况下您已达到用户许可证数的限制，则会在未许可用户的形式添加该用户。 `--silent-progress` 不显示命令的进度消息。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## decryptextracts 对站点上的所有数据提取进行解密。如果未指定任何站点，则将对默认站点上的数据提取进行解密。有关详细信息，请参见[静态数据提取加密](https://help.tableau.com/current/server-linux/zh-cn/security_ear.htm)。 根据数据提取的数量和大小，此操作可能会消耗大量服务器资源。请考虑在正常工作时间之外运行此命令。 **示例** `tabcmd decryptextracts "West Coast Sales"` 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## delete _workbook-name_ 或 _datasource-name_ 从服务器中删除指定工作簿或数据源。 此命令按原样使用服务器上的工作簿或数据源的名称，而不是发布时的文件名。 **示例** `tabcmd delete "Sales_Analysis"` ### 选项 `-r`, `--project` 包含您要删除的工作簿或数据源的项目的名称。如果未指定，则使用“Default”项目。 `--parent-project-path` 指定使用 `-r` 选项指定的嵌套项目的父项目的名称。例如，若要指定“Main”项目中名为“Nested”的项目，请使用以下语法： `--parent-project-path "Main" -r "Nested"`。对于多级嵌套项目： `--parent-project-path "Main/Nested/Nested2 -r "Nested3`。 `--workbook` 要删除的工作簿的名称。 `--datasource` 要删除的数据源的名称。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## 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 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## deletegroup _group-name_ 从服务器中删除指定的组。 **示例** `tabcmd deletegroup "Development"` 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## deleteproject _project-name_ 从服务器中删除指定的项目。 使用 `tabcmd`，您可以仅指定项目分层结构中的顶层项目。若要自动执行想要对父项目内的项目执行的任务，请使用等效的 Tableau [REST API](https://help.tableau.com/current/api/rest_api/en-us/help.htm#REST/rest_api_ref.htm%23API_Reference "在新浏览器选项卡中打开 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 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## deletesite _site-name_ 从服务器中删除指定的站点。 **示例** `tabcmd deletesite "Development"` 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## deletesiteusers _filename.csv_ 从您登录到的站点中移除用户。要移除的用户在一个文件中指定，该文件包含每行一个用户名的简单列表。（除用户名之外不需要其他信息。） 默认情况下，如果服务器只有一个站点，或者用户只属于一个站点，则还会从服务器中移除用户。在 Tableau Server Enterprise 安装上，如果服务器包含多个站点，则会从站点中移除分配了**“服务器管理员”**站点角色的用户，但不会从服务器中移除这些用户。 如果用户拥有内容，则用户的角色将变为**“未许可”**，但不会从服务器或站点中移除用户。内容仍然由该用户拥有。若要完全移除用户，您必须更改内容的所有者，然后再次尝试移除用户。 如果用户是从 Active Directory 导入的，则会从站点中移除用户，并可能会从服务器中将其移除。但是，不会将用户从 Active Directory 中删除。 **示例** `tabcmd deletesiteusers "users.csv"` 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## 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 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## editdomain **注意：**作为最佳做法，在编辑域之前，您应该备份 Tableau Server。该域保存在 Tableau 存储库中，如果更改不正确，管理员可能无法登录。 更改服务器上 Active Directory 域的昵称或完整域名。域“昵称”是 Windows NetBIOS 域名。 您可以修改服务器正在使用的任何域的昵称。通常，除了您用来登录的域外，您可以修改任何域的完整域名。但是，如果您当前用来登录的用户名同时存在于当前域以及新域中，则可以修改当前域的完整域名。 为了确保 Tableau Server 可以连接到其他 Active Directory 域，您还必须通过使用 TSM 设置 `wgserver.domain.whitelist` 选项来指定 Tableau Server 连接到的辅助域。有关辅助域和配置连接的详细信息，请参见[wgserver.domain.whitelist](https://help.tableau.com/current/server-linux/zh-cn/cli_configuration-set_tsm.htm#wgserver-domain)。 查看[使用外部身份存储的部署中的用户管理](https://help.tableau.com/current/server-linux/zh-cn/users_manage_ad.htm)，以了解多个域、域名映射和用户名与 Tableau Server 的交互方式。 若要查看域的列表，请使用 [listdomains](#listdomains)。 **示例** `tabcmd editdomain --id 2 --nickname "new-nickname"` `tabcmd editdomain --id 3 --name "new-name"` ### 选项 `--id` 要更改的域的 ID。若要获取域 ID 的列表，请使用 [listdomains](#listdomains)。 `--name` 域的新名称。 `--nickname` 域的新昵称。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## 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` 站点的数据提取加密模式可以为“**强制**”、“**已启用**”或“**已禁用**”。有关详细信息，请参见[静态数据提取加密](https://help.tableau.com/current/server-linux/zh-cn/security_ear.htm)。根据数据提取的数量和大小，此操作可能会消耗大量服务器资源。 `--run-now-enabled` 允许或拒绝用户手动运行数据提取刷新、流程或计划。**true** 允许用户手动运行任务，**false** 阻止用户手动运行任务。有关详细信息，请参见[服务器设置（常规和自定义）](https://help.tableau.com/current/server-linux/zh-cn/maintenance_set.htm)。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## encryptextracts 对站点上的所有数据提取进行加密。如果未指定任何站点，则将对默认站点上的数据提取进行加密。有关详细信息，请参见[静态数据提取加密](https://help.tableau.com/current/server-linux/zh-cn/security_ear.htm)。 根据数据提取的数量和大小，此操作可能会消耗大量服务器资源。请考虑在正常工作时间之外运行此命令。 **示例** `tabcmd encryptextracts "West Coast Sales"` 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## export 从 Tableau Server 导出视图或工作簿，并将其保存到文件。此命令还可导出恰好适用于视图的数据。视图数据在摘要级别导出。若要导出详细级别数据，您必须使用 Tableau Server UI。有关详细信息，请参见[下载视图和工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/export.htm)。 使用此命令时，请注意以下问题： - **权限**：若要导出，您必须拥有“导出图像”权限。虽然可针对每个工作簿或视图设置权限，但默认情况下，所有角色均会获得或继承此权限。 - **导出数据**：若要导出恰好适用于视图的数据，请使用 `--csv` 选项。这会将视图中使用的摘要数据导出为 .csv 文件。 - **指定要导出的视图、工作簿或数据：** - 使用 URL 的一部分标识要导出的内容，特别是工作簿或视图的 URL 中显示的 `"workbook/view"` 字符串。不要使用“友好名称”，并且不要包括 URL 末尾的 `:iid=__` 会话 ID。 例如，“_Superstore_”（超市）工作簿中的 Tableau 示例视图“_Order Details_”（订单详细信息）具有类似于如下的 URL：`/#/views/Superstore/OrderDetails?:iid=2` 若要导出“_Order Details_”（订单详细信息）视图，请使用字符串 `Superstore/OrderDetails`。 _不要_使用 `Superstore/Order Details` 或 `Superstore/OrderDetails?:iid=2`。 - 如果服务器运行多个站点，并且视图或工作簿不在“默认”站点上，请使用 `-t `。 - 若要导出工作簿，请通过在工作簿中打开视图来获取 URL 字符串，并在使用的字符串中包括视图。 在上面的示例中，若要导出“_Superstore_”（超市）工作簿，请使用字符串 `Superstore/OrderDetails`。 - 若要导出工作簿，必须在 Tableau Desktop 的“发布”对话框中选中“将工作表显示为标签”的情况下发布该工作簿。 **注意：**无法导出包含[管理视图](https://help.tableau.com/current/server/zh-cn/adminview.htm)的 Tableau 工作簿。 - 若要筛选下载的数据，请使用此格式添加参数筛选器： ?=value 或者，如果对参数进行筛选且该参数具有与度量或维度的名称匹配的显示名称： `?Parameters.=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 的页面方向（`landscape` 或 `portrait`）。如果不指定，则将使用其 Tableau Desktop 设置。 `--pagesize` 将导出的 PDF 的页面大小设置为以下各项之一：`unspecified`、`letter`、`legal`、`note folio`、`tabloid`、`ledger`、`statement`、`executive`、 `a3`、`a4`、`a5`、`b4`、`b5` 或 `quarto`。默认值为 `letter`。 `--width` 以像素为单位设置宽度。默认值为 800 像素。 `--height` 以像素为单位设置高度。默认值为 600 像素。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## get _url_ 从指定（部分）URL 表示的 Tableau Server 中获取资源。结果以文件形式返回。 使用此命令时，请注意以下问题： - **权限**：若要获取文件，您必须拥有“下载/另存到 Web”权限。虽然可针对每个工作簿或视图设置权限，但默认情况下，所有角色均会获得或继承此权限。 - **指定要获取的视图或工作簿**：使用 `"/views//."` 字符串指定要获取的视图，并使用 `"/workbooks/."` 字符串指定要获取的工作簿。将 ``  和 `` 替换为当您在浏览器打开视图时工作簿和视图在 URL 中的显示名称，并将 替换为想要保存的文件类型。不要在 URL 的末尾使用会话 ID (`?:iid=`)，也不要使用工作簿或视图的“友好”名称。 例如，当您在名为 _Metrics Summary_ 的工作簿中打开视图 _Regional Totals_ 时，URL 将类似于如下： `/views/MetricsSummary_1/RegionalTotals?:iid=1` 使用字符串 `/views/MetricsSummary_1/RegionalTotals.` 来获取视图。 使用字符串 `/workbooks/MetricsSummary_1.` 来获取工作簿。 从 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 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## 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 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## listdomains 显示服务器正在使用的 Active Directory 域的列表，以及其昵称和 ID。如果服务器配置为使用本地身份验证，则该命令仅返回域名 `local`。 **示例** `tabcmd listdomains` 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## listsites 返回已登录用户所属站点的列表。 **示例** `tabcmd listsites --username adam --password mypassword` ### 选项 `--get-extract-encryption-mode` 站点的数据提取加密模式可以为“**强制**”、“**已启用**”或“**已禁用**”。有关详细信息，请参见[静态数据提取加密](https://help.tableau.com/current/server-linux/zh-cn/security_ear.htm)。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## login 使 Tableau Server 用户登录。 可使用 `--server`、`--site`、`--username`、`--password` 全局选项来创建会话。 **注意**：使用 **tabcmd login** 命令时，将无法使用 SAML 站点登录 (SSO)，即使服务器配置为使用 SAML。若要登录，您必须传递在服务器上创建的用户的用户名和密码。您将具有您在登录时使用的 Tableau Server 用户的权限。有关详细信息，请参见[设置用户的站点角色](https://help.tableau.com/current/server-linux/zh-cn/users_site_roles.htm)和[权限](https://help.tableau.com/current/server-linux/zh-cn/permissions.htm)。 如果要使用创建会话时使用的相同信息进行登录，只需指定 `--password` 选项。将使用存储在 Cookie 中的服务器和用户名。 如果服务器使用 80（默认值）之外的端口，您需要指定该端口。 仅当服务器运行多个站点，并且您登录的站点不是默认站点时，才需要使用 `--site` (`-t`) 选项。如果未提供密码，则会提示您输入密码。如果指定 `--no-prompt` 选项但未提供密码，则该命令将失败。 登录后，该会话将继续进行，直到其在服务器上过期或 `logout` 命令运行。 **示例** 使用户 jsmith 登录到本地计算机上运行的 Tableau Server： `tabcmd login -s http://localhost -u jsmith -p password` 使管理员登录到 sales-server 上的“Sales”（销售额）站点： `tabcmd login -s http://sales-server -t Sales -u administrator -p password` `tabcmd login -s http://sales-server:8000 -t Sales -u administrator -p password` 使用 SSL 将管理员登录到 sales-server 上的“Sales”（销售额）站点，但不验证服务器的 SSL 证书： `tabcmd login --no-certcheck -s https://sales-server -t Sales -u administrator -p password` 为 localhost 建立正向代理和端口： `tabcmd login --proxy myfwdproxyserver:8888 -s http://localhost -u jsmith -p password` 使用户 jsmith 使用 SSL 登录到反向代理： `tabcmd login -s https://myreverseproxy -u jsmith -p password` ### 选项 `-s`, `--server` 如果从网络上的 Tableau Server 计算机中运行命令，您可以使用 `http://localhost`。否则，指定计算机的 URL，例如 `http://bigbox.myco.com` 或 `http://bigbox`。 如果服务器使用 SSL，则需要在计算机的 URL 中指定 `https://`。 对于 Tableau 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 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## logout 退出服务器。 **示例** `tabcmd logout` ## publish _filename.twb(x)_、_filename.tds(x)_ 或 _filename.hyper_ 将指定的工作簿 (.twb(x))、数据源 (.tds(x)) 或数据提取 (.hyper) 发布到 Tableau Server。 如果发布工作簿，则默认情况下无需数据库用户名或密码即可发布工作簿中的所有工作表。 将从在其中发布文件的项目中复制最初分配给工作簿或数据源的权限。可在发布了文件后更改已发布资源的权限。  如果工作簿中包含用户筛选器，则必须指定一个缩略图选项。 **注意：**目前不支持使用 tabcmd 发布扩展数据源或组合数据源。如果使用 tabcmd 发布组合工作簿或数据源文件，它将无法正确链接到其在服务器上的父项。 **示例** `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` 在将工作簿、数据源或数据提取发布到服务器时对数据提取进行加密。有关详细信息，请参见[静态数据提取加密](https://help.tableau.com/current/server-linux/zh-cn/security_ear.htm)。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## 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 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## reencryptextracts 使用新的加密密钥对站点上的所有数据提取进行重新加密。此命令将重新生成密钥加密密钥和数据加密密钥。您必须指定站点。有关详细信息，请参见[静态数据提取加密](https://help.tableau.com/current/server-linux/zh-cn/security_ear.htm)。 根据数据提取的数量和大小，此操作可能会消耗大量服务器资源。请考虑在正常工作时间之外运行此命令。 **示例** `tabcmd reencryptextracts "Default"` `tabcmd reencryptextracts "West Coast Sales"` 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## refreshextracts _workbook-name_ 或 _datasource-name_ 对属于指定工作簿或数据源的数据提取执行完全或增量刷新。 此命令使用服务器上显示的工作簿或数据源的名称，而不使用发布时的文件名。仅允许管理员或者工作簿或数据源的所有者执行此操作。 **注意：**如果服务器管理员为站点禁用了“**立即运行**”设置，此方法将失败并导致错误。有关详细信息，请参见 [Tableau Server 设置](https://help.tableau.com/current/server/zh-cn/maintenance_set.htm)。 **示例** 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` 结合使用以在数据提取数据源中实现计算。将操作添加到后台程序进程使用的查询中。如果后台程序进程可用，操作将立即运行。此操作出现在[数据提取后台任务](https://help.tableau.com/current/online/zh-cn/adminview_backgrnd.htm) 管理视图中。 `--removecalculations` 与 `--workbook` 或 `--datasource` 结合使用可移除以前实现的计算。将操作添加到后台程序进程使用的查询中。如果后台程序进程可用，操作将立即运行。此操作出现在[数据提取后台任务](https://help.tableau.com/current/online/zh-cn/adminview_backgrnd.htm) 管理视图中。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## reset\_openid\_sub 清除已与 Tableau Server 身份关联的 COpenID Connect 标识符（子值）。请参见[针对 OpenID Connect 更改 Tableau Server 中的 IdP](https://help.tableau.com/current/server-linux/zh-cn/openid_auth_changing_idp.htm)。 **示例** `tabcmd reset_openid_sub --target-username jsmith` ### 选项 `--target-username` 为指定的单个用户清除子值。 `--all` 为所有用户清除子值。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## removeusers _group-name_ 从指定的组中移除用户。 **示例** `tabcmd removeusers "Development" --users "users.csv"` ### 选项 `--users` 从指定的组删除给定 `.csv` 文件中的用户。该文件应是每行一个用户名的简单列表。 `--[no-]complete` 要求所有行都必须有效，更改才能成功。如果未指定，则使用 `--complete`。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## runschedule _schedule-name_ 为您当前登录的站点运行指定计划中的任务。您不能使用 tabcmd 为所有站点运行此命令。若要为所有站点运行计划中的任务，请登录 Web 界面，从**“计划”**页面中选择**“所有站点”**，然后按计划中**“立即运行”**。 此命令采用服务器上指定的计划名称。 此命令不可用于 Tableau Cloud。 **注意：**如果服务器管理员为站点禁用了“**立即运行**”设置，此方法将失败并导致错误。有关详细信息，请参见 [Tableau Server 设置](https://help.tableau.com/current/server/zh-cn/maintenance_set.htm)。 **示例** `tabcmd runschedule "5AM Sales Refresh"` 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## 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 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## syncgroup _group-name_ 将 Tableau Server 组与 Active Directory 组同步。如果 Tableau Server 组尚未存在，则会创建该组并将其与指定的 Active Directory 组同步。 如果组名称本身包括“@”（而不是作为域分隔符），则您需要使用十六进制格式引用该符号“\\0x40” **示例** `tabcmd syncgroup "Development"` `tabcmd syncgroup "Dev\0x40West"` **注意：** 如果同步您是其成员的组，则使用此命令所做的更改不会应用于您的用户。举例来说，如果您使用此命令移除您是其成员的组中用户的管理员权限，则在命令完成时您仍然是管理员。 ### 选项 `--grant-license-mode ` 指定是否应在登录时授予角色。默认值为 `on-sync`。有效的值包括 `on-login`、`on-sync`。如果未指定值，则会假定使用了 `on-sync`，并在组同步时授予默认角色。有关详细信息，请参见[使用“登录时授予角色”修改用户角色](https://help.tableau.com/current/server-linux/zh-cn/grant_role.htm#GrantRoleOnSignin)。 `--no-publisher` 已弃用。请改用 `--role` 选项。 `--overwritesiterole` 使用 `--role` 时，允许用权限较低的角色覆盖用户的站点角色。默认情况下，在使用 `--role` 时，用户站点角色可能会收到提示，但无法降级。由于 `--overwritesiterole` 选项会使用户站点角色降级，因此请小心使用。 `--publisher` 已弃用。请改用 `--role` 选项。 `-r`, `--role` 为组中的用户指定站点角色。默认值为 `Unlicensed`。 有效的值包括：`SiteAdministratorCreator`、`SiteAdministratorExplorer`、`SiteAdministrator`、`Creator`、`ExplorerCanPublish`、`Publisher`、`Explorer`、`Interactor`、`Viewer`、`Unlicensed`。 `--silent-progress` 不显示命令的进度消息。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## upgradethumbnails 启动和停止“升级缩略图”作业。若要了解详细信息，请参见[“升级缩略图”作业](https://help.tableau.com/current/server-linux/zh-cn/adminview_backgrounder_upgrade_thumbnails.htm)。 **示例** 启动“升级缩略图”作业： `tabcmd upgradethumbnails --server ` 停止正在执行的“升级缩略图”作业： `tabcmd upgradethumbnails --server --stop` ### 选项 `--stop` 指定后，停止正在执行的“升级缩略图”作业。如果未指定此选项，则将启动“升级缩略图”作业。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## validateidpmetadata 使用不安全的摘要算法 SHA-1 标识配置了 IdP 的 Tableau Server 站点。此命令还标识所使用证书 RSA 密钥大小或椭圆曲线大小不足的 IdP。 **注意：**此命令仅可用于特定于站点的 SAML。有关详细信息，请参见[配置特定于站点的 SAML](https://help.tableau.com/current/server-linux/zh-cn/saml_site_specific.htm)。 ### 选项 `--digest-algorithms ` 用空格分隔的摘要算法列表。合法值包括 `sha1` 和 `sha256`。如果未指定，则服务器使用服务器配置设置 [wgserver.saml.blocklisted\_digest\_algorithms](https://help.tableau.com/current/server-linux/zh-cn/cli_configuration-set_tsm.htm#wgserver5) 中的值。 `--min-allowed-elliptic-curve-size ` 如果未指定，则服务器使用服务器配置设置 [wgserver.saml.min\_allowed.elliptic\_curve\_size](https://help.tableau.com/current/server-linux/zh-cn/cli_configuration-set_tsm.htm#wgserver2) 中的值。 `--min-allowed-rsa-key-size ` 如果未指定，则服务器使用服务器配置设置 [wgserver.saml.min\_allowed.rsa\_key\_size](https://help.tableau.com/current/server-linux/zh-cn/cli_configuration-set_tsm.htm#wgserver4) 中的值。 `--site-names ` 要对其执行证书验证的站点名称的空格分隔列表。如果未指定，则将检查所有站点。 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` ## version 显示 tabcmd 实用工具的当前安装的版本信息。 **示例** `tabcmd version` 全局选项 所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。 `-h`, `--help` 显示命令帮助。 `-c`, `--use-certificate` 使用客户端证书登录。启用相互 SSL 时需要。 有关配置证书的信息，请从适用于您的 Tableau Server OS 的以下主题开始： - **Windows**：[配置相互 SSL](https://help.tableau.com/current/server/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") - **Linux**：[配置相互 SSL](https://help.tableau.com/current/server-linux/zh-cn/ssl_config_mutual.htm "在新浏览器选项卡中打开主题") `-s`, `--server` Tableau Server URL，至少需要使用一次才能开始会话。 `-u`, `--user` Tableau Server 用户名，至少需要使用一次才能开始会话。 `-p`, `--password` Tableau Server 密码，至少需要使用一次才能开始会话。 `--password-file` 允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。 `-t`, `--site` 指示命令将应用于由 Tableau Server 站点 ID 指定的站点，用单引号或双引号引起来。若要指定默认站点，请使用带单引号或双引号（''或""）的空字符串，或使用双引号中的“Default”（"Default"）。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。 `-x`, `--proxy` Host:Port 使用指定的 HTTP 代理。 `--no-prompt` 指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。 `--no-proxy` 指定后，将不使用 HTTP 代理。 `--no-certcheck` 在指定时，tabcmd（客户端）不会验证服务器的 SSL 证书。 `--[no-]cookie` 指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。 `--timeout` 等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。 `--` 指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。 `tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1` **提示**：有关可用于 Tableau Cloud 的 Tabcmd 1.0 命令，请参见 [tabcmd 命令](https://help.tableau.com/current/online/zh-cn/tabcmd_cmd.htm)。