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  |