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