接続ファイルの使用

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

接続ファイルの作成

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

[group_name]
parameter_name=parameter_value
    

例:

[options]
fullscreen=true
    

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

注記

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

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

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

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

3. 右上隅にある NICE DCV サーバーのホスト名を選択し、[Save Connection As] (名前を付けて接続を保存) を選択します。

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

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

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

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

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

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

   [version]
   format=1.0

   重要

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

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

   [group_name]

   パラメータグループの詳細については、「サポートされているパラメータ」を参照してください。

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

   parameter_name=parameter_value

   注記

   • パラメータ名では大文字と小文字が区別されます。

   • 文字列パラメータ値を引用符で囲まないでください。

   パラメータとパラメータ値の詳細については、「サポートされているパラメータ」を参照してください。

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

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

サポートされているパラメータ

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

グループ

• [version] パラメータ
• [connect] パラメータ
• [options] パラメータ

[version] パラメータ

重要

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

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

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

[connect] パラメータ

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

パラメータ	タイプ	デフォルト値	説明
ホスト	文字列		セッションをホストしている NICE DCV サーバーのホスト名。
port	整数	8443	NICE DCV サーバーへの接続時に使用するポート。
weburlpath	文字列		NICE DCV サーバーの接続用カスタムパス。たとえば、customPath を指定した場合、クライアントは host:port/customPath への接続を試みます。
sessionid	文字列		接続する NICE DCV セッションの ID。
authtoken	文字列		接続に使用する認証トークン。authtoken を指定する場合は、sessionid も指定する必要があります。authtoken を使用するときは、user パラメータと passwordパラメータを省略できます。
ユーザー	文字列		NICE DCV サーバーへの接続時に使用するユーザー名。
password	文字列		NICE DCV サーバーへの接続時に使用するパスワード。パスワードは暗号化されません。
proxytype	文字列	SYSTEM	使用するプロキシタイプ。有効な値は、HTTPS、HTTP、SOCKS5|SOCKS、SYSTEM、または NONE|DIRECT です。SYSTEM を指定すると、コンピュータのプロキシ設定が使用されます。
proxyhost	文字列		プロキシサーバー経由で接続する場合に使用されるプロキシサーバーのアドレス。
proxyport	整数		プロキシサーバー経由で接続する場合に使用されるポート。
proxyuser	文字列		プロキシ認証に使用されるユーザー名。
proxypassword	文字列		プロキシ認証に使用されるパスワード。パスワードは暗号化されません。
トランスポート	文字列	websocket	データ転送に使用するプロトコル。データ転送に WebSocket (TCP) websocket プロトコルを使用するように指定するか、データ転送に QUIC (UDP) quic プロトコルを使用するように指定します。QUIC を有効にすると、QUIC プロトコルがデータ転送に使用され WebSocket、認証トラフィックにも使用されます。有効にすると WebSocket、 WebSocket このプロトコルはデータ転送と認証トラフィックの両方に使用されます。
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)] を有効にするかどうかを示します。

接続ファイルの実行

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

または、dcvviewer コマンドの引数としてファイルパスを指定します。

• Windows クライアント

  C:\> dcvviewer.exe path\connection_file_name.dcv

• Linux クライアントおよび macOS クライアント

  $ dcvviewer path/connection_file_name.dcv