Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Étape 4 : Création d'un fichier de connexion (facultatif)
À l'aide du client natif Windows, Linux ou macOS, vous pouvez créer un fichier de connexion que vous pouvez utiliser pour vous connecter instantanément à une session Amazon DCV.
**Topics**
+ [Création du fichier de connexion](#connection-file-create)
+ [Paramètres pris en charge](#connection-file-params)
+ [Exécution du fichier de connexion](#connection-file-execute)
## Création du fichier de connexion
Le fichier de connexion est un fichier texte avec une extension de fichier `.dcv`. Le format du `.dcv` fichier est similaire à celui d'un `.ini` fichier. Le fichier inclut, `[groups]` suivis des paramètres et de leurs valeurs. Les groupes et paramètres prennent le format suivant :
```
[group_name]
parameter_name=parameter_value
```
Par exemple :
```
[options]
fullscreen=true
```
Vous pouvez créer un fichier de connexion pour une session Amazon DCV spécifique directement depuis le client. Vous pouvez également créer un fichier de connexion à partir de zéro à l'aide d'un éditeur de texte.
**Note**
La procédure de création d'un fichier de connexion à partir de zéro à l'aide d'un éditeur de texte est la même pour les clients Windows, Linux et macOS.
**Pour créer un fichier de connexion à partir du client**
1. Ouvrez le client .
1. Connectez-vous au serveur et à la session sur lesquels vous créez le fichier.
1. Sélectionnez le nom d'hôte du serveur Amazon DCV dans le coin supérieur droit et choisissez **Enregistrer** la connexion sous.
1. Dans la fenêtre **Enregistrer sous**, saisissez un nom de fichier et un dossier de destination, puis choisissez **Enregistrer**.
Par défaut, lorsque vous créez un fichier de connexion, celui-ci inclut les `proxytype` paramètres `format` `host``port`,`user`,, et. Ces paramètres sont nécessaires pour se connecter à la session à partir de laquelle le fichier a été créé. Vous pouvez personnaliser ou ajouter manuellement des paramètres à tout moment en éditant le fichier à l'aide d'un éditeur de texte.
**Pour créer un fichier de connexion à partir de zéro à l'aide d'un éditeur de texte**
1. Créez un fichier `.dcv` avec le format de nom de fichier suivant : `file_name.dcv`
1. Ouvrez le fichier `.dcv` à l'aide de votre éditeur de texte préféré.
1. Ajoutez le `[version]` groupe et le `format` paramètre en haut du fichier au format suivant :
```
[version]
format=1.0
```
**Important**
Si le `.dcv` fichier n'inclut pas le `[version]` groupe et le `format` paramètre, l'analyse échoue.
1. Ajoutez les groupes de paramètres requis en utilisant le format suivant :
```
[group_name]
```
Pour de plus amples informations sur les groupes de paramètres, veuillez consulter [Paramètres pris en charge](#connection-file-params).
1. Ajoutez les paramètres et les valeurs des paramètres après les groupes en utilisant le format suivant :
```
parameter_name=parameter_value
```
**Note**
Les noms des paramètres distinguent les majuscules et minuscules.
Ne placez pas les valeurs des paramètres de chaîne entre guillemets.
Pour de plus amples informations sur les paramètres et les valeurs des paramètres, veuillez consulter [Paramètres pris en charge](#connection-file-params).
1. Enregistrez les modifications, puis fermez le fichier `.dcv`.
Vous pouvez également utiliser cette procédure pour ajouter des paramètres supplémentaires à un fichier de connexion existant à tout moment.
## Paramètres pris en charge
Actuellement, le `.dcv` fichier prend en charge les paramètres dans trois groupes de paramètres : `[version]``[connect]`, et`[options]`. Les tableaux suivants répertorient les groupes et leurs paramètres disponibles.
**Topics**
+ [Paramètres dans l’`[version]`](#param-version)
+ [Paramètres dans l’`[connect]`](#param-connect)
+ [Paramètres dans l’`[options]`](#param-option)
+ [Paramètres dans l’`[debug]`](#param-debug)
### Paramètres dans l’`[version]`
**Important**
Ce groupe est obligatoire. Si votre `.dcv` fichier n'inclut pas ce groupe, l'analyse échoue.
Le tableau suivant répertorie les paramètres qui peuvent être spécifiés dans le groupe `[version]`.
| Paramètre | Type | Valeur par défaut | Description |
| --- | --- | --- | --- |
| format | chaîne | | Il s'agit d'un paramètre obligatoire. La valeur du paramètre doit être `1.0`. Si votre `.dcv` fichier n'inclut pas ce paramètre, l'analyse échoue. |
### Paramètres dans l’`[connect]`
Le tableau suivant répertorie les paramètres qui peuvent être spécifiés dans le groupe `[connect]`.
| Paramètre | Type | Valeur par défaut | Description |
| --- | --- | --- | --- |
| hôte | String | | Le nom d'hôte du serveur Amazon DCV hébergeant la session. |
| port | Entier | 8443 | Port à utiliser lors de la connexion au serveur Amazon DCV. |
| weburlpath | String | | Un chemin personnalisé sur le serveur Amazon DCV pour la connexion. Par exemple, si vous spécifiez customPath, le client tente de se connecter à host:port/customPath. |
| sessionid | String | | ID de la session Amazon DCV à laquelle se connecter. |
| authtoken | String | | Jeton d'authentification à utiliser pour la connexion. Si vous spécifiez un authtoken, vous devez également spécifier un sessionid. Lors de l'utilisation d'un authtoken, vous pouvez omettre les paramètres user et password. |
| user | String | | Le nom d'utilisateur à utiliser lors de la connexion au serveur Amazon DCV. |
| mot de passe | String | | Le mot de passe à utiliser lors de la connexion au serveur Amazon DCV. Le mot de passe n'est pas crypté. |
| proxytype | String | SYSTEM | Type de proxy à utiliser. Les valeurs valides incluent HTTPSHTTP,SOCKS5\$1SOCKS,SYSTEM, ouNONE\$1DIRECT. Si vous spécifiez SYSTEM, les paramètres proxy de votre ordinateur sont utilisés. |
| proxyhost | String | | Adresse du serveur proxy à utiliser en cas de connexion via un serveur proxy. |
| proxyport | Entier | | Port à utiliser en cas de connexion via un serveur proxy. |
| proxyuser | String | | Nom d'utilisateur à utiliser pour l'authentification par proxy. |
| proxypassword | String | | Mot de passe à utiliser pour l'authentification par proxy. Le mot de passe n'est pas crypté. |
| transport | String | auto | Protocole à utiliser pour le transport des données. Avec `auto` le client essaie d'abord de se connecter en utilisant le protocole QUIC (UDP). Si la connexion QUIC échoue, le transport revient automatiquement à`websocket`. Spécifiez `websocket` l'utilisation du protocole WebSocket (TCP) pour le transport des données ou spécifiez `quic` l'utilisation du protocole QUIC (UDP) pour le transport des données. Si vous activez QUIC, le protocole QUIC est utilisé pour le transport de données et pour le WebSocket trafic d'authentification. Si vous l'activez WebSocket, le WebSocket protocole est utilisé à la fois pour le transport de données et le trafic d'authentification. |
| port Web | Entier | 8443 | Port à utiliser pour le trafic WebSocket (TCP). |
| port rapide | Entier | 8443 | Port à utiliser pour le trafic QUIC (UDP). |
| politique de validation des certificats | String | demande-utilisateur | Politique de validation d'un certificat non fiable. Les valeurs incluent strict, accept-untrusted et ask-user. |
### Paramètres dans l’`[options]`
Le tableau suivant répertorie les paramètres qui peuvent être spécifiés dans le groupe `[options]`.
| Paramètre | Type | Valeur par défaut | Description |
| --- | --- | --- | --- |
| fullscreen | Booléen | false | Indique si le client démarre en mode plein écran. |
| useallmonitors | Booléen | false | Indique si le client utilise tous les moniteurs lors du démarrage du mode plein écran. |
| promptreconnect | Booléen | true | Indique si le client vous invite à vous reconnecter après vous être déconnecté d'une session. Si le paramètre est défini surtrue, vous êtes redirigé vers l'écran de connexion lorsque vous vous déconnectez. Si le paramètre est défini sur false, le client se ferme lorsque vous vous déconnectez. |
| activer le décodage yuv444 | Booléen | false | Indique s'il faut activer la [haute précision des couleurs (YUV 4:4:4)](using-high-color-accuracy.md) lors du codage de contenu vidéo dynamique. |
### Paramètres dans l’`[debug]`
Le tableau suivant répertorie les paramètres qui peuvent être spécifiés dans le groupe `[debug]`.
| Paramètre | Type | Valeur par défaut | Description |
| --- | --- | --- | --- |
| loglevel | String | INFO | La valeur peut être définie surDebug. |
## Exécution du fichier de connexion
Pour exécuter le fichier de `.dcv` connexion, naviguez jusqu'au fichier et double-cliquez dessus.
Ou, spécifiez le chemin d'accès au fichier comme argument pour la commande `dcvviewer`.
+ Client Windows
```
C:\> dcvviewer.exe path\connection_file_name.dcv
```
+ Client Linux et macOS
```
$ dcvviewer path/connection_file_name.dcv
```