使用命令列安裝

本文除了介紹如何使用命令列安裝 Tableau Desktop、Tableau Prep Builder 和 Tableau Desktop Public Edition,並執行啟動和註冊等其它安裝動作,也將說明如何解除安裝該產品。

有關查找安裝程式和產品金輪的更多資訊,請參閱安裝程式的位置在哪裡?以及查找您的產品金輪

附註:如果要升級,請參閱升級 Tableau Desktop 和 Tableau Prep Builder ,了解有關準備升級的資訊。

預設情況下,Tableau 會為您啟用特定功能,例如使用情況報告或自動產品更新(僅限 Tableau Desktop)。有關如何關閉這些功能以及其他內容的資訊,請參閱在安裝之後變更安裝設定(連結在新視窗開啟)

開始之前

  • 與 Server 的相容性:Tableau 產品並不總是同時發佈。安裝新版本的 Tableau Desktop 時,請確保其與 Tableau Server 相容。請參閱查找和解決相容性問題
  • 在同一台電腦中安裝 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 file) 的部署工具安裝 Tableau Desktop 或者 Tableau Prep Builder,請按照 擷取並執行 Windows (MSI) 安裝程式 中的說明擷取 .msi 檔案,該檔案包含著 Tableau 安裝程式 .exe 檔案中。

按一下您要安裝之產品下方的索引標籤,以檢視安裝步驟。

Windows

  1. 以管理員身分從電腦的命令列中執行安裝程式 .exe 檔案。
    如果需要擷取 .msi 檔案,請按照本文的擷取並執行 Windows (MSI) 安裝程式部分中的說明進行操作。

    用於從命令列中執行 Tableau 安裝程式的語法為:

    tableau_<product_installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2

    • tableau_<product_installer_name>.exe:這是您要安裝之產品及版本的 Tableau 安裝程式。

    • 選項:您使用的這些選項指定了安裝過程應如何執行。例如,是否應在安裝時顯示輸出或者是否應建立記錄檔。請參閱可用選項清單的安裝程式選項

    • 屬性:這些設定指定安裝程式在安裝過程中應進行的組態設定。請參閱可用屬性清單的安裝程式屬性
  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

重要資訊︰請只將 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_name>.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 <path and name of .pkg file> -target /

    這將提示輸入管理員密碼,然後執行基本上無提示的安裝。您將看到以下三行:

    • installer: Package name is Tableau Desktop

    • installer: Upgrading at base path /
    • installer: The upgrade was successful.

選取要自動安裝的驅動程式

預設情況下,會隨 Tableau Desktop 一起自動安裝多個資料來源驅動程式。有關完整清單,請參閱安裝之前

附註:從 2019.4 版本開始,只有 PostgreSQL 驅動程式會自動安裝在 Mac 上。

若要阻止自動安裝其中一個或全部驅動程式,請首先使用 ‑showChoiceChangesXML 針對 Desktop.pkg 執行 Mac 安裝程式應用程式,以生成包含所有可能自訂項的 plist 檔案。語法如下:

installer -showChoiceChangesXML -pkg <path and name of .pkg file> –target / > <name of plist>

範例:

installer -showChoiceChangesXML -pkg Install\ Tableau\ Desktop.pkg –target / > InstallTableauDesktopChoices.xml

對於 Oracle 驅動程式,產生的 plist 檔案中的部份外觀如下:

<dict> <key>attributeSetting</key> <integer>1</integer> <key>choiceAttribute</key> <string>selected</string> <key>choiceIdentifier</key> <string>com.tableau.oracle</string> </dict>

若要防止安裝驅動程式,請執行下列動作:

  1. 在 .plist 檔案中,為您不想自動安裝的任何驅動程式將 <integer> 值從 1 變更為 0。

  2. 儲存檔案,然後使用下列命令將檔案新增至命令列以將其傳遞至安裝程式:

    -applyChoiceChangesXML <pathToXMLFile>

建立了包含所需變更的 plist 檔案後,完整的命令列可能類似於如下:

sudo installer -pkg Install\ Tableau\ Desktop.pkg -applyChoiceChangesXML InstallTableauDesktopChoices.xml -pkg -target /

有關 Mac 安裝程式應用程式的文件,請參閱 Apple 開發人員(連結在新視窗開啟) 文件。

停用桌面捷徑

若要防止 Tableau 安裝程式為 Tableau Desktop 建立桌面捷徑,請按上一個部分的說明生成 XML 檔案,並將以下部分中的整數值從 0 變更為 1。

<dict> <key>attributeSetting</key> <integer>0</integer> <key>choiceAttribute</key> <string>selected</string> <key>choiceIdentifier</key> <string>com.tableau.desktopShortcut</string> </dict>

注意:此選項僅適用於 Windows。

  1. 以管理員身分從電腦的命令列中執行安裝程式 .exe 檔案。

    用於從命令列中執行 Tableau 安裝程式的語法為:

    tableau_<product_installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2

    • tableau_<product_installer_name>.exe:這是您要安裝之產品及版本的 Tableau 安裝程式。

    • 選項:您使用的這些選項指定了安裝過程應如何執行。例如,是否應在安裝時顯示輸出或者是否應建立記錄檔。請參閱可用選項清單的安裝程式選項

    • 屬性:這些設定指定安裝程式在安裝過程中應進行的組態設定。請參閱可用屬性清單的安裝程式屬性
  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/(連結在新視窗開啟)) 下載並安裝最新版本的 WiX Toolset。

  2. 以管理員身份開啟命令視窗,並巡覽到安裝了 WiX Toolset 的資料夾的根目錄。

  3. 執行以下命令:

    Dark.exe <path_to_the_Tableau_exe_installer> -x <output_folder>

    例如,執行以下命令:

    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)透過命令列輸入產品金鑰。

若要在安裝期間自動執行此過程,請新增一個包括安裝程式選項 ACTIVATE_KEY "<key>" 的命令列,並在引號中輸入產品金鑰。安裝程式將在安裝過程中應用產品金鑰。

若要在安裝後自動執行此過程,請在安裝後使用 -activate <key> 選項執行 Tableau.exe 或 Tableau Prep Builder.exe,例如 tableau.exe -activate <my_product_key>

注意:如果要使用自動化指令碼啟用 Tableau Server,請參閱 Tableau Server 說明中的自動執行授權工作(連結在新視窗開啟)

Windows

使用 -activate 選項和產品金鑰執行 tableau.exeTableau Prep Builder.exe

例如:

Tableau Desktop"C:\Program Files\Tableau\Tableau <version>\bin\tableau.exe" -activate <product_key>

Tableau Prep Builder“C:\Program Files\Tableau\Tableau Prep Builder <version>\Tableau Prep Builder.exe" -activate <product_key>

Mac

/Applications 路徑中使用 -activate 選項和產品金鑰執行 Tableau 或 Tableau Prep Builder 可執行檔。

例如:

Tableau Desktop"Tableau Desktop <version>.app/Contents/MacOS/Tableau" –activate <product_key>

Tableau Prep Builder"Tableau Prep Builder <vesion>.app/Contents/MacOS./Tableau Prep Builder" –activate <product_key>

有關在授權失敗的情況下可以獲取和評估的結束代碼的資訊,請參閱本指南內「安裝疑難排解」一文中的使用啟動結束代碼排除啟動錯誤

註冊 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) 檔案中。

註冊資訊包括對於多個使用者可能相同的位置欄位(例如,citycountryzip),以及通常對於每個使用者唯一的欄位(email、first_namelast_nametitle)。

對於 Tableau Desktop,必須包含 "opt_in""privac_consent" 欄位才能使用命令列選項成功註冊產品。

註冊資訊儲存在以下位置之一中:

  • Windows。登錄檔:HKEY_CURRENT_USER\Software\Tableau\Registration\Data

  • Mac.plist 檔位置:/Users/<user_name>/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.exeTableau Prep Builder.exe

    例如:

    Tableau Desktop:"Program Files\Tableau\Tableau <version>\bin\tableau.exe -register"

    Tableau Prep Builder:"Program Files\Tableau\Tableau Prep Builder<version>\Tableau Prep Builder.exe -register"

    如果註冊成功,安裝記錄檔將具有以下條目:

    Current registration state: complete / not needed

    如果註冊未成功,Tableau 將關閉,並顯示錯誤代碼 error 117。您也可以檢查記錄檔案,其中包含有關無效或缺失的欄位的資訊。記錄檔位於此位置中:

    文件 >我的 Tableau 存放庫我的 Tableau Prep Builder 存放庫 > 記錄> log.txt

    如果註冊失敗,則需要更新您建立的自動化指令碼。有關疑難排解提示,請參閱 您的 Tableau Desktop 或 Tableau Prep Builder 安裝疑難排解

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/<user_name>/Library/Preferences,並備份想要用作範本的 com.tableau.Registration.plist 檔案。

  3. 將範本 com.tableau.Registration.plist 檔案複製到要安裝 Tableau Desktop 的 Mac 上的 /Users/<user_name</Library/Preferences 資料夾。

  4. 執行以下命令:

    cd /Users/<user_name>/Library/Preferences

    例如:

    cd /Users/agarcia/Library/Preferences

  5. 對於要更新的每個 .plist 項,執行以下命令:

    defaults write com.tableau.Registration.plist <key_value>

    例如:

    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 <version>.app/Contents/MacOS/Tableau" –activate <product_key>

      Tableau Prep Builder"Tableau Prep Builder <vesion>.app/Contents/MacOS./Tableau Prep Builder" –activate <product_key>

    • 若要註冊 Tableau Desktop 或 Tableau Prep Builder,請執行以下命令:

      Tableau Desktop"Tableau Desktop <version>.app/Contents/MacOS./Tableau" –register

      Tableau Prep Builder"Tableau Prep Builder <vesion>.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-<product_installer_name>.exe /uninstall /quiet

    TableauPrepBuilder-<product_installer_name>.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(連結在新視窗開啟) 中的步驟移除所有未使用的資料夾。

Mac

若要在 Mac 上解除安裝 Tableau Desktop,請執行以下操作:

  1. 若需要停用或傳回產品金鑰,請在 /Applications 路徑中對 Tableau 物件上執行 -return 選項。有關更多資訊,請參閱移動或停用產品金鑰移動或停用產品金鑰
  2. 請將應用程式和 Desktop 捷徑(如果有)拖到垃圾筒資料夾中,然後清空垃圾筒。
  3. 解除安裝自動安裝的任何驅動程式。
感謝您的意見反應!已成功提交您的意見回饋。謝謝!