命令行选项和属性
Tableau 安装程序命令行接受两种类型的值:选项和属性。选项是控制命令行行为的标志列表。属性提供您想要实现的操作或操作列表。
安装程序选项
您可以在命令行中指定一个或多个选项:注意有关选项的以下信息:
每个选项都以斜杠 (
/
) 为前缀。选项必须放在属性前面。
选项 | 描述 |
---|---|
quiet | 运行安装程序时不会显示消息(状态或安装进度),也无需用户交互。产品在安装完成后不会启动。 |
passive | 运行安装程序并显示对话框以及安装状态。但不提示用户输入内容。产品在安装完成后启动。 |
norestart | 禁止任何尝试重新启动的操作。默认情况下,安装程序将在重新启动之前提示您,除非您在无提示模式下运行安装程序。 |
log "logfile.txt" | 将安装信息记录到指定的路径和文件。指定路径和文件名,例如 /log "c:\logs\logfile.txt" 。默认日志文件为系统 %TEMP% 目录。 |
repair | 运行安装程序以修复 Tableau 的现有安装。 |
uninstall | 卸载 Tableau 的现有安装。 |
h | Help — 列出安装程序的选项和属性。 |
安装程序属性
您可以为安装程序在命令行中包括一个或多个属性。注意有关这些属性的以下信息:
这些属性不能用于在初始安装后更新任何设置。
属性名称和值区分大小写。
等号的两边没有空格。
各个属性集用空格分隔。
某些属性特定于版本。
属性 | 描述 | 产品版本 | 值 |
---|---|---|---|
ACCEPTEULA | 接受最终用户许可协议 (EULA)。如果未将此选项设置为 1 ,则无法使用无提示或被动模式安装 Tableau。 | Desktop:10.1 及更高版本 Prep:所有版本 Reader:所有版本 Public:所有版本 | 1 = 接受 0 = 不接受(默认值) |
ACTIVATE_KEY | 通过命令行激活 Tableau Desktop 或 Tableau Prep Builder。除非您在使用 基于登录名的许可证管理 的环境中激活,否则您将需要您的产品密钥。添加一个包含安装程序选项 ACTIVATE_KEY="<key>" 的命令行。此安装程序运行 -activate 来应用产品密钥。有关详细信息,请参见激活 Tableau Desktop 和 Tableau Prep Builder。 | Desktop:10.5 及更高版本 Prep:2018.1.2 及更高版本 Reader:不可用 Public:不可用 | 使用引号输入的产品密钥。 |
ACTIVATIONSERVER | 设置您希望用户在使用 基于登录名的许可证管理 时用于激活的 Tableau Server 的默认 URL。 有关详细信息,请参见基于登录名的许可证管理(链接在新窗口中打开)。 | Desktop:2019.3 及更高版本 Prep:2020.4.1 及更高版本 Reader:不可用 Public:不可用 | 将为用户授权的 Tableau Server 的 URL。 |
ATRENABLED | 启用虚拟桌面支持。如果要为虚拟桌面支持使用自动许可证停用,您需要在安装时或通过编辑注册表来启用此选项。 有关详细信息,请参见配置虚拟桌面支持(链接在新窗口中打开)。 | Desktop:10.5 及更高版本 Prep:2018.2.1 及更高版本 Reader:不可用 Public:不可用 | 1 = 已启用(默认值) 0 = 未启用 |
ATRREQUESTEDDURATIONSECONDS | 设置在许可证自动停用之前 Tableau Desktop 或 Tableau Prep Builder 可在不联系 ATR 服务的情况下运行的时长。默认值为 1209600 秒(14 天)。只有在设置了 ATREnabled 的情况下,此选项才适用。 如果要使用默认值 14 天,则不需要设置此选项。若要更改间隔,请使用此选项指定新的间隔(秒)。例如,以下命令会安装 Tableau Desktop、将其配置为自动停用许可证,并将持续时间设置为 14400 秒(4 小时): | Desktop:10.5 及更高版本 Prep:2018.2.1 及更高版本 Reader:不可用 Public:不可用 | 秒数整数值。最小值为 14400 秒(4 小时),最大值为 15552000 秒(6 个月)。
|
AUTOSAVE | 将 Tableau 配置为自动保存工作。如果 Tableau 意外关闭,则用户可以打开工作簿 (.twbr) 文件或流程 (.tflr) 文件的恢复版本。 Tableau Desktop:如果选择 此选项不适用于 Tableau Reader 或 Tableau Public。 有关详细信息,请参见关闭文件恢复(链接在新窗口中打开)。 | Desktop:10.2 及更高版本 Prep:2020.3.3 及更高版本 Reader:不可用 Public:不可用 | 1 = 是(默认值) 0 = 否 |
AUTOUPDATE | 配置 Tableau 以检查产品更新。您还可以控制您的用户将更新到哪个 Tableau Desktop 版本。 如果选择 AUTOUPDATE=0 , 则 Tableau Desktop 中“帮助”菜单上用于更改“自动更新”和“检查产品更新”设置的选项对于用户处于禁用状态。有关详细信息,请参见控制 Tableau Desktop 的产品更新。 | Desktop:9.1 及更高版本(自动更新) 10.2 及更高版本(检查产品更新) Prep:不可用 Reader:不可用 Public:9.1 及更高版本(自动更新) 10.2 及更高版本(检查产品更新) | 1 = 是(默认值) 0 = 否 |
AUTOUPDATESERVER | 指定哪个服务器将检查 Tableau 产品更新。可通过自定义并将 TableauAutoUpdate.xml 文件随相应的 Tableau 安装程序一起托管来为用户控制更新。有关详细信息,请参见控制 Tableau Desktop 的产品更新。 | Desktop:9.1 及更高版本 Prep:不可用 Reader:不可用 Public:不可用 | 主机名,例如 assets.internal.lan 。默认值为 downloads.tableau.com |
CRASHDUMP | 如果 Tableau 遇到问题并意外关闭,则会生成崩溃转储文件和日志。使用此选项通过命令行启用或禁用此选项。 有关详细信息,请参见关闭错误报告(链接在新窗口中打开)。 此选项在 Mac 上不可用。 | Desktop:2018.2 及更高版本 Prep:所有版本 Reader:所有版本 Public:所有版本 | 1 = 是(默认值) 0 = 否 |
CUSTOMSAMPLESDIR | 指定自定义示例工作簿的本地目录路径。您最多可以使用组织的 5 个自定义示例工作簿替换默认的 Tableau 加速器工作簿。 有关详细信息,请参见将加速器工作簿替换为自定义工作簿(仅限 Tableau Desktop) 。 仅适用于 Tableau Desktop。 | Desktop:2021.3 及更高版本 Prep:不可用 Reader:不可用 Public:不可用 | 您创建的自定义示例目录的完整本地文件路径。 例如“C:\用户\mkim\文档\我的 Tableau 存储库\CustomSamples” 不支持网络目录。 |
DESKTOPSHORTCUT | 创建桌面快捷方式。 | Desktop:所有版本 Prep:所有版本 Reader:所有版本 Public:所有版本 | 1 = 是(默认值) 0 = 否 |
DISABLEEXTENSIONS | 启用仪表板扩展程序,借助 Tableau 和第三方开发人员创建的 Web 应用程序来扩展仪表板功能。从版本 2019.4 开始,仪表板扩展程序要么是支持网络的扩展程序(并且具有对 Web 的完全访问权限),要么是沙盒化扩展程序(并在受保护的环境中运行,无需 Web 访问权限)。 默认情况下,允许使用支持网络的仪表板扩展程序和沙盒化仪表板扩展程序。如果不想为用户提供此选项,请设置 如果只想允许沙盒化扩展程序,请将 有关此功能的详细信息,请参见 Tableau Desktop 联机帮助中的使用仪表板扩展程序(链接在新窗口中打开) 。有关使用仪表板扩展程序时的数据安全性的详细信息,请参见扩展程序安全性 - 部署最佳做法(链接在新窗口中打开)。有关如何在安装后禁用此功能的信息,请参见禁用仪表板和可视化项扩展程序(仅限 Tableau Desktop)。 | Desktop:2019.1 及更高版本 Prep:不可用 Reader:所有版本 Public:不可用 | 1 = 是 0 = 否(默认值) |
DISABLENETWORKEXTENSIONS | 支持网络的仪表板扩展程序是在 Web 服务器上运行的扩展程序,这些扩展程序可以位于本地网络内部或外部。支持网络的扩展程序具有对 Web 的完全访问权限。如果不想为用户提供此选项,请设置 DISABLENETWORKEXTENSIONS=1 。注意:如果使用此选项禁用了支持网络的扩展程序,则只允许沙盒化仪表板扩展程序。沙盒化仪表板扩展程序在 Tableau 托管的受保护环境中运行。 有关仪表板扩展程序的详细信息,请参见 Tableau Desktop 帮助中的数据安全扩展程序、支持网络的扩展程序以及沙盒化扩展程序(链接在新窗口中打开)。有关使用仪表板扩展程序时的数据安全性的信息,请参见扩展程序安全性 - 部署最佳做法(链接在新窗口中打开)。有关如何在安装后禁用此功能的信息,请参见禁用仪表板和可视化项扩展程序(仅限 Tableau Desktop)。 | Desktop:2019.4 及更高版本 Prep:不可用 Reader:所有版本 Public:不可用 | 1 = 是 0 = 否(默认值) |
DISCOVERPANEURL | 创建使用已启用 https 的 URL 托管的自定义内容,并将其显示在 Tableau Desktop 的开始页面上的“发现”窗格中,而不是 Tableau 提供的默认内容。 使用此模板(链接在新窗口中打开)以便为您的内容采用相同的布局。 对于 Windows,请在安装期间在命令行中包括 DISCOVERPANEURL="<https://YourWebPage.com>” 属性。 例如, 有关如何在安装后为“发现”窗格配置自定义内容的信息,请参见将“发现”窗格配置为显示自定义内容(仅限 Tableau Desktop)。 | Desktop:2020.1 及更高版本 Prep:不可用 Reader:不可用 Public:不可用 | 自定义网页的 URL。例如“https://help.tableau.com” |
DRIVERDIR | 驱动程序的默认位置是 Program Files/Tableau/Drivers。Tableau Desktop、Tableau Prep Builder 和 Tableau Bridge 共用此位置。 对于 Windows,您可以为驱动程序指定安装目录(而不是默认值)。此选项会创建该目录并在 HKEY_LOCAL_MACHINE\ 注册表中创建一个条目。 任何一个应用程序最后更改的目录是所有三个应用程序将指向的新目录。 如果更改驱动程序目录,则必须将安装在之前的目录中的任何驱动程序手动转移到新目录。否则,应用程序可能找不到驱动程序。 有关连接器驱动程序要求的更多信息,请参见联机帮助中的连接器示例(链接在新窗口中打开)。有关下载驱动程序的信息,请参见驱动程序下载(链接在新窗口中打开)页面。 | Desktop:10.3 及更高版本 Prep:2018.2.1 及更高版本 Reader:不可用 Public:不可用 | 诸如 D:\Drivers 之类的路径 |
INSTALLDIR | 指定除默认目录之外的安装目录。 如果为安装位置指定自定义目录,并打算将未来的版本安装到此相同位置,您需要指定要安装到其中的版本特定子文件夹。否则,您将需要先卸载以前的版本。 不支持将多个版本并排安装在同一子目录中。 | Desktop:所有版本 Prep:所有版本 Reader:所有版本 Public:所有版本 | 诸如 D:\Software\Tableau 等路径。 |
LBLM | 设置为 enabled (默认值),许可屏幕将显示两个激活选项(产品密钥或凭据)。设置为 设置为 | Desktop:2019.4 及更高版本 Prep:2019.4.1 及更高版本 Reader:不可用 Public:不可用 | enabled disabled required |
RECLAIMLICENSE | 添加包括 RECLAIMLICENSE=1 的单一命令行,用于在卸载 Tableau Desktop 时停用任何永久(或版本 2018.3 及更高版本的订阅)产品密钥。此选项不可用于 Mac 或 Tableau Prep。 | Desktop:10.3 及更高版本 Prep:不可用 Reader:不可用 Public:不可用 | 1 = 是 |
REGISTER | 在安装期间自动注册 Tableau Desktop 或 Tableau Prep Builder。添加一个包含安装程序选项 REGISTER=1 的命令行。安装程序将运行 -register 以完成注册。此选项使用注册表位置 HKEY_CURRENT_USER\Software\Tableau\Registration\Data 中的注册信息。有关如何向注册表中添加此信息的信息,请参见注册 Tableau Desktop 和 Tableau Prep Builder。 此选项在 Mac 上不可用。 | Desktop:2018.1 及更高版本 Prep:2018.1.2 及更高版本 Reader:不可用 Public:不可用 | 1 = 是 |
REMOVEINSTALLEDAPP | 从命令行进行安装时,将会自动移除所有版本的版本 9.3 及更高版本。若要移除版本 9.2 和更早版本,您必须手动卸载它们。 此选项在 Mac 上不可用。 | Desktop:10.4 及更高版本 Prep:不可用 Reader:10.4 及更高版本 Public:10.4 及更高版本 | 1 = 是 0 = 否(默认值) |
REPORTINGSERVER | 用于 Desktop 许可证报告。指定将许可证报告信息发送到其中的一个或多个 Tableau Server 实例。对于 Tableau Desktop 许可证报告,要求在组织中启用 Tableau Server。有关详细信息,请参见启用和配置 Tableau Desktop 报告。 用逗号分隔多个服务器 URL。例如,以下命令会安装 Tableau Desktop 并将它配置为向两个 Tableau Server 实例报告: tableau-setup-std-x64.exe /quiet ACCEPTEULA=1 REPORTINGSERVER="http://mytableau,https://mytableau02:8060" | Desktop:所有版本 Prep:不可用 Reader:不可用 Public:不可用 | 服务器 URL,例如 http://mytableau 。 |
SCHEDULEREPORTINTERVAL | 用于 Desktop 许可证报告。指定 Tableau Desktop 向 Tableau Server 报告许可信息所使用的间隔。必须为 Tableau Desktop 许可证报告启用 Tableau Server。有关详细信息,请参见启用和配置 Tableau Desktop 报告。 如果要使用默认的八小时,则不需要设置此选项。若要更改间隔,请使用此选项指定新的间隔(秒)。例如,以下命令会安装 Tableau Desktop、将其配置为向两个 Tableau Server 实例报告,并将报告间隔设置为四小时(14,400 秒): tableau-setup-std-x64.exe /quiet ACCEPTEULA=1 SCHEDULEREPORTINTERVAL=14400 REPORTINGSERVER="http://mytableau,https://mytableau02:8060" | Desktop:所有版本 Prep:不可用 Reader:不可用 Public:不可用 | 秒数整数值。 默认值为 |
SENDTELEMETRY | Tableau 会收集数据,帮助我们了解产品的使用情况,以便改进现有功能并开发新的功能。所有使用情况数据均依据隐私政策(链接在新窗口中打开)收集和处理。如果您不想参与此选项,可通过在安装过程中或安装之后选择退出。 对于 Windows,若要在安装过程中通过命令行关闭此选项,请添加包括 若要在安装后为 Windows 和在 Mac 上启用或禁用此选项,请参见关闭使用情况报告。 | Desktop:2018.2 及更高版本 Prep:所有版本 Reader:2018.2 及更高版本 Public:2018.2 及更高版本 | 1 = 是(默认值) 0 = 否 |
SILENTLYREGISTERUSER | 以静默方式将注册信息发送到 Tableau,以便用户在多个虚拟机环境中工作时不必填写注册对话框。 | Desktop:2019.4 及更高版本 Prep:2020.4.1 及更高版本 Reader:2018.2 及更高版本 Public:2018.2 及更高版本 | true=启用 |
SKIPAPPLICATIONLAUNCH | 您可以设置 SKIPAPPLICATIONLAUNCH=1 以防止新应用程序在安装过程完成时自动打开。此选项适用于手动安装和自动更新。此选项不适用于无提示安装,因为在使用该选项时应用程序不会自动打开。此选项在 Mac 上不可用。 | Desktop:10.4 及更高版本 Prep:不可用 Reader:不可用 Public:10.4 及更高版本 | 1 = 是 0 = 否(默认值) |
STARTMENUSHORTCUT | 在 Windows 的“开始”菜单上创建 Tableau 条目。 | Desktop:所有版本 Prep:所有版本 Reader:所有版本 Public:所有版本 | 1 = 是(默认值) 0 = 否 |
SYNCHRONOUSLICENSECHECK | 在 Tableau 启动时验证 Tableau 许可证,以便在多个虚拟机环境中工作时,许可证状态是最新的。 | Desktop:2019.4 及更高版本 Prep:2019.4.1 及更高版本 Reader:不可用 Public:不可用 | true=启用 |
WEBVIEWTOGGLEWEBZONESENABLED | 允许仪表板中的网页对象显示目标 URL。有关详细信息,请参见添加仪表板对象(链接在新窗口中打开)。 | Desktop:2020.4 及更高版本 Prep:不可用 Reader:不可用 Public:2020.4 及更高版本 | 1 = 是(默认值) 0 = 否 |