As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Gerenciar o nome da sessão
<a name="managing-session-name"></a>

É possível alterar o nome de uma sessão em execução a qualquer momento. Você pode usar o nome específico da sessão para identificar rapidamente uma sessão com base em seu nome. Os nomes das sessões não precisam ser exclusivos nas sessões em execução.

Para alterar o nome de uma sessão em execução, use o comando `dcv set-name`. 

**Topics**
+ [Sintaxe](#managing-session-name-syntax)
+ [Opções](#managing-session-name-options)
+ [Exemplos](#example)

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

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

Você precisa especificar `--name` ou `--none`.

## Opções
<a name="managing-session-name-options"></a>

As opções a seguir podem ser usadas com o comando `dset-name`.

**`--session`**  
A ID da sessão para a qual o nome será definido.   
Tipo: String  
Obrigatório: Sim

**`--name`**  
O nome a ser atribuído à sessão. Especifique essa opção somente se quiser atribuir um nome à sessão. Se quiser remover um nome, omita esse parâmetro. O nome da sessão pode ter até 256 caracteres. Ele pode conter letras, números e caracteres especiais. Se a string especificada exceder 256 caracteres, o comando falhará.  
Tipo: string  
Obrigatório: não

**`--none`**  
Especifique esse parâmetro para remover um nome existente de uma sessão. Se você não quiser remover o nome da sessão, omita essa opção.  
Obrigatório: não

## Exemplos
<a name="example"></a>

**Exemplo 1—Alterar o nome de uma sessão**  
O exemplo a seguir define o nome de uma sessão com uma ID `my-session` como `my graphics session`.

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

**Exemplo 2—Remover o nome de uma sessão**  
O exemplo a seguir remove o nome de uma sessão com um ID `my-session`.

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