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.
# Gestion des sessions Amazon DCV actives
Une fois qu'un client est connecté et commence à utiliser une session DCV, celle-ci est considérée comme active. Lorsqu'une session est active, vous pouvez toujours effectuer certaines tâches de gestion. Cette section fournit les informations dont vous avez besoin pour gérer les paramètres de ces sessions pendant qu'elles sont encore utilisées par le client.
**Topics**
+ [Gestion du stockage des sessions](managing-session-storage.md)
+ [Gestion de l'autorisation de session](managing-session-perms.md)
+ [Gestion de la disposition d'affichage de la session](managing-session-display.md)
+ [Gérer le nom de la session](managing-session-name.md)
+ [Recherche et arrêt des sessions inactives](stop-idle-sessions.md)
# Gestion du stockage des sessions Amazon DCV
Le stockage de session est un répertoire sur le serveur Amazon DCV auquel les clients peuvent accéder lorsqu'ils sont connectés à une session Amazon DCV.
Si le stockage de session est activé sur le serveur Amazon DCV, vous pouvez utiliser la `dcv set-storage-root` commande pour spécifier le répertoire du serveur à utiliser pour le stockage de session. Pour plus d'informations sur l'activation du stockage de session sur le serveur Amazon DCV, consultez[Activation du stockage de session](manage-storage.md).
Pour définir le chemin de stockage de session, utilisez la `dcv set-storage-root` commande et spécifiez l'ID de session et le chemin d'accès au répertoire à utiliser.
**Topics**
+ [Syntaxe](#managing-session-storage-syntax)
+ [Options](#managing-session-storage-options)
+ [Exemples](#session-storage-example)
## Syntaxe
```
dcv set-storage-root --session session_id /path_to/directory
```
Pour le chemin du répertoire, vous pouvez l'utiliser `%home%` pour spécifier le répertoire de base de l'utilisateur actuellement connecté. Par exemple, le chemin d'accès `%home%/storage/` se résout en `c:\Users\username\storage\` sur les serveurs Windows. Il se résout en `$HOME/storage/` sur les serveurs Linux.
**Note**
La `storage-root` valeur doit être un chemin absolu sur macOS.
## Options
Les options suivantes peuvent être utilisées avec la `dcv set-storage-root` commande
**`--session`**
ID de session pour lequel le répertoire de stockage doit être spécifié.
Type : Chaîne
Obligatoire : oui
## Exemples
**Exemple de serveur Windows Amazon DCV**
L'exemple suivant définit le chemin d'accès de stockage vers `c:\session-storage` pour une session avec un ID de session de `my-session`.
```
C:\> dcv set-storage-root --session my-session c:\session-storage
```
**Exemple de serveur Linux Amazon DCV**
L'exemple suivant définit le chemin d'accès de stockage vers un répertoire nommé `session-storage` dans le répertoire de base de l'utilisateur actuel, pour une session avec un ID de session de `my-session`.
```
$ dcv set-storage-root --session my-session %home%/session-storage/
```
# Gestion de l'autorisation de session Amazon DCV
L'autorisation est utilisée pour accorder ou refuser aux clients Amazon DCV l'autorisation d'accéder à des fonctionnalités spécifiques d'Amazon DCV. Généralement, l'autorisation est configurée lorsqu'une session Amazon DCV est démarrée. Cependant, il est possible de modifier les autorisations pour une session en cours d'exécution. Pour plus d'informations sur l'autorisation Amazon DCV, consultez[Configuration de l'autorisation Amazon DCV](security-authorization.md).
Pour modifier les autorisations d'une session en cours d'exécution, utilisez la `dcv set-permissions` commande.
**Topics**
+ [Syntaxe](#managing-session-perms-syntax)
+ [Options](#managing-session-perms-options)
+ [Exemples](#session-perms-example)
## Syntaxe
```
dcv set-permissions --session session-id --none | --reset-builtin | --file /path_to/permissions_file
```
Vous devez spécifier soit `--none``--reset-builtin`, soit`--file`.
## Options
Les options qui peuvent être utilisées avec la commande `dcv set-permissions` sont les suivantes.
**--session**
Spécifie l'ID de la session pour laquelle définir les autorisations.
**--reset-builtin**
Réinitialise les autorisations de session sur les autorisations de session par défaut. Les autorisations par défaut accordent uniquement au propriétaire de la session un accès complet à toutes les fonctions.
**--none**
Révoque toutes les autorisations pour la session.
**--file**
Indique le chemin d'accès d'un fichier d'autorisations personnalisées. Si le fichier spécifié est vide, toutes les autorisations sont révoquées. Pour de plus amples informations sur la création d'un fichier d'autorisations personnalisées, veuillez consulter [Comprendre les fichiers d'autorisations](security-authorization-file-create.md).
## Exemples
**Exemple 1 — Révocation de toutes les autorisations**
L'exemple suivant révoque toutes les autorisations client pour une session avec un ID de `my-session`.
```
C:\> dcv set-permissions --session my-session --none
```
**Exemple 2 — Spécification d'autorisations personnalisées**
L'exemple suivant indique un fichier d'autorisations personnalisé nommé `perm-file.txt` d'après une session dont l'ID est`my-session`. Ce fichier est situé dans le répertoire `c:\dcv\`.
```
C:\> dcv set-permissions --session my-session --file c:\dcv\perm-file.txt
```
**Exemple 3 : Réinitialisation des autorisations**
L'exemple suivant réinitialise les autorisations par défaut pour une session avec un ID de `my-session`.
```
C:\> dcv set-permissions --session my-session --reset-builtin
```
# Gestion de la disposition d'affichage de la session Amazon DCV
Vous pouvez définir la disposition d'affichage pour une session Amazon DCV en cours d'exécution. La disposition d'affichage indique la configuration par défaut utilisée lorsque les clients se connectent à la session. Toutefois, les clients peuvent modifier manuellement la mise en page à l'aide des paramètres du client Amazon DCV ou des paramètres d'affichage du système d'exploitation natif.
Si la configuration matérielle et logicielle du serveur hôte ne prend pas en charge la résolution spécifiée ou le nombre d'écrans, le serveur Amazon DCV n'applique pas la disposition d'affichage spécifiée.
Amazon DCV peut configurer une résolution en fonction des paramètres et de la configuration du système du serveur.
+ La résolution du client Web est limitée par défaut à 1920 x 1080 (à partir du paramètre web-client-max-head -resolution du serveur).
+ Les clients natifs sont limités par défaut à 4096 x 2160 (à partir de). max-head-resolution
Notez que les résolutions disponibles et le nombre de moniteurs dépendent de la configuration du serveur. Assurez-vous de suivre le [guide des prérequis](https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing.html) pour configurer correctement l'environnement système et les pilotes afin d'optimiser les performances.
**Note**
Pour les clients natifs, un maximum de quatre moniteurs peuvent être utilisés.
Pour les clients Web, il est possible d'utiliser jusqu'à deux moniteurs.
Les résolutions supérieures ou le nombre maximum de moniteurs ne sont pris en charge dans aucune configuration.
**Topics**
+ [Accès à la disposition de l'affichage](#display-restrict)
+ [Configuration de la disposition de l'affichage](#dislay-set)
+ [Affichage de la disposition d'affichage](#dislay-view)
## Accès à la disposition de l'affichage
Vous pouvez configurer le serveur Amazon DCV pour empêcher les clients de demander des mises en page situées en dehors d'une plage spécifiée. Pour limiter les modifications de disposition d'affichage, configurez les paramètres du serveur Amazon DCV suivants.
+ [`enable-client-resize`](config-param-ref.md#paramref.display.enable-client-resize)—Pour empêcher les clients de modifier la disposition d'affichage, définissez ce paramètre sur`false`.
+ [`min-head-resolution`](config-param-ref.md#paramref.display.min-head-resolution)et [`max-head-resolution`](config-param-ref.md#paramref.display.max-head-resolution)—Spécifie respectivement les résolutions minimale et maximale autorisées.
+ [`web-client-max-head-resolution`](config-param-ref.md#paramref.display.web-client-max-head-resolution)—Spécifie la résolution maximale autorisée pour les clients de navigateur Web. La limitation `max-head-resolution` est appliquée en plus de la limitation `web-client-max-head-resolution`. Par défaut, la résolution maximale pour les clients de navigateur Web est de 1920 x 1080. La spécification d'une résolution supérieure peut entraîner des problèmes de performances, en fonction du navigateur Web et des spécifications de l'ordinateur client.
+ [`max-num-heads`](config-param-ref.md#paramref.display.max-num-heads): indique le nombre maximal d'écrans.
+ `max-layout-area`— Spécifie le nombre maximum de pixels autorisés pour la zone d'écran. Les demandes dont la surface d'écran totale (exprimée en pixels) dépasse la valeur spécifiée sont ignorées.
Pour de plus amples informations sur ces paramètres, veuillez consulter [Paramètres `display`](config-param-ref.md#display) dans la Référence des paramètres.
## Configuration de la disposition de l'affichage
**Pour configurer la disposition d'affichage pour une session Amazon DCV en cours d'exécution**
Utilisez la `dcv set-display-layout` commande et spécifiez la session pour laquelle définir la disposition d'affichage et le descripteur de mise en page d'affichage pour.
```
dcv set-display-layout --session session-id display-layout-descriptor
```
Le descripteur de disposition d'affichage indique le nombre d'affichages ainsi que la résolution et le décalage de position de chaque affichage. La description doit être spécifiée dans le format suivant :
```
widthxheight+|-x-position-offset+|-y-position-offset
```
Si vous spécifiez plusieurs écrans, séparez les descripteurs d'écran par une virgule. Les décalages de position de l'écran indiquent la position du coin supérieur gauche de l'écran par rapport à l'écran 1. Si vous ne spécifiez pas de décalage de position pour un écran, les valeurs par défaut sont x=0 et y=0.
**Important**
Si vous spécifiez plusieurs écrans, veillez à définir correctement le décalage de position pour chaque écran, afin d'éviter les chevauchements d'écran.
Par exemple, le descripteur de disposition d'affichage suivant spécifie deux écrans :
+ Écran 1 : résolution 1920x1080 décalage de x=0, y=0
+ Écran 2 : résolution 800x600 décalage de x=1920, y=0 pour qu'il apparaisse à droite de l'écran 1.
![\[Disposition de l'écran avec deux écrans.\]](http://docs.aws.amazon.com/fr_fr/dcv/latest/adminguide/images/eg2.png)
```
1920x1080+0+0,800x600+1920+0
```
Le descripteur de disposition d'affichage suivant spécifie trois écrans.
+ Écran 1 : résolution 1920x1080 décalage de x=0, y=0
+ Écran 2 : résolution 1920x1080 décalage de x=1920, y=0 pour qu'il apparaisse à droite de l'écran 1.
+ Écran 3 : résolution 1024x768 décalage de x=-1024, y=0 pour qu'il apparaisse à gauche de l'écran 1.
![\[Disposition de l'écran avec trois écrans.\]](http://docs.aws.amazon.com/fr_fr/dcv/latest/adminguide/images/eg1.png)
```
1920x1080+0+0,1920x1080+1920+0,1024x768-1024+0
```
## Affichage de la disposition d'affichage
**Pour afficher la disposition d'affichage d'une session**
Utilisez la commande `dcv describe-session` et passez en revue l'élément `display layout` dans la sortie. Pour de plus amples informations, veuillez consulter [Affichage des sessions Amazon DCV](managing-sessions-lifecycle-view.md).
# Gérer le nom de la session
Vous pouvez modifier le nom d'une session en cours à tout moment. Vous pouvez utiliser le nom spécifique de la session pour identifier rapidement une session en fonction de son nom. Il n'est pas nécessaire que les noms de session soient uniques pour les sessions en cours d'exécution.
Pour modifier le nom d'une session en cours d'exécution, utilisez la `dcv set-name` commande.
**Topics**
+ [Syntaxe](#managing-session-name-syntax)
+ [Options](#managing-session-name-options)
+ [Exemples](#example)
## Syntaxe
```
$ dcv set-name --session session_id --none |--name "session-name"
```
Vous devez spécifier `--name` ou `--none`.
## Options
Les options qui peuvent être utilisées avec la commande `dset-name` sont les suivantes.
**`--session`**
ID de la session dont le nom doit être défini.
Type : Chaîne
Obligatoire : oui
**`--name`**
Le nom à attribuer à la session. Spécifiez cette option uniquement si vous souhaitez attribuer un nom à la session. Si vous souhaitez supprimer un nom, omettez ce paramètre. Le nom de session peut comporter jusqu'à 256 caractères. Il peut être composé de lettres, de chiffres et de caractères spéciaux. Si la chaîne spécifiée dépasse 256 caractères, la commande échoue.
Type : chaîne
Obligatoire : non
**`--none`**
Spécifiez ce paramètre pour supprimer un nom existant d'une session. Si vous ne souhaitez pas supprimer le nom de session, omettez cette option.
Obligatoire : non
## Exemples
**Exemple 1 — Modification du nom d'une session**
L'exemple suivant définit le nom d'une session avec l'ID `my-session` to`my graphics session`.
```
$ dcv set-name --session my-session --name "my graphics sessions"
```
**Exemple 2 — Supprimer le nom d'une session**
L'exemple suivant supprime le nom d'une session dont l'ID est`my-session`.
```
$ dcv set-name --session my-session --none
```
# Recherche et arrêt des sessions inactives
Vous pouvez identifier les sessions Amazon DCV inactives à l'aide de la commande `dcv describe-sessions` CLI avec l'option de `-j` commande. La spécification de l'option `-j` configure la commande pour renvoyer la sortie au format JSON, ce qui fournit des détails supplémentaires sur la session.
Par exemple, la commande suivante renvoie des informations sur une session nommée `my-session`.
```
$ dcv describe-session my-session -j
```
Sortie :
```
{
"id" : "my-session",
"owner" : "dcvuser",
"x11-display" : ":1",
"x11-authority" : "/run/user/1009/dcv/test3.xauth",
"num-of-connections" : 1,
"creation-time" : "2019-05-13T13:21:19.262883Z",
"last-disconnection-time" : "2019-05-14T12:32:14.357567Z",
"licensing-mode" : "DEMO",
"licenses" : [
{
"product" : "dcv",
"status" : "LICENSED",
"check-timestamp" : "2019-05-14T12:35:40Z",
"expiration-date" : "2019-05-29T00:00:00Z"
},
{
"product" : "dcv-gl",
"status" : "LICENSED",
"check-timestamp" : "2019-05-14T12:35:40Z",
"expiration-date" : "2019-05-29T00:00:00Z"
}
]
}
```
Dans la sortie de la commande, le paramètre `num-of-connections` indique le nombre de connexions clientes actives. La valeur de `0` indique qu'il n'y a pas de connexion client actives et que la session est actuellement inactive. Vous pouvez également utiliser le paramètre `last-disconnection-time` pour déterminer quand la dernière session avait une connexion client active.
Vous pouvez créer un script ou une tâche cron qui utilise ces informations pour identifier les sessions inactives. Ensuite, vous pouvez arrêter de les utiliser en utilisant la commande [`dcv close-session`](managing-sessions-lifecycle-stop.md).
**Note**
L'arrêt d'une session ferme toutes les applications qui s'exécutent dans la session.