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á.

# Usar a ferramenta da linha de comando para gerenciar sessões
<a name="managing-sessions-cli"></a>

O servidor Amazon DCV inclui uma ferramenta de linha de comandos que pode ser usada para iniciar, interromper e exibir sessões do Amazon DCV.



## Usar a ferramenta de linha de comandos em um servidor Amazon DCV do Windows
<a name="cli-win"></a>

Para usar a ferramenta de linha de comandos em um servidor Amazon DCV do Windows, execute os comandos do diretório de instalação do Amazon DCV ou adicione o diretório do Amazon DCV à variável de ambiente PATH. Se você adicionar o diretório do Amazon DCV à variável de ambiente PATH, poderá usar os comandos de qualquer diretório.

**Para usar a ferramenta de linha de comandos do diretório de instalação do Amazon DCV**  
Navegue até a pasta na qual o arquivo `dcv.exe` está localizado, `C:\Program Files\NICE\DCV\Server\bin\` por padrão, e abra uma janela de prompt de comando.

Ou você pode especificar o caminho completo ao executar um comando de um diretório diferente.

```
"C:\> Program Files\NICE\DCV\Server\bin\dcv.exe" list-sessions
```

**Para adicionar o diretório do Amazon DCV à variável de ambiente PATH**

1. No gerenciador de arquivos, clique com o botão direito do mouse em **Este PC** e escolha **Propriedades**.

1. Escolha **Configurações de sistema avançadas**.

1. Na aba **Avançado**, selecione **Variáveis de ambiente**.

1. Na seção **Variáveis do sistema**, selecione a variável **Path** e escolha **Editar**.

1. Escolha **Novo** e especifique o caminho completo para a pasta `bin` no diretório de instalação do Amazon DCV (por exemplo, `C:\Program Files\NICE\DCV\Server\bin\`).

1. Escolha **OK** e feche a janela Variáveis de ambiente.

## Usar a linha de comandos em um servidor Amazon DCV do Linux
<a name="cli-lin"></a>

Em servidores Amazon DCV do Linux, a ferramenta da linha de comandos é configurada automaticamente na variável de ambiente `$PATH`. Você pode usar a ferramenta em qualquer pasta. Abra uma janela de terminal e digite o comando a ser executado.

## Usando a linha de comando em um servidor macOS Amazon DCV
<a name="cli-macos"></a>

Nos servidores macOS Amazon DCV, a ferramenta de linha de comando é configurada automaticamente na `$PATH` variável de ambiente. Você pode usar a ferramenta em qualquer pasta. Abra uma janela de terminal e digite o comando a ser executado.

## Uso da ferramenta de linha de comando
<a name="command-line-usage"></a>

A tabela a seguir abrange as opções de ferramentas de linha de comandos disponíveis. Esta lista pode ser recuperada usando `--help` ao chamar `dcv`. Para obter mais informações sobre como usar cada comando, passe `--help` após o comando para o qual você gostaria de obter informações de uso. Por exemplo: `dcv create-session --help`.


| Command | Description | 
| --- | --- | 
| `create-session` | Criar uma sessão do DCV | 
| `close-session` | Fechar uma sessão ativa do DCV | 
| `describe-session` | Descrever uma sessão do DCV | 
| `list-sessions` | Listar as sessões ativas do DCV | 
| `list-connections` | Listar as conexões do cliente para uma sessão do DCV | 
| `close-connection` | Fechar uma conexão de cliente ativa | 
| `get-screenshot` | Obter uma captura de tela do console do DCV | 
| `set-display-layout` | Definir o layout de exibição de uma sessão ativa do DCV | 
| `set-name` | Definir nome para uma sessão do DCV | 
| `set-permissions` | Definir permissões de uma sessão ativa do DCV | 
| `set-storage-root` | Definir raiz de armazenamento de uma sessão ativa do DCV | 
| `reload-licenses` | Forçar o recarregamento das licenças para todas as sessões em execução | 
| `get-config` | Obter configuração do servidor | 
| `list-endpoints` | Listar os endpoints do DCV | 
| `set-config` | Definir configuração do servidor | 
| `version` | Mostrar a versão do DCV | 
| `help` | Mostrar ajuda |