tsm 命令行参考
此部分中的主题包括 Tableau 服务管理器 (TSM) 命令行界面 (CLI) 的参考内容,为 Tableau Server 提供支持。
TSM 用于管理 Tableau Server 的安装和配置。若要了解有关 TSM 的详细信息,请参见Tableau 服务管理器概述。
您可以使用 TSM API 自动执行 TSM CLI 支持的安装和配置任务。若要了解有关预发行版本 (Alpha) TSM API 的详细信息,请参见 Tableau 服务管理器 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 授权组(默认情况为 Windows 计算机上的“本地管理员”组)的成员。
- 您在运行 Tableau Server 管理控制器服务的 Tableau Server 本地运行命令。默认情况下,将在分布式部署中的初始节点上安装和配置 Tableau Server 管理控制器服务。
以本地方式登录到 tsm CLI
如果使用作为 TSM 授权组成员的帐户在本地计算机上运行 tsm 命令,则无需指定密码。在这种情况下,只需运行命令,例如:
tsm version
以远程方式登录到 tsm CLI
如果从未运行 Tableau Server 管理控制器服务的群集节点中运行 TSM 命令,则您必须向远程计算机上的 Tableau Server 管理控制器服务验证会话的身份,然后才能运行命令。例如,运行以下命令:
tsm login -s <server_name> -u <account_name>
其中,<server_name>
是运行 Tableau Server 管理控制器服务的节点的名称,<account_name>
是作为 TSM 授权组成员的帐户。
运行此命令后,系统将提示您输入密码。在对帐户进行身份验证后,您可以运行 TSM 命令。
作为最佳安全做法,请勿公开 TSM 端口(默认情况下为 8850
)到互联网。
tsm CLI 脚本处理和自动化
TSM 是一个批处理文件。若要在另一个批处理文件中运行 TSM 命令,请使用 call
命令。例如“call tsm maintenance ziplogs
”。这样做会将控制权交还给批处理文件。
若要在没有密码的情况下在脚本文件中自动运行 Tableau Server,请使用适当 TSM 授权组中的帐户在初始节点上运行脚本。请参见上面的“身份验证”部分。
在 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
所有顶级命令或类别的列表。