기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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