本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 管理工作階段名稱
<a name="managing-session-name"></a>

您可以隨時變更執行中工作階段的名稱。您可以使用工作階段的特定名稱，根據工作階段的名稱快速識別工作階段。工作階段名稱在執行中的工作階段之間不需要是唯一的。

若要變更執行中工作階段的名稱，請使用 `dcv set-name`命令。

**Topics**
+ [語法](#managing-session-name-syntax)
+ [選項](#managing-session-name-options)
+ [範例](#example)

## 語法
<a name="managing-session-name-syntax"></a>

```
$ dcv set-name --session session_id --none |--name "session-name"
```

您必須擇一指定 `--name` 或 `--none`。

## 選項
<a name="managing-session-name-options"></a>

下列選項可以搭配 `dset-name` 命令使用。

**`--session`**  
要設定其名稱的工作階段 ID。  
類型：字串  
必要：是

**`--name`**  
要指派工作階段的名稱。只有在您想要將名稱指派給工作階段時，才指定此選項。如果您想要移除名稱，請省略此參數。工作階段名稱長度最多可達 256 個字元。它可以包含字母、數字和特殊字元。如果指定的字串超過 256 個字元，命令會失敗。  
類型：字串  
必要：否

**`--none`**  
指定此參數以從工作階段中移除現有名稱。如果您不想移除工作階段名稱，請省略此選項。  
必要：否

## 範例
<a name="example"></a>

**範例 1—變更工作階段的名稱**  
下列範例會將 ID 為 的工作階段名稱`my-session`設定為 `my graphics session`。

```
$ dcv set-name --session my-session --name "my graphics sessions"
```

**範例 2 - 移除工作階段的名稱**  
下列範例會移除 ID 為 的工作階段名稱`my-session`。

```
$ dcv set-name --session my-session --none
```