翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon DCV サーバーパラメータリファレンス
以下の表に、Amazon DCV サーバーをカスタマイズするために設定可能なパラメータを示します。
**注記**
各テーブルの**再ロードコンテキスト**列には、パラメータがいつ再ロードされるかが示されます。可能なコンテキストには、以下が含まれます。
`server` — このパラメータはサーバーの起動時に一度ロードされます。パラメータ値が更新されると、サーバーの再起動時に新しい値がロードされます。
`session` — このパラメータはセッションの作成時にロードされます。パラメータ値が更新されると、新しい値が後続のセッション用にロードされます。
`connection` — このパラメータは新しいクライアント接続が確立されたときにロードされます。パラメータ値が更新されると、新しい値が後続のクライアント接続に使用されます。
`custom` — このパラメータがロードされる条件は、このパラメータに固有です。詳細については、パラメータの説明を参照してください。
**Topics**
+ [`audio` パラメータ](#audio)
+ [`clipboard` パラメータ](#clipboard)
+ [`connectivity` パラメータ](#connectivity)
+ [`display` パラメータ](#display)
+ [`display/linux` パラメータ](#display_linux)
+ [`extensions` パラメータ](#extensions)
+ [`input` パラメータ](#input)
+ [`license` パラメータ](#license)
+ [`log` パラメータ](#log)
+ [`printer` パラメータ](#printer)
+ [`redirection` パラメータ](#redirection)
+ [`security` パラメータ](#security)
+ [`session-management` パラメータ](#session_management)
+ [`session-management/automatic-console-session` パラメータ](#session_management_automatic_console_session)
+ [`session-management/defaults` パラメータ](#session_management_defaults)
+ [`smartcard` パラメータ](#smartcard)
+ [`webauthn` パラメータ](#webauthn)
+ [`webcam` パラメータ](#webcam)
+ [`windows` パラメータ](#windows)
+ [設定パラメータの変更](config-param-ref-modify.md)
## `audio` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[audio]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `audio` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| avsync-support | string | セッション | 'auto' | クライアントによるオーディオ/ビデオ同期の有効化を許可するかどうかを決める — 接続されたクライアントによるオーディオ/ビデオ同期の有効化を許可します。有効値は 'enabled'、'disabled'、'auto' (デフォルトは 'auto') です。'auto' を指定すると、オーディオ/ビデオの同期はコンソールセッションでのみ有効になり、高速ビデオ圧縮が使用可能な場合のみ有効になります。— バージョン [2021.1-10557](doc-history-release-notes.md#release.2021.1-10557) から使用可能。 |
| source-channels | integer - DWORD (32 ビット) | セッション | 2 | Linux のスピーカーデバイスのチャネル数 — Linux のスピーカーデバイスのチャネル数を設定します。この値は、デバイスによってサポートされるチャネル数以下とします。許容される値は、2 (ステレオ)、4 (4.0 チャネルステレオ)、6 (5.1 サラウンド)、8 (7.1 サラウンド) です。デフォルト値 は 2 (ステレオ) です。— バージョン [2020.0-8428](doc-history-release-notes.md#release.2020.0-8428) から使用可能。 |
## `clipboard` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[clipboard]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `clipboard` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| enabled | true または false - DWORD (32 ビット) | セッション | Linux: true - Windows: 1 | クリップボード機能を有効にするかどうか - クリップボード機能を有効にするかどうかを指定します。クリップボード機能が無効になっている場合、ユーザーはクリップボードのリモート化を使用できなくなります。クリップボードのモニタリングも無効になります。— バージョン [2020.0-8428](doc-history-release-notes.md#release.2020.0-8428) から使用可能。 |
| max-image-area | integer - DWORD (32 ビット) | セッション | -1 | クリップボードのイメージの最大領域 — サーバーとクライアントの間で転送できるクリップボードのイメージの最大領域 (ピクセル数) を指定します。この値を指定しないか、-1 に設定されている場合、制限は適用されません。— バージョン [2017.0-4334](doc-history-release-notes.md#release.2017.0-4334) から使用可能。 |
| max-payload-size | integer - DWORD (32 ビット) | セッション | 20971520 | クリップボードのデータの最大サイズ — サーバーとクライアントの間で転送できるクリップボードのデータの最大サイズ (バイト) を指定します。サポートされる最大値は 20 MB です。この値を指定しない場合、最大値が適用されます。— バージョン [2017.0-4334](doc-history-release-notes.md#release.2017.0-4334) から使用可能。 |
| max-payload-size-copy | integer - DWORD (32 ビット) | セッション | -1 | クリップボードのデータの最大サイズ — サーバーからクライアントに転送されるクリップボードのデータの最大サイズ (バイト) を指定します。この値が指定されていない場合、max-payload-size が考慮されます。それ以外の場合は、2 つの値の最小値が適用されます。— バージョン [2023.0-14852](doc-history-release-notes.md#release.2023.0-14852) から使用可能。 |
| max-payload-size-paste | integer - DWORD (32 ビット) | セッション | -1 | クリップボードのデータの最大サイズ — クライアントからサーバーに転送されるクリップボードのデータの最大サイズ (バイト) を指定します。この値が指定されていない場合、max-payload-size が考慮されます。それ以外の場合は、2 つの値の最小値が適用されます。— バージョン [2023.0-14852](doc-history-release-notes.md#release.2023.0-14852) から使用可能。 |
| max-text-len | integer - DWORD (32 ビット) | セッション | -1 | クリップボードのテキストの最大文字数 — サーバーからクライアントに転送できるクリップボードテキストの最大文字数を指定します。それよりも長い文字は切り詰められます。この値を指定しないか、-1 に設定されている場合、制限は適用されません。— バージョン [2017.0-4334](doc-history-release-notes.md#release.2017.0-4334) から使用可能。 |
| max-text-len-copy | integer - DWORD (32 ビット) | セッション | -1 | クリップボードのテキストの最大文字数 — サーバーからクライアントに転送できるクリップボードテキストの最大文字数を指定します。それよりも長い文字は切り詰められます。この値が指定されていない場合、max-text-len が考慮されます。それ以外の場合は、2 つの値の最小値が適用されます。— バージョン [2023.0-14852](doc-history-release-notes.md#release.2023.0-14852) から使用可能。 |
| max-text-len-paste | integer - DWORD (32 ビット) | セッション | -1 | クリップボードのテキストの最大文字数 — クライアントからサーバーに転送できるクリップボードテキストの最大文字数を指定します。それよりも長い文字は切り詰められます。この値が指定されていない場合、max-text-len が考慮されます。それ以外の場合は、2 つの値の最小値が適用されます。— バージョン [2023.0-14852](doc-history-release-notes.md#release.2023.0-14852) から使用可能。 |
| primary-selection-copy | true または false - DWORD (32 ビット) | セッション | Linux: false - Windows: 0 | Linux からのプライマリ選択コピーを有効にする — Linux デスクトップは複数のクリップボード (汎用クリップボードとプライマリ選択) をサポートします。コンテンツを選択すると、プライマリ選択が更新またはコピーされます。その後、マウスの中央ボタンを使用するか、Shift\$1Insert キーの組み合わせを使用して貼り付けられます。有効にすると、プライマリ選択がモニタリングされ、更新がクライアントに伝播されます。— バージョン [2019.0-7318](doc-history-release-notes.md#release.2019.0-7318) から使用可能。 |
| primary-selection-paste | true または false - DWORD (32 ビット) | セッション | Linux: false - Windows: 0 | Linux でのプライマリ選択の貼り付けの有効化 — Linux デスクトップでは、複数のクリップボード (汎用クリップボードとプライマリ選択) をサポートします。コンテンツを選択すると、プライマリ選択が更新またはコピーされます。その後、マウスの中央ボタンまたは Shift\$1Insert キーの組み合わせを使用して貼り付けられます。有効にすると、クライアントのクリップボードのコンテンツもプライマリ選択に挿入されます。— バージョン [2019.0-7318](doc-history-release-notes.md#release.2019.0-7318) から使用可能。 |
| update-timeout | integer - DWORD (32 ビット) | セッション | 200 | イベント通知タイムアウトの更新— クライアントに通知を送信するための最終更新イベントからの待機時間をミリ秒単位で指定します。デフォルト値は 200 ミリ秒です。— バージョン [2020.1-8942](doc-history-release-notes.md#release.2020.1-8942) から使用可能。 |
## `connectivity` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[connectivity]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `connectivity` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| disconnect-on-lock | true または false - DWORD (32 ビット) | カスタム | Linux: false - Windows: 0 | OS のセッションロック時にクライアントを切断するかどうか — 有効化すると、リモート OS セッションがロックされたときにクライアントを強制的に切断します。有効化しない場合、クライアントはリモートセッションのストリーミングを続行します。現在はコンソールセッションでのみサポートされています。このパラメータ値は、リモート OS セッションがロックされるたびに読み込まれます。— バージョン [2023.1-16220](doc-history-release-notes.md#release.2023.1-16220) から使用可能。 |
| disconnect-on-logout | true または false - DWORD (32 ビット) | カスタム | Linux: false - Windows: 0 | OS のユーザーログアウト時にクライアントを切断するかどうか — 有効化すると、OS ユーザーがログアウトしたとき (つまり OS セッションが終了したとき) にクライアントのを強制的に切断します。有効化しない場合、クライアントはリモートセッションのストリーミングを続行します。現在はコンソールセッションでのみサポートされています。このパラメータ値は、リモート OS ユーザーがログアウトするたびに読み込まれます。— バージョン [2023.1-16220](doc-history-release-notes.md#release.2023.1-16220) から使用可能。 |
| enable-quic-frontend | true または false - DWORD (32 ビット) | server | Linux: true - Windows: 1 | QUIC フロントエンドを有効にするかどうか - QUIC フロントエンドを有効にするかどうかを指定します。— バージョン [2020.2-9508](doc-history-release-notes.md#release.2020.2-9508) から使用可能。 |
| idle-timeout | integer - DWORD (32 ビット) | custom | 60 | アイドルタイムアウト — アイドルクライアントを切断するまでの待機時間 (分) を指定します。0 に指定すると、アイドルクライアントは切断されません。このパラメータ値は毎秒読み込まれます。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| idle-timeout-warning | integer - DWORD (32 ビット) | custom | 350 | アイドルタイムアウトの警告 — アイドル状態のクライアントに対してアイドルタイムアウトの切断を警告するまでのアイドルタイムアウト関連待機時間 (秒) を指定します。アイドル状態のクライアントに警告しないようにするには、0 を指定します。— バージョン [2017.4-6898](doc-history-release-notes.md#release.2017.4-6898) から使用可能。 |
| quic-listen-endpoints | string | server | ['0.0.0.0', '::'] | DCV により着信 QUIC 接続がリッスンされるエンドポイントを指定する — DCV により着信 QUIC 接続がリッスンされるエンドポイントのリストを指定します。エンドポイントは、ローカルでバインド可能な IPv4 アドレスのリスト (潜在的なアドレスをすべてワイルドカード化するには '0.0.0.0') か、コロン (':') で区切られた任意のポートを含むバインド可能な IPv6 アドレス (潜在的なすべてのアドレスをワイルドカード化するには '::') にできます。たとえば '1.2.3.4:5678' とした場合、'1.2.3.4' アドレスに関連付けられたインターフェイスの着信接続がポート 5678 でリッスンされます。ポートが指定されていない場合は、'quic-port' の設定がデフォルトとして使用されます。IPv6 アドレスでポートを指定するには、アドレスを角括弧で囲みます (例: '[::1]:8443')。明示的なインターフェイスを含む IPv6 アドレスもサポートされています (例: '[::%eth1]:8443')。— バージョン [2022.0-11954](doc-history-release-notes.md#release.2022.0-11954) から使用可能。 |
| quic-port | integer - DWORD (32 ビット) | server | 8443 | QUIC フロントエンドの UDP ポート - クライアント接続のために DCV サーバーによりリッスンされる UDP ポートを指定します。ポート番号は 1024～65535 の間である必要があります。この設定の適用方法の詳細は、'quic-listen-endpoints' の設定を参照してください。— バージョン [2020.2-9508](doc-history-release-notes.md#release.2020.2-9508) から使用可能。 |
| web-extra-http-headers | string | server | [] | HTTP/HTTPS ヘッダーにさらに追加ヘッダーの配列を設定 – これを使用してヘッダーを追加します。配列には [('header\$1name','header\$1content')] のような組み合わせで入力する必要があります。複数のヘッダーを追加できます。— バージョン [2017.2-6182](doc-history-release-notes.md#release.2017.2-6182) から使用可能。 |
| web-listen-endpoints | string | server | ['0.0.0.0', '::'] | DCV により着信ウェブ接続がリッスンされるエンドポイントを指定する — DCV により着信ウェブ接続がリッスンされるエンドポイントのリストを指定します。エンドポイントは、ローカルでバインド可能な IPv4 アドレスのリスト (潜在的なアドレスをすべてワイルドカード化するには '0.0.0.0') か、コロン (':') で区切られた任意のポートを含むバインド可能な IPv6 アドレス (潜在的なすべてのアドレスをワイルドカード化するには '::') にできます。たとえば '1.2.3.4:5678' とした場合、'1.2.3.4' アドレスに関連付けられたインターフェイスの着信接続がポート 5678 でリッスンされます。ポートが指定されていない場合は、'web-port' の設定がデフォルトとして使用されます。IPv6 アドレスでポートを指定するには、アドレスを角括弧で囲みます (例: '[::1]:8443')。明示的なインターフェイスを含む IPv6 アドレスもサポートされています (例: '[::%eth1]:8443')。— バージョン [2022.0-11954](doc-history-release-notes.md#release.2022.0-11954) から使用可能。 |
| web-port | integer - DWORD (32 ビット) | server | 8443 | クライアントの TCP ポート — クライアント接続で DCV サーバーがリッスンする TCP ポートを指定します。ポート番号は 1024～65535 の間である必要があります。この設定の適用方法の詳細は、'web-listen-endpoints' の設定を参照してください。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| web-root | string | server | '' | 埋め込みウェブサーバーのドキュメントのルート — 埋め込みウェブサーバーのドキュメントのルートを指定します。— バージョン 2017.0-4100 [から使用可能](doc-history-release-notes.md#release.2017.0-4100)。 |
| web-url-path | string | server | '/' | 埋め込みウェブサーバーの URL パス — 埋め込みウェブサーバーの URL パスを指定します (先頭は必ず '/')。たとえば、/test/foo に設定すると、ウェブサーバーは https://host:port/test/foo にアクセスできるようになります。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| web-use-hsts | true または false - DWORD (32 ビット) | server | Linux: true - Windows: 1 | HSTS を使用するかどうか — これを有効にして、ブラウザが HTTP 経由で送信される通信を強制的に禁止するようにします。ウェブページ (およびすべてのサブドメイン) へのすべての転送は、代わりに HTTPS を使用して行われます。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| web-x-frame-options | string | server | 'DENY' | X-Frame-Options 値の設定 – デフォルト値は DENY に設定されます。これを変更する場合は、クリックジャック攻撃を防ぐために別の保護方法を導入する必要があります。他の保護機能がない場合は、この設定を変更しないでください。— バージョン [2017.1-5870](doc-history-release-notes.md#release.2017.1-5870) から使用可能。 |
| ws-keepalive-interval | integer - DWORD (32 ビット) | server | 10 | Websocket のキープアライブ間隔 — キープアライブメッセージを送信する間隔 (秒) を指定します。0 に設定すると、キープアライブメッセージは無効になります。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
## `display` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[display]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `display` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| console-session-default-layout | string | セッション | [] | コンソールセッションにおけるデフォルトの画面解像度と画面位置 — コンソールセッションにおけるデフォルトの画面解像度と画面位置を指定します。設定すると、DCV によって、リクエストされたレイアウトが起動時に設定されます。モニタごとに、解像度 (w,h) と位置 (x,y) で設定できます。指定されたモニタはすべて、有効になります。デフォルトレイアウトの値の例: [\$1'w':<800>, 'h':<600>, 'x':<0>, 'y': <0>\$1, \$1'w':<1024>, 'h':<768>, 'x':<800>,'y':<0>\$1] — バージョン [2017.0-5600](doc-history-release-notes.md#release.2017.0-5600) から使用可能。 |
| cuda-devices | string | connection | [] | ストリームエンコーディングに使用される CUDA デバイス — DCV がエンコーディングと CUDA ワークロードを分散するために使用するローカル CUDA デバイスのリストを指定します。各デバイスは、nvidia-smi コマンドから取得できる番号によって識別されます。例えば、cuda-devices= ['0', '2'] は、DCV が 2 つの GPU を使用し、ID が 0 と 2 であることを示します。この設定は CUDA\$1VISIBLE\$1DEVICES 環境変数と似ていますが、DCV にのみ適用されます。このオプションが設定されていない場合、DCV は 0 から始まる増分セッションインデックスを使用して、次に使用するデバイスを選択します。— バージョン [2017.2-6182](doc-history-release-notes.md#release.2017.2-6182) から使用可能。 |
| enable-client-resize | true または false - DWORD (32 ビット) | セッション | Linux: true - Windows: 1 | クライアントによるディスプレイレイアウトの設定を許可するかどうか — クライアントによるディスプレイレイアウトの設定を許可するかどうかを指定します。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| enable-qu | true または false - DWORD (32 ビット) | セッション | Linux: true - Windows: 1 | 品質更新を送信するかどうか — 品質更新を送信するかどうかを指定します。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| enable-yuv444-encoding | string | セッション | 'default-off' | YUV444 エンコーディングを有効にするかどうか — YUV444 エンコーディングを有効または無効にします。'always-on' の場合、サーバーは色精度が高くなるように最適化された YUV444 形式を優先します。'always-off' の場合、サーバーはストリーミングパフォーマンスに向けて最適化された形式を優先します。'default-on' と'default-off' の値は同じ意味で、クライアントに決定を委ねます。使用できる値: 'always-on'、'always-off'、'default-on'、'default-off'。— バージョン [2022.0-11954](doc-history-release-notes.md#release.2022.0-11954) から使用可能。 |
| grabber-target-fps | integer - DWORD (32 ビット) | セッション | 0 | フレームグラバーの 1 秒あたりのターゲットフレーム — 1 秒あたりにフレームをグラブする上限です。値を 0 にすると、各フレームバッファリーダーの標準動作 (target-fps へのフォールバックや、グラブを制限しないなど) にデフォルト設定されます。すべてのフレームキャプチャバックエンドでこの設定が優先されるわけではありません。— バージョン [2017.1-5870](doc-history-release-notes.md#release.2017.1-5870) から使用可能。 |
| max-compressor-threads | integer - DWORD (32 ビット) | セッション | 4 | 最大圧縮スレッド — 圧縮スレッドの最大数を指定します。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| max-head-resolution | string | custom | (4096、2160) | 最大ヘッド解像度 — クライアントがリクエストできるディスプレイヘッドの最大解像度。ディスプレイヘッドは、ホストモニターに相当します。この設定は、クライアントのレイアウトリクエストごとに再ロードされます。クライアントに、より大きなヘッド解像度がリクエストされると、サーバーはこのオプションで設定された最大幅と最大高の値と一致するように解像度を調整します。サポートされる最大解像度は (4096, 4096) です。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| max-layout-area | integer - DWORD (32 ビット) | custom | 0 | 最大レイアウト領域 (ピクセル単位) — クライアントがリクエストできる表示レイアウトの最大領域 (ピクセル単位)。この制限より大きいレイアウトは無視されます。この最大値は、表示レイアウトジオメトリに制約を与えずに、送信する必要のある表示データの量に上限を提供することを目的としています。0 に設定すると、レイアウト領域に制限は適用されません。この設定は、クライアントのレイアウトリクエストごとに再ロードされます。— バージョン [2019.1-7423](doc-history-release-notes.md#release.2019.1-7423) から使用可能。 |
| max-num-heads | integer - DWORD (32 ビット) | custom | 4 | ヘッドの最大数 — クライアントがリクエストできるディスプレイヘッドの最大数を指定します。ディスプレイヘッドは、ホストモニターに相当します。この設定は、クライアントのレイアウトリクエストごとに再ロードされます。クライアントからより多くのヘッドがリクエストされると、サーバーはその値がこのオプションで設定された値を超えないようにヘッドの数を調整します。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| min-head-resolution | string | custom | (640、480) | 最小ヘッド解像度 — クライアントがリクエストできるディスプレイヘッドの最小解像度。ディスプレイヘッドは、ホストモニターに相当します。この設定は、クライアントのレイアウトリクエストごとに再ロードされます。クライアントに、より小さい解像度がリクエストされると、サーバーはこのオプションで設定された最小幅と最大高の値と一致するように解像度を調整します。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| target-fps | integer - DWORD (32 ビット) | セッション | -1 | 1 秒あたりの目標フレーム — 1 秒あたりに許可される最大フレームを指定します。値を 0 にすると、無制限に設定されます。値を -1 にすると、サーバー特性とセッションタイプに応じて target-fps 値が決定されます。2020.2 より前のバージョンでは、値 -1 は認識されず、デフォルト値は 25 になります。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| use-grabber-dirty-region | true または false - DWORD (32 ビット) | セッション | Linux: true - Windows: 1 | ダーティー領域を使用するかどうか — ダーティー画面領域を使用するかどうかを指定します。有効にすると、グラバーは、画面からダーティー領域における新しいフレームを計算します。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| web-client-max-head-resolution | string | custom | (1920、1080) | ウェブクライアントの最大ヘッド解像度 — ウェブクライアントによってリクエストされるディスプレイヘッドの最大解像度。ディスプレイヘッドは、ホストモニターに相当します。この設定は、クライアントのレイアウトリクエストごとに再ロードされます。この設定は、ウェブクライアントが最大解像度を明示的に設定している場合に無視されます。最大ヘッド解像度の制限オプションは、このオプションで設定された最大幅と最大高の値の上に適用されます。値が (0、0) に設定されている場合は無視されます。— バージョン [2020.0-8428](doc-history-release-notes.md#release.2020.0-8428) から使用可能。 |
## `display/linux` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[display/linux]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `display/linux` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| disable-local-console | true または false - DWORD (32 ビット) | セッション | Linux: true - Windows: 1 | ローカル画面を空白にし、ローカル入力を禁止します (Xorg の Linux コンソールセッションのみ) — ローカルに接続されたモニターを空白にして、リモートクライアントが接続されている間は進行中の DCV コンソールセッションが表示されないようにし、ローカル入力デバイスを無効にします。モニターと入力デバイスは、最後のクライアントが切断されると再び有効になります。これにより、ローカルユーザーがリモートコンソールセッションに介入できなくなり、プライバシーが向上します。名前が "DCV " (スペースを含む) または "Xdcv " (スペースを含む) で始まる入力デバイスは、設定では無効になっていません。— バージョン [2024.0-17979](doc-history-release-notes.md#release.2024.0-17979) から利用可能。 |
| enable-console-scaling | true または false - DWORD (32 ビット) | セッション | Linux: false - Windows: 0 | フレームバッファのスケーリングを有効にして任意の解像度をサポート (Xorg の Linux コンソールセッションのみ) — フレームバッファからスキャンアウトバッファへの XRandR 変換を適切に設定することで、コンソールセッションの任意の解像度を許可します。"false" (デフォルト) に設定した場合は、レガシー動作が予想されます (ローカルに接続されたディスプレイで直接サポートされている解像度のみが許可されます)。"true" に設定した場合、クライアントは、物理的に接続されたディスプレイでサポートされているかどうかに関係なく、サーバーで任意の解像度をリクエストできます。— バージョン [2024.0-17979](doc-history-release-notes.md#release.2024.0-17979) から使用可能。 |
| gl-displays | string | セッション | [':0.0'] | 3D 高速 X ディスプレイ — 仮想セッションで OpenGL レンダリングに DCV が使用するローカル 3D 高速 X 表示および画面のリストを指定します。この値がない場合は、仮想セッションで OpenGL アプリケーションを実行できません。この設定は、コンソールセッションでは無視されます。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
## `extensions` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[extensions]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `extensions` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| enabled | true または false - DWORD (32 ビット) | connection | Linux: true - Windows: 1 | 拡張機能を有効にするかどうか - 拡張機能を有効にするかどうかを指定します。拡張機能が無効になっている場合、ユーザーは DCV にサードパーティー拡張機能を使用することはできません。— バージョン [2023.0-14852](doc-history-release-notes.md#release.2023.0-14852) から使用可能。 |
## `input` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[input]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `input` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| enable-autorepeat | true または false - DWORD (32 ビット) | セッション | Linux: true - Windows: 1 | Linux での自動リピートを許可するかどうか — 単一のキーに対して自動リピートを許可するかどうかを指定します。— バージョン [2017.2-6182](doc-history-release-notes.md#release.2017.2-6182) から使用可能。 |
| enable-gamepad | true または false - DWORD (32 ビット) | セッション | Linux: true - Windows: 1 | ゲームパッド入力を許可するかどうか — ゲームパッドを有効にするかどうかを指定します。— バージョン [2022.0-11954](doc-history-release-notes.md#release.2022.0-11954) から使用可能。 |
| enable-relative-mouse | true または false - DWORD (32 ビット) | セッション | Linux: true - Windows: 1 | 相対マウス移動を許可するかどうか — 相対マウス移動を許可するかどうかを指定します。— バージョン [2017.0-5121](doc-history-release-notes.md#release.2017.0-5121) から使用可能。 |
| enable-stylus | true または false - DWORD (32 ビット) | セッション | Linux: true - Windows: 1 | スタイラス入力を許可するかどうか — スタイラスを有効にするかどうかを指定します。— バージョン [2019.0-7318](doc-history-release-notes.md#release.2019.0-7318) から使用可能。 |
| enable-touch | true または false - DWORD (32 ビット) | セッション | Linux: true - Windows: 1 | タッチ入力を許可するかどうか — タッチを有効にするかどうかを指定します。— バージョン [2017.3-6698](doc-history-release-notes.md#release.2017.3-6698) から使用可能。 |
| use-server-keyboard-layout | string | connection | 'default-off' | キー解釈にサーバー側のキーボードレイアウトを使用するかどうかを制御する — キーボード入力でサーバー側のキーボードレイアウトを使用するか、クライアント側のキーボードレイアウトを使用するかを決定します。デフォルトでは「default-off」のクライアントレイアウトが使用されますが、ユーザーはサーバーレイアウトの使用を選択できます。デフォルトでは「default-on」のサーバーレイアウトが使用されますが、ユーザーはクライアントレイアウトの使用を選択できます。「always-off」のクライアントレイアウトが常に使用されるため、ユーザーの選択肢はありません。「always-on」のサーバーレイアウトが常に使用されるため、ユーザーの選択肢はありません。— バージョン 2025.0 以降で利用可能。 |
## `license` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[license]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `license` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| license-file | string | セッション | '' | ライセンス — EC2 以外のインスタンスで実行する場合に、DCV サーバーに使用するライセンスを指定します。ライセンスは RLM ライセンスによって付与されます。ライセンス仕様のリストを含めることができ、Windows では ';' で区切り、Linux では ':' で区切ります。各ライセンス仕様は、延長評価ライセンスの場合はローカルライセンスファイルに、フローティングライセンスの場合は「ポート@ホスト名」形式で指定された RLM サーバーのポートとホスト名にすることができます。複数のライセンスが指定されている場合、サーバーは最初のライセンスが検証されるまで (たとえば、ライセンスファイルが正しく認識されるか、リモート RLM サーバーに接続できるまで)、それぞれを順番に試行します。値が指定されていない場合、サーバーは Linux では '/usr/share/license.lic'、Windows では 'C:\$1Program Files\$1NICE\$1DCV\$1Server\$1license\$1license.lic' でデフォルトのライセンスファイルを検索します。デフォルトのライセンスファイルが見つからない場合は、デモライセンスが使用されます。このパラメータは EC2 インスタンスでは無視されます。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
## `log` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[log]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `log` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| directory | string | server | '' | ログ出力ディレクトリ — ログの保存先を指定します。指定しない場合、デフォルトは Windows では「C:\$1ProgramData\$1NICE\$1DCV\$1log\$1」、Linux では「/var/log/dcv/」です。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| enable-image-audit | true または false - DWORD (32 ビット) | server | Linux: false - Windows: 0 | 転送された画像のコンテンツ監査を有効にする — 転送された画像のコンテンツを別のファイルに保存する必要があるかどうかを指定します。画像はログサブディレクトリに保存され、ファイル名は監査 CSV ファイルで報告されます。transfer-audit が無効にされている場合、値は無視されます。— バージョン [2023.0-14852](doc-history-release-notes.md#release.2023.0-14852) から使用可能。 |
| level | string | custom | 'info' | ログレベル — ログファイルの詳細レベルを指定します。詳細レベル (詳細度が高い順) は、 'error'、'warn'、'info'、'debug' です。新しい値は、設定上で変更され、DCV エージェントプロセスに伝播されるとすぐに有効になります。バージョン <= 2019.1 の場合、DCV エージェントプロセスのログレベルは、開始時にのみ設定されます。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| max-file-size | integer - DWORD (32 ビット) | server | 0 | ローテーション前の最大ログファイルサイズ (メガバイト) — ローテーションがトリガーされる前の最大ログファイルサイズを指定します。値が '0' の場合、サイズによるローテーションは無効になり、ファイルを生成するプロセスが再開したときにファイルがローテーションされます。— バージョン [2022.1-13067](doc-history-release-notes.md#release.2022.1-13067) から使用可能。 |
| rotate | integer - DWORD (32 ビット) | server | 10 | ログファイルのローテーションの数 — 削除される前にログファイルがローテーションされる回数を指定します。値を 0 にした場合、古いバージョンはローテーションされずに削除されます。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| rotation-interval | string | server | 'none' | 2 回連続するログファイルローテーションの最大時間間隔 — 2 回連続するログファイルローテーションの最大時間間隔を指定します。値が 'none' の場合、ファイルは時間に基づいてローテーションされません。他に指定できる値は、'every-minute'、'every-twenty-minutes'、'every-hour'、'every-day' です。— バージョン [2022.1-13067](doc-history-release-notes.md#release.2022.1-13067) から使用可能。 |
| rotation-suffix | string | server | 'counter' | ローテーションされたログファイルに追加するサフィックス — ローテーションされたログファイルに追加するサフィックスを指定します。'counter' を指定すると、ローテーションされる各ログファイルに、単純に増加するカウンターのサフィックスが追加されます。'timestamp' を指定すると、'YYYY-MM-DD-HH-MM' 形式のタイムスタンプがログファイルに適用されます。そのタイムスタンプが適用されたローテーションするファイルがログフォルダにすでに存在する場合は、タイムスタンプに数値カウンターが追加されます。— バージョン [2022.1-13067](doc-history-release-notes.md#release.2022.1-13067) から使用可能。 |
| transfer-audit | string | server | 'none' | 監査を転送する方向 — 監査を転送する方向を指定します。このパラメータが有効になっている場合、新しい CSV ファイルのログはサーバーとクライアント間で転送されます。指定できる値は「none」、「server-to-client」、「client-to-server」、「all」です。この値が設定されていないか、「none」でない場合、転送監査は無効になり、ファイルは作成されません。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
## `printer` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[printer]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `printer` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| file-printer-name | string | カスタム | 'DCV printer' | ファイルダウンロード用の仮想 DCV プリンターの名前 — DCV サーバー上の仮想 DCV プリンターの名前を表す文字列です。Linux では、この値は新しい Linux DCV セッションが作成されるたびに設定から読み取られます。この設定が空ではなく、値に PREFIX という文字列が含まれている場合、'PREFIX-SESSION-NUMBER' という名前の新しい仮想プリンターが CUPS に登録されます。この設定が空の場合、仮想 DCV プリンターは登録されません。Windows では、この設定はシステムのデフォルトプリンターを変更するために使用されます。空の文字列に設定すると、DCV によって現在の既定のプリンターは変更されません。— バージョン [2022.0-11954](doc-history-release-notes.md#release.2022.0-11954) から使用可能。 |
| use-default-printer | string | カスタム | 'client-decides' | デフォルトプリンターの設定方法を決定する — どのプリンターをデフォルトプリンターとして設定するかをサーバーが決定します 指定できる値は、'client-decides'、'always-on'、'always-off' です。この設定の値が 'always-off' の場合、サーバーはいずれのプリンターもデフォルトとして設定しません。値が 'always-on' の場合、'printer' セクションの 'file-printer-name' 設定で指定されているプリンターを設定します。値が 'client-decides' の場合、クライアントから送信されたデフォルトプリンターが設定されます。クライアントからデフォルトプリンタが送信されない場合、'printer' セクションの 'file-printer-name' で指定されているプリンタが設定されます。デフォルト値は 'client-decides' です。現在 Windows でのみサポートされています。— バージョン [2022.2-13907](doc-history-release-notes.md#release.2022.2-13907) から使用可能。 |
## `redirection` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[redirection]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `redirection` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| enable-timezone-redirection | string | セッション | 'client-decides' | クライアントからサーバーへのタイムゾーンのリダイレクトを許可または拒否 — クライアントからサーバーへタイムゾーンがリダイレクトされることを許可または拒否します。指定できる値は、'always-on'、'always-off'、'client-decides' です。'always-on' に設定すると、優先ユーザークライアントがタイムゾーンをサーバーに送信し、それがサーバーのタイムゾーンに設定されます。'always-off' に設定すると、サーバーはクライアントに独自のタイムゾーンを表示します。クライアントのタイムゾーンメッセージはすべて破棄されます。'client-decides' に設定すると、優先ユーザークライアントが自分のタイムゾーンをサーバーに送信でき、それがサーバーのタイムゾーンに設定されます。クライアントは、自分のタイムゾーンをサーバーに送信しないことも選択できます。デフォルト値は 'client-decides' です。— バージョン [2022.2-13907](doc-history-release-notes.md#release.2022.2-13907) から使用可能。 |
## `security` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[security]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `security` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| allowed-http-host-regex | string | server | '^.\$1\$1' | 許可されたホストの正規表現 — この DCV サーバーで処理可能なホスト名を表す正規表現パターンを指定します。着信 HTTP リクエストのホストヘッダーがこのパターンに一致していない場合、リクエストそのものが、HTTP 403 (禁止) ステータスコードで失敗します。これは、HTTP ホストヘッダー攻撃を回避するためのセキュリティ対策です。Javascript のように有効な正規表現のパターンである必要があります。パターンの文字は、大文字と小文字の両方に一致します。例: '^(www\$1.)?example\$1.com\$1' — バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| allowed-ws-origin-regex | string | server | '^https://.\$1\$1' | 許可されたオリジン — この DCV サーバーが受け入れるオリジンを表す正規表現パターンを指定します。WebSocket 接続を確立する際、クライアントハンドシェイクのオリジンヘッダーフィールドは、接続を確立するスクリプトのオリジンを示します。着信 HTTP リクエストのオリジンヘッダーがこのパターンに一致していない場合、リクエストそのものが、HTTP 403 (禁止) ステータスコードで失敗します。これは、クロスサイトの WebSocket ハイジャック (CSWSH) 攻撃を回避するためのセキュリティ対策です。Javascript のように有効な正規表現のパターンである必要があります。パターンの文字は、大文字と小文字の両方に一致します。オリジンヘッダーの形式は "://" [ ":" ] です。例: '^https://(www\$1.)?example\$1.com(:443)?\$1'。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| auth-connection-setup-timeout | integer - DWORD (32 ビット) | server | 120 | 認証チャネル接続セットアップのタイムアウト — タイムアウトまでに認証チャネル接続セットアップ手順の完了に費やす時間 (秒) を指定します。手順にこれ以上の時間がかかった場合、チャネルは閉じられます。0 に設定すると、認証チャネル接続セットアップのタイムアウトは無効になります。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| auth-token-verifier | string | server | '' | 認証トークンの検証装置のエンドポイント — DCV サーバーで使用される認証トークンの検証装置のエンドポイント (URL) を指定します。空にすると、内部認証トークンの検証装置が使用されます。空でない場合、エンドポイントへの有効な変更はすぐに適用されます。サーバーを再起動する必要はありません (再起動せずに空に変更することはできません)。— バージョン 2017.0-4100 [から使用可能](doc-history-release-notes.md#release.2017.0-4100)。 |
| auth-token-verifier-timeout | integer - DWORD (32 ビット) | server | 100 | 認証トークン検証装置のタイムアウト (秒単位) — DCV サーバーによって認証トークン検証装置が使用されるのを待つ時間 (秒単位) を指定します。— バージョン [2023.0-14852](doc-history-release-notes.md#release.2023.0-14852) から使用可能。 |
| 認証 | string | server | 'system' | 認証メソッド — DCV サーバーで使用されるクライアント認証方法を指定します。クライアント認証を基盤となるオペレーティングシステムに委任するには、「system」を使用します。クライアント認証を無効にし、すべてのクライアントへのアクセスを付与するには、「none」を使用します。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| authentication-threshold | integer - DWORD (32 ビット) | server | 3 | 認証しきい値 — サーバーの接続が閉じられるまでの各クライアントの認証試行回数を指定します。試行回数を無制限に設定するには、0 を使用します。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| ca-file | string | カスタム | '' | CA ファイル — DCV サーバーで信頼されている認証機関 (CA) を含むファイルを指定します。空にすると、システムによって提供されるデフォルトの信頼ストアが使用されます。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| certificate-to-user-file | string | カスタム | '' | 証明書からユーザーへのマッピングファイル — 証明書からユーザーへのマッピングリストを含むファイルを指定します。— バージョン [2022.0-11954](doc-history-release-notes.md#release.2022.0-11954) から使用可能。 |
| ciphers | string | server | 'ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384' | TLS 接続で使用される暗号リスト — TLS 接続で使用する暗号リストを指定します。暗号は、「:」文字を使用して区切る必要があります。また、openssl とクライアントでサポートされている必要があります。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| connection-estab-timeout | integer - DWORD (32 ビット) | server | 5 | 接続確立のタイムアウト — タイムアウトまでに接続手順の完了に費やす時間 (秒) を指定します。手順にこれ以上の時間がかかった場合、接続は閉じられます。0 に設定すると、接続の確立はタイムアウトしません。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| connection-setup-timeout | integer - DWORD (32 ビット) | server | 5 | チャネル接続セットアップのタイムアウト — タイムアウトまでにチャネル接続セットアップ手順の完了に費やす時間 (秒) を指定します。手順にこれ以上の時間がかかった場合、チャネルは閉じられます。0 に設定すると、チャネル接続セットアップはタイムアウトしません。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| crl-file | string | カスタム | '' | CRL ファイル — 証明書失効リスト (CRL) を含むファイルを指定します。— バージョン [2022.0-11954](doc-history-release-notes.md#release.2022.0-11954) から使用可能。 |
| enable-gssapi | true または false - DWORD (32 ビット) | server | Linux: false - Windows: 0 | GSSAPI SASL メカニズムを有効にする — Kerberos を使用して DCV 認証を可能にする GSSAPI SASL メカニズムを有効または無効にします。— バージョン [2017.3-6698](doc-history-release-notes.md#release.2017.3-6698) から使用可能。 |
| max-connections-per-user | integer - DWORD (32 ビット) | server | 10 | ユーザーの最大接続数 — ユーザーあたりに許可される同時接続の最大数を指定します。この数を超えると接続は拒否されます。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| no-tls-strict | true または false - DWORD (32 ビット) | カスタム | Linux: false - Windows: 0 | 厳格な証明書検証を有効または無効にする — 外部認証トークンの検証装置に接続する際、厳格な証明書検証を有効または無効にします。認証トークンの検証装置で自己署名証明書が使用される場合は厳格な認証の検証を無効にする必要があります。このパラメータの変更はすぐに適用されます。サーバーを再起動する必要はありません。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| os-auto-lock | true または false - DWORD (32 ビット) | セッション | Linux: true - Windows: 1 | 最後のクライアント接続が終了したときに OS セッションをロックするかどうか — 有効にすると、最後のクライアント接続が閉じられたときに、OS セッションがロックされます。— バージョン [2017.1-5777](doc-history-release-notes.md#release.2017.1-5777) から使用可能。 |
| pam-service-name | string | server | 'dcv' | PAM サービス名 — DCV で使用される PAM 設定ファイルの名前を指定します。デフォルトの PAM サービス名は「dcv」であり、/etc/pam.d/dcv 設定ファイルに該当します。このパラメータは、「system」の認証メソッドを使用する場合にのみ使用されます。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| passwd-file | string | server | '' | パスワードファイル — ユーザーの認証情報を確認するために使用するパスワードファイルを指定します (dcv 認証モードの場合のみ)。空にすると、\$1\$1XDG\$1CONFIG\$1HOME\$1/NICE/dcv/passwd (Linux の場合)、%CSIDL\$1LOCAL\$1APPDATA%\$1NICE\$1dcv\$1passwd (Windows の場合) のデフォルトファイルが使用されます。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| server-fqdn | string | server | '' | サーバー FQDN — サーバーの完全修飾ドメイン名。空は gethostname() を意味します。— バージョン [2017.3-6698](doc-history-release-notes.md#release.2017.3-6698) から使用可能。 |
| service-name | string | server | 'dcv' | サービス名 — サービスの登録名 (通常はプロトコル名)。— バージョン [2020.0-8428](doc-history-release-notes.md#release.2020.0-8428) から使用可能。 |
| supervision-control | string | カスタム | 無効 | セッションの監視制御のタイプ — セッションの監視制御のタイプを指定します 指定できる値は 'disabled' と 'enforced' です。この値を 'enforced' に設定すると、監視対象外アクセス権を設定して、コラボレーションセッションのユーザーによる所有者なしのアクセスを許可または拒否できます。ユーザーに監視対象外アクセスを許可すると、ユーザーは所有者なしでセッションにアクセスできます。デフォルトでは、所有者を除くすべてのユーザーに対してこの権限が拒否されます。この値が 'disabled' (デフォルト) に設定されている場合、サーバーはこの監視制御と権限を適用しません。新しい値は、設定で変更されるとすぐに有効になります。— バージョン [2021.3-11591](doc-history-release-notes.md#release.2021.3-11591) から使用可能。 |
| user-realm | string | server | '' | サーバーユーザー領域 — サーバーのユーザー領域を指定します。— バージョン [2017.3-6698](doc-history-release-notes.md#release.2017.3-6698) から使用可能。 |
## `session-management` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[session-management]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `session-management` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| create-session | true または false - DWORD (32 ビット) | server | Linux: false - Windows: 0 | サーバースタートアップ時にコンソールセッションを作成する — サーバースタートアップ時に自動的にコンソールセッション (ID 「console」を使用) が起動されるようにするかどうかを指定します。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| enable-gl-in-virtual-sessions | string | セッション | 'default-on' | dcv-gl 機能を使用するかどうか — dcv-gl 機能を使用するかどうかを指定します (要ライセンス)。使用できる値: 'always-on'、'always-off'、'default-on'、'default-off'。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| max-concurrent-clients | integer - DWORD (32 ビット) | セッション | -1 | セッションあたりの最大同時クライアント数 — セッションあたりの最大同時クライアント数を指定します。-1 に設定すると、制限は適用されません。自動セッションにのみ制限を設定するには、「session-management/automatic-console-session」セクションの「max-concurrent-clients」を使用します。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| max-concurrent-sessions | integer - DWORD (32 ビット) | server | 0 | 同時セッションの最大数 — 許可される同時セッションの最大数を指定します。コンソールセッションは本質的に 1 つに制限されているため、この制限は現在、仮想セッションにのみ適用されます。制限を強制しない場合は、0 を指定します。— バージョン [2019.0-7318](doc-history-release-notes.md#release.2019.0-7318) から使用可能。 |
| max-sessions-per-user | integer - DWORD (32 ビット) | server | 0 | ユーザーあたりの最大セッション数 - 各ユーザーが所有できる同時セッションの最大数を指定します。この制限は現在、仮想セッションにのみ適用されます。制限を強制しない場合は、0 を指定します。— バージョン [2021.0-10242](doc-history-release-notes.md#release.2021.0-10242) から使用可能。 |
| performance-profile | string | カスタム | 'none' | 一部の機能の初期化中に使用されるプロファイルを指定 — インスタンスのパフォーマンスプロファイルに従って、一部の機能のデフォルト設定を調整します。プロファイルが選択されていない場合、プロファイルは CPU の数および GPU が存在するかどうかに応じて自動的に推定されます。使用できる値は、「low」、「medium」、「high」、「none」です。— バージョン [2024.0-17979](doc-history-release-notes.md#release.2024.0-17979) から使用可能。 |
| virtual-session-default-layout | string | セッション | [] | 仮想セッションのデフォルトのレイアウト — これが設定されている場合、Xdcv はスタートアップ時に指定したレイアウトを作成するように設定されます。モニタごとに、解像度 (w,h) と位置 (x,y) で設定できます。指定されたモニタはすべて、有効になります。デフォルトレイアウトの値の例: [\$1'w': <800>, 'h': <600>, 'x <0>':, 'y': <0>\$1, \$1'w <1024>': <768>, 'h': <800>, 'x':, 'y': <0>\$1] この設定では、モニターの最大数 (virtual-session-monitors 設定で指定) は、配列内の要素数よりも優先されます。たとえば、5 つのモニターが設定されていて、モニターの最大数が 4 の場合、最初の 4 つのモニターだけが作成されます。このキーを設定すると、有効になっているモニターの数 (virtual-session-monitors 設定で指定) は無視されます。— バージョン [2017.0-5600](doc-history-release-notes.md#release.2017.0-5600) から使用可能。 |
| virtual-session-font-path | string | セッション | '' | 特殊なフォントのパスを追加するかどうか — 特殊なフォントのパスを指定します。アプリケーションによっては、特殊なフォントを X サーバーに渡す必要がある場合があります。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| virtual-session-source-profile | true または false - DWORD (32 ビット) | セッション | Linux: false - Windows: 0 | 初期仮想セッションのセットアップ時にユーザープロファイルをソースにするかどうか — init スクリプト実行用の環境を設定するときに、DCV がユーザープロファイルをソースにするかどうかを制御します。false (デフォルト) に設定すると、DCV は「bash --noprofile --norc」で init スクリプトを実行します。なお、これは DCV の初期環境設定にのみ影響します。init スクリプト (デフォルトまたはカスタム) は、セッションのスタートアップ中にプロファイルを個別にソースにする場合があります。— バージョン [2021.3-11591](doc-history-release-notes.md#release.2021.3-11591) から使用可能。 |
| virtual-session-xdcv-args | string | セッション | '' | Xdcv に渡す追加の引数 — 必要に応じて、Xdcv に渡す追加の引数を指定します。— バージョン [2017.0-4334](doc-history-release-notes.md#release.2017.0-4334) から使用可能。 |
## `session-management/automatic-console-session` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[session-management/automatic-console-session]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `session-management/automatic-console-session` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| client-eviction-policy | string | server | 'reject-new-connection' | 制限に達した場合のクライアント接続の処理方法を指定する — セッションあたりの同時接続クライアントの最大数に達した場合に、新しい接続を拒否するか、既存の接続を自動的に終了するかを指定します。許可される値は 'reject-new-connection' (着信接続は拒否される) と 'same-user-oldest-connection' (サーバーは、同じユーザーの接続のうちセッションと最も長い時間通信していない接続か、その情報がない場合は接続時間が最も古いものを終了する) です。— バージョン [2022.1-13067](doc-history-release-notes.md#release.2022.1-13067) から使用可能。 |
| max-concurrent-clients | integer - DWORD (32 ビット) | server | -1 | セッションあたりの最大同時クライアント数 — セッションごとに許可する最大同時クライアント数を指定します。-1 に設定すると、制限は適用されません。— バージョン [2017.0-5600](doc-history-release-notes.md#release.2017.0-5600) から使用可能。 |
| 所有者 | string | server | '' | 自動作成された「console」セッションの所有者 — 「console」セッションの所有者のユーザーネームを指定します。空にすると、DCV サーバーを起動したユーザーが所有者になります。この設定は、サーバー起動時に自動的に作成した「console」セッションにのみ適用されます (create-session 設定を true にした場合)。— バージョン [2017.0-5600](doc-history-release-notes.md#release.2017.0-5600) から使用可能。 |
| permissions-file | string | server | '' | 「console」の自動セッションのアクセス許可ファイル — ユーザーによる DCV 機能へのアクセスを確認するために使用するアクセス許可ファイルへのパスを指定します。空にすると、所有者にセッションへのフルアクセスが許可されます。— バージョン [2017.0-5600](doc-history-release-notes.md#release.2017.0-5600) から使用可能。 |
| storage-root | string | server | '' | ファイルストレージのルートフォルダへのパス — コンソールセッションストレージに使用されるフォルダの完全パスを指定します。storage-root が空の場合や、フォルダが存在しない場合、ファイルストレージは無効になります。— バージョン [2017.0-5600](doc-history-release-notes.md#release.2017.0-5600) から使用可能。 |
## `session-management/defaults` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[session-management/defaults]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `session-management/defaults` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| permissions-file | string | セッション | '' | すべてのセッションに含まれるデフォルトのアクセス許可 — 各セッション用にユーザーによって選択されるアクセス許可に自動的にマージされるアクセス許可ファイルへのパスを指定します。空にすると、'default.perm' ファイルが使用されます。このファイルは、/etc/dcv/ (Linux の場合)、または DCV のインストールフォルダ (例: 'C:\$1Program Files\$1NICE\$1DCV\$1Server\$1conf') (Windows の場合) にあります。— バージョン [2017.0-5600](doc-history-release-notes.md#release.2017.0-5600) から使用可能。 |
## `smartcard` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[smartcard]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `smartcard` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| enable-cache | string | custom | 'default-on' | スマートカードキャッシュメッセージを有効にするかどうか — スマートカードキャッシュを有効または無効にします。有効にすると、DCV サーバーは、クライアントのスマートカードから受信した最後の値をキャッシュします。その後の呼び出しでは、クライアントからではなく、サーバーのキャッシュから直接取得されます。これにより、クライアントとサーバー間で転送されるトラフィックの量が削減されるため、パフォーマンスが向上します。使用できる値には、'always-on'、'always-off'、'default-on'、'default-off' が含まれます。この値は、クライアントスマートカードアプリケーションが起動されるたびに設定から読み取られます。— バージョン [2017.2-6182](doc-history-release-notes.md#release.2017.2-6182) から使用可能。 |
## `webauthn` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[webauthn]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `webauthn` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| enabled | true または false - DWORD (32 ビット) | セッション | Linux: true - Windows: 1 | Webauthn リダイレクト機能を有効にするかどうか — この設定は、WebAuthn リクエストのリダイレクトを制御します。有効にすると、ユーザーは YubiKey 、Windows Hello など、ローカル認証ツールを使用してウェブリソースを認証できます。この設定を無効にすると、WebAuthn リダイレクトは無効になり、ユーザーはローカル認証機能を利用できません。— バージョン [2023.1-16220](doc-history-release-notes.md#release.2023.1-16220) から使用可能。 |
## `webcam` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[webcam]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `webcam` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| max-resolution | string | connection | (0, 0) | ウェブカメラの最大解像度 — クライアントが提供する解像度の中から、選択可能な、アプリケーションに適用されるウェブカメラの最大解像度を指定します。この値が欠落している、または (0、0) の場合は、デフォルト値が使用されます。デフォルト値: 高中程度のパフォーマンスプロファイルの場合は 1280x720、低パフォーマンスプロファイルの場合は 640x480。— バージョン [2021.0-10242](doc-history-release-notes.md#release.2021.0-10242) から使用可能。 |
| preferred-resolution | string | connection | (0, 0) | 好ましいウェブカメラの解像度— クライアントによって提供される解像度のうち、優先するウェブカメラの解像度を指定します。指定した解像度がサポートされていない場合は、一致する解像度のうち最も近いものが選択されます。この値が欠落している、または (0, 0) の場合は、デフォルト値が使用されます。デフォルト値: 高中程度のパフォーマンスプロファイルの場合は 640x360、低パフォーマンスプロファイルの場合は 424x240。— バージョン [2021.0-10242](doc-history-release-notes.md#release.2021.0-10242) から使用可能。 |
## `windows` パラメータ
以下の表に、Linux Amazon DCV サーバーの `/etc/dcv/dcv.conf` ファイルの `[windows]` セクションの設定パラメータと、Windows Amazon DCV サーバーの `windows` レジストリキーを示します。
| パラメータ | タイプ - Windows レジストリの種類 | コンテキストの再ロード | デフォルト値: | 説明 |
| --- | --- | --- | --- | --- |
| disable-display-sleep | true または false - DWORD (32 ビット) | セッション | Linux: true - Windows: 1 | ディスプレイが省電力モードになるのを防ぐ — ディスプレイが省電力モードにならないようにするかどうかを指定します。— バージョン [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) から使用可能。 |
| printer | string | セッション | '' | プリンターをデフォルトとして設定する — 仮想 DCV プリンターの名前を指定します。この名前を使用してシステムのデフォルトプリンターを変更します。空の文字列に設定すると、DCV によって現在の既定のプリンターは変更されません。非推奨: 'プリンター' セクションの 'file-printer-name' を使用。— バージョン 2017.0-4100 [から使用可能](doc-history-release-notes.md#release.2017.0-4100)。 |
# 設定パラメータの変更
このセクションでは、Amazon DCV サーバーの設定パラメータを変更する方法について説明します。Windows サーバーのレジストリキー、Linux サーバーのセクション、パラメータの名前、タイプ、有効値の詳細については、「[Amazon DCV サーバーパラメータリファレンス](config-param-ref.md)」を参照してください。
**Topics**
+ [Windows Amazon DCV サーバー](#config-param-ref-win)
+ [Linux Amazon DCV サーバー](#config-param-ref-linux)
+ [macOS Amazon DCV サーバー](#config-param-ref-macos)
## Windows Amazon DCV サーバー
Windows Amazon DCV サーバーの場合は、Windows レジストリエディタ、PowerShell、またはコマンドラインを使用して設定パラメータを変更します。
**Windows レジストリエディタを使用して設定パラメータを変更するには**
1. Windows レジストリエディタを開きます。
1. 以下のレジストリパスに移動します。
```
HKEY_USERS\S-1-5-18\Software\GSettings\com\nicesoftware\dcv\
```
1. パラメータがあるレジストリキーを選択します。そのレジストリキーがない場合は、「[Amazon DCV サーバーパラメータリファレンス](config-param-ref.md)」に説明されている正確なキー名を使用して作成します。
1. そのパラメータを開きます (ダブルクリックします)。そのパラメータがない場合は、「[Amazon DCV サーバーパラメータリファレンス](config-param-ref.md)」に説明されているタイプと名前を使用して作成します。
**PowerShell を使用して設定パラメータを変更するには**
1. 管理者として PowerShell を実行します。
1. 「[Amazon DCV サーバーパラメータリファレンス](config-param-ref.md)」に説明されているキー名を使用して、レジストリキーを追加します。
```
PS C:\> New-Item -Path "Microsoft.PowerShell.Core\Registry::\HKEY_USERS\S-1-5-18\Software\GSettings\com\nicesoftware\dcv\" -Name registry_key -Force
```
1. 「[Amazon DCV サーバーパラメータリファレンス](config-param-ref.md)」に説明されているタイプと名前を使用して、レジストリキーにパラメータを作成します。
```
PS C:\> New-ItemProperty -Path "Microsoft.PowerShell.Core\Registry::\HKEY_USERS\S-1-5-18\Software\GSettings\com\nicesoftware\dcv\registry_key" -Name parameter_name -PropertyType parameter_type -Value parameter_value -Force
```
**コマンドラインを使用して起動設定を変更するには**
1. 管理者としてコマンドラインを実行します。
1. 「[Amazon DCV サーバーパラメータリファレンス](config-param-ref.md)」に説明されているキー名、パラメータのタイプと名前を使用して、レジストリキーを作成し、パラメータを追加します。
```
C:\> reg.exe ADD "HKEY_USERS\S-1-5-18\Software\GSettings\com\nicesoftware\dcv\registry_key" /v parameter_name /t parameter_type /d parameter_value /f
```
## Linux Amazon DCV サーバー
Linux Amazon DCV サーバーの場合、設定パラメータはテキストエディタや **crudini** などのコマンドラインツールを使用して変更できます。
**テキストエディタを使用して設定パラメータを変更するには**
1. お好みのテキストエディタを使用して`/etc/dcv/dcv.conf`を開きます。
1. そのファイルで該当するセクションを見つけます。そのセクションがない場合は、「[Amazon DCV サーバーパラメータリファレンス](config-param-ref.md)」に説明されているセクション名を使用して追加します。
```
[section]
```
1. そのセクションでパラメータを見つけ、値を変更します。そのパラメータがセクションにない場合は、「[Amazon DCV サーバーパラメータリファレンス](config-param-ref.md)」に説明されているパラメータ名を使用して追加します。
```
parameter_name="parameter_value"
```
1. ファイルを保存して閉じます。
**crudini を使用して設定パラメータを変更するには**
「[Amazon DCV サーバーパラメータリファレンス](config-param-ref.md)」に説明されているセクション名とパラメータ名を使用して、セクションを作成し、パラメータを追加します。
```
$ sudo crudini --set /etc/dcv/dcv.conf section_name parameter_name 'parameter_value'
```
## macOS Amazon DCV サーバー
macOS Amazon DCV サーバーの場合、設定パラメータはテキストエディタまたは **crudini** などのコマンドラインツールを使用して変更できます。
**テキストエディタを使用して設定パラメータを変更するには**
1. お好みのテキストエディタを使用して`/etc/dcv/dcv.conf`を開きます。
1. そのファイルで該当するセクションを見つけます。そのセクションがない場合は、「[Amazon DCV サーバーパラメータリファレンス](config-param-ref.md)」に説明されているセクション名を使用して追加します。
```
[section]
```
1. そのセクションでパラメータを見つけ、値を変更します。そのパラメータがセクションにない場合は、「[Amazon DCV サーバーパラメータリファレンス](config-param-ref.md)」に説明されているパラメータ名を使用して追加します。
```
parameter_name="parameter_value"
```
1. ファイルを保存して閉じます。
**crudini を使用して設定パラメータを変更するには**
「[Amazon DCV サーバーパラメータリファレンス](config-param-ref.md)」に説明されているセクション名とパラメータ名を使用して、セクションを作成し、パラメータを追加します。
```
$ sudo crudini --set /etc/dcv/dcv.conf section_name parameter_name 'parameter_value'
```