---
schema_version: "1"
id: db55fab7a5fcf172a254216093f1f11e1af03e080c0e84c59285d0555d9e8af6
title: tsm configuration
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/server-linux/cli_configuration_tsm.md
canonical_url: https://help.tableau.com/v0.0/server-linux/zh-cn/cli_configuration_tsm.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 8da4e2a1e8e2c117ff05995dfdcb5db929a4c96d82644b56c4e11a56fa8cc8f7
description: Reference for tsm configuration commands to get, set, and update Tableau Server configuration keys.
---
[跳转到主要内容](#main-content)

# tsm configuration

您可以使用 `tsm configuration` 命令获取、设置和更新配置键值。

## “未知键”响应

当您尝试获取其当前值或设置新值时，某些配置键将返回“未知键”响应。如果发生这种情况，请验证键是否拼写正确，包括正确的大写。若要更改值，请在 `--force-keys` 命令上使用选项 `tsm configuration set`。有关您可以更改的配置键的列表，请参见[tsm configuration set 选项](https://help.tableau.com/v0.0/server-linux/zh-cn/cli_configuration-set_tsm.htm)。

## “Null”值响应

某些配置键具有特定的默认值，但在您尝试获取其当前值时会返回“Null”响应。这些键使用派生自 Tableau Server 代码的默认值。如果密钥在 [tsm configuration set 选项](https://help.tableau.com/v0.0/server-linux/zh-cn/cli_configuration-set_tsm.htm)列为具有特定默认值，并且 `tsm configuration get` 命令返回“Null”作为当前值，则默认值由运行 Tableau Server 的代码确定。您可以使用 `tsm configuration set` 设置键值，但这不是必需的，除非您想更改该值。

- [tsm configuration get](#TSMGet)
- [tsm configuration list-dynamic-keys](#TSMListDynamicKeys)
- [tsm configuration set](#TSMSet)

## 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](https://help.tableau.com/v0.0/server-linux/zh-cn/cli_pending-changes.htm#pending-changes-apply)` 应用待定配置更改。在您执行该操作之前，新值将不会由 Tableau 使用或显示在 `tsm configuration get` 命令的结果中。您可以使用 `tsm pending-changes list` 查看待定更改。有关详细信息，请参阅[tsm pending-changes](https://help.tableau.com/v0.0/server-linux/zh-cn/cli_pending-changes.htm)。

### 概要

`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 客户端](https://help.tableau.com/v0.0/server-linux/zh-cn/tsm_overview.htm#Connecti)。

\-u, --username <user>

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

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