tsm 命令列參考
此部分中的主題包括 Tableau Services Manager (TSM) 命令列介面 (CLI) 的參考內容,為 Tableau Server 提供支援。
TSM 用於管理 Tableau Server 的安裝和設定。若要瞭解有關 TSM 的詳情,請參閱Tableau 服務管理員概觀。
您可以使用 TSM API 自動執行 TSM CLI 支援的安裝和設定工作。若要瞭解有關預發行版本 (Alpha) TSM API 詳情,請參閱 Tableau Services Manager API。
使用 tsm CLI
您可在初始節點(安裝 TSM 的所在節點),或是叢集中的任何其他節點上執行 tsm 命令。
若要執行 tsm 命令,您必須開啟 Windows 命令提示字元。請勿使用 PowerShell 執行 tsm 命令。使用 PowerShell 可能會出現非預期的行為。
使用屬於叢集中節點上的「管理員」群組成員的帳戶開啟 Windows 命令提示字元。
執行您要的命令。如果您透過非初始節點執行命令,請加入
-s
選項以按照名稱(而非 IP 位址)指定初始節點的 URL,以及加入 TSM 連接埠 8850。若要從初始節點查看 TSM 和 Tableau Server 的版本:
tsm version
若要從其他節點查看 TSM 和 Tableau Server 的版本:
tsm version -s https://<inital_node_name>:8850
例如:
tsm version -s https://myTableauHost:8850
藉由 tsm CLI 進行驗證
從 Tableau Server 2019.2 版開始,如果符合以下條件,執行 tsm 命令就不會要求您輸入密碼:
- 您執行命令的帳戶是 TSM-authorized 群組的成員,位於 Windows 電腦上的本機管理員群組。
- 您正在執行 Tableau Server Administration Controller 服務的 Tableau Server 上本機執行命令。預設情況下,在分散式部署的起始節點上,會安裝及設定 Tableau Server Administration Controller 服務。
本機登入 tsm CLI
如果您在本機電腦上執行 tsm 命令,且使用者帳戶屬於 TSM-authorized 群組成員,則不需要指定密碼。在此情況下,直接執行命令即可,例如:
tsm version
遠端登入 tsm CLI
若您是透過未執行 Tableau Server Administration Controller 服務的叢集中的節點執行 TSM 命令,則您必須先藉由遠端電腦上的 Tableau Server Administration Controller 服務來驗證工作階段,才能執行命令。例如,執行以下命令:
tsm login -s <server_name> -u <account_name>
其中 <server_name>
是執行 Tableau Server Administration Controller 服務所在之處的節點名稱,而 <account_name>
是屬於 TSM-authorized 群組成員之帳戶。
執行此命令之後,系統會提示您輸入密碼。帳戶經過驗證後,您便可以執行 TSM 命令。
作為安全最佳實踐,請勿在網際網路中公開 TSM 連接埠(預設情況下, 8850
)。
使用 tsm CLI 編寫指令碼以及執行自動化作業
TSM 屬於批次檔。若要在另一個批次檔中執行 TSM 命令,請使用 call
命令。例如「call tsm maintenance ziplogs
」。這樣做會將控制項傳回批次檔。
若要在指令碼檔案未使用密碼保護的 Tableau Server 上執行自動化作業,請在初始節點上執行指令碼,並在適當的 TSM-authorized 群組中以帳戶執行。請參閱上述「驗證」一節。
在 shell 中查看說明內容
若要從命令列中查看最少的說明內容,請使用 tsm help
類別。
概要
tsm help [category] [command]
命令
tsm help
所有 tsm 命令的說明
tsm help <category>
顯示特定命令類別的說明。例如,
tsm help authentication
。tsm help <category> <command>
顯示特定命令的說明。例如,
tsm help authentication open-id
。tsm help commands
所有頂級命令或類別的清單。