翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon DCV セッションの管理
Amazon DCV サーバーが設定され、すべてのアプリケーションがインストールされると、クライアントは安全なセッションを通じてアクセスします。クライアントでこれらのセッションを管理すると、アクセスが許可され、各セッションのパラメータが設定されます。
クライアントを Amazon DCV セッションに接続できるようにするには、Amazon DCV サーバーでセッションを作成する必要があります。アクティブなセッションがある場合にのみ、クライアントを Amazon DCV サーバーに接続できます。
各 Amazon DCV セッションには次の属性があります。
+ **セッション ID** — Amazon DCV サーバーで特定のセッションを識別するために使用します。
+ **所有者** — セッションを作成した Amazon DCV ユーザー。デフォルトでは、所有者のみがセッションに接続できます。
セッションに接続するのに、Amazon DCV クライアントはこの情報を必要とします。
**Topics**
+ [Amazon DCV セッションについて](managing-sessions-intro.md)
+ [コマンドラインツールを使用したセッションの管理](managing-sessions-cli.md)
+ [Amazon DCV セッションの開始](managing-sessions-start.md)
+ [Amazon DCV セッションの停止](managing-sessions-lifecycle-stop.md)
+ [Amazon DCV セッションの表示](managing-sessions-lifecycle-view.md)
+ [アクティブな Amazon DCV セッションの管理](managing-running-session.md)
+ [セッションのタイムゾーンの設定](managing-session-time-zone.md)
+ [Linux でのスクリーンブランキングの管理](managing-screen-blanking.md)
+ [Amazon DCV セッションでのスクリーンショットの作成](managing-sessions-lifecycle-screenshot.md)
# Amazon DCV セッションについて
Amazon DCV には、コンソールセッションと仮想セッションの 2 種類のセッションがあります。次の表はこれら 2 種類のセッションの違いをまとめたものです。
| セッションタイプ | サポート | 複数のセッション | 必要なアクセス許可 | 直接画面キャプチャー | GPU 加速 OpenGL サポート |
| --- | --- | --- | --- | --- | --- |
| コンソール | Linux、macOS、および Windows Amazon DCV サーバー | 不可。各サーバーで許容されるコンソールセッションは 1 つのみ | セッションの開始と終了を実行できるのは管理ユーザーのみ | 可 | 可。追加ソフトウェアなし |
| 仮想 | Linux Amazon DCV サーバーのみ | 可。1 つのサーバーで複数の仮想セッションが許容される | すべてのユーザーがセッションの開始と終了を実行できる | 不可。各仮想セッションに対して専用の X サーバ (Xdcv) が実行される。X サーバーから画面がキャプチャーされる。 | 可。ただし DCV-GL パッケージが必要 |
**注記**
同一の Amazon DCV サーバーにおいて、コンソールセッションと仮想セッションを同時に実行することはできません。
## コンソールセッション
コンソールセッションは、Windows、Linux、macOS の Amazon DCV サーバーでサポートされています。Windows または macOS Amazon DCV サーバーを使用している場合は、コンソールセッションのみを使用できます。
Amazon DCV サーバーで一度にホストできるコンソールセッションは 1 つのみです。コンソールセッションは、Windows Amazon DCV サーバーの管理者と Linux および macOS Amazon DCV サーバーのルートユーザーによって作成および管理されます。
コンソールセッションでは、Amazon DCV によりデスクトップ画面のコンテンツが直接キャプチャーされます。サーバーが GPU で設定されている場合、Amazon DCV コンソールセッションは GPU に直接アクセスします。
## 仮想セッション
仮想セッションは、Linux Amazon DCV サーバーでのみサポートされます。
同一の Amazon DCV サーバーにおいて、複数の仮想セッションを同時にホストすることができます。仮想セッションの作成と管理は Amazon DCV ユーザーが行います。Amazon DCV ユーザーは、自分が作成したセッションしか管理できません。ルートユーザーは Amazon DCV サーバーで現在実行されているすべての仮想セッションを管理できます。
仮想セッションの場合、Amazon DCV では、X サーバーインスタンス `Xdcv` が起動され、X サーバー内でデスクトップ環境が実行されます。Amazon DCV により、仮想セッションごとに新しい専用 X サーバーインスタンスが起動されます。各仮想セッションは、X サーバーインスタンスによって提供される表示を使用します。
**注記**
Amazon DCV では各仮想セッションで独立した `Xdcv` 表示が使用されますが、ユーザーのホームフォルダ内のファイル、D-Bus サービス、デバイスなど、他の多くのシステムリソースはユーザーごとに表示されます。そのため、同じユーザーの複数の仮想セッションで共有され、アクセスできます。
共有リソースに関する懸念を軽減するようにオペレーティングシステムを設定していない限り、同じ Amazon DCV サーバー上で同じユーザーの複数の仮想セッションを同時に実行しないでください。
`dcv-gl` パッケージがインストールされており、ライセンスを取得している場合、Amazon DCV 仮想セッションにおいてサーバーの GPU へのアクセス権が共有されます。複数の仮想セッション間でハードウェアベースの OpenGL を共有するには、`dcv-gl.conf` ファイルを設定して、仮想 X サーバーインスタンスを GPU に接続する必要があります。
# コマンドラインツールを使用したセッションの管理
Amazon DCV サーバーには、Amazon DCV セッションの開始、停止、表示に使用できるコマンドラインツールが含まれています。
## Windows Amazon DCV サーバーでのコマンドラインツールの使用
Windows Amazon DCV サーバーでコマンドラインツールを使用するには、Amazon DCV インストールディレクトリからコマンドを実行するか、Amazon DCV ディレクトリを PATH 環境変数に追加する必要があります。Amazon DCV ディレクトリを PATH 環境変数に追加すると、任意のディレクトリからコマンドを使用できます。
**Amazon DCV インストールディレクトリからコマンドラインツールを使用するには**
`dcv.exe` ファイルがあるフォルダ (デフォルトで `C:\Program Files\NICE\DCV\Server\bin\`) に移動し、コマンドプロンプトウィンドウを開きます。
または、別のディレクトリからコマンドを実行するときにフルパスを指定することもできます。
```
"C:\> Program Files\NICE\DCV\Server\bin\dcv.exe" list-sessions
```
**Amazon DCV ディレクトリを PATH 環境変数に追加するには**
1. ファイルエクスプローラーで、[**この PC**] を右クリックし、[**プロパティ**]を選択します。
1. [**システムの詳細設定**] を選択します。
1. **[Advanced]** (詳細設定) タブで、**[Environment Variables]** (環境変数) を選択します。
1. [**システム環境変数**] セクションで、[**Path**] 変数を選択し、[**編集]**] を選択します。
1. **[新規]** を選択し、Amazon DCV インストールディレクトリ内の `bin` フォルダへのフルパス (例: `C:\Program Files\NICE\DCV\Server\bin\`) を指定します。
1. [**OK**] を選択し、環境変数ウィンドウを閉じます。
## Linux Amazon DCV サーバーでのコマンドラインツールの使用
Linux Amazon DCV サーバーでは、コマンドラインツールは、`$PATH` 環境変数で自動的に設定されます。このツールは任意のフォルダから使用できます。ターミナルウィンドウを開き、実行するコマンドを入力します。
## macOS Amazon DCV サーバーでのコマンドラインの使用
macOS Amazon DCV サーバーでは、コマンドラインツールは`$PATH`環境変数で自動的に設定されます。このツールは任意のフォルダから使用できます。ターミナルウィンドウを開き、実行するコマンドを入力します。
## コマンドラインツールの使用
次の表に、使用できるコマンドラインツールのオプションを示します。このリストは、`dcv` を呼び出すときに `--help` を使用して取得できます。各コマンドの使用方法の詳細については、使用状況の情報を希望するコマンドの後に `--help` を渡します。例: `dcv create-session --help`。
| コマンド | 説明 |
| --- | --- |
| `create-session` | 新しい DCV セッションを作成します。 |
| `close-session` | アクティブな DCV セッションを閉じます。 |
| `describe-session` | DCV セッションを説明します。 |
| `list-sessions` | アクティブな DCV セッションを一覧表示します。 |
| `list-connections` | DCV セッションのクライアント接続を一覧表示します。 |
| `close-connection` | アクティブなクライアント接続を閉じます。 |
| `get-screenshot` | DCV コンソールのスクリーンショットを取得します。 |
| `set-display-layout` | アクティブな DCV セッションの表示レイアウトを設定します。 |
| `set-name` | DCV セッションの名前を設定します。 |
| `set-permissions` | アクティブな DCV セッションのアクセス許可を設定します。 |
| `set-storage-root` | アクティブな DCV セッションのストレージルートを設定します。 |
| `reload-licenses` | 実行中のすべてのセッションのライセンスを強制的に再ロードします。 |
| `get-config` | サーバー設定を取得します。 |
| `list-endpoints` | DCV エンドポイントを一覧表示します。 |
| `set-config` | サーバー構成を設定します。 |
| `version` | DCV のバージョンを表示します。 |
| `help` | ヘルプを表示します。 |
# Amazon DCV セッションの開始
デフォルトを使用して [Windows Amazon DCV サーバーをインストール](setting-up-installing-wininstall.md)すると、サーバーのインストール後に[コンソールセッション](managing-sessions-intro.md#managing-sessions-intro-console)が自動的に作成され、アクティブになります。デフォルトのコンソールセッションは `Administrator` によって所有されており、デフォルトのセッション ID は `console` です。このセッションを使用することも、[終了して](managing-sessions-lifecycle-stop.md)新しいセッションを作成することもできます。
Amazon DCV サーバーのインストール時に自動的にコンソールセッションを作成しなかった場合は、手動でセッションを作成する必要があります。Amazon DCV サーバーのインストール後はいつでも、[コンソールセッションの自動作成](#managing-sessions-start-auto)を有効または無効にすることができます。
**注記**
Linux および macOS Amazon DCV サーバーは、インストール後にデフォルトのコンソールセッションを取得しません。
オンプレミスまたは代替のクラウドベースサーバーでフローティングライセンスを使用していて、ライセンスでサポートされている同時セッションの最大数を超えたとします。その場合は `no licenses` エラーが発生する可能性があります。このエラーが発生した場合は、未使用のセッションを停止してライセンスをリリースしてから再試行してください。
セッションを開始するには、Amazon DCV サーバーを実行している必要があります。詳細については、「[Amazon DCV サーバーの起動](manage-start.md)」を参照してください。
**Topics**
+ [コンソールセッションおよび仮想セッションの手動開始](#managing-sessions-start-manual)
+ [自動コンソールセッションの有効化](#managing-sessions-start-auto)
## コンソールセッションおよび仮想セッションの手動開始
Amazon DCV セッションはいつでも開始することができます。一度に 1 つのコンソールセッションしか実行できません。Linux Amazon DCV サーバーを使用している場合は、複数の仮想セッションを同時に実行できます。
特に Windows Amazon DCV サーバーを使用している場合は、セッションを作成する前に `dcv list-sessions` を実行することをお勧めします。
Windows、Linux、または macOS Amazon DCV サーバーでコンソールまたは仮想セッションを作成するには、 `dcv create-session` コマンドを使用します。
**Topics**
+ [構文](#managing-sessions-start-manual-syntax)
+ [オプション](#managing-sessions-start-manual-options)
+ [例](#managing-sessions-start-manual-examples)
### 構文
セッションを開始するコマンドの最小限の構文は次のとおりです。
```
dcv create-session session_ID
```
すべてのオプションを含む完全な構文は以下のとおりです。
```
dcv create-session \
--type console|virtual \
--name session_name \
--user username \
--owner owner_name \
--permissions-file /path_to/permissions_file \
--storage-root /path_to/storage_directory \
--gl on|off \
--max-concurrent-clients number_of_clients \
--init /path_to/init_script \
session_ID
```
**注記**
`\` 記号は、コマンドを複数行に分割する構文を表しています。
`dcv create-session --help` を使用して構文のクイックリファレンスを表示することもできます。
### オプション
以下のオプションは `dcv create-session` コマンドで使用できます。
**`--type`**
このオプションは、Linux Amazon DCV サーバーでのみサポートされます。作成されるセッションのタイプを指定します。`console` または `virtual` のいずれかになります。
タイプ: 文字列
許可される値: `console` \$1 `virtual`
必須: いいえ
**`--name`**
セッションの名前を指定します。セッション名は、最大 256 文字までの任意の文字列とします。文字列が 256 文字を超えると、コマンドは失敗します。セッション名は、実行中のセッション間で一意である必要はありません。
セッション名は `dcv set-name` コマンドを使用していつでも変更できます。詳細については、「[セッション名の管理](managing-session-name.md)」を参照してください。
型: 文字列
必須: はい
**`--user`**
このオプションは Linux Amazon DCV セッションの仮想セッションでのみサポートされています。この値は、セッションの作成に使用されるユーザーです。ルートユーザーのみが他のユーザーを偽装できます。
タイプ: 文字列
必須: いいえ
**`--owner`**
セッションの所有者を指定します。省略した場合、デフォルトは現在サインインしているユーザーです。
タイプ: 文字列
必須: いいえ
**`--permissions-file`**
カスタムアクセス権限ファイルへのパスを指定します。省略した場合、デフォルトはサーバーのデフォルトです。
タイプ: 文字列
必須: いいえ
**`--storage-root`**
セッションストレージに使用されるフォルダのパスを指定します。
`%home%` を使用して、現在サインインしているユーザーのホームディレクトリを指定できます。たとえば、以下では、セッションストレージのディレクトリを Windows サーバーで `c:\Users\username\storage\`、または Linux サーバーで `$HOME/storage/` に設定します。
```
--storage-root %home%/storage/
```
指定したサブディレクトリが存在しない場合、セッションストレージは無効になります。
タイプ: 文字列
必須: いいえ
**`--gl`**
このオプションは Linux Amazon DCV セッションの仮想セッションでのみサポートされています。デフォルトの `dcv-gl` 状態をオーバーライドします。`on` または `off` のいずれかになります。
タイプ: 文字列
許可される値: `on` \$1 `off`
必須: いいえ
**`--max-concurrent-clients`**
セッションへの接続が許可されている Amazon DCV クライアントの最大数を指定します。省略した場合、デフォルトは無制限の接続です。
タイプ: 整数
必須: いいえ
**`--init`**
このオプションは Linux Amazon DCV サーバーの仮想セッションでのみサポートされています。カスタム `init` スクリプトへのパスを指定します。このスクリプトを使用して特定のデスクトップ環境を起動し、セッションの開始時に特定のアプリケーションを自動的に起動することができます。スクリプトは実行可能である必要があります。省略した場合、デフォルトはデフォルトのデスクトップ環境を起動するスクリプトです。
タイプ: 文字列
必須: いいえ
**`session ID`**
コマンドの最後にセッションの ID を指定します。
タイプ: 文字列
必須: はい
### 例
**例 1 - コンソールセッション**
以下のコマンドにより、`dcv-user` が所有するコンソールセッションが作成されます。セッション ID は一意の `my-session` で、セッション名は `my graphics session` です。`perm-file.txt` という名前のアクセス許可ファイルも指定されます。
+ Windows Amazon DCV サーバー
```
C:\> dcv create-session^
--owner dcv-user^
--name "my graphics session"^
--permissions-file perm-file.txt^
my-session
```
+ Linux Amazon DCV サーバー
```
$ sudo dcv create-session \
--type=console \
--owner dcv-user \
--name "my graphics session" \
--permissions-file perm-file.txt \
my-session
```
**例 2 - 仮想セッション (Linux Amazon DCV サーバーのみ)**
以下のコマンドでは、意図されたセッション所有者 `dcv-user` になりすますために、 ルートユーザーを使用して仮想セッションを作成します。ルートユーザーによって作成されていても、セッションの所有者は `dcv-user` です。
```
$ sudo dcv create-session \
--owner dcv-user \
--user dcv-user \
my-session
```
**例 3 - 仮想セッション (Linux Amazon DCV サーバーのみ)**
以下のコマンドでは、作成したユーザーが所有する仮想セッションが作成されます。
```
$ dcv create-session my-session
```
## 自動コンソールセッションの有効化
自動コンソールセッションを有効にすると、Amazon DCV サーバーが起動するたびに、コンソールセッションが自動的に作成されます。自動コンソールセッションは、`owner` 設定パラメータで指定された Amazon DCV ユーザーによって所有されています。そのセッション ID は常に `console` です。
自動コンソールセッションに影響するパラメータには他にも、`max-concurrent-clients`、`permissions-file`、および `storage-root` があります。これらのパラメータの詳細については、「[`session-management/automatic-console-session` パラメータ](config-param-ref.md#session_management_automatic_console_session)」を参照してください。
**注記**
Amazon DCV では自動仮想セッションはサポートされません。
------
#### [ Windows Amazon DCV server ]
**Windows Amazon DCV サーバーで自動コンソールセッションを有効にするには**
1. Windows レジストリエディタを開きます。
1. **HKEY\$1USERS\$1S-1-5-18\$1Software\$1GSettings\$1com\$1nicesoftware\$1dcv\$1session-management** キーに移動します。
1. `create-session` パラメータの作成
1. ナビゲーションペインで、**[session-management]** キーのコンテキスト (右クリック) メニューを開き、**[New]** (新規)、**[DWORD (32-bit) Value]** (DWORD (32 ビット) 値) の順に選択します。
1. [**名前**] に `create-session` と入力し、[**Enter**] を押します。
1. [**create-session**] パラメータを開きます。[**値のデータ**] に `1` と入力し、[**OK**] を選択します。
1. **HKEY\$1USERS\$1S-1-5-18\$1Software\$1GSettings\$1com\$1nicesoftware\$1dcv\$1session-management/automatic-console-session** キーに移動します。
1. `owner` パラメータの作成
1. ナビゲーションペインで、**[automatic-console-session]** キーのコンテキスト (右クリック) メニューを開き、**[新規]**、**[文字列値]** の順に選択します。
1. [**名前**] に `owner` と入力し、[**Enter**] を押します。
1. [**owner**] パラメータを開きます。[**値のデータ**] にセッションの所有者名を入力し、[**OK**] を選択します。
1. [**OK**] を選択して Windows レジストリエディタを閉じます。
1. Amazon DCV サーバーを[停止](manage-stop.md)して[再起動](manage-start.md)します。
------
#### [ Linux Amazon DCV server ]
**Linux Amazon DCV サーバーで自動コンソールセッションを有効にするには**
1. `/etc/dcv/` に移動し、任意のテキストエディタで `dcv.conf` を開きます。
1. 次の形式を使用して、`create-session` および `owner` パラメータを `[session-management/automatic-console-session]` セクションに追加します。
```
[session-management]
create-session = true
[session-management/automatic-console-session]
owner="session-owner"
```
1. ファイルを保存して閉じます。
1. Amazon DCV サーバーを[停止](manage-stop.md)して[再起動](manage-start.md)します。
------
#### [ macOS Amazon DCV server ]
**macOS Amazon DCV サーバーで自動コンソールセッションを有効にするには**
1. `/etc/dcv/` に移動し、任意のテキストエディタで `dcv.conf` を開きます。
1. 次の形式を使用して、`create-session` および `owner` パラメータを `[session-management/automatic-console-session]` セクションに追加します。
```
[session-management]
create-session = true
[session-management/automatic-console-session]
owner="session-owner"
```
1. ファイルを保存して閉じます。
1. Amazon DCV サーバーを[停止](manage-stop.md)して[再起動](manage-start.md)します。
------
# Amazon DCV セッションの停止
コンソールセッションを停止できるのは、Windows Amazon DCV サーバーの管理者と、Linux および macOS Amazon DCV サーバーのルートユーザーのみです。Linux Amazon DCV サーバーの仮想セッションは、ルートユーザー、またはこのセッションを作成した Amazon DCV ユーザーのみが停止できます。
**注記**
セッションを停止すると、そのセッションで実行されているすべてのアプリケーションが閉じます。
Windows、Linux、または macOS Amazon DCV サーバーでコンソールまたは仮想セッションを停止するには、 `dcv close-session` コマンドを使用して一意のセッション ID を指定します。
**Topics**
+ [Syntax](#managing-sessions-lifecycle-stop-syntax)
+ [例](#example)
## Syntax
```
dcv close-session session-id
```
## 例
例えば、次のコマンドでは一意の ID `my-session` を使用してセッションが停止されます。
```
dcv close-session my-session
```
# Amazon DCV セッションの表示
Windows Amazon DCV サーバーの管理者または Linux Amazon DCV サーバーのルートユーザーは、サーバーで実行されているすべてのアクティブなセッションを表示できます。Amazon DCV ユーザーは、自分が作成したセッションのみ表示できます。
**Topics**
+ [すべてのアクティブなセッションの表示](#list-all)
+ [特定のアクティブなセッションの表示](#view-specific)
## すべてのアクティブなセッションの表示
Windows または Linux の Amazon DCV サーバーでアクティブなコンソールまたは仮想セッションを一覧表示するには、`dcv list-sessions` コマンドを使用します。
**Topics**
+ [構文](#list-all-syntax)
+ [Output](#output)
### 構文
```
dcv list-sessions
```
### Output
このコマンドから、次の形式でアクティブなセッションのリストが返されます。
```
Session: session-id (owner:session-owner type:virtual|console name:'my session')
```
## 特定のアクティブなセッションの表示
セッションに関する情報を表示するには、`dcv describe-session` コマンドを使用して、一意のセッション ID を指定します。
**Topics**
+ [構文](#view-specific-syntax)
+ [Output](#output)
### 構文
```
$ dcv describe-session session_id
```
### Output
次の出力例では、`display-layout` 要素は、セッションの表示レイアウトが 800x600 画面を 2 つ使用するように設定されていることを示しています。このうち、2 番目の画面は 1 番目の画面の x=800 (右側) にオフセットされます。
```
Session: test
owner: session-id
name: session-name
x display: :1
x authority: /run/user/1009/dcv/test.xauth
display layout: 800x600+0+0,800x600+800+0
```
`--json` (または `-j`) オプションを指定して、コマンドが出力を JSON 形式で返すようにすることもできます。JSON 出力には、セッションに関する追加の詳細が表示されます。
```
$ dcv describe-session session-id --json
```
JSON 出力の例を次に示します。
```
{
"id" : "session-id",
"owner" : "dcvuser",
"name" : "session-name",
"num-of-connections" : 0,
"creation-time" : "2020-03-02T16:08:50Z",
"last-disconnection-time" : "",
"licenses" : [
{
"product" : "dcv",
"status" : "licensed",
"check-timestamp" : "2020-03-02T16:08:50Z",
"expiration-date" : "2020-03-29T00:00:00Z"
},
{
"product" : "dcv-gl",
"status" : "licensed",
"check-timestamp" : "2020-03-02T16:08:50Z",
"expiration-date" : "2020-03-29T00:00:00Z"
}
],
"storage-root" : "",
"type" : "virtual",
"x11-display" : ":2",
"x11-authority" : "/run/user/1009/dcv/vsession.xauth",
"display-layout" : [
{
"width" : 800,
"height" : 600,
"x" : 0,
"y" : 0
},
{
"width" : 800,
"height" : 600,
"x" : 800,
"y" : 0
}
]
}
```
# アクティブな Amazon DCV セッションの管理
クライアントがログインして DCV セッションの使用を開始すると、セッションはアクティブと見なされます。セッションがアクティブである間も、特定の管理タスクを実行できます。このセクションでは、使用中のセッションでクライアントがパラメータを管理するのに必要な情報を提供します。
**Topics**
+ [セッションストレージの管理](managing-session-storage.md)
+ [セッション認可の管理](managing-session-perms.md)
+ [セッション表示レイアウトの管理](managing-session-display.md)
+ [セッション名の管理](managing-session-name.md)
+ [アイドル状態のセッションの検出と停止](stop-idle-sessions.md)
# Amazon DCV セッションストレージの管理
セッションストレージは 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)
## 構文
```
dcv set-storage-root --session session_id /path_to/directory
```
ディレクトリパスについては、`%home%` を使用して、現在サインインしているユーザーのホームディレクトリを指定できます。たとえば、`%home%/storage/` パスは Windows サーバーで `c:\Users\username\storage\` に解決されます。Linux サーバでは `$HOME/storage/` に解決されます。
**注記**
`storage-root` 値は macOS の絶対パスである必要があります。
## オプション
以下のオプションは `dcv set-storage-root` コマンドで使用できます。
**`--session`**
ストレージディレクトリを指定するセッション ID。
タイプ: 文字列
必須: はい
## 例
**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 セッション認可の管理
認可は、特定の 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)
## 構文
```
dcv set-permissions --session session-id --none | --reset-builtin | --file /path_to/permissions_file
```
`--none`、`--reset-builtin`、`--file` のいずれかを指定する必要があります。
## オプション
以下のオプションは `dcv set-permissions` コマンドで使用できます。
**--session**
アクセス許可を設定するセッションの ID を指定します。
**--reset-builtin**
セッションのアクセス許可をデフォルトのセッションアクセス許可にリセットします。デフォルトのアクセス許可では、セッション所有者のみにすべての機能へのフルアクセス権を付与します。
**--none**
セッションのすべてのアクセス許可を取り消します。
**--file**
カスタムアクセス許可ファイルへのパスを指定します。指定したファイルが空の場合、すべてのアクセス許可が取り消されます。カスタムアクセス許可ファイルの作成の詳細については、「[アクセス許可ファイルについて](security-authorization-file-create.md)」を参照してください。
## 例
**例 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 セッション表示レイアウトの管理
実行中の 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)
## 表示レイアウトへのアクセス
指定した範囲外の表示レイアウトをクライアントがリクエストしないように 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)」を参照してください。
## 表示レイアウトの設定
**実行中の 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
```
## 表示レイアウトの表示
**セッションの表示レイアウトを表示するには**
`dcv describe-session` コマンドを使用して、出力の `display layout` 要素を確認します。詳細については、「[Amazon DCV セッションの表示](managing-sessions-lifecycle-view.md)」を参照してください。
# セッション名の管理
実行中のセッションの名前は、いつでも変更できます。特定のセッション名を使用すれば、その名前に基づいてセッションをすばやく識別できます。セッション名は、実行中のセッション間で一意である必要はありません。
実行中のセッションの名前を変更するには、`dcv set-name` コマンドを使用します。
**Topics**
+ [構文](#managing-session-name-syntax)
+ [オプション](#managing-session-name-options)
+ [例](#example)
## 構文
```
$ dcv set-name --session session_id --none |--name "session-name"
```
`--name` または `--none` のどちらかを指定する必要があります。
## オプション
以下のオプションは `dset-name` コマンドで使用できます。
**`--session`**
名前を設定するセッションの ID。
タイプ: 文字列
必須: はい
**`--name`**
セッションに割り当てる名前。セッションに名前を割り当てる場合にのみ、このオプションを指定します。名前を削除する場合は、このパラメータを省略します。セッション名の長さは 256 文字以下にしてください。パスワードには、文字、数字、特殊文字を使用できます。指定した文字列が 256 文字を超えると、コマンドは失敗します。
タイプ: 文字列
必須: いいえ
**`--none`**
セッションから既存の名前を削除するには、このパラメータを指定します。セッション名を削除しない場合は、このオプションを省略します。
必須: いいえ
## 例
**例 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
```
# アイドル状態のセッションの検出と停止
アイドル状態の 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) コマンドを使用して、それらの使用を停止できます。
**注記**
セッションを停止すると、そのセッションで実行されているすべてのアプリケーションが閉じます。
# セッションのタイムゾーンの設定
DCV を使用すると、セッションのオーナーとユーザーは DCV サーバーの場所またはユーザーの現在の場所を反映するようにセッションのタイムゾーンを設定できます。
セッション内の個々のユーザーのみにこの機能が必要である場合は、まず全ユーザーに対して中央パラメーターを設定します。次に [アクセス許可を追加](security-authorization-file-create-permission.md) でカスタム権限ファイルを作成し、各ユーザーの権限を個別に調整する必要があります。
**注記**
この機能は Linux 仮想セッションでは使用できません。
**注記**
macOS では、タイムゾーンのリダイレクトはログイン後に適用されます。
**タイムゾーンリダイレクトの有効化**
特定のセッションのすべてのユーザーに対してこの機能を有効または無効にできます。
1. [`enable-timezone-redirection`](config-param-ref.md#paramref.redirection.enable-timezone-redirection) パラメータを次のいずれかの値に設定します。
+ `always-on`: タイムゾーンのリダイレクトは常に有効になります。
機能がオンになり、セッションにクライアントのタイムゾーン情報が表示されます。ユーザーは機能をオフにすることはできません。
+ `always-off`: タイムゾーンのリダイレクトは常に無効になります。
機能はオフになり、セッションには独自のタイムゾーン情報が表示されます。ユーザーは機能をオンにすることはできません。
+ `client-decides`: タイムゾーンのリダイレクトはデフォルトで有効になります。
セッションではこの機能が有効になり、クライアントのタイムゾーンが表示されます。ユーザーはこれを無効にして、サーバーのタイムゾーンを表示することもできます。
**注記**
この設定は標準のデフォルト設定です。
1. 変更内容を反映するには該当するセッションを再起動します。
# Linux でのスクリーンブランキングの管理
Linux サーバー上のコンソールセッションの場合、DCV は少なくとも 1 人のリモートユーザーがサーバーに接続されているときにデフォルトでローカル画面をブランクにし、最後のリモートユーザーの切断時に出力を復元 (画面もロック) します。
これにより、サーバーが物理的に近接しているユーザーが画面を表示し、ホストに接続された入力デバイスを使用してリモートセッションとやり取りすることができなくなります。これは、コンソールセッションをリモートで作業する場合、プライバシー上の理由や現地の法律のコンプライアンスのために望ましくない場合があります。ローカル入力は、キーボードやマウスなどの物理的に接続されたデバイスを無効にすることで防止されます。入力デバイスは、プラグインされるとすぐに、または有効であることがわかったときに無効になります。同様に、リモートユーザーが接続されていない場合、入力デバイスは再び有効になり、ローカルのログインとインタラクションが可能になります。
**スクリーンブランキングと入力ブロックの無効化**
スクリーンブランキングは、次の手順を使用して無効にできます。
1. `/etc/dcv/` に移動し、任意のテキストエディタで `dcv.conf` ファイルを開きます。
1. `[display/linux]` セクションで `disable-local-console parameter` を見つけます。ローカルに接続されたディスプレイをアクティブのままにして進行中のリモートセッションを表示し、ローカルに接続されたデバイスを介したインタラクションを許可するには、`disable-local-console=false` を設定します。デフォルト値は `true` (スクリーンブランキングと入力ブロックがアクティブなど) です。`[display/linux]` セクションに `disable-local-console` パラメータが存在しない場合は、次の形式を使用して手動で追加します。
```
[display/linux]
disable-local-console=false|true
```
1. ファイルを保存して閉じます。
1. Amazon DCV サーバーを[停止](manage-stop.md)して[再起動](manage-start.md)します。
**選択した入力デバイスの無効化の防止**
特定のデバイスを有効にしたままに設定できます。
名前が `DCV ` で始まる入力デバイス (名前の後のスペースに注意してください) は、`display-local-console` 設定の値に関係なく無効にされることはありません。入力デバイスの名前を変更するには、「[スタイラスを有効にする](enable-stylus.md)」のガイドを参照してください。
# Amazon DCV セッションでのスクリーンショットの作成
`dcv get-screenshot` コマンドを使用すれば、実行中のセッションのデスクトップのスクリーンショットを作成できます。
## 構文
```
dcv get-screenshot --max-width pixels --max-height pixels --format JPEG|PNG --primary --json --output /path_to/destination session_name
```
## オプション
**`--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 イメージファイルが作成されます。
タイプ: 文字列
必須: いいえ
## 例
**例 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
```