As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Fazer uma captura de tela em uma sessão do Amazon DCV
<a name="managing-sessions-lifecycle-screenshot"></a>

Você pode usar o comando `dcv get-screenshot` para obter uma captura de tela da área de trabalho para a sessão em execução. 

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

## Opções
<a name="managing-sessions-lifecycle-screenshot-options"></a>

**`--max-width`**  
Especifica a largura máxima, em pixels, da captura de tela. Se você não especificar uma largura ou altura, a captura de tela usará a resolução de exibição da sessão. Se você especificar somente uma altura, a largura será automaticamente escalada para manter a proporção.  
Tipo: inteiro  
Obrigatório: não

**`--max-height`**  
Especifica a altura máxima, em pixels, da captura de tela. Se você não especificar uma largura ou altura, a captura de tela usará a resolução de exibição da sessão. Se você especificar somente uma largura, a altura será automaticamente escalada para manter a proporção.  
Tipo: inteiro  
Obrigatório: não

**`--format`**  
O formato do arquivo da captura de tela. Atualmente, apenas os formatos `JPEG` e `PNG` são compatíveis. Se você especificar tipos de arquivo conflitantes para as opções `--format` e `--output`, o valor especificado para `--format` terá prioridade. Por exemplo, se você especificar `--format JPEG` e `--output myfile.png`, o Amazon DCV cria um arquivo de imagem JPEG.  
Tipo: string  
Valores permitidos: `JPEG` \| `PNG`  
Obrigatório: não

**`--primary`**  
Indica se será obtida uma captura de tela somente da exibição principal. Para obter uma captura de tela somente da exibição principal, especifique `--primary`. Para obter uma captura de tela de todas as exibições, omita essa opção. Se você optar por obter uma captura de tela de todas as exibições, todas elas serão combinadas em uma única captura de tela.  
Obrigatório: não

**`--json`, `-j`**  
Indica se a saída será entregue no formato JSON codificado em base64. Para obter a saída JSON, especifique `--json`. Caso contrário, omita-o.  
Obrigatório: não

**`--output`, `-o`**  
Especifica o caminho de destino, o nome do arquivo e o tipo de arquivo para a captura de tela. Por exemplo, para Windows, especifique `c:\directory\filename.format` e, para Linux, especifique `/directory/filename.format`. O formato deve ser `.png` ou `.jpeg`. Se você especificar tipos de arquivo conflitantes para as opções `--format` e `--output`, o valor especificado para `--format` terá prioridade. Por exemplo, se você especificar `--format JPEG` e `--output myfile.png`, o Amazon DCV cria um arquivo de imagem JPEG.  
Tipo: string  
Obrigatório: não

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

**Exemplo 1**  
O comando de exemplo a seguir obtém uma captura de tela de uma sessão chamada `my-session`. A captura de tela usa a resolução do servidor.

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

**Exemplo 2**  
O comando de exemplo a seguir faz uma captura de tela com `200` pixels de largura por `100` pixels de altura. Isso vem de uma sessão chamada `my-session`. Ela salva a captura de tela no diretório atual com o nome de arquivo `myscreenshot.png`.

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

**Exemplo 3**  
O comando de exemplo a seguir faz uma captura de tela de uma sessão chamada `my-session`. A captura de tela é somente da exibição principal. Ela salva a captura de tela no diretório atual e a nomeia como `myscreenshot.png`.

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

**Exemplo 4**  
O comando de exemplo a seguir obtém uma captura de tela de uma sessão chamada `my-session`. O comando gera o arquivo codificado em base64 e no formato JSON.

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