本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 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`**  
指出是否以 base64 編碼的 JSON 格式交付輸出。若要取得 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`像素寬 x `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`。命令會輸出以 base64 和 JSON 格式編碼的檔案。

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