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.
# Démarrage de sessions Amazon DCV
Lorsque vous utilisez les paramètres par défaut pour [installer le serveur Windows Amazon DCV](setting-up-installing-wininstall.md), une [session de console](managing-sessions-intro.md#managing-sessions-intro-console) est automatiquement créée et active après l'installation du serveur. La session de console par défaut appartient à `Administrator` et son ID de session par défaut est `console`. Vous pouvez utiliser cette session ou la [fermer](managing-sessions-lifecycle-stop.md) et créer une nouvelle session.
Si vous avez choisi de désactiver la création automatique de session de console lors de l'installation du serveur Amazon DCV, vous devez en créer une manuellement. Après avoir installé le serveur Amazon DCV, vous pouvez activer ou désactiver la [création automatique de session de console](#managing-sessions-start-auto) à tout moment.
**Note**
Les serveurs Amazon DCV Linux et macOS ne bénéficient pas d'une session de console par défaut après l'installation.
Supposons que vous utilisez une licence flottante sur un serveur local ou sur un autre serveur basé sur le cloud et que vous dépassez le nombre maximal de sessions simultanées pris en charge par votre licence. Il se peut qu'un `no licenses` message d'erreur apparaisse. Dans ce cas, arrêtez une session non utilisée pour libérer la licence, puis réessayez.
Le serveur Amazon DCV doit être en cours d'exécution pour démarrer une session. Pour de plus amples informations, veuillez consulter [Démarrage du serveur Amazon DCV](manage-start.md).
**Topics**
+ [Démarrage manuel de la console et des sessions virtuelles](#managing-sessions-start-manual)
+ [Activation des sessions de console automatiques](#managing-sessions-start-auto)
## Démarrage manuel de la console et des sessions virtuelles
Vous pouvez démarrer une session Amazon DCV à tout moment. Vous ne pouvez exécuter qu'une seule session de console à la fois. Si vous utilisez un serveur Linux Amazon DCV, vous pouvez exécuter plusieurs sessions virtuelles en même temps.
Il est recommandé de l'exécuter `dcv list-sessions` avant de créer une session, en particulier si vous utilisez le serveur Windows Amazon DCV.
Pour créer une console ou une session virtuelle sur un serveur Amazon DCV Windows, Linux ou macOS, utilisez la `dcv create-session` commande.
**Topics**
+ [Syntaxe](#managing-sessions-start-manual-syntax)
+ [Options](#managing-sessions-start-manual-options)
+ [Exemples](#managing-sessions-start-manual-examples)
### Syntaxe
La syntaxe minimale de la commande pour démarrer une session est la suivante :
```
dcv create-session session_ID
```
La syntaxe complète avec toutes les options est la suivante :
```
dcv create-session \
--type console|virtual \
--name session_name \
--user username \
--owner owner_name \
--permissions-file /path_to/permissions_file \
--storage-root /path_to/storage_directory \
--gl on|off \
--max-concurrent-clients number_of_clients \
--init /path_to/init_script \
session_ID
```
**Note**
Le `\` symbole représente la syntaxe permettant de diviser une commande en plusieurs lignes.
Vous pouvez également l'utiliser `dcv create-session --help` pour afficher une référence rapide à la syntaxe.
### Options
Les options qui peuvent être utilisées avec la commande `dcv create-session` sont les suivantes :
**`--type`**
Cette option est prise en charge uniquement sur les serveurs Linux Amazon DCV. Elle indique le type de session à créer et peut être `console` ou `virtual`.
Type : Chaîne
Valeurs autorisées : `console` \$1 `virtual`
Obligatoire : non
**`--name`**
Spécifie le nom de la session. Les noms de session peuvent être n'importe quelle chaîne de 256 caractères maximum. Si la chaîne dépasse 256 caractères, la commande échoue. Il n'est pas nécessaire que les noms de session soient uniques pour les sessions en cours d'exécution.
Vous pouvez modifier le nom d'une session à tout moment à l'aide de la `dcv set-name` commande. Pour de plus amples informations, veuillez consulter [Gérer le nom de la session](managing-session-name.md).
Type : Chaîne
Obligatoire : oui
**`--user`**
Cette option n'est prise en charge que pour les sessions virtuelles sur les sessions Linux Amazon DCV. Cette valeur correspond à l'utilisateur qui doit créer la session. Seul l'utilisateur root peut emprunter l'identité des autres utilisateurs.
Type : chaîne
Obligatoire : non
**`--owner`**
Indique le propriétaire de la session. S'il est omis, il s'agit par défaut de l'utilisateur actuellement connecté.
Type : chaîne
Obligatoire : non
**`--permissions-file`**
Indique le chemin d'un fichier d'autorisations personnalisées. Si elle est omise, il s'agit par défaut des valeurs par défaut du serveur.
Type : chaîne
Obligatoire : non
**`--storage-root`**
Indique le chemin du dossier utilisé pour le stockage de session.
Vous pouvez utiliser `%home%` pour indiquer le répertoire de base de l'utilisateur actuellement connecté. Par exemple, ce qui suit définit le répertoire pour le stockage de session, tel que `c:\Users\username\storage\` pour les serveurs Windows ou `$HOME/storage/` pour les serveurs Linux.
```
--storage-root %home%/storage/
```
Si le sous-répertoire spécifié n'existe pas, le stockage de session est désactivé.
Type : chaîne
Obligatoire : non
**`--gl`**
Cette option n'est prise en charge que pour les sessions virtuelles sur les sessions Linux Amazon DCV. Elle remplace l'état `dcv-gl` par défaut et peut être `on` ou `off`.
Type : Chaîne
Valeurs autorisées : `on` \$1 `off`
Obligatoire : non
**`--max-concurrent-clients`**
Spécifie le nombre maximum de clients Amazon DCV autorisés à se connecter à la session. Si elle est omise, le nombre de connexions est illimité par défaut.
Type : Integer
Obligatoire : non
**`--init`**
Cette option est prise en charge uniquement avec les sessions virtuelles sur les serveurs Linux Amazon DCV. Elle indique le chemin d'un script `init` personnalisé. Le script permet de démarrer un environnement de poste de travail spécifique et de lancer automatiquement des applications spécifiques au démarrage de la session. Le script doit être exécutable. Si elle est omise, il s'agit par défaut d'un script qui démarre l'environnement de poste de travail par défaut.
Type : chaîne
Obligatoire : non
**`session ID`**
Fournit un identifiant pour votre session à la fin de la commande.
Type : Chaîne
Obligatoire : oui
### Exemples
**Exemple 1 - Session de la console**
La commande suivante crée une session de console détenue par `dcv-user` avec un ID de `my-session` session unique et un nom de session de`my graphics session`. Il spécifie également un fichier d'autorisations nommé`perm-file.txt`.
+ Serveur Windows Amazon DCV
```
C:\> dcv create-session^
--owner dcv-user^
--name "my graphics session"^
--permissions-file perm-file.txt^
my-session
```
+ Serveur Linux Amazon DCV
```
$ sudo dcv create-session \
--type=console \
--owner dcv-user \
--name "my graphics session" \
--permissions-file perm-file.txt \
my-session
```
**Exemple 2 : session virtuelle (serveurs Linux Amazon DCV uniquement)**
La commande suivante crée une session virtuelle en utilisant l'utilisateur root pour se faire passer pour le propriétaire de session prévu,. `dcv-user` La session appartient à l'utilisateur root `dcv-user` même si elle est créée
```
$ sudo dcv create-session \
--owner dcv-user \
--user dcv-user \
my-session
```
**Exemple 3 : session virtuelle (serveurs Linux Amazon DCV uniquement)**
La commande suivante crée une session virtuelle appartenant à l'utilisateur qui l'a créée :
```
$ dcv create-session my-session
```
## Activation des sessions de console automatiques
L'activation d'une session de console automatique garantit qu'une session de console est automatiquement créée chaque fois que le serveur Amazon DCV démarre. La session de console automatique appartient à l'utilisateur Amazon DCV spécifié par le paramètre de `owner` configuration. Son ID de session est toujours `console`.
Les autres paramètres qui affectent les sessions de console automatiques sont `max-concurrent-clients`, `permissions-file` et `storage-root`. Pour obtenir plus d’informations sur ces paramètres, consultez [Paramètres `session-management/automatic-console-session`](config-param-ref.md#session_management_automatic_console_session).
**Note**
Amazon DCV ne prend pas en charge les sessions virtuelles automatiques.
------
#### [ Windows Amazon DCV server ]
**Pour activer une session de console automatique sur un serveur Windows Amazon DCV**
1. Ouvrez l’Éditeur du Registre Windows.
1. Accédez à la clé de gestion de **session HKEY\$1USERS \$1 S-1-5-18 \$1 Software \$1 \$1 com \$1 n GSettings icesoftware \$1 dcv \$1.**
1. Créez un paramètre `create-session` :
1. Dans le volet de navigation, ouvrez le menu contextuel (clic droit) de la clé de **gestion de session et** choisissez **Nouveau**, valeur **DWORD (**32 bits).
1. Pour **Nom**, saisissez `create-session` et appuyez sur **Entrée**.
1. Ouvrez le paramètre **create-session**. Pour **Données de la valeur**, saisissez `1`, puis choisissez **OK**.
1. Accédez à la **clé HKEY\$1USERS \$1 S-1-5-18 \$1 Software \$1 \$1 com\$1nicesoftware \$1 dcv GSettings \$1** session-management/. automatic-console-session
1. Créez un paramètre `owner` :
1. Dans le volet de navigation, ouvrez le menu contextuel (clic droit) de la **automatic-console-session**clé et choisissez **Nouveau**, **valeur de chaîne**.
1. Pour **Nom**, saisissez `owner` et appuyez sur **Entrée**.
1. Ouvrez le paramètre **owner**. Pour **Données de la valeur**, saisissez le nom du propriétaire de la session, puis choisissez **OK**.
1. Choisissez **OK**, puis fermez l'Éditeur du Registre Windows.
1. [Arrêtez](manage-stop.md) et [redémarrez](manage-start.md) le serveur Amazon DCV.
------
#### [ Linux Amazon DCV server ]
**Pour activer une session de console automatique sur un serveur Linux Amazon DCV**
1. Accédez à `/etc/dcv/` et ouvrez `dcv.conf` avec l'éditeur de texte de votre choix.
1. Ajoutez les paramètres `create-session` et `owner` à la section `[session-management/automatic-console-session]` en respectant le format suivant :
```
[session-management]
create-session = true
[session-management/automatic-console-session]
owner="session-owner"
```
1. Enregistrez et fermez le fichier .
1. [Arrêtez](manage-stop.md) et [redémarrez](manage-start.md) le serveur Amazon DCV.
------
#### [ macOS Amazon DCV server ]
**Pour activer une session de console automatique sur un serveur MacOS Amazon DCV**
1. Accédez à `/etc/dcv/` et ouvrez `dcv.conf` avec l'éditeur de texte de votre choix.
1. Ajoutez les paramètres `create-session` et `owner` à la section `[session-management/automatic-console-session]` en respectant le format suivant :
```
[session-management]
create-session = true
[session-management/automatic-console-session]
owner="session-owner"
```
1. Enregistrez et fermez le fichier .
1. [Arrêtez](manage-stop.md) et [redémarrez](manage-start.md) le serveur Amazon DCV.
------