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
Une fois que les serveurs Amazon DCV sont configurés et que toutes vos applications sont installées, vos clients y accèdent via une session sécurisée. La gestion de ces sessions pour votre client lui accorde l'accès et définit les paramètres de chaque session.
Avant que vos clients puissent s'y connecter, vous devez créer une session Amazon DCV sur votre serveur Amazon DCV. Les clients ne peuvent se connecter à un serveur Amazon DCV que s'il existe une session active.
Chaque session Amazon DCV possède les attributs suivants :
+ **ID de session** : utilisé pour identifier une session spécifique sur le serveur Amazon DCV.
+ **Propriétaire** : utilisateur Amazon DCV qui a créé la session. Par défaut, seul un propriétaire peut se connecter à la session.
Les clients Amazon DCV ont besoin de ces informations pour se connecter à la session.
**Topics**
+ [Comprendre les sessions Amazon DCV](managing-sessions-intro.md)
+ [Utilisation de l'outil de ligne de commande pour gérer les sessions](managing-sessions-cli.md)
+ [Démarrage de sessions Amazon DCV](managing-sessions-start.md)
+ [Arrêt des sessions Amazon DCV](managing-sessions-lifecycle-stop.md)
+ [Affichage des sessions Amazon DCV](managing-sessions-lifecycle-view.md)
+ [Gestion des sessions Amazon DCV actives](managing-running-session.md)
+ [Réglage du fuseau horaire de la session](managing-session-time-zone.md)
+ [Gestion du blanchiment d'écran sous Linux](managing-screen-blanking.md)
+ [Prendre une capture d'écran lors d'une session Amazon DCV](managing-sessions-lifecycle-screenshot.md)
# Comprendre les sessions Amazon DCV
Amazon DCV propose deux types de sessions : les sessions de console et les sessions virtuelles. Le tableau suivant résume les différences entre les deux types de sessions.
| Type de session | Support | Sessions multiples | Autorisations requises | Capture d'écran directe | Support OpenGL accéléré par GPU |
| --- | --- | --- | --- | --- | --- |
| Console | Serveurs Amazon DCV Linux, macOS et Windows | Non, une seule session de console est autorisée sur chaque serveur | Seul l'utilisateur administrateur peut démarrer et fermer des sessions | Oui | Oui, sans logiciel supplémentaire |
| Virtuel | Serveurs Linux Amazon DCV uniquement | Oui, plusieurs sessions virtuelles sont autorisées sur un seul serveur | Tout utilisateur peut démarrer et fermer des sessions | Non, un serveur X dédié (Xdcv) s'exécute pour chaque session virtuelle. L'écran est capturé depuis le serveur X. | Oui, mais nécessite le package DCV-GL |
**Note**
Vous ne pouvez pas exécuter simultanément des sessions de console et virtuelles sur le même serveur Amazon DCV.
## Sessions de console
Les sessions de console sont prises en charge sur les serveurs Amazon DCV Windows, Linux et macOS. Si vous utilisez un serveur Amazon DCV Windows ou macOS, vous ne pouvez utiliser que des sessions de console.
Une seule session de console peut être hébergée sur le serveur Amazon DCV à la fois. Les sessions de console sont créées et gérées par l'administrateur sur les serveurs Amazon DCV Windows et par l'utilisateur root sur les serveurs Amazon DCV Linux et macOS.
Avec les sessions de console, Amazon DCV capture directement le contenu de l'écran du bureau. Si le serveur est configuré avec un GPU, les sessions de console Amazon DCV ont un accès direct au GPU.
## Sessions virtuelles
Les sessions virtuelles sont prises en charge uniquement sur les serveurs Linux Amazon DCV.
Vous pouvez héberger plusieurs sessions virtuelles sur le même serveur Amazon DCV en même temps. Les sessions virtuelles sont créées et gérées par les utilisateurs d'Amazon DCV. Les utilisateurs d'Amazon DCV peuvent uniquement gérer les sessions qu'ils ont créées. L'utilisateur root peut gérer toutes les sessions virtuelles actuellement en cours d'exécution sur le serveur Amazon DCV.
Avec les sessions virtuelles, Amazon DCV démarre une instance de serveur X et exécute un environnement de bureau au sein du serveur X. `Xdcv` Amazon DCV démarre une nouvelle instance de serveur X dédiée pour chaque session virtuelle. Chaque session virtuelle utilise l'affichage fourni par son instance de serveur X.
**Note**
Amazon DCV garantit que chaque session virtuelle dispose d'un `Xdcv` affichage indépendant, mais de nombreuses autres ressources système, notamment les fichiers du dossier personnel de l'utilisateur, les services D-Bus et les appareils, sont destinées à chaque utilisateur et seront donc partagées et accessibles sur plusieurs sessions virtuelles pour le même utilisateur.
Vous ne devez pas exécuter plusieurs sessions virtuelles sur le même serveur Amazon DCV pour le même utilisateur en même temps, sauf si vous avez configuré votre système d'exploitation pour atténuer les éventuels problèmes liés aux ressources partagées.
Si le `dcv-gl` package est installé et sous licence, les sessions virtuelles Amazon DCV partagent l'accès au serveur. GPUs Pour partager l'OpenGL matériel entre plusieurs sessions virtuelles, vous devez connecter l'instance de serveur X virtuel au GPU en configurant le fichier `dcv-gl.conf`.
# Utilisation de l'outil de ligne de commande pour gérer les sessions
Le serveur Amazon DCV inclut un outil de ligne de commande qui peut être utilisé pour démarrer, arrêter et afficher les sessions Amazon DCV.
## Utilisation de l'outil de ligne de commande sur un serveur Amazon DCV Windows
Pour utiliser l'outil de ligne de commande sur un serveur Amazon DCV Windows, exécutez les commandes depuis le répertoire d'installation Amazon DCV ou ajoutez le répertoire Amazon DCV à la variable d'environnement PATH. Si vous ajoutez le répertoire Amazon DCV à la variable d'environnement PATH, vous pouvez utiliser les commandes de n'importe quel répertoire.
**Pour utiliser l'outil de ligne de commande depuis le répertoire d'installation Amazon DCV**
Accédez au dossier dans lequel se trouve le `dcv.exe` fichier, `C:\Program Files\NICE\DCV\Server\bin\` par défaut, et ouvrez une fenêtre d'invite de commande.
Vous pouvez également indiquer le chemin d'accès complet lors de l'exécution d'une commande à partir d'un répertoire différent.
```
"C:\> Program Files\NICE\DCV\Server\bin\dcv.exe" list-sessions
```
**Pour ajouter le répertoire Amazon DCV à la variable d'environnement PATH**
1. Dans l'Explorateur de fichiers, cliquez avec le bouton droit sur **Ce PC** et choisissez **Propriétés**.
1. Choisissez **Paramètres système avancés**.
1. Sous l'onglet **Avancé**, choisissez **Variables d'environnement**.
1. Dans la section **Variables système** sélectionnez la variable **Path** et choisissez **Modifier**.
1. Choisissez **Nouveau** et spécifiez le chemin complet du `bin` dossier dans le répertoire d'installation Amazon DCV (par exemple,`C:\Program Files\NICE\DCV\Server\bin\`).
1. Choisissez **OK** et fermez la fenêtre Variables d'environnement.
## Utilisation de la ligne de commande sur un serveur Amazon DCV Linux
Sur les serveurs Linux Amazon DCV, l'outil de ligne de commande est automatiquement configuré dans la variable d'`$PATH`environnement. Vous pouvez utiliser l'outil depuis n'importe quel dossier. Ouvrez une fenêtre de terminal et saisissez la commande à exécuter.
## Utilisation de la ligne de commande sur un serveur MacOS Amazon DCV
Sur les serveurs MacOS Amazon DCV, l'outil de ligne de commande est automatiquement configuré dans la variable d'`$PATH`environnement. Vous pouvez utiliser l'outil depuis n'importe quel dossier. Ouvrez une fenêtre de terminal et saisissez la commande à exécuter.
## Utilisation de l'outil de ligne de commande
Le tableau suivant décrit les options des outils de ligne de commande disponibles. Cette liste peut être récupérée en l'utilisant `--help` lors de l'appel`dcv`. Pour plus d'informations sur l'utilisation de chaque commande, passez-la `--help` après la commande pour laquelle vous souhaitez obtenir des informations d'utilisation. Par exemple : `dcv create-session --help`.
| Commande | Description |
| --- | --- |
| `create-session` | Création d'une nouvelle session DCV |
| `close-session` | Fermer une session DCV active |
| `describe-session` | Décrire une session DCV |
| `list-sessions` | Répertorier les sessions DCV actives |
| `list-connections` | Répertorier les connexions client pour une session DCV |
| `close-connection` | Fermer une connexion client active |
| `get-screenshot` | Obtenez une capture d'écran de la console DCV |
| `set-display-layout` | Définir la disposition d'affichage d'une session DCV active |
| `set-name` | Définir le nom d'une session DCV |
| `set-permissions` | Définir les autorisations d'une session DCV active |
| `set-storage-root` | Définir la racine de stockage d'une session DCV active |
| `reload-licenses` | Forcer le rechargement des licences pour toutes les sessions en cours |
| `get-config` | Obtenir la configuration du serveur |
| `list-endpoints` | Répertorier les points de terminaison DCV |
| `set-config` | Définir la configuration du serveur |
| `version` | Afficher la version de DCV |
| `help` | Afficher l'aide |
# 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.
------
# Arrêt des sessions Amazon DCV
Une session de console ne peut être arrêtée que par l'administrateur sur les serveurs Amazon DCV Windows et par l'utilisateur root sur les serveurs Amazon DCV Linux et macOS. Une session virtuelle sur un serveur Amazon DCV Linux ne peut être arrêtée que par l'utilisateur root ou par l'utilisateur Amazon DCV qui l'a créée.
**Note**
L'arrêt d'une session ferme toutes les applications qui s'exécutent dans la session.
Pour arrêter une console ou une session virtuelle sur un serveur Amazon DCV Windows, Linux ou macOS, utilisez la `dcv close-session` commande et spécifiez l'ID de session unique.
**Topics**
+ [Syntaxe](#managing-sessions-lifecycle-stop-syntax)
+ [Exemple](#example)
## Syntaxe
```
dcv close-session session-id
```
## Exemple
Par exemple, la commande suivante arrête une session avec l'identifiant unique de`my-session`.
```
dcv close-session my-session
```
# Affichage des sessions Amazon DCV
L'administrateur d'un serveur Amazon DCV Windows ou l'utilisateur root d'un serveur Amazon DCV Linux peut consulter toutes les sessions actives en cours d'exécution sur le serveur. Les utilisateurs d'Amazon DCV peuvent uniquement consulter les sessions qu'ils ont créées.
**Topics**
+ [Afficher toutes les sessions actives](#list-all)
+ [Afficher une session active spécifique](#view-specific)
## Afficher toutes les sessions actives
Pour répertorier la console active ou les sessions virtuelles sur un serveur Amazon DCV Windows ou Linux, utilisez la `dcv list-sessions` commande.
**Topics**
+ [Syntaxe](#list-all-syntax)
+ [Output](#output)
### Syntaxe
```
dcv list-sessions
```
### Output
La commande renvoie une liste des sessions actives au format suivant.
```
Session: session-id (owner:session-owner type:virtual|console name:'my session')
```
## Afficher une session active spécifique
Pour afficher les informations relatives à une session, utilisez la `dcv describe-session` commande et spécifiez l'ID de session unique.
**Topics**
+ [Syntaxe](#view-specific-syntax)
+ [Output](#output)
### Syntaxe
```
$ dcv describe-session session_id
```
### Output
Dans l'exemple de sortie suivant, l'`display-layout`élément indique que la disposition d'affichage de la session est configurée pour utiliser deux écrans 800 x 600. Parmi ceux-ci, le deuxième écran est décalé à x=800 (à droite) par rapport au premier écran.
```
Session: test
owner: session-id
name: session-name
x display: :1
x authority: /run/user/1009/dcv/test.xauth
display layout: 800x600+0+0,800x600+800+0
```
Vous pouvez également inclure l'option `--json` (ou `-j`) pour forcer la commande à renvoyer la sortie au format JSON. La sortie JSON fournit des détails supplémentaires sur la session.
```
$ dcv describe-session session-id --json
```
Voici un exemple de sortie JSON.
```
{
"id" : "session-id",
"owner" : "dcvuser",
"name" : "session-name",
"num-of-connections" : 0,
"creation-time" : "2020-03-02T16:08:50Z",
"last-disconnection-time" : "",
"licenses" : [
{
"product" : "dcv",
"status" : "licensed",
"check-timestamp" : "2020-03-02T16:08:50Z",
"expiration-date" : "2020-03-29T00:00:00Z"
},
{
"product" : "dcv-gl",
"status" : "licensed",
"check-timestamp" : "2020-03-02T16:08:50Z",
"expiration-date" : "2020-03-29T00:00:00Z"
}
],
"storage-root" : "",
"type" : "virtual",
"x11-display" : ":2",
"x11-authority" : "/run/user/1009/dcv/vsession.xauth",
"display-layout" : [
{
"width" : 800,
"height" : 600,
"x" : 0,
"y" : 0
},
{
"width" : 800,
"height" : 600,
"x" : 800,
"y" : 0
}
]
}
```
# 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.
# Réglage du fuseau horaire de la session
Le DCV permet aux propriétaires de sessions et aux utilisateurs de définir le fuseau horaire de leur session pour qu'il reflète soit l'emplacement du serveur DCV, soit leur emplacement actuel.
Si seuls les utilisateurs individuels d'une session sont nécessaires pour bénéficier de cette fonctionnalité, vous devez d'abord définir le paramètre centralisé pour tous les utilisateurs, puis ajuster les autorisations individuelles séparément en créant un fichier d'autorisations personnalisé sur. [Ajout d’autorisations](security-authorization-file-create-permission.md)
**Note**
Cette fonctionnalité n'est pas disponible sur les sessions virtuelles Linux.
**Note**
Sur macOS, la redirection du fuseau horaire est appliquée après la connexion.
**Activation de la redirection des fuseaux horaires**
Vous pouvez activer et désactiver cette fonctionnalité pour tous les utilisateurs d'une session spécifique.
1. Modifiez le [`enable-timezone-redirection`](config-param-ref.md#paramref.redirection.enable-timezone-redirection)paramètre en lui attribuant l'une des valeurs suivantes :
+ `always-on`: La redirection de fuseau horaire est toujours activée.
La fonctionnalité sera activée et la session affichera les informations de fuseau horaire du client. L'utilisateur ne pourra pas désactiver cette fonctionnalité.
+ `always-off`: La redirection de fuseau horaire est toujours désactivée.
La fonctionnalité sera désactivée et la session affichera ses propres informations de fuseau horaire. L'utilisateur ne pourra pas activer cette fonctionnalité.
+ `client-decides`: La redirection de fuseau horaire est activée par défaut.
La session aura la fonctionnalité activée, affichera le fuseau horaire du client, et l'utilisateur aura la possibilité de la désactiver pour permettre l'affichage du fuseau horaire du serveur.
**Note**
Ce paramètre est le paramètre par défaut standard.
1. Redémarrez les sessions concernées pour que vos modifications apparaissent.
# Gestion du blanchiment d'écran sous Linux
Pour les sessions de console sur un serveur Linux, DCV vide l'écran local par défaut lorsqu'au moins un utilisateur distant est connecté au serveur, et restaure la sortie (verrouille également l'écran) lors de la déconnexion du dernier utilisateur distant.
Cela empêche l'utilisateur se trouvant à proximité physique d'un serveur de voir l'écran et d'interagir avec la session à distance à l'aide des périphériques d'entrée connectés à l'hôte. Cela peut être indésirable pour des raisons de confidentialité ou de conformité aux lois locales lorsque vous travaillez à distance sur des sessions de console. La saisie locale est empêchée en désactivant les périphériques physiquement connectés tels que le clavier et la souris. Les périphériques d'entrée sont désactivés dès qu'ils sont branchés ou qu'ils sont activés. De manière analogue, les périphériques d'entrée sont réactivés lorsqu'aucun utilisateur distant n'est connecté, ce qui permet une connexion et une interaction locales.
**Désactiver le blanchiment d'écran et le blocage des entrées**
Le masquage d'écran peut être désactivé à l'aide de la procédure suivante :
1. Accédez à `/etc/dcv/` et ouvrez le fichier `dcv.conf` avec l'éditeur de texte de votre choix.
1. `disable-local-console parameter`Repérez-le dans la `[display/linux]` section. Permettre aux écrans connectés localement de rester actifs et d'afficher la session à distance en cours, et autoriser l'interaction via des appareils connectés localement définis`disable-local-console=false`. La valeur par défaut est `true` (c'est-à-dire : le blanchiment d'écran et le blocage des entrées sont actifs). S'il n'y a aucun `disable-local-console` paramètre dans la `[display/linux]` section, ajoutez-le manuellement en utilisant le format suivant :
```
[display/linux]
disable-local-console=false|true
```
1. Enregistrez et fermez le fichier .
1. [Arrêtez](manage-stop.md) et [redémarrez](manage-start.md) le serveur Amazon DCV.
**Empêcher la désactivation des périphériques d'entrée sélectionnés**
Des appareils spécifiques peuvent être configurés pour rester activés.
Les périphériques de saisie dont le nom commence par `DCV ` (veuillez faire attention à l'espace après le nom) ne seront jamais désactivés, quelle que soit la valeur du `display-local-console` paramètre. Pour renommer les périphériques d'entrée, reportez-vous à ce guide : [Activer le stylet](enable-stylus.md).
# Prendre une capture d'écran lors d'une session Amazon DCV
Vous pouvez utiliser la `dcv get-screenshot` commande pour prendre une capture d'écran du bureau pour la session en cours d'exécution.
## Syntaxe
```
dcv get-screenshot --max-width pixels --max-height pixels --format JPEG|PNG --primary --json --output /path_to/destination session_name
```
## Options
**`--max-width`**
Spécifie la largeur maximale, en pixels, de la capture d'écran. Si vous ne spécifiez ni largeur ni hauteur, la capture d'écran utilise la résolution d'affichage de la session. Si vous spécifiez uniquement une hauteur, la largeur est automatiquement redimensionnée pour conserver le rapport hauteur/largeur.
Type : Integer
Obligatoire : non
**`--max-height`**
Spécifie la hauteur maximale, en pixels, de la capture d'écran. Si vous ne spécifiez ni largeur ni hauteur, la capture d'écran utilise la résolution d'affichage de la session. Si vous spécifiez une largeur uniquement, la hauteur est automatiquement redimensionnée pour conserver le rapport hauteur/largeur.
Type : Integer
Obligatoire : non
**`--format`**
Format de fichier de la capture d'écran. Actuellement, seuls les `PNG` formats `JPEG` et sont pris en charge. Si vous spécifiez des types de fichiers conflictuels pour les `--output` options `--format` et, la valeur spécifiée pour `--format` est prioritaire. Par exemple, si vous spécifiez `--format JPEG` et`--output myfile.png`, Amazon DCV crée un fichier image JPEG.
Type : Chaîne
Valeurs autorisées : `JPEG` \$1 `PNG`
Obligatoire : non
**`--primary`**
Indique s'il faut obtenir une capture d'écran de l'écran principal uniquement. Pour obtenir une capture d'écran de l'écran principal uniquement, spécifiez`--primary`. Pour obtenir une capture d'écran de tous les écrans, omettez cette option. Si vous choisissez d'obtenir une capture d'écran de tous les écrans, tous les écrans sont combinés en une seule capture d'écran.
Obligatoire : non
**`--json`, `-j`**
Indique s'il faut fournir la sortie au format JSON codé en base64. Pour obtenir une sortie JSON, spécifiez`--json`. Sinon, omettez-le.
Obligatoire : non
**`--output`, `-o`**
Spécifie le chemin de destination, le nom du fichier et le type de fichier pour la capture d'écran. Par exemple, pour Windows, spécifiez`c:\directory\filename.format`, et pour Linux, spécifiez`/directory/filename.format`. Le format doit être `.png` ou`.jpeg`. Si vous spécifiez des types de fichiers conflictuels pour les `--output` options `--format` et, la valeur spécifiée pour `--format` est prioritaire. Par exemple, si vous spécifiez `--format JPEG` et`--output myfile.png`, Amazon DCV crée un fichier image JPEG.
Type : chaîne
Obligatoire : non
## Exemples
**Exemple 1**
L'exemple de commande suivant permet d'obtenir une capture d'écran d'une session nommée`my-session`. La capture d'écran utilise la résolution du serveur.
```
dcv get-screenshot --output myscreenshot.png my-session
```
**Exemple 2**
L'exemple de commande suivant prend une capture d'écran de `200` pixels de largeur par `100` pixels de hauteur. Cela provient d'une session nommée`my-session`. Il enregistre la capture d'écran dans le répertoire courant avec le nom du fichier`myscreenshot.png`.
```
dcv get-screenshot --max-width 200 --max-height 100 --output myscreenshot.png my-session
```
**Exemple 3**
L'exemple de commande suivant prend une capture d'écran d'une session nommée`my-session`. La capture d'écran ne concerne que l'écran principal. Il enregistre le fichier dans le répertoire en cours et nomme la capture d'écran`myscreenshot.png`.
```
dcv get-screenshot --primary --output myscreenshot.jpeg my-session
```
**Exemple 4**
L'exemple de commande suivant permet d'obtenir une capture d'écran d'une session nommée`my-session`. La commande affiche le fichier codé en base64 et au format JSON.
```
dcv get-screenshot --json --format png my-session
```