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.

# Prendre une capture d'écran lors d'une session Amazon DCV
<a name="managing-sessions-lifecycle-screenshot"></a>

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
<a name="managing-sessions-lifecycle-screenshot-syntax"></a>

```
dcv get-screenshot --max-width {{pixels}} --max-height {{pixels}} --format {{JPEG|PNG}} --primary --json --output {{/path_to/destination}} {{session_name}}
```

## Options
<a name="managing-sessions-lifecycle-screenshot-options"></a>

**`--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` \| `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
<a name="examples"></a>

**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
```