Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Acquisizione di uno screenshot in una sessione Amazon DCV
<a name="managing-sessions-lifecycle-screenshot"></a>

Puoi usare il `dcv get-screenshot` comando per acquisire uno screenshot del desktop per la sessione in esecuzione. 

## Sintassi
<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
```

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

**`--max-width`**  
Speciifica la larghezza massima, in pixel, dello screenshot. Se non specificate una larghezza o un'altezza, lo screenshot utilizza la risoluzione dello schermo della sessione. Se specificate solo un'altezza, la larghezza viene ridimensionata automaticamente per mantenere le proporzioni.  
Tipo: Integer  
Obbligatorio: no

**`--max-height`**  
Speciifica l'altezza massima, in pixel, dello screenshot. Se non specificate una larghezza o un'altezza, lo screenshot utilizza la risoluzione dello schermo della sessione. Se specificate solo una larghezza, l'altezza viene ridimensionata automaticamente per mantenere le proporzioni.  
Tipo: Integer  
Obbligatorio: no

**`--format`**  
Il formato del file dello screenshot. Attualmente sono supportati solo i `PNG` formati `JPEG` e. Se si specificano tipi di file in conflitto per le `--output` opzioni `--format` and, il valore specificato per `--format` ha la priorità. Ad esempio, se specifichi `--format JPEG` and`--output myfile.png`, Amazon DCV crea un file di immagine JPEG.  
Tipo: String  
Valori consentiti: `JPEG` \$1 `PNG`  
Obbligatorio: no

**`--primary`**  
Indica se visualizzare uno screenshot solo dello schermo principale. Per ottenere uno screenshot solo dello schermo principale, specificare. `--primary` Per ottenere uno screenshot di tutti gli schermi, ometti questa opzione. Se scegli di ottenere uno screenshot di tutti gli schermi, tutti gli schermi vengono combinati in un'unica schermata.  
Obbligatorio: no

**`--json`, `-j`**  
Indica se fornire l'output in formato JSON codificato in base64. Per ottenere l'output JSON, specificare. `--json` Altrimenti, omettilo.  
Obbligatorio: no

**`--output`, `-o`**  
Specificate il percorso di destinazione, il nome e il tipo di file per lo screenshot. Ad esempio, per Windows, specificare `c:\directory\filename.format` e per Linux, specificare. `/directory/filename.format` Il formato deve essere `.png` o`.jpeg`. Se si specificano tipi di file in conflitto per le `--output` opzioni `--format` and, il valore specificato per `--format` ha la priorità. Ad esempio, se specifichi `--format JPEG` and`--output myfile.png`, Amazon DCV crea un file di immagine JPEG.  
▬Tipo: stringa  
Obbligatorio: no

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

**Esempio 1**  
Il seguente comando di esempio ottiene uno screenshot di una sessione denominata. `my-session` Lo screenshot utilizza la risoluzione del server.

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

**Esempio 2**  
Il comando di esempio seguente acquisisce uno screenshot con `200` pixel di larghezza per `100` pixel di altezza. Lo prende da una sessione `my-session` denominata. Salva lo screenshot nella directory corrente con il nome `myscreenshot.png` del file.

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

**Esempio 3**  
Il comando di esempio seguente acquisisce uno screenshot di una sessione denominata. `my-session` Lo screenshot è solo dello schermo principale. Salva il file nella directory corrente e assegna un nome allo screenshot`myscreenshot.png`.

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

**Esempio 4**  
Il comando di esempio seguente ottiene uno screenshot di una sessione denominata. `my-session` Il comando restituisce il file codificato in base64 e in formato JSON.

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