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 list-dynamic-keys

• tsm configuration set

tsm configuration get

查看当前服务器配置和拓扑。

概要

tsm configuration get --key

选项

• -k, --key

• 必需。

  获取指定配置键的当前值。

tsm configuration list-dynamic-keys

查看可动态配置的所有配置键（无需重新启动 Tableau Server）。

概要

tsm configuration list-dynamic-keys [global options]

tsm configuration set

设置或导入服务器配置或拓扑。

除非有空格，否则 和 两边的引号是可选的，在有空格的情况下，您必须在键或值两边使用引号。

注意：设置配置键值之后，您必须使用 tsm pending-changes apply 应用待定配置更改。在您执行该操作之前，新值将不会由 Tableau 使用或显示在 tsm configuration get 命令的结果中。您可以使用 tsm pending-changes list 查看待定更改。有关详细信息，请参阅tsm pending-changes。

概要

tsm configuration set --key

选项

• -k,--key

• 必需。

  配置密钥。

• -v,--value

• 必需。从三月维护版本（版本 2021.2.10、2021.3.9、2021.4.5）开始，如果不包括此选项，系统将提示您输入值。

  配置值。

• -d

• 可选。

  将配置值重置为其默认值。

• -frc, --force-keys

• 可选。

  强制将键添加到配置中，即使其以前不存在。

全局选项

• -h, --help

• 可选。

  显示命令帮助。

• -p, --password

• 在会话不是活动状态的情况下为必需，-u 或 --username 也为必需。

  为在 -u 或 --username 中指定的用户指定密码。

  如果密码包括空格或特殊字符，请将其括在引号中：

  --password 'my password'

• -s, --server https://

• 可选。

  对 Tableau 服务管理器使用指定的地址。URL 必须以 https 开头，包括端口 8850，并使用服务器名称（而不是 IP 地址）。例如，https://。如果没有指定服务器，则假定为 https://。

• --trust-admin-controller-cert

• 可选。

  使用此标志来信任 TSM 控制器上的自签名证书。有关证书信任和 CLI 连接的详细信息，请参见 连接 TSM 客户端。

• -u, --username

• 在会话不是活动状态的情况下为必需，-p 或 --password 也为必需。

  指定用户帐户。如果未包括此选项，则使用您登录所使用的凭据运行该命令。