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

# ステップ 4: 接続ファイルを作成する (オプション)
<a name="using-connection-file"></a>

Windows、Linux、または macOS のネイティブクライアントを使用している場合、接続ファイルを作成して使用すれば、瞬時に Amazon DCV セッションに接続できます。

**Topics**
+ [接続ファイルの作成](#connection-file-create)
+ [サポートされているパラメータ](#connection-file-params)
+ [接続ファイルの実行](#connection-file-execute)

## 接続ファイルの作成
<a name="connection-file-create"></a>

接続ファイルは、`.dcv` ファイル拡張子を持つテキストベースのファイルです。`.dcv` ファイルの形式は `.ini` ファイルの形式と同様です。このファイルには、`[groups]`、続いてパラメータとそれらの値が含まれます。グループとパラメータは、次の形式になります。

```
[group_name]
parameter_name=parameter_value
```

例えば、次のようになります。

```
[options]
fullscreen=true
```

特定の Amazon DCV セッション用の接続ファイルをクライアントから直接作成できます。あるいは、テキストエディタを使用すれば接続ファイルを最初から作成できます。

**注記**  
テキストエディタを使用して接続ファイルを最初から作成する手順は、Windows、Linux、macOS クライアントで同じです。

**クライアントから接続ファイルを作成するには**

1.  クライアントを開きます。

1. ファイルを作成するサーバーとセッションに接続します。

1. 右上隅にある Amazon DCV サーバーのホスト名を選択し、**[接続に名前を付けて保存]** を選択します。

1. [**名前を付けて保存**] ウィンドウで、ファイル名と移動先フォルダを入力し、[**保存**] を選択します。

デフォルトでは、接続ファイルを作成する場合、このファイルには、`format`、`host`、`port`、`user` および `proxytype` パラメータが含まれます。これらのパラメータは、ファイルの作成元セッションに接続するために必要です。テキストエディタを使用してファイルを編集することで、いつでも手動でパラメータをカスタマイズまたは追加できます。

**テキストエディタを使用して接続ファイルを最初から作成するには**

1. 次のファイル名形式で `.dcv` ファイルを作成します。`file_name.dcv`

1. 任意のテキストエディタを使用して `.dcv` ファイルを開きます。

1. `[version]` グループおよび `format` パラメータをファイルの先頭に次の形式で追加します。

   ```
   [version]
   format=1.0
   ```
**重要**  
`.dcv` ファイルに `[version]` グループと `format` パラメータが含まれていない場合、解析は失敗します。

1. 次の形式を使用して、必要なパラメータグループを追加します。

   ```
   [group_name]
   ```

   パラメータグループの詳細については、「[サポートされているパラメータ](#connection-file-params)」を参照してください。

1. 次の形式を使用して、グループの後にパラメータとパラメータ値を追加します。

   ```
   parameter_name=parameter_value
   ```
**注記**  
パラメータ名では大文字と小文字が区別されます。
文字列パラメータ値を引用符で囲まないでください。

   パラメータとパラメータ値の詳細については、「[サポートされているパラメータ](#connection-file-params)」を参照してください。

1. 変更内容を保存し、`.dcv` ファイルを閉じます。

この手順を使用して、いつでも既存の接続ファイルにパラメータを追加することもできます。

## サポートされているパラメータ
<a name="connection-file-params"></a>

現在、`.dcv` ファイルでは 3 つのパラメータグループのパラメータ `[version]`、`[connect]`、`[options]` がサポートされています。次の表に、グループとその使用可能なパラメータを示します。

**Topics**
+ [`[version]` 個のパラメータ](#param-version)
+ [`[connect]` 個のパラメータ](#param-connect)
+ [`[options]` 個のパラメータ](#param-option)
+ [`[debug]` 個のパラメータ](#param-debug)

### `[version]` 個のパラメータ
<a name="param-version"></a>

**重要**  
これは必須のフィールドです。`.dcv` ファイルにこのグループが含まれていない場合、解析は失敗します。

次の表に、`[version]` グループで指定できるパラメータを示します。


| パラメータ | タイプ | デフォルトの値 | 説明 | 
| --- | --- | --- | --- | 
| format | string |  |   これは必須のパラメータです。パラメータ値は `1.0` である必要があります。 `.dcv` ファイルにこのパラメータが含まれていない場合、解析は失敗します。   | 

### `[connect]` 個のパラメータ
<a name="param-connect"></a>

次の表に、`[connect]` グループで指定できるパラメータを示します。


| パラメータ | タイプ | デフォルトの値 | 説明 | 
| --- | --- | --- | --- | 
| ホスト | String |  | セッションをホストしている Amazon DCV サーバーのホスト名。 | 
| port | 整数 | 8443 | Amazon DCV サーバーへの接続時に使用するポート。 | 
| weburlpath | String |  | Amazon DCV サーバーの接続用カスタムパス。たとえば、customPath を指定した場合、クライアントは host:port/customPath への接続を試みます。 | 
| sessionid | String |  | 接続する Amazon DCV セッションの ID。 | 
| authtoken | String |  | 接続に使用する認証トークン。authtoken を指定する場合は、sessionid も指定する必要があります。authtoken を使用するときは、user パラメータと passwordパラメータを省略できます。 | 
| ユーザー | String |  | Amazon DCV サーバーへの接続時に使用するユーザー名。 | 
| password | String |  | Amazon DCV サーバーへの接続時に使用するパスワード。パスワードは暗号化されません。 | 
| proxytype | String | SYSTEM | 使用するプロキシタイプ。有効な値は、HTTPS、HTTP、SOCKS5\$1SOCKS、SYSTEM、または NONE\$1DIRECT です。SYSTEM を指定すると、コンピュータのプロキシ設定が使用されます。 | 
| proxyhost | String |  | プロキシサーバー経由で接続する場合に使用されるプロキシサーバーのアドレス。 | 
| proxyport | 整数 |  | プロキシサーバー経由で接続する場合に使用されるポート。 | 
| proxyuser | String |  | プロキシ認証に使用されるユーザー名。 | 
| proxypassword | String |  | プロキシ認証に使用されるパスワード。パスワードは暗号化されません。 | 
| トランスポート | String | auto | データ転送に使用するプロトコル。`auto` でクライアントは最初に QUIC (UDP) プロトコルを使用して接続を試みます。QUIC 接続が失敗すると、トランスポートは自動的に `websocket` に戻ります。 データ転送に WebSocket (TCP) プロトコルを使用する場合は `websocket` を、データ転送に QUIC (UDP) プロトコルを使用する場合は `quic` を指定します。QUIC を有効にすると、QUIC プロトコルがデータ転送に使用され、WebSocket が認証トラフィックに使用されます。WebSocket を有効にすると、WebSocket プロトコルがデータ転送と認証トラフィックの両方に使用されます。  | 
| webport | 整数 | 8443 | WebSocket (TCP) トラフィックに使用するポート。 | 
| quicport | 整数 | 8443 | QUIC (UDP) トラフィックに使用するポート。 | 
| certificatevalidationpolicy | String | ask-user | 信頼できない証明書を検証するためのポリシー。値には strict、accept-untrusted、および ask-user があります。 | 

### `[options]` 個のパラメータ
<a name="param-option"></a>

次の表に、`[options]` グループで指定できるパラメータを示します。


| パラメータ | タイプ | デフォルトの値 | 説明 | 
| --- | --- | --- | --- | 
| fullscreen | ブール値 | false | クライアントが全画面モードで起動するかどうかを示します。 | 
| useallmonitors | ブール値 | false | 全画面モードの開始時にクライアントですべてのモニターが使用されるかどうかを示します。 | 
| promptreconnect | ブール値 | true | セッションから切断した後、クライアントにより再接続を求めるメッセージが表示されるかどうかを示します。パラメータが true に設定されている場合、切断するとサインイン画面にリダイレクトされます。パラメータが false に設定されている場合、切断するとクライアントは閉じます。 | 
| enableyuv444decoding | ブール値 | false | 動的ビデオコンテンツをエンコードするときに、[[高色精度 (YUV 4:4:4)](using-high-color-accuracy.md)] を有効にするかどうかを示します。 | 

### `[debug]` 個のパラメータ
<a name="param-debug"></a>

次の表に、`[debug]` グループで指定できるパラメータを示します。


| パラメータ | タイプ | デフォルトの値 | 説明 | 
| --- | --- | --- | --- | 
| loglevel | String | 情報 | 値は Debug に設定できます。 | 

## 接続ファイルの実行
<a name="connection-file-execute"></a>

`.dcv` 接続ファイルを実行するには、そのファイルに移動してダブルクリックします。

または、`dcvviewer` コマンドの引数としてファイルパスを指定します。
+ Windows クライアント

  ```
  C:\> dcvviewer.exe path\connection_file_name.dcv
  ```
+ Linux クライアントおよび macOS クライアント

  ```
  $ dcvviewer path/connection_file_name.dcv
  ```