---
schema_version: "1"
id: 232974cbf39368be23632718a295e755afdc1bb748592fac28bc06611baebdb4
title: tsm configuration
collection: tableau
version: current
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/current/zh-tw/server/cli_configuration_tsm.md
canonical_url: https://help.tableau.com/current/server/zh-tw/cli_configuration_tsm.htm
source_site: help.tableau.com
content_type: documentation
content_hash: ea7938cbffcb5b7ca236a4c6ec72e8fb746a7c0a7b4b806eac1e51630ecd592a
description: Reference for tsm configuration commands to get, set, and update Tableau Server configuration keys.
---
[跳至主要內容](#main-content)

# tsm configuration

您可以使用 `tsm configuration` 命令獲取、設定和更新組態金鑰值。

## 「不明金鑰」回應

當您嘗試獲取組態金鑰的當前值或設定新值時，某些組態金鑰將傳回「不明金鑰」回應。如果發生這種情況，請驗證金鑰拼寫正確，包括正確的大寫。若要變更該值，請使用 `tsm configuration set` 命令上的 `--force-keys` 選項。如需您可以變更的組態金鑰清單，請參閱 [tsm configuration set 選項](https://help.tableau.com/current/server/zh-tw/cli_configuration-set_tsm.htm)。

## 「Null」值回應

某些組態金鑰具有特定的預設值，但在您嘗試取得其目前值時會傳回「Null」回應。這些金鑰使用衍生自 Tableau Server 程式碼的預設值。若某個金鑰列為在 [tsm configuration set 選項](https://help.tableau.com/current/server/zh-tw/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/current/server/zh-tw/cli_pending-changes.htm#pending-changes-apply)` 套用待定組態變更。在您執行該操作之前，新值將不會由 Tableau 使用或顯示在 `tsm configuration get` 命令的結果中。您可以使用 `tsm pending-changes list` 檢視待定變更。有關詳情，請參閱 [tsm pending-changes](https://help.tableau.com/current/server/zh-tw/cli_pending-changes.htm)。

### 概要

`tsm configuration set --key <config.key> --value <config_value> [global options]`

### 選項

\-k,--key <config.key>

必需。

組態金鑰。

\-v,--value <config\_value>

必需。從 3 月維護版本開始（版本 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/current/server/zh-tw/tsm_overview.htm#Connecti)。

\-u, --username <user>

在會話不是活動狀態的情況下為必需，`-p` 或 `--password` 也為必需。

請指定使用者名稱。如果未包括此選項，則使用您登入所使用的認證執行該命令。