--- schema_version: "1" id: 7fabfbd4262812addc2d9eb268189866c1b891243d4d4e98d48db62d93570833 title: 通过命令行安装 collection: tableau version: current locale: zh-cn portal_url: https://docs.salesforce.com/tableau/current/zh-cn/desktopdeploy/desktop_deploy_automate.md canonical_url: https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_automate.htm source_site: help.tableau.com content_type: documentation content_hash: a6705c1fdba2cc06846932207e77575e447cf453adba39a998d1262cc5803a90 description: Install Tableau Desktop and Prep Builder from the command line, including activation. --- [跳转到主要内容](#main-content) # 通过命令行安装 本文介绍如何使用命令行安装 Tableau Desktop、Tableau Prep Builder 和 Tableau Desktop Public Edition，并执行其他安装操作（例如激活和注册），以及如何卸载产品。 有关查找安装程序和产品密钥的更多详细信息，请参见[安装程序在何处？](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_download.htm)和[查找产品密钥](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_product_key.htm)。 **注意**：如果您要升级，请参见[升级 Tableau Desktop 和 Tableau Prep Builder](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_upgrade.htm)，了解有关准备升级的信息。 默认情况下，Tableau 会为您启用某些功能，例如使用报告或自动产品更新（仅限 Tableau Desktop）。有关如何关闭这些功能及其他功能的信息，请参见[在安装之后更改安装设置](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_setting_changes.htm)。 ## 开始之前 - **与服务器的兼容性**：Tableau 产品并不总是同时发布。安装新版本的 Tableau Desktop 时，请确保它与 Tableau Server 兼容。请参见[查找和解决兼容性问题](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_compatibility.htm)。 - **在同一台计算机上安装 Desktop 和 Prep**：Tableau Prep Builder 设计为可与 Tableau Desktop 配合使用。建议您将 Tableau Prep Builder 和 Tableau Desktop 安装在同一台计算机上。 - **不要在运行 Tableau Server 的同一台计算机上安装 Tableau Prep Builder**：Tableau Server 资源管理器 (SRM) 无法区分 Tableau Server 协议服务器进程和 Tableau Prep Builder 协议服务器进程。如果计算机资源耗尽，SRM 可能会终止属于 Tableau Prep Builder 的协议服务器进程，而该进程没有恢复机制。 - **Windows 安装程序要求**：如果使用需要 Windows 安装程序（`.msi` 文件）的部署工具来安装 Tableau Desktop 或 Tableau Prep Builder，请按照[提取并运行 Windows (MSI) 安装程序](#msi)中的说明进行操作，从 Tableau 安装程序 `.exe` 文件中提取 `.msi` 文件。 单击下面适用于您所安装的产品的选项卡，查看安装步骤。 ### Windows 1. 以管理员身份从计算机的命令行中运行安装程序 `.exe` 文件。 如果需要提取 .msi 文件，请按照本文的[提取并运行 Windows (MSI) 安装程序](#msi)部分中的说明进行操作。 用于从命令行中运行 Tableau 安装程序的语法为： `tableau___.exe /option1 /option2 PROPERTY1 PROPERTY2` - `tableau___.exe`：这是您所安装的产品和版本的 Tableau 安装程序。 - **选项：**用于指定安装过程应如何运行的选项。例如，是否应在安装时显示输出或者是否应创建日志文件。有关可用选项的列表，请参见[安装程序选项](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_cli_ref.htm#Installer_options) 。 - **属性：**这些设置指定安装程序在安装过程中应进行的配置设置。有关可用属性的列表，请参见[安装程序属性](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_cli_ref.htm#installer_properties)。 2. 从 `.exe` 文件所在的目录运行命令，或指定计算机上 `.exe` 文件位置的完整路径。不要从网络上的共享目录中运行安装程序。而是要将 `.exe` 文件下载到您进行安装的计算机上的某个目录。 **示例** 以下示例显示具有一些选项和一些属性设置的安装程序命令： `tableauDesktop-64bit-2021-4-4.exe /quiet /norestart ACCEPTEULA=1 AUTOUPDATESERVER="assets.intranet.lan" REPORTINGSERVER="http://mytableau"` 示例中的命令执行以下操作： - 安装 Tableau Desktop 2021.4.4 的 64 位版本。 - 在无提示模式下运行安装程序，意即安装过程不显示提示、UI 或许可证对话框。 - 将安装设置为完成后不重新启动。 - 接受最终用户许可协议 (EULA)。 - 配置非默认产品更新服务器。 - 配置产品以将许可证报告发送到内部 Tableau Server。 ### Mac > [!IMPORTANT] > > **重要信息**：仅在根驱动器上安装 Tableau，以便 FlexNet 和设备驱动程序安装到正确的位置。 1. 将 Tableau Desktop DMG 文件的副本上载到网络共享位置，并告知用户从该处将文件下载到其 Mac 计算机。可以按照提示操作来完成安装。 您还可以创建一个 `.sh` 脚本，用于装载 DMG 文件并将 Tableau 复制到用户的计算机。以下示例显示用于为不同版本的 Tableau Desktop 执行此任务的脚本。 **示例：Tableau Desktop 版本 10.2 及更高版本** #!/usr/bin/env bash # mount the DMG and copy Tableau.app to a folder output=\`yes | hdiutil attach "__.dmg"\` sleep 10 volName=\`echo "$output" | tail -n 1 |sed 's;^.\*\\(/Volumes.\*$\\);\\1;'\` open "/Volumes/Tableau/Tableau Desktop.pkg" # dismount the Tableau DMG volume hdiutil detach " "${volName}" " -force 2. （可选）运行安装程序应用程序以执行无提示安装。在终端提示符处键入以下命令： `sudo installer -pkg -target /` 这将提示输入管理员密码，然后执行基本上无提示的安装。您将看到以下三行： - `installer: Package name is Tableau Desktop` - `installer: Upgrading at base path /` - `installer: The upgrade was successful.` #### 选择要自动安装的驱动程序 默认情况下，会随 Tableau Desktop 一起自动安装多个数据源驱动程序。有关完整列表，请参见[安装之前](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_intro.htm)。 **注意**：只会在 Mac 上会自动安装 PostgreSQL 驱动程序。 若要阻止自动安装其中一个或全部驱动程序，请首先使用 `‑showChoiceChangesXML` 针对 Desktop.pkg 运行 Mac 安装程序应用程序，以生成包含所有可能的自定义项的 plist 文件。语法如下： `installer -showChoiceChangesXML -pkg –target / > ` **示例：** `installer -showChoiceChangesXML -pkg Install\ Tableau\ Desktop.pkg –target / > InstallTableauDesktopChoices.xml` 对于 Oracle 驱动程序，生成的 plist 文件中的该部分如下所示： attributeSetting 1 choiceAttribute selected choiceIdentifier com.tableau.oracle 若要阻止安装驱动程序，请执行以下操作： 1. 在 .ppsdc 文件中，对于不希望自动安装的任何驱动程序，将 `` 的值从 1 更改为 0。 2. 保存该文件，然后通过使用以下命令将其添加到命令行，从而传递给安装程序： `-applyChoiceChangesXML ` 创建了包含所需更改的 plist 文件后，完整的命令行可能类似于如下： `sudo installer -pkg Install\ Tableau\ Desktop.pkg -applyChoiceChangesXML InstallTableauDesktopChoices.xml -pkg -target /` 有关 Mac 安装程序应用程序的文档，请参见 [Apple 开发人员](https://developer.apple.com/documentation/)文档。 #### 禁用桌面快捷方式 若要防止 Tableau 安装程序为 Tableau Desktop 创建桌面快捷方式，请按上一部分的说明生成 XML 文件，并将以下部分中的整数值从 0 更改为 1。 attributeSetting 0 choiceAttribute selected choiceIdentifier com.tableau.desktopShortcut 有关 Tableau Prep 中支持的所有命令行选项的列表，请参见 [Tableau Prep 命令行参考](https://help.tableau.com/current/prep/zh-cn/prep_command_line_reference.htm)。 **注意：**此安装选项仅适用于 Windows。 1. 以管理员身份从计算机的命令行中运行安装程序 `.exe` 文件。 用于从命令行中运行 Tableau 安装程序的语法为： `tableau___.exe /option1 /option2 PROPERTY1 PROPERTY2` - `tableau___.exe`：这是您所安装的产品和版本的 Tableau 安装程序。 - **选项：**用于指定安装过程应如何运行的选项。例如，是否应在安装时显示输出或者是否应创建日志文件。有关可用选项的列表，请参见[安装程序选项](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_cli_ref.htm#Installer_options) 。 - **属性：**这些设置指定安装程序在安装过程中应进行的配置设置。有关可用属性的列表，请参见[安装程序属性](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_cli_ref.htm#installer_properties)。 2. 从 `.exe` 文件所在的目录运行命令，或指定计算机上 `.exe` 文件位置的完整路径。不要从网络上的共享目录中运行安装程序。而是要将 `.exe` 文件下载到您进行安装的计算机上的某个目录。 **示例** 以下示例显示具有一些选项和一些属性设置的安装程序命令： `tableauPrepBuilder-64bit-2021-4-4.exe /quiet /norestart ACCEPTEULA=1 CRASHDUMP="0" SENDTELEMETRY="0"` 示例中的命令执行以下操作： - 安装 Tableau Prep Builder 2021.4.4。 - 在无提示模式下运行安装程序，意即安装过程不显示提示、UI 或许可证对话框。 - 将安装设置为完成后不重新启动。 - 接受最终用户许可协议 (EULA)。 - 将错误报告设置为关闭。 - 将使用情况报告设置为关闭 ## 提取并运行 Windows (MSI) 安装程序 如果您使用需要 Windows 安装程序（`.msi` 文件）的部署工具来安装 Tableau Desktop 或 Tableau Prep Builder，您可以从 Tableau 安装程序 `.exe` 文件中提取 `.msi` 文件。在提取 `.msi` 文件时，您将看到安装程序 `.msi` 文件，以及包括在 Tableau Desktop 安装过程中的每个数据库驱动程序的 `.msi` 文件。 若要提取 `.msi` 文件，您可以使用像 WiX Toolset 这样的第三方工具。 **免责声明：** 此解决方案包括有关第三方产品的信息。尽管我们会尽力保持第三方内容引用的正确性，但是 WiX Toolset 选项可能会进行更改而不另行通知。有关最新信息，请查阅 WiX 文档。若要在使用 WiX 实用工具时获得帮助，请联系 WiX 用户邮件列表。 1. 在下载了 Tableau 安装程序的计算机上，从 WiX 网站 ([http://wixtoolset.org/](http://wixtoolset.org/)) 下载并安装最新版本的 WiX Toolset。 2. 以管理员身份打开命令窗口，并导航到安装了 WiX Toolset 的文件夹的根目录。 3. 运行以下命令： `Dark.exe __ -x __` 例如，运行以下命令： `Dark.exe C:\tableau-setup-std-tableau-2021-1.21.0125.1838-x64.exe -x c:\output` 输出文件夹将包含一个名为 `AttachedContainer` 的文件夹，其中包括 `.msi` 文件。 ## 激活 Tableau Desktop 和 Tableau Prep Builder 安装 Tableau Desktop 或 Tableau Prep Builder 后，您可以使用 基于登录名的许可证管理 通过登录 Tableau Cloud 或 Tableau Server 进行激活。否则，您需要通过向 Tableau 发送激活请求来提供产品密钥以激活产品。您可以在安装过程中 (Windows) 或在安装后（Windows 及 Mac）通过命令行输入产品密钥。 **注意：** Tableau Desktop Free Edition 未激活，但必须通过登录 Tableau.com 进行注册。如果没有帐户，您可以创建一个。 若要在安装期间自动执行此过程，请添加一个包括安装程序选项 ACTIVATE\_KEY "” 的命令行，并在引号中输入产品密钥。安装程序将在安装过程中应用产品密钥。 若要在安装后自动执行此过程，请在安装后使用 -activate 选项运行 Tableau.exe 或 Tableau Prep Builder.exe，例如 `tableau.exe -activate `。 > [!TIP] > > **注意：**如果要使用自动化脚本激活 Tableau Server，请参见 Tableau Server 帮助中的[自动执行许可任务](https://help.tableau.com/current/server/zh-cn/license_automating.htm)。 ### Windows 使用 `-activate` 选项和产品密钥运行 `tableau.exe` 或 `Tableau Prep Builder.exe`。 例如： **Tableau Desktop**：`"C:\Program Files\Tableau\Tableau \bin\tableau.exe" -activate ` **Tableau Prep Builder**：`"C:\Program Files\Tableau\Tableau Prep Builder \Tableau Prep Builder.exe" -activate ` ### Mac 在 `/Applications` 路径中使用 `-activate` 选项和产品密钥运行 Tableau 或 Tableau Prep Builder 可执行文件。 例如： **Tableau Desktop**：`"Tableau Desktop .app/Contents/MacOS/Tableau" –activate __` **Tableau Prep Builder**：`"Tableau Prep Builder .app/Contents/MacOS./Tableau Prep Builder" –activate ` 有关在许可失败的情况下可以获取和评估的退出代码的信息，请参见本指南内“安装疑难解答”一文中的[使用激活退出代码排除激活错误](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_troubleshoot_licensing.htm#Troubleshoot_activation)。 ## 注册 Tableau Desktop 和 Tableau Prep Builder 您可通过自动执行注册 Tableau 单独副本的任务来确保组织中一致的注册。若要为 Windows 自动完成此过程，请添加一个包括安装程序选项 REGISTER="1” 的命令行。安装程序将运行 -register 并注册产品。 若要通过命令行注册 Tableau，您需要在将运行 Tableau Desktop 和 Tableau Prep Builder 的每台计算机上预先填充注册表 (Windows) 或 .plist (Mac) 值。对于 Windows，您可以在安装过程中触发此过程。对于 Windows 和 Mac，您可以执行安装过程并使用 register 命令行选项。当 Tableau 启动时，它将读取注册信息并为该用户注册 Tableau。 注册信息存储在计算机上 Tableau 的安装位置中。 - **Windows**：该信息位于注册表中。 - **Mac**：该信息位于属性列表 (`.plist`) 文件中。 注册信息包括对于多个用户可能相同的位置字段（例如，`city`、`country` 和 `zip`），以及通常对于每个用户唯一的字段（email、`first_name`、`last_name`、`title`）。 > [!IMPORTANT] > > 对于 Tableau Desktop，您必须包括`"opt_in"`和`"privac_consent"`字段才能使用命令行选项成功注册产品。 注册信息保存在以下位置之一中： - **Windows**。注册表：`HKEY_CURRENT_USER\Software\Tableau\Registration\Data` - **Mac**。`.plist` 文件位置：`/Users//Library/Preferences/_<.plist_file_name>_` 在多台计算机上预先填充注册表或属性列表值的最简单方式是：在一台计算机上手动安装和注册 Tableau，然后使用通过该过程填写的注册表项或属性列表文件作为模板来更新其他计算机上的注册表。 ### Windows **注册 Tableau 并创建模板** 1. 作为计算机上的管理员，请在对注册表文件进行任何更改之前将其备份。 2. 在至少一台 Windows 计算机上安装并手动注册产品。在其他计算机上安装 Tableau 时，您可以使用该注册信息作为模板。 注册信息保存在 Windows 注册表中的以下条目下： `HKEY_CURRENT_USER\Software\Tableau\Registration\Data` 3. 将数据（项）导出为注册表文本文件。 4. 创建一个执行以下操作的脚本： 1. 建立模板注册表文本文件的副本，并更新对于用户唯一的字段。 2. 将更新的注册表文本文件复制到用户的计算机。 3. 在该计算机上更新注册表。 更新的字段将取决于您想要随注册一起发送的信息。有关如何自动更新注册的信息，请参见 Microsoft 文档。 下图显示了您可能会在导出的注册表文件中看到的注册表值的示例： `[HKEY_CURRENT_USER\Software\Tableau\Registration\Data] "campaign_id"=" "company"=" "country"=" "db_title"=" "department"=" "elqCustomerGUID"=" "elqFormName"=" "email"=" "first_name"=" "form_environment"=" "form_variant"=" "ga_client_id"=" "job_role"=" "last_name"=" "lead_source"=" "lead_source_detail"=" "phone"=" "product_key"=" "product_name"=" "state"=" "title"=" "zip"=" "registration_date"=" "city"=" "industry"=" "opt_in"=" "privac_consent"="` **使用模板在另一台计算机上注册 Tableau** 1. 在另一台计算机上，安装 Tableau Desktop 或 Tableau Prep Builder。 2. 带 `-register` 选项运行 `tableau.exe` 或 `Tableau Prep Builder.exe`。 例如： **Tableau Desktop**：“`Program Files\Tableau\Tableau \bin\tableau.exe -register`” **Tableau Prep Builder：**“`Program Files\Tableau\Tableau Prep Builder\Tableau Prep Builder.exe -register`” 如果注册成功，安装日志文件将具有以下条目： `Current registration state: complete / not needed` 如果注册未成功，Tableau 将关闭，并显示错误代码 `error 117`。您也可以检查日志文件，其中包含有关无效或缺失的字段的信息。日志文件位于此位置中： Documents >我的 Tableau 存储库 or 我的 Tableau Prep Builder 存储库 > Logs\> log.txt 如果注册失败，则需要更新您创建的自动化脚本。有关疑难解答提示，请参见 [Tableau Desktop 或 Tableau Prep Builder 安装疑难解答](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_troubleshoot.htm)。 ### Mac **注册 Tableau 并创建模板** 若要在 Mac 上注册 Tableau Desktop 或 Tableau Prep Builder，您可以使用 Xcode 或 `defaults` 命令来更新以下属性列表文件：`com.tableau.Registration.plist`。 可在 Apple Support 上找到有关如何编辑 OS X 属性列表文件的详细信息。 1. 在至少一台 Mac 计算机上安装并手动注册产品。这将创建 `.plist` 文件，您可将其用作模板在其他计算机上注册 Tableau Desktop 或 Tableau Prep Builder。 2. 转到 `/Users/__/Library/Preferences`，并备份想要用作模板的 `com.tableau.Registration.plist` 文件。 3. 将模板 `com.tableau.Registration.plist` 文件复制到要安装 Tableau Desktop 的 Mac 上的 `/Users/__/Library/Preferences` 例如： `cd /Users/agarcia/Library/Preferences` 5. 对于要更新的每个 `.plist` 项，运行以下命令： `defaults write com.tableau.Registration.plist __` 例如： `defaults write com.tableau.Registration.plist Data.first_name Ashley` `defaults write com.tableau.Registration.plist Data.last_name Garcia` **使用模板在另一台计算机上注册 Tableau** - 在另一台计算机上，安装 Tableau Desktop 或 Tableau Prep Builder。 在安装过程中，系统会提示您输入产品密钥，然后会运行激活向导。如果您在完成激活或注册之前退出程序，或者以无提示方式进行安装，请启动终端应用程序，然后运行以下命令： - 若要激活 Tableau Desktop 或 Tableau Prep Builder，请运行以下命令： **Tableau Desktop**：`"Tableau Desktop .app/Contents/MacOS/Tableau" –activate __` **Tableau Prep Builder**：`"Tableau Prep Builder .app/Contents/MacOS./Tableau Prep Builder" –activate ` - 若要注册 Tableau Desktop 或 Tableau Prep Builder，请运行以下命令： **Tableau Desktop**：`"Tableau Desktop .app/Contents/MacOS./Tableau" –register` **Tableau Prep Builder**：`"Tableau Prep Builder .app/Contents/MacOS./Tableau Prep Builder" –register` ## 卸载 Tableau Desktop 和 Tableau Prep Builder 尽管在安装较新版本时不必卸载以前版本的 Tableau Desktop 和 Tableau Prep Builder，但如果计算机上不再需要任何版本的这些应用程序，您可以将其卸载。 ### Windows 若要通过命令行以无提示方式卸载 Tableau Desktop 或 Tableau Prep Builder，请执行以下操作： 1. 以管理员身份打开命令提示符。 2. 在 .exe 的安装位置中，运行以下命令： `TableauDesktop-.exe /uninstall /quiet` 或 `TableauPrepBuilder-.exe /uninstall /quiet` 例如： `Downloads\TableauPrepBuilder-2021-1-4.exe /uninstall /quiet` 若要通过命令行卸载 Tableau Desktop 的多个版本，请执行以下操作。 **注意：**此选项不可用于 Tableau Prep Builder。 1. 使用 REMOVEINSTALLEDAPP 选项安装最新版本的 Tableau Desktop。 例如：`tableauDesktop-64bit-2021-4-4.exe /quiet /norestart ACCEPTEULA=1 REMOVEINSTALLEDAPP=1` 2. 确认除最新版本外的所有旧版本均已卸载。 3. 卸载最新版本。例如：`tableauDesktop-64bit-2021-4-4.exe /uninstall /quiet /norestart` 4. 按照[彻底移除 Tableau Desktop](https://kb.tableau.com/articles/howto/completely-removing-tableau-desktop?lang=zh-cn)中的步骤删除所有未使用的文件夹。 ### Mac 若要在 Mac 上卸载 Tableau Desktop，请执行以下操作： 1. 如果需要停用或退回产品密钥，请在 `/Applications` 路径中的 Tableau 对象上运行 `-return` 选项。有关详细信息，请参见[转移或停用产品密钥](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_move_or_deactivate.htm)。[转移或停用产品密钥](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_move_or_deactivate.htm). 2. 将应用程序和 Desktop 快捷方式（如果有）拖到废纸篓文件夹，然后清空废纸篓。 3. 卸载自动安装的任何驱动程序。 ## 此部分中的其他文章