翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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` ピクセル、高さ `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
```