本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 管理会话名称
<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
```