翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ステップ 4: 接続ファイルを作成する (オプション)
Windows、Linux、または macOS のネイティブクライアントを使用している場合、接続ファイルを作成して使用すれば、瞬時に Amazon DCV セッションに接続できます。
接続ファイルの作成
接続ファイルは、.dcv ファイル拡張子を持つテキストベースのファイルです。.dcv ファイルの形式は .ini ファイルの形式と同様です。このファイルには、[groups]、続いてパラメータとそれらの値が含まれます。グループとパラメータは、次の形式になります。
[group_name]parameter_name=parameter_value
例:
[options]fullscreen=true
特定の Amazon DCV セッション用の接続ファイルをクライアントから直接作成できます。あるいは、テキストエディタを使用すれば接続ファイルを最初から作成できます。
注記
テキストエディタを使用して接続ファイルを最初から作成する手順は、Windows、Linux、macOS クライアントで同じです。
クライアントから接続ファイルを作成するには
-
クライアントを開きます。
-
ファイルを作成するサーバーとセッションに接続します。
-
右上隅にある Amazon DCV サーバーのホスト名を選択し、[接続に名前を付けて保存] を選択します。
-
[名前を付けて保存] ウィンドウで、ファイル名と移動先フォルダを入力し、[保存] を選択します。
デフォルトでは、接続ファイルを作成する場合、このファイルには、format、host、port、user および proxytype パラメータが含まれます。これらのパラメータは、ファイルの作成元セッションに接続するために必要です。テキストエディタを使用してファイルを編集することで、いつでも手動でパラメータをカスタマイズまたは追加できます。
テキストエディタを使用して接続ファイルを最初から作成するには
-
次のファイル名形式で
.dcvファイルを作成します。file_name.dcv -
任意のテキストエディタを使用して
.dcvファイルを開きます。 -
[version]グループおよびformatパラメータをファイルの先頭に次の形式で追加します。[version] format=1.0重要
.dcvファイルに[version]グループとformatパラメータが含まれていない場合、解析は失敗します。 -
次の形式を使用して、必要なパラメータグループを追加します。
[group_name]パラメータグループの詳細については、「サポートされているパラメータ」を参照してください。
-
次の形式を使用して、グループの後にパラメータとパラメータ値を追加します。
parameter_name=parameter_value注記
パラメータ名では大文字と小文字が区別されます。
文字列パラメータ値を引用符で囲まないでください。
パラメータとパラメータ値の詳細については、「サポートされているパラメータ」を参照してください。
-
変更内容を保存し、
.dcvファイルを閉じます。
この手順を使用して、いつでも既存の接続ファイルにパラメータを追加することもできます。
サポートされているパラメータ
現在、.dcv ファイルでは 3 つのパラメータグループのパラメータ [version]、[connect]、[options] がサポートされています。次の表に、グループとその使用可能なパラメータを示します。
[version] 個のパラメータ
重要
これは必須のフィールドです。.dcv ファイルにこのグループが含まれていない場合、解析は失敗します。
次の表に、[version] グループで指定できるパラメータを示します。
| パラメータ | タイプ | デフォルト値 | 説明 |
|---|---|---|---|
| 形式 | 文字列 |
重要これは必須のパラメータです。パラメータ値は
|
[connect] 個のパラメータ
次の表に、[connect] グループで指定できるパラメータを示します。
| パラメータ | タイプ | デフォルト値 | 説明 |
|---|---|---|---|
| ホスト | 文字列 | セッションをホストしている Amazon DCV サーバーのホスト名。 | |
| ポート | 整数 | 8443 | Amazon DCV サーバーへの接続時に使用するポート。 |
| weburlpath | 文字列 | Amazon DCV サーバーの接続用カスタムパス。たとえば、customPath を指定した場合、クライアントは host:port/customPath への接続を試みます。 |
|
| sessionid | 文字列 | 接続する Amazon DCV セッションの ID。 | |
| authtoken | 文字列 | 接続に使用する認証トークン。authtoken を指定する場合は、sessionid も指定する必要があります。authtoken を使用するときは、user パラメータと passwordパラメータを省略できます。 |
|
| ユーザー | 文字列 | Amazon DCV サーバーへの接続時に使用するユーザー名。 | |
| password | 文字列 | Amazon DCV サーバーへの接続時に使用するパスワード。パスワードは暗号化されません。 | |
| proxytype | 文字列 | SYSTEM | 使用するプロキシタイプ。有効な値は、HTTPS、HTTP、SOCKS5|SOCKS、SYSTEM、または NONE|DIRECT です。SYSTEM を指定すると、コンピュータのプロキシ設定が使用されます。 |
| proxyhost | 文字列 | プロキシサーバー経由で接続する場合に使用されるプロキシサーバーのアドレス。 | |
| proxyport | 整数 | プロキシサーバー経由で接続する場合に使用されるポート。 | |
| proxyuser | 文字列 | プロキシ認証に使用されるユーザー名。 | |
| proxypassword | 文字列 | プロキシ認証に使用されるパスワード。パスワードは暗号化されません。 | |
| トランスポート | 文字列 | auto |
データ転送に使用するプロトコル。 データ転送に WebSocket (TCP) プロトコルを使用する場合は |
| webport | 整数 | 8443 | WebSocket (TCP) トラフィックに使用するポート。 |
| quicport | 整数 | 8443 | QUIC (UDP) トラフィックに使用するポート。 |
| certificatevalidationpolicy | 文字列 | ask-user | 信頼できない証明書を検証するためのポリシー。値には strict、accept-untrusted、および ask-user があります。 |
[options] 個のパラメータ
次の表に、[options] グループで指定できるパラメータを示します。
| パラメータ | タイプ | デフォルト値 | 説明 |
|---|---|---|---|
| fullscreen | ブール値 | false | クライアントが全画面モードで起動するかどうかを示します。 |
| useallmonitors | ブール値 | false | 全画面モードの開始時にクライアントですべてのモニターが使用されるかどうかを示します。 |
| promptreconnect | ブール値 | true | セッションから切断した後、クライアントにより再接続を求めるメッセージが表示されるかどうかを示します。パラメータが true に設定されている場合、切断するとサインイン画面にリダイレクトされます。パラメータが false に設定されている場合、切断するとクライアントは閉じます。 |
| enableyuv444decoding | ブール値 | false | 動的ビデオコンテンツをエンコードするときに、[高色精度 (YUV 4:4:4)] を有効にするかどうかを示します。 |
[debug] 個のパラメータ
次の表に、[debug] グループで指定できるパラメータを示します。
| パラメータ | タイプ | デフォルト値 | 説明 |
|---|---|---|---|
| loglevel | 文字列 | 情報 | 値は Debug に設定できます。 |
接続ファイルの実行
.dcv 接続ファイルを実行するには、そのファイルに移動してダブルクリックします。
または、dcvviewer コマンドの引数としてファイルパスを指定します。
-
Windows クライアント
C:\>dcvviewer.exepath\connection_file_name.dcv -
Linux クライアントおよび macOS クライアント
$dcvviewerpath/connection_file_name.dcv
