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

# アクティブな Amazon DCV セッションの管理
<a name="managing-running-session"></a>

クライアントがログインして DCV セッションの使用を開始すると、セッションはアクティブと見なされます。セッションがアクティブである間も、特定の管理タスクを実行できます。このセクションでは、使用中のセッションでクライアントがパラメータを管理するのに必要な情報を提供します。

**Topics**
+ [セッションストレージの管理](managing-session-storage.md)
+ [セッション認可の管理](managing-session-perms.md)
+ [セッション表示レイアウトの管理](managing-session-display.md)
+ [セッション名の管理](managing-session-name.md)
+ [アイドル状態のセッションの検出と停止](stop-idle-sessions.md)

# Amazon DCV セッションストレージの管理
<a name="managing-session-storage"></a>

セッションストレージは Amazon DCV サーバーにあるディレクトリで、Amazon DCV セッションに接続されているクライアントによるアクセスが可能です。

Amazon DCV サーバーでセッションストレージが有効になっている場合、`dcv set-storage-root` コマンドを使用して、セッションストレージに使用するサーバーでディレクトリを指定できます。Amazon DCV サーバーでのセッションストレージの有効化の詳細については、「[セッションストレージの有効化](manage-storage.md)」を参照してください。

セッションストレージパスを設定するには、`dcv set-storage-root` コマンドを使用して、セッション ID と、使用するディレクトリへのパスを指定します。

**Topics**
+ [構文](#managing-session-storage-syntax)
+ [オプション](#managing-session-storage-options)
+ [例](#session-storage-example)

## 構文
<a name="managing-session-storage-syntax"></a>

```
dcv set-storage-root --session session_id /path_to/directory
```

ディレクトリパスについては、`%home%` を使用して、現在サインインしているユーザーのホームディレクトリを指定できます。たとえば、`%home%/storage/` パスは Windows サーバーで `c:\Users\username\storage\` に解決されます。Linux サーバでは `$HOME/storage/` に解決されます。

**注記**  
`storage-root` 値は macOS の絶対パスである必要があります。

## オプション
<a name="managing-session-storage-options"></a>

以下のオプションは `dcv set-storage-root` コマンドで使用できます。

**`--session`**  
ストレージディレクトリを指定するセッション ID。  
タイプ: 文字列  
必須: はい

## 例
<a name="session-storage-example"></a>

**Windows Amazon DCV サーバーの例**  
次の例では、セッション ID が `my-session` であるセッションのストレージパスを `c:\session-storage` に設定します。

```
C:\> dcv set-storage-root --session my-session c:\session-storage
```

**Linux Amazon DCV サーバーの例**  
次の例では、セッション ID が `my-session` であるセッションの場合、現在のユーザーのホームディレクトリにある `session-storage` という名前のディレクトリへのストレージパスをに設定します。

```
$ dcv set-storage-root --session my-session %home%/session-storage/
```

# Amazon DCV セッション認可の管理
<a name="managing-session-perms"></a>

認可は、特定の Amazon DCV 機能に対して、Amazon DCV クライアントのアクセス許可を付与する場合や拒否する場合に使用されます。通常、認可は Amazon DCV セッションの起動時に設定されます。ただし、実行中のセッションのアクセス許可を編集することはできます。Amazon DCV 認可の詳細については、「[Amazon DCV 認可の設定](security-authorization.md)」を参照してください。

実行中のセッションのアクセス許可に変更を加えるには、`dcv set-permissions` コマンドを使用します。

**Topics**
+ [構文](#managing-session-perms-syntax)
+ [オプション](#managing-session-perms-options)
+ [例](#session-perms-example)

## 構文
<a name="managing-session-perms-syntax"></a>

```
dcv set-permissions --session session-id --none | --reset-builtin | --file /path_to/permissions_file
```

`--none`、`--reset-builtin`、`--file` のいずれかを指定する必要があります。

## オプション
<a name="managing-session-perms-options"></a>

以下のオプションは `dcv set-permissions` コマンドで使用できます。

**--session**  
アクセス許可を設定するセッションの ID を指定します。

**--reset-builtin**  
セッションのアクセス許可をデフォルトのセッションアクセス許可にリセットします。デフォルトのアクセス許可では、セッション所有者のみにすべての機能へのフルアクセス権を付与します。

**--none**  
セッションのすべてのアクセス許可を取り消します。

**--file**  
カスタムアクセス許可ファイルへのパスを指定します。指定したファイルが空の場合、すべてのアクセス許可が取り消されます。カスタムアクセス許可ファイルの作成の詳細については、「[アクセス許可ファイルについて](security-authorization-file-create.md)」を参照してください。

## 例
<a name="session-perms-example"></a>

**例 1 — すべてのアクセス許可の取り消し**  
次の例では、ID が `my-session` であるセッションのすべてのクライアントアクセス許可を取り消します。

```
C:\> dcv set-permissions --session my-session --none
```

**例 2 — カスタムアクセス許可の指定**  
次の例では、ID が `my-session` であるセッションに対して、`perm-file.txt` という名前のカスタムアクセス許可ファイルを指定します。この ファイルは `c:\dcv\` ディレクトリにあります。

```
C:\> dcv set-permissions --session my-session --file c:\dcv\perm-file.txt
```

**例 3 - アクセス許可のリセット**  
次の例では、ID が `my-session` であるセッションのアクセス許可をデフォルトにリセットします。

```
C:\> dcv set-permissions --session my-session --reset-builtin
```

# Amazon DCV セッション表示レイアウトの管理
<a name="managing-session-display"></a>

実行中の Amazon DCV セッションの表示レイアウトを設定できます。この表示レイアウトは、クライアントがセッションに接続するときに使用されるデフォルト設定を指定します。ただし、クライアントは、Amazon DCV クライアント設定またはオペレーティングシステムのネイティブ表示設定を使用して、手動でレイアウトを上書きできます。

ホストサーバーのハードウェアとソフトウェアの設定において、指定された解像度または画面数がサポートされていない場合、Amazon DCV サーバーでは指定された表示レイアウトが適用されません。

Amazon DCV は、設定とサーバーシステム設定に従って解像度を設定できます。
+ ウェブクライアント解像度は、デフォルトで 1920x1080 (web-client-max-head-resolution サーバー設定から) に制限されています。
+ ネイティブクライアントは、デフォルトで 4096x2160 (max-head-resolution から) に制限されています。

使用可能な解像度とモニターの数はサーバーの設定に依存することに注意してください。最適なパフォーマンスを得るには、システム環境とドライバーを適切にセットアップするための「[前提条件ガイド](https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing.html)」に従ってください。

**注記**  
ネイティブクライアントでは、最大 4 つのモニターを使用できます。  
ウェブクライアントでは、最大 2 つのモニターを使用できます。  
高解像度または最大モニター数を超えるモニターは、どの設定でもサポートされていません。

**Topics**
+ [表示レイアウトへのアクセス](#display-restrict)
+ [表示レイアウトの設定](#dislay-set)
+ [表示レイアウトの表示](#dislay-view)

## 表示レイアウトへのアクセス
<a name="display-restrict"></a>

指定した範囲外の表示レイアウトをクライアントがリクエストしないように Amazon DCV サーバーを設定できます。表示レイアウトの変更を制限するには、次の Amazon DCV サーバーパラメータを設定します。
+ [`enable-client-resize`](config-param-ref.md#paramref.display.enable-client-resize) — クライアントが表示レイアウトを変更できないようにするには、このパラメータを `false` に設定します。
+ [`min-head-resolution`](config-param-ref.md#paramref.display.min-head-resolution) および [`max-head-resolution`](config-param-ref.md#paramref.display.max-head-resolution) — 許容される最小解像度と最大解像度をそれぞれ指定します。
+ [`web-client-max-head-resolution`](config-param-ref.md#paramref.display.web-client-max-head-resolution) — ウェブブラウザクライアントの最大許容解像度を指定します。`max-head-resolution` 制限は、`web-client-max-head-resolution` 制限の上に適用されます。デフォルトでは、ウェブブラウザクライアントの最大解像度は 1920x1080 です。より高い解像度を指定すると、ウェブブラウザとクライアントコンピュータの仕様によっては、パフォーマンスの問題が発生する可能性があります。
+ [`max-num-heads`](config-param-ref.md#paramref.display.max-num-heads) - 最大表示数を指定します。
+ `max-layout-area` - 画面領域に許可される最大ピクセル数を指定します。総画面面積 (ピクセル) が指定された値を超えているリクエストは無視されます。

これらのパラメータの詳細については、パラメータリファレンスの「[`display` パラメータ](config-param-ref.md#display)」を参照してください。

## 表示レイアウトの設定
<a name="dislay-set"></a>

**実行中の Amazon DCV セッションの表示レイアウトを設定するには**  
`dcv set-display-layout` コマンドを使用して、表示レイアウトと表示レイアウト記述子を設定するセッションを指定します。

```
dcv set-display-layout --session session-id display-layout-descriptor
```

表示レイアウト記述子は、表示の数と、各表示の解像度と位置オフセットを指定します。説明は、次の形式で指定する必要があります。

```
widthxheight+|-x-position-offset+|-y-position-offset
```

複数の画面を指定する場合は、画面記述子をカンマで区切ります。画面位置のオフセットは、画面 1 に対する画面の左上隅の位置を指定します。画面の位置オフセットを指定しない場合、デフォルトは x=0 および y=0 です。

**重要**  
複数の画面を指定する場合は、画面の重なりを避けるために、各画面の位置オフセットを適切に設定してください。

たとえば、次の表示レイアウト記述子は 2 つの画面を指定します。
+ 画面 1: 解像度 1920x1080、オフセット x=0、y=0
+ 画面 2: 解像度 800x600、オフセット x=1920、y=0、画面 1の右側に表示されます。

![\[2 つの画面を使用する画面レイアウト。\]](http://docs.aws.amazon.com/ja_jp/dcv/latest/adminguide/images/eg2.png)


```
1920x1080+0+0,800x600+1920+0
```

次の表示レイアウト記述子は、3 つの画面を指定します。
+ 画面 1: 解像度 1920x1080、オフセット x=0、y=0
+ 画面 2: 解像度 1920x1080、オフセット x=1920、y=0、画面 1 の右側に表示されます。
+ 画面 3: 解像度 1024x768、オフセット x=-1024、y=0、画面 1 の左側に表示されます。

![\[3 つの画面使用する画面レイアウト。\]](http://docs.aws.amazon.com/ja_jp/dcv/latest/adminguide/images/eg1.png)


```
1920x1080+0+0,1920x1080+1920+0,1024x768-1024+0
```

## 表示レイアウトの表示
<a name="dislay-view"></a>

**セッションの表示レイアウトを表示するには**  
`dcv describe-session` コマンドを使用して、出力の `display layout` 要素を確認します。詳細については、「[Amazon DCV セッションの表示](managing-sessions-lifecycle-view.md)」を参照してください。

# セッション名の管理
<a name="managing-session-name"></a>

実行中のセッションの名前は、いつでも変更できます。特定のセッション名を使用すれば、その名前に基づいてセッションをすばやく識別できます。セッション名は、実行中のセッション間で一意である必要はありません。

実行中のセッションの名前を変更するには、`dcv set-name` コマンドを使用します。

**Topics**
+ [構文](#managing-session-name-syntax)
+ [オプション](#managing-session-name-options)
+ [例](#example)

## 構文
<a name="managing-session-name-syntax"></a>

```
$ dcv set-name --session session_id --none |--name "session-name"
```

`--name` または `--none` のどちらかを指定する必要があります。

## オプション
<a name="managing-session-name-options"></a>

以下のオプションは `dset-name` コマンドで使用できます。

**`--session`**  
名前を設定するセッションの ID。  
タイプ: 文字列  
必須: はい

**`--name`**  
セッションに割り当てる名前。セッションに名前を割り当てる場合にのみ、このオプションを指定します。名前を削除する場合は、このパラメータを省略します。セッション名の長さは 256 文字以下にしてください。パスワードには、文字、数字、特殊文字を使用できます。指定した文字列が 256 文字を超えると、コマンドは失敗します。  
タイプ: 文字列  
必須: いいえ

**`--none`**  
セッションから既存の名前を削除するには、このパラメータを指定します。セッション名を削除しない場合は、このオプションを省略します。  
必須: いいえ

## 例
<a name="example"></a>

**例 1 - セッション名の変更**  
次の例では、ID が `my-session` であるセッションの名前を `my graphics session` に設定します。

```
$ dcv set-name --session my-session --name "my graphics sessions"
```

**例 2 - セッション名の削除**  
次の例では、ID が `my-session` であるセッションの名前を削除します。

```
$ dcv set-name --session my-session --none
```

# アイドル状態のセッションの検出と停止
<a name="stop-idle-sessions"></a>

アイドル状態の Amazon DCV セッションを識別するには、`-j` コマンドオプションがある `dcv describe-sessions` CLI コマンドを使用します。`-j` オプションを指定すると、コマンドが JSON 形式で出力を返すように設定され、セッションに関する追加の詳細情報が提供されます。

たとえば、次のコマンドは、`my-session` という名前のセッションに関する情報を返します。

```
$ dcv describe-session my-session -j
```

出力:

```
{
    "id" : "my-session",
    "owner" : "dcvuser",
    "x11-display" : ":1",
    "x11-authority" : "/run/user/1009/dcv/test3.xauth",
    "num-of-connections" : 1,
    "creation-time" : "2019-05-13T13:21:19.262883Z",
    "last-disconnection-time" : "2019-05-14T12:32:14.357567Z",
    "licensing-mode" : "DEMO",
    "licenses" : [
        {
            "product" : "dcv",
            "status" : "LICENSED",
            "check-timestamp" : "2019-05-14T12:35:40Z",
            "expiration-date" : "2019-05-29T00:00:00Z"
        },
        {
            "product" : "dcv-gl",
            "status" : "LICENSED",
            "check-timestamp" : "2019-05-14T12:35:40Z",
            "expiration-date" : "2019-05-29T00:00:00Z"
        }
    ]
}
```

コマンド出力で、`num-of-connections` パラメータは、アクティブなクライアント接続の数を示します。値が `0` の場合は、アクティブなクライアント接続がなく、セッションが現在アイドル状態であることを示します。また、`last-disconnection-time` パラメータを使用して、セッションが最後にアクティブなクライアント接続を確立した日時を判別することもできます。

この情報を使用してアイドル状態のセッションを識別するスクリプトまたは cron ジョブを作成できます。その後、[`dcv close-session`](managing-sessions-lifecycle-stop.md) コマンドを使用して、それらの使用を停止できます。

**注記**  
セッションを停止すると、そのセッションで実行されているすべてのアプリケーションが閉じます。