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

# Etapa 4: criar um arquivo de conexão (opcional)
<a name="using-connection-file"></a>

Usando clientes nativos Windows, Linux e macOS, você pode criar um arquivo de conexão que é possível usar para se conectar instantaneamente a uma sessão do Amazon DCV. 

**Topics**
+ [Criar um arquivo de conexão](#connection-file-create)
+ [Parâmetros compatíveis](#connection-file-params)
+ [Executar o arquivo de conexão](#connection-file-execute)

## Criar um arquivo de conexão
<a name="connection-file-create"></a>

O arquivo de conexão é um arquivo baseado em texto com uma extensão de arquivo `.dcv`. O formato do arquivo `.dcv` é semelhante ao de um arquivo `.ini`. O arquivo inclui `[groups]` seguido pelos parâmetros e os respectivos valores. Os grupos e parâmetros têm o seguinte formato:

```
[group_name]
parameter_name=parameter_value
```

Por exemplo:

```
[options]
fullscreen=true
```

É possível criar um arquivo de conexão para uma sessão do Amazon DCV específica direto do cliente. Outra opção é criar do zero um arquivo de conexão em um editor de texto. 

**nota**  
O procedimento para criar um arquivo de conexão do zero usando um editor de texto é o mesmo para os clientes Windows, Linux e macOS.

**Criar um arquivo de conexão do cliente**

1. Abra o cliente.

1. Conecte-se ao servidor e à sessão em que você está criando o arquivo.

1. Selecione o nome do host do servidor Amazon DCV no canto superior direito e escolha **Salvar conexão como**.

1. Na janela **Salvar como**, insira um nome de arquivo e uma pasta de destino e escolha **Salvar**.

Por padrão, quando você cria um arquivo de conexão, o arquivo inclui os parâmetros `format`, `host`, `port`, `user` e `proxytype`. Esses parâmetros são necessários para se conectar à sessão a partir da qual o arquivo foi criado. É possível personalizar ou adicionar parâmetros manualmente a qualquer momento editando o arquivo com um editor de texto.

**Como criar um arquivo de conexão do zero usando um editor de texto**

1. Crie um arquivo `.dcv` com o seguinte formato de nome de arquivo: `file_name.dcv`

1. Abra o arquivo `.dcv` usando o editor de texto de sua preferência.

1. Adicione o grupo `[version]` e o parâmetro `format` à parte superior do arquivo no seguinte formato:

   ```
   [version]
   format=1.0
   ```
**Importante**  
Se o arquivo `.dcv` não incluir o grupo `[version]` e o parâmetro `format`, a análise não funcionará.

1. Adicione os grupos de parâmetros necessários usando o seguinte formato:

   ```
   [group_name]
   ```

   Para obter mais informações sobre os grupos de parâmetros, consulte [Parâmetros compatíveis](#connection-file-params).

1. Adicione os parâmetros e valores de parâmetros após os grupos usando o seguinte formato:

   ```
   parameter_name=parameter_value
   ```
**nota**  
Nomes dos parâmetros diferenciam maiúsculas de minúsculas.
Não coloque os valores de parâmetro de string entre aspas.

   Para obter mais informações sobre os parâmetros e valores de parâmetros, consulte [Parâmetros compatíveis](#connection-file-params).

1. Salve as alterações e feche o arquivo `.dcv`.

Também é possível usar esse procedimento para adicionar parâmetros adicionais a um arquivo de conexão existente a qualquer momento.

## Parâmetros compatíveis
<a name="connection-file-params"></a>

Atualmente, o arquivo `.dcv` é compatível com parâmetros em três grupos de parâmetros — `[version]`, `[connect]` e `[options]`. As tabelas a seguir listam os grupos e seus parâmetros disponíveis.

**Topics**
+ [Parâmetros do `[version]`](#param-version)
+ [Parâmetros do `[connect]`](#param-connect)
+ [Parâmetros do `[options]`](#param-option)
+ [Parâmetros do `[debug]`](#param-debug)

### Parâmetros do `[version]`
<a name="param-version"></a>

**Importante**  
Este é um grupo obrigatório. Se o arquivo `.dcv` não incluir esse grupo, a análise não funcionará.

A tabela a seguir lista os parâmetros que podem ser especificados no grupo `[version]`.


| Parâmetro | Tipo | Valor padrão  | Description | 
| --- | --- | --- | --- | 
| formato | string |  |   Este é um parâmetro obrigatório. O valor do parâmetro deve ser `1.0`. Se o arquivo `.dcv` não incluir esse parâmetro, a análise não funcionará.   | 

### Parâmetros do `[connect]`
<a name="param-connect"></a>

A tabela a seguir lista os parâmetros que podem ser especificados no grupo `[connect]`.


| Parâmetro | Tipo | Valor padrão  | Description | 
| --- | --- | --- | --- | 
| host | String |  | O nome do host do servidor Amazon DCV que hospeda a sessão. | 
| porta | Inteiro | 8443 | A porta a ser usada ao se conectar ao servidor Amazon DCV. | 
| weburlpath | String |  | Um caminho personalizado no servidor Amazon DCV para a conexão. Por exemplo, se você especificar customPath, o cliente tentará se conectar a host:port/customPath. | 
| sessionid | String |  | O ID da sessão do Amazon DCV à qual se conectar. | 
| authtoken | String |  | O token de autenticação a ser usado para a conexão. Se você especificar um authtoken, também deverá especificar um sessionid. Ao usar o authtoken, é possível omitir os parâmetros de password e user. | 
| usuário | String |  | O nome de usuário a ser usado ao se conectar ao servidor Amazon DCV. | 
| password | String |  | A senha a ser usada ao se conectar ao servidor Amazon DCV. A senha não está criptografada. | 
| proxytype | String | SYSTEM | O tipo de proxy a ser usado. Os valores válidos incluem HTTPS, HTTP, SOCKS5\$1SOCKS, SYSTEM ou NONE\$1DIRECT. Se você especificar SYSTEM, as configurações de proxy do computador serão usadas. | 
| proxyhost | String |  | O endereço do servidor de proxy a ser usado se estiver se conectando por meio de um servidor de proxy. | 
| proxyport | Inteiro |  | A porta a ser usada se estiver se conectando por meio de um servidor de proxy. | 
| proxyuser | String |  | O nome de usuário a ser usado para a autenticação de proxy. | 
| proxypassword | String |  | A senha a ser usada para autenticação de proxy. A senha não está criptografada. | 
| transport | String | auto | O protocolo a ser usado para o transporte de dados. Com `auto`, o cliente primeiro tenta se conectar usando o protocolo QUIC (UDP). Se a conexão QUIC falhar, o transporte retorna automaticamente para `websocket`. Especifique `websocket` o uso do protocolo WebSocket (TCP) para transporte de dados ou especifique `quic` o uso do protocolo QUIC (UDP) para transporte de dados. Se você habilitar o QUIC, o protocolo QUIC será usado para transporte de dados e WebSocket para tráfego de autenticação. Se você habilitar WebSocket, o WebSocket protocolo será usado tanto para transporte de dados quanto para tráfego de autenticação.  | 
| webport | Inteiro | 8443 | A porta a ser usada para tráfego WebSocket (TCP). | 
| quicport | Inteiro | 8443 | A porta a ser usada para tráfego QUIC (UDP). | 
| certificatevalidationpolicy | String | ask-user | A política para validar um certificado não confiável. Os valores incluem strict, accept-untrusted e ask-user. | 

### Parâmetros do `[options]`
<a name="param-option"></a>

A tabela a seguir lista os parâmetros que podem ser especificados no grupo `[options]`.


| Parâmetro | Tipo | Valor padrão  | Description | 
| --- | --- | --- | --- | 
| fullscreen | Booliano | false | Indica se o cliente inicia no modo de tela cheia. | 
| useallmonitors | Booliano | false | Indica se o cliente usa todos os monitores ao iniciar o modo de tela cheia. | 
| promptreconnect | Booleano | true | Indica se o cliente solicita que você se reconecte depois que se desconectar de uma sessão. Se o parâmetro estiver definido como true, você será redirecionado para a tela de entrada quando se desconectar. Se o parâmetro estiver definido como false, o cliente será encerrado quando você se desconectar. | 
| enableyuv444decoding | Booleano | false | Indica se a [Alta precisão de cores (YUV 4:4:4)](using-high-color-accuracy.md) será habilitada na codificação de conteúdo de vídeo dinâmico. | 

### Parâmetros do `[debug]`
<a name="param-debug"></a>

A tabela a seguir lista os parâmetros que podem ser especificados no grupo `[debug]`.


| Parâmetro | Tipo | Valor padrão  | Description | 
| --- | --- | --- | --- | 
| loglevel | String | INFO | O valor pode ser definido como Debug. | 

## Executar o arquivo de conexão
<a name="connection-file-execute"></a>

Para executar um arquivo de conexão `.dcv`, navegue até o arquivo e clique duas vezes nele.

Ou especifique o caminho do arquivo como um argumento para o comando `dcvviewer`.
+ Cliente Windows

  ```
  C:\> dcvviewer.exe path\connection_file_name.dcv
  ```
+ Cliente Linux e macOS

  ```
  $ dcvviewer path/connection_file_name.dcv
  ```