tsm configuration
您可以使用 tsm configuration
命令获取、设置和更新配置键值。
“未知键”响应
当您尝试获取其当前值或设置新值时,某些配置键将返回“未知键”响应。如果发生这种情况,请验证键是否拼写正确,包括正确的大写。若要更改值,请在 --force-keys
命令上使用选项 tsm configuration set
。有关您可以更改的配置键的列表,请参见tsm configuration set 选项。
“Null”值响应
某些配置键具有特定的默认值,但在您尝试获取其当前值时会返回“Null”响应。这些键使用派生自 Tableau Server 代码的默认值。如果密钥在 tsm configuration set 选项列为具有特定默认值,并且 tsm configuration get
命令返回“Null”作为当前值,则默认值由运行 Tableau Server 的代码确定。您可以使用 tsm configuration set
设置键值,但这不是必需的,除非您想更改该值。
tsm configuration get
查看当前服务器配置和拓扑。
概要
tsm configuration get --key <config.key> [global options]
选项
-k, --key
必需。
获取指定配置键的当前值。
tsm configuration list-dynamic-keys
查看可动态配置的所有配置键(无需重新启动 Tableau Server)。
概要
tsm configuration list-dynamic-keys [global options]
tsm configuration set
设置或导入服务器配置或拓扑。
除非有空格,否则 <config.key>
和 <config_value>
两边的引号是可选的,在有空格的情况下,您必须在键或值两边使用引号。
注意:设置配置键值之后,您必须使用 tsm pending-changes apply
应用待定配置更改。在您执行该操作之前,新值将不会由 Tableau 使用或显示在 tsm configuration get
命令的结果中。您可以使用 tsm pending-changes list
查看待定更改。有关详细信息,请参阅tsm pending-changes。
概要
tsm configuration set --key <config.key> --value <config_value> [global options]
选项
-k,--key <config.key>
必需。
配置密钥。
-v,--value <config_value>
必需。从三月维护版本(版本 2021.2.10、2021.3.9、2021.4.5)开始,如果不包括此选项,系统将提示您输入值。
配置值。
-d
可选。
将配置值重置为其默认值。
-frc, --force-keys
可选。
强制将键添加到配置中,即使其以前不存在。
全局选项
-h, --help
可选。
显示命令帮助。
-p, --password <password>
在会话不是活动状态的情况下为必需,
-u
或--username
也为必需。为在
-u
或--username
中指定的用户指定密码。如果密码包括空格或特殊字符,请将其括在引号中:
--password 'my password'
-s, --server https://<hostname>:8850
可选。
对 Tableau 服务管理器使用指定的地址。URL 必须以
https
开头,包括端口 8850,并使用服务器名称(而不是 IP 地址)。例如,https://<tsm_hostname>:8850
。如果没有指定服务器,则假定为https://<localhost | dnsname>:8850
。--trust-admin-controller-cert
可选。
使用此标志来信任 TSM 控制器上的自签名证书。有关证书信任和 CLI 连接的详细信息,请参见 连接 TSM 客户端。
-u, --username <user>
在会话不是活动状态的情况下为必需,
-p
或--password
也为必需。指定用户帐户。如果未包括此选项,则使用您登录所使用的凭据运行该命令。