Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Einen Screenshot in einer Amazon DCV-Sitzung aufnehmen
<a name="managing-sessions-lifecycle-screenshot"></a>

Sie können den `dcv get-screenshot` Befehl verwenden, um einen Screenshot des Desktops für die laufende Sitzung zu erstellen. 

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

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

**`--max-width`**  
Gibt die maximale Breite des Screenshots in Pixeln an. Wenn Sie keine Breite oder Höhe angeben, verwendet der Screenshot die Bildschirmauflösung der Sitzung. Wenn Sie nur eine Höhe angeben, wird die Breite automatisch skaliert, um das Seitenverhältnis beizubehalten.  
Typ: Ganzzahl  
Erforderlich: Nein

**`--max-height`**  
Gibt die maximale Höhe des Screenshots in Pixeln an. Wenn Sie keine Breite oder Höhe angeben, verwendet der Screenshot die Bildschirmauflösung der Sitzung. Wenn Sie nur eine Breite angeben, wird die Höhe automatisch skaliert, um das Seitenverhältnis beizubehalten.  
Typ: Ganzzahl  
Erforderlich: Nein

**`--format`**  
Das Dateiformat des Screenshots. Derzeit werden nur die `PNG` Formate `JPEG` und unterstützt. Wenn Sie für die `--output` Optionen `--format` und widersprüchliche Dateitypen angeben, hat der für angegebene Wert `--format` Vorrang. Wenn Sie beispielsweise `--format JPEG` und angeben`--output myfile.png`, erstellt Amazon DCV eine JPEG-Bilddatei.  
Typ: Zeichenfolge  
Zulässige Werte: `JPEG` \| `PNG`  
Erforderlich: Nein

**`--primary`**  
Gibt an, ob nur ein Screenshot des primären Displays angezeigt werden soll. Geben Sie an, dass nur ein Screenshot der Hauptanzeige angezeigt `--primary` werden soll. Um einen Screenshot aller Displays zu erhalten, lassen Sie diese Option weg. Wenn Sie sich dafür entscheiden, einen Screenshot aller Displays zu erstellen, werden alle Displays zu einem einzigen Screenshot zusammengefasst.  
Erforderlich: Nein

**`--json`, `-j`**  
Gibt an, ob die Ausgabe im JSON-Format bereitgestellt werden soll, das in Base64 codiert ist. Um die JSON-Ausgabe zu erhalten, geben Sie an. `--json` Andernfalls lassen Sie es weg.  
Erforderlich: Nein

**`--output`, `-o`**  
Gibt den Zielpfad, den Dateinamen und den Dateityp für den Screenshot an. Geben Sie beispielsweise für Windows `c:\directory\filename.format` und für Linux Folgendes an`/directory/filename.format`. Das Format muss `.png` oder sein`.jpeg`. Wenn Sie für die `--output` Optionen `--format` und widersprüchliche Dateitypen angeben, hat der für angegebene Wert `--format` Vorrang. Wenn Sie beispielsweise `--format JPEG` und angeben`--output myfile.png`, erstellt Amazon DCV eine JPEG-Bilddatei.  
Typ: Zeichenfolge  
Erforderlich: nein

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

**Beispiel 1**  
Mit dem folgenden Beispielbefehl wird ein Screenshot einer Sitzung mit dem Namen `my-session` abgerufen. Der Screenshot verwendet die Auflösung des Servers.

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

**Beispiel 2**  
Mit dem folgenden Beispielbefehl wird ein Screenshot erstellt, der `200` Pixel breit und `100` pixelhoch ist. Er nimmt es aus einer Sitzung, die benannt ist`my-session`. Es speichert den Screenshot im aktuellen Verzeichnis mit dem Dateinamen`myscreenshot.png`.

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

**Beispiel 3**  
Der folgende Beispielbefehl erstellt einen Screenshot einer Sitzung mit dem Namen`my-session`. Der Screenshot zeigt nur das primäre Display. Es speichert die Datei im aktuellen Verzeichnis und benennt den Screenshot`myscreenshot.png`.

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

**Beispiel 4**  
Mit dem folgenden Beispielbefehl wird ein Screenshot einer Sitzung abgerufen, die benannt ist`my-session`. Der Befehl gibt die Datei im Base64- und JSON-Format codiert aus.

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