Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Paso 4: creación de un archivo de conexión (opcional)
<a name="using-connection-file"></a>

Los clientes nativos de Windows, Linux y macOS permiten crear un archivo de conexión que puede utilizar para conectarse instantáneamente a una sesión de Amazon DCV. 

**Topics**
+ [Crear el archivo de conexión](#connection-file-create)
+ [Parámetros admitidos](#connection-file-params)
+ [Ejecutar el archivo de conexión](#connection-file-execute)

## Crear el archivo de conexión
<a name="connection-file-create"></a>

El archivo de conexión es un archivo de texto con una extensión de archivo `.dcv`. El formato del archivo `.dcv` es similar al de un archivo `.ini`. El archivo incluye `[groups]`, seguido de los parámetros y sus valores. Los grupos y parámetros adoptan el siguiente formato:

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

Por ejemplo:

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

Puede crear un archivo de conexión para una sesión de Amazon DCV específica directamente desde el cliente. También puede crear un archivo de conexión desde cero con un editor de texto 

**nota**  
El procedimiento para crear un archivo de conexión desde cero con un editor de texto es el mismo para los clientes de Windows, Linux y macOS.

**Para crear un archivo de conexión desde el cliente**

1. Abra el cliente de .

1. Conéctese al servidor y a la sesión donde va a crear el archivo.

1. Seleccione el nombre de host del servidor Amazon DCV en la esquina superior derecha y elija **Guardar conexión como**.

1. En la ventana **Save As (Guardar como)**, proporcione un nombre de archivo y una carpeta de destino, y elija **Save (Guardar)**.

De forma predeterminada, cuando se crea un archivo de conexión, este incluye los parámetros `format`, `host`, `port`, `user`, y `proxytype`. Estos parámetros son necesarios para conectarse a la sesión desde la que se creó el archivo. Puede personalizar o agregar parámetros manualmente en cualquier momento editando el archivo mediante un editor de texto.

**Para crear un archivo de conexión desde cero con un editor de texto**

1. Cree un archivo `.dcv` con el siguiente formato de nombre de archivo: `file_name.dcv`

1. Abra el archivo `.dcv` con el editor de texto que prefiera.

1. Agregue el grupo `[version]` y el parámetro `format` a la parte superior del archivo con el siguiente formato:

   ```
   [version]
   format=1.0
   ```
**importante**  
Si el archivo `.dcv` no incluye el grupo `[version]` y el parámetro `format`, se produce un error de análisis.

1. Añada los grupos de parámetros necesarios con el siguiente formato:

   ```
   [group_name]
   ```

   Para obtener más información acerca de los grupos de parámetros, consulte [Parámetros admitidos](#connection-file-params).

1. Añada los parámetros y valores de parámetros después de los grupos con el siguiente formato:

   ```
   parameter_name=parameter_value
   ```
**nota**  
Los nombres de los parámetros distinguen entre mayúsculas y minúsculas.
No encierre los valores de los parámetros de cadena entre comillas.

   Para obtener más información acerca de los parámetros y valores de los parámetros, consulte [Parámetros admitidos](#connection-file-params).

1. Guarde los cambios y cierre el archivo `.dcv`.

También puede utilizar este procedimiento para agregar parámetros adicionales a un archivo de conexión existente en cualquier momento.

## Parámetros admitidos
<a name="connection-file-params"></a>

Actualmente, el archivo `.dcv` admite parámetros de tres grupos de parámetros: `[version]`, `[connect]` y `[options]`. En las siguientes tablas se incluyen los grupos y sus parámetros disponibles.

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

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

**importante**  
Este grupo es obligatorio. Si el archivo `.dcv` no incluye este grupo, se producirá un error de análisis.

En la siguiente tabla se incluyen los parámetros que se pueden especificar en el grupo `[version]`.


| Parámetro | Tipo | Predeterminado | Description (Descripción) | 
| --- | --- | --- | --- | 
| formato | cadena |  |   Este es un parámetro obligatorio. El valor del parámetro debe ser `1.0`. Si el archivo `.dcv` no incluye este parámetro, se producirá un error de análisis.   | 

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

En la siguiente tabla se incluyen los parámetros que se pueden especificar en el grupo `[connect]`.


| Parámetro | Tipo | Predeterminado | Description (Descripción) | 
| --- | --- | --- | --- | 
| host | Cadena |  | El nombre de host del servidor Amazon DCV que aloja la sesión. | 
| puerto | Entero | 8443 | El puerto que se va a utilizar al conectarse al servidor Amazon DCV. | 
| weburlpath | Cadena |  | Una ruta personalizada en el servidor Amazon DCV para la conexión. Por ejemplo, si especifica customPath, el cliente intenta conectarse a host:port/customPath. | 
| sessionid | Cadena |  | ID de la sesión de Amazon DCV a la que se va a conectar. | 
| authtoken | Cadena |  | El token de autenticación que se utilizará para la conexión. Si especifica un authtoken, también debe especificar un sessionid. Al utilizar authtoken, puede omitir los parámetros user y password. | 
| usuario | Cadena |  | Puerto que se va a utilizar al conectarse al servidor Amazon DCV. | 
| contraseña | Cadena |  | Contraseña que se va a utilizar al conectarse al servidor Amazon DCV. La contraseña no está cifrada. | 
| proxytype | Cadena | SYSTEM | El tipo de proxy que se va a utilizar. Los valores válidos son: HTTPS, HTTP, SOCKS5\$1SOCKS, SYSTEM o NONE\$1DIRECT. Si especifica SYSTEM, se utilizará la configuración del proxy del equipo. | 
| proxyhost | Cadena |  | La dirección del servidor proxy que se utilizará si se conecta a través de un servidor proxy. | 
| proxyport | Entero |  | El puerto que se utilizará si se conecta a través de un servidor proxy. | 
| proxyuser | Cadena |  | Nombre de usuario que se utilizará para la autenticación del proxy. | 
| proxypassword | Cadena |  | La contraseña que se utilizará para la autenticación del proxy. La contraseña no está cifrada. | 
| transporte | Cadena | auto | Protocolo que se va a utilizar para el transporte de datos. Con `auto`, el cliente intenta conectar primero mediante el protocolo QUIC (UDP). Si se produce un error en la conexión QUIC, el transporte recurre automáticamente a `websocket`. Especifique `websocket` el uso del protocolo WebSocket (TCP) para el transporte de datos o especifique `quic` el uso del protocolo QUIC (UDP) para el transporte de datos. Si habilita el QUIC, el protocolo QUIC se utiliza para el transporte de datos y para el WebSocket tráfico de autenticación. Si lo habilita WebSocket, el WebSocket protocolo se utiliza tanto para el transporte de datos como para el tráfico de autenticación.  | 
| webport | Entero | 8443 | El puerto que se va a utilizar para el tráfico WebSocket (TCP). | 
| quicport | Entero | 8443 | Puerto que se va a utilizar para el tráfico QUIC (UDP). | 
| certificatevalidationpolicy | Cadena | ask-user | Política para validar un certificado que no es de confianza. Los valores incluyen strict, accept-untrusted, y ask-user. | 

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

En la siguiente tabla se incluyen los parámetros que se pueden especificar en el grupo `[options]`.


| Parámetro | Tipo | Predeterminado | Description (Descripción) | 
| --- | --- | --- | --- | 
| fullscreen | Booleano | false | Indica si el cliente se inicia en modo de pantalla completa. | 
| useallmonitors | Booleano | false | Indica si el cliente utiliza todos los monitores al iniciar el modo de pantalla completa. | 
| promptreconnect | Booleano | true | Indica si el cliente le solicita que vuelva a conectarse después de desconectarse de una sesión. Si el parámetro se establece en true, se le redirigirá a la pantalla de inicio de sesión cuando se desconecte. Si el parámetro está establecido en false, el cliente se cierra cuando se desconecta. | 
| enableyuv444decoding | Booleano | false | Indica si se debe habilitar [Alta precisión de color (YUV 4:4:4)](using-high-color-accuracy.md) al codificar contenido de vídeo dinámico. | 

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

En la siguiente tabla se incluyen los parámetros que se pueden especificar en el grupo `[debug]`.


| Parámetro | Tipo | Predeterminado | Description (Descripción) | 
| --- | --- | --- | --- | 
| loglevel | Cadena | INFO | El valor se puede establecer en Debug. | 

## Ejecutar el archivo de conexión
<a name="connection-file-execute"></a>

Para ejecutar un archivo de conexión de `.dcv`, desplácese hasta el archivo y haga doble clic en él.

O bien, especifique la ruta del archivo como argumento para el comando `dcvviewer`.
+ Cliente de Windows

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

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