本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Amazon DCV 会话中获取屏幕截图
<a name="managing-sessions-lifecycle-screenshot"></a>

您可以使用 `dcv get-screenshot` 命令获取运行的会话的桌面屏幕截图。

## 语法
<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
```

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

**`--max-width`**  
指定屏幕截图的最大宽度（以像素为单位）。如果未指定宽度或高度，屏幕截图将使用会话的显示分辨率。如果仅指定高度，则自动扩缩宽度以保持纵横比。  
类型：整数  
必需：否

**`--max-height`**  
指定屏幕截图的最大高度（以像素为单位）。如果未指定宽度或高度，屏幕截图将使用会话的显示分辨率。如果仅指定宽度，则自动扩缩高度以保持纵横比。  
类型：整数  
必需：否

**`--format`**  
屏幕截图的文件格式。目前，仅支持 `JPEG` 和 `PNG` 格式。如果为 `--format` 和 `--output` 选项指定的文件类型发生冲突，则优先使用为 `--format` 指定的值。例如，如果您指定 `--format JPEG` 和 `--output myfile.png`，则 Amazon DCV 创建 JPEG 图像文件。  
类型：字符串  
允许的值：`JPEG` \$1 `PNG`  
必需：否

**`--primary`**  
指示是否仅获取主显示器的屏幕截图。要仅获取主显示器的屏幕截图，请指定 `--primary`。要获取所有显示器的屏幕截图，请省略该选项。如果您选择获取所有显示器的屏幕截图，则所有显示器将合并为单个屏幕截图。  
必需：否

**`--json`, `-j`**  
指示是否使用 JSON 格式提供 Base64 编码的输出。要获取 JSON 输出，请指定 `--json`。否则，省略该选项。  
必需：否

**`--output`, `-o`**  
指定屏幕截图的目标路径、文件名和文件类型。例如，对于 Windows，指定 `c:\directory\filename.format`；对于 Linux，指定 `/directory/filename.format`。格式必须是 `.png` 或 `.jpeg`。如果为 `--format` 和 `--output` 选项指定的文件类型发生冲突，则优先使用为 `--format` 指定的值。例如，如果您指定 `--format JPEG` 和 `--output myfile.png`，则 Amazon DCV 创建 JPEG 图像文件。  
类型：字符串  
是否必需：否

## 示例
<a name="examples"></a>

**示例 1**  
以下示例命令获取名为 `my-session` 的会话的屏幕截图。屏幕截图使用服务器的分辨率。

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

**示例 2**  
以下示例命令获取宽度为 `200` 像素且高度为 `100` 像素的屏幕截图。该示例从名为 `my-session` 的会话中获取屏幕截图。它将屏幕截图保存在当前目录中，文件名为 `myscreenshot.png`。

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

**示例 3**  
以下示例命令获取名为 `my-session` 的会话的屏幕截图。屏幕截图仅是主显示器的屏幕截图。它将文件保存在当前目录中，并将屏幕截图命名为 `myscreenshot.png`。

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

**示例 4**  
以下示例命令获取名为 `my-session` 的会话的屏幕截图。该命令使用 JSON 格式输出 Base64 编码的文件。

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