Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Realización de una captura de pantalla en una sesión de Amazon DCV
<a name="managing-sessions-lifecycle-screenshot"></a>

Puede utilizar el comando `dcv get-screenshot` para hacer una captura de pantalla del escritorio durante la sesión en ejecución. 

## Sintaxis
<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}}
```

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

**`--max-width`**  
Especifica el ancho máximo, en píxeles, de la captura de pantalla. Si no especifica la anchura o la altura, la captura de pantalla utilizará la resolución de pantalla de la sesión. Si solo especifica la altura, la anchura se ajusta automáticamente para mantener la relación de aspecto.  
Tipo: entero  
Obligatorio: no

**`--max-height`**  
Especifica la anchura máxima, en píxeles, de la captura de pantalla. Si no especifica la anchura o la altura, la captura de pantalla utilizará la resolución de pantalla de la sesión. Si solo especifica la altura, la anchura se escala automáticamente para mantener la relación de aspecto.  
Tipo: entero  
Obligatorio: no

**`--format`**  
Formato de archivo de la captura de pantalla. Actualmente, los formatos compatibles son `JPEG` y `PNG`. Si especifica tipos de archivo en conflicto para las opciones `--format` y `--output`, el valor especificado para `--format` tendrá prioridad. Por ejemplo, si especifica `--format JPEG` y `--output myfile.png`, Amazon DCV crea un archivo de imagen JPEG.  
Tipo: cadena  
Valores permitidos: `JPEG` \| `PNG`  
Obligatorio: no

**`--primary`**  
Indica si se debe realizar una captura de pantalla únicamente de la pantalla principal. Para obtener una captura de pantalla de la pantalla principal únicamente, especifique `--primary`. Para obtener una captura de pantalla de todas las pantallas, omita esta opción. Si opta por obtener una captura de pantalla de todas las pantallas, se combinarán en una sola captura de pantalla.  
Obligatorio: no

**`--json`, `-j`**  
Indica si se debe entregar la salida en formato JSON codificada en base64. Para obtener salida JSON, especifique `--json`. De lo contrario, omítalo.  
Obligatorio: no

**`--output`, `-o`**  
Especifica la ruta de destino, el nombre de archivo y el tipo de archivo de la captura de pantalla. Por ejemplo, para Windows, especifique `c:\directory\filename.format` y para Linux, `/directory/filename.format`. El formato debe ser `.png` o `.jpeg`. Si especifica tipos de archivo en conflicto para las opciones `--format` y `--output`, el valor especificado para `--format` tendrá prioridad. Por ejemplo, si especifica `--format JPEG` y `--output myfile.png`, Amazon DCV crea un archivo de imagen JPEG.  
Tipo: cadena  
Obligatorio: no

## Ejemplos
<a name="examples"></a>

**Ejemplo 1**  
El siguiente comando de ejemplo realiza una captura de pantalla de una sesión llamada `my-session`. La captura de pantalla utiliza la resolución del servidor.

```
dcv get-screenshot --output myscreenshot.png my-session
```

**Ejemplo 2**  
El siguiente comando de ejemplo toma una captura de pantalla de `200` píxeles de ancho por `100` píxeles de alto. La toma de una sesión llamada `my-session`. Guarda la captura de pantalla en el directorio actual con el nombre del archivo `myscreenshot.png`.

```
dcv get-screenshot --max-width 200 --max-height 100 --output myscreenshot.png my-session
```

**Ejemplo 3**  
El siguiente comando de ejemplo realiza una captura de pantalla de una sesión llamada `my-session`. La captura de pantalla es solo de la pantalla principal. Guarda el archivo en el directorio actual con el nombre de la captura de pantalla `myscreenshot.png`.

```
dcv get-screenshot --primary --output myscreenshot.jpeg my-session
```

**Ejemplo 4**  
El siguiente comando de ejemplo toma una captura de pantalla de una sesión llamada `my-session`. El comando genera el archivo codificado en base64 y en formato JSON.

```
dcv get-screenshot --json --format png my-session
```