本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon DCV Server 參數參考
<a name="config-param-ref"></a>

下表列出可設定為自訂 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` 參數
<a name="audio"></a>

 下表說明 Linux Amazon DCV 伺服器 `/etc/dcv/dcv.conf` 檔案的 `[audio]`區段中的組態參數，以及 Windows Amazon DCV 伺服器的`audio`登錄機碼。


| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 | 
| --- | --- | --- | --- | --- | 
| avsync-support | string | 工作階段 | 'auto' | 判斷用戶端是否可以啟用音訊/視訊同步 — 允許連接的用戶端啟用音訊/視訊同步。有效值為 'enabled'、'disabled' 或 'auto' (default='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` 參數
<a name="clipboard"></a>

 下表說明 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，否則會套用兩個值的最小值。— 從 [2023.0-14852](doc-history-release-notes.md#release.2023.0-14852) 版開始提供。 | 
| max-payload-size-paste | integer - DWORD (32 位元） | 工作階段 | -1 | 剪貼簿資料的大小上限 — 指定可以從用戶端傳輸到伺服器的剪貼簿資料大小上限 （以位元組為單位）。如果此值遺失，則會考慮max-payload-size，否則會套用兩個值的最小值。— 從 [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，否則會套用兩個值的最小值。— 從 [2023.0-14852](doc-history-release-notes.md#release.2023.0-14852) 版開始提供。 | 
| max-text-len-paste | integer - DWORD (32 位元） | 工作階段 | -1 | 剪貼簿文字的字元數上限 — 指定可以從用戶端傳輸到伺服器的剪貼簿文字字元數上限。多餘的字元將被截斷。如果此值遺失，則會考慮 max-text-len，否則會套用兩個值的最小值。— 從 [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` 參數
<a name="connectivity"></a>

 下表說明 Linux Amazon DCV 伺服器 `/etc/dcv/dcv.conf` 檔案的 `[connectivity]`區段中的組態參數，以及 Windows Amazon DCV 伺服器的`connectivity`登錄機碼。


| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 | 
| --- | --- | --- | --- | --- | 
| disconnect-on-lock | true 或 false - DWORD (32 位元） | 自訂 | Linux：false - Windows：0 | 用戶端是否在作業系統工作階段鎖定時中斷連線 — 啟用此選項可在遠端作業系統工作階段鎖定時強制用戶端中斷連線。否則，用戶端將繼續串流遠端工作階段。目前僅主控台工作階段支援 。此參數值會在每次遠端作業系統工作階段鎖定時讀取。— 自 2023.1-16220 版起提供。 [](doc-history-release-notes.md#release.2023.1-16220) | 
| disconnect-on-logout | true 或 false - DWORD (32 位元） | 自訂 | Linux：false - Windows：0 | 用戶端是否在作業系統使用者登出時中斷連線 — 啟用此選項可在遠端作業系統使用者登出 （即作業系統工作階段關閉） 時強制中斷用戶端連線。否則，用戶端將繼續串流遠端工作階段。目前僅主控台工作階段支援 。每個遠端作業系統使用者登出都會讀取此參數值。— 從 [2023.1-16220](doc-history-release-notes.md#release.2023.1-16220) 版開始提供。 | 
| enable-quic-frontend | true 或 false - DWORD (32 位元） | 伺服器 | Linux：true - Windows：1 | 是否啟用 QUIC 前端 — 指定是否應啟用 QUIC 前端。— 從 [2020.2-9508](doc-history-release-notes.md#release.2020.2-9508) 版開始提供。 | 
| idle-timeout | integer - DWORD (32 位元） | 自訂 | 60 | 閒置逾時 — 指定中斷閒置用戶端連線之前要等待的分鐘數。指定 0 則永遠不會中斷閒置用戶端。此參數值每秒讀取一次。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| idle-timeout-warning | integer - DWORD (32 位元） | 自訂 | 350 | 閒置逾時警告 — 指定閒置逾時的相對等待秒數，然後再警告閒置用戶端閒置逾時中斷連線。指定 0 永遠不會警告閒置用戶端。— 從 [2017.4-6898](doc-history-release-notes.md#release.2017.4-6898) 版開始提供。 | 
| quic-listen-endpoints | string | 伺服器 | 【'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 位元） | 伺服器 | 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 | 伺服器 | [] | 設定要新增至 HTTP/HTTPS 標頭的額外標頭陣列 — 用來新增額外的標頭。陣列應填充如下的耦合：【('header\$1name'，'header\$1content')】。您可以新增多個標頭。— 從 [2017.2-6182](doc-history-release-notes.md#release.2017.2-6182) 版開始提供。 | 
| web-listen-endpoints | string | 伺服器 | 【'0.0.0.0'、'：：'】 | 指定 DCV 接聽傳入 Web 連線的端點 — 指定 DCV 將接聽傳入 Web 連線的端點清單。端點可以是本機可繫結 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 位元） | 伺服器 | 8443 | 用戶端的 TCP 連接埠 — 指定 DCV 伺服器接聽用戶端連線的 TCP 連接埠。連接埠號碼必須為介於 1024 到 65535 的數字。如需如何套用此設定的更多詳細資訊，請參閱「web-listen-endpoints」設定。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| web-root | string | 伺服器 | '' | 內嵌 Web 伺服器的文件根 — 指定內嵌 Web 伺服器的文件根。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| web-url-path | string | 伺服器 | '/' | 內嵌 Web 伺服器的 URL 路徑 — 指定內嵌 Web 伺服器的 URL 路徑，必須以 '/' 開頭。例如，設定為 /test/foo 表示 Web 伺服器可在 https://host:port/test/foo 存取。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| web-use-hsts | true 或 false - DWORD (32 位元） | 伺服器 | Linux：true - Windows：1 | 是否使用 HSTS — 讓此選項強制瀏覽器防止透過 HTTP 傳送任何通訊。完全改用 HTTPS 來傳輸到網頁 (以及所有子網域)。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| web-x-frame-options | string | 伺服器 | 'DENY' | 設定 X-Frame-Options 值 — 預設值設定為 DENY。如果您變更此設定，您必須引進另一種形式的保護，以避免點擊劫持攻擊。如果您沒有其他保護，請勿變更此設定。— 從 [2017.1-5870](doc-history-release-notes.md#release.2017.1-5870) 版開始提供。 | 
| ws-keepalive-interval | integer - DWORD (32 位元） | 伺服器 | 10 | Websocket 保持連線間隔 — 指定傳送保持連線訊息的間隔 （以秒為單位）。如果設定為 0，則會停用保持連線訊息。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 

## `display` 參數
<a name="display"></a>

 下表說明 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 | 連線 | [] | 用於串流編碼的 CUDA 裝置 — 指定 DCV 用來分配編碼和 CUDA 工作負載的本機 CUDA 裝置清單。從 nvidia-smi 命令可擷取每個裝置的識別號碼。例如，cuda-devices=['0', '2'] 表示 DCV 使用兩個 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 編碼。如果為「一律開啟」，伺服器會偏好針對高色彩準確度進行最佳化的 YUV444 格式。如果為「永遠關閉」，伺服器會偏好針對串流效能進行最佳化的格式。值 '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 | 每秒影格擷取器的目標影格數 — 將上限設定為每秒擷取影格數。值 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 | 自訂 | (4096, 2160) | 最大頭解析度 — 設定用戶端可請求的顯示頭的最大解析度。顯示蓋等同於主機監視器。此設定隨著每次的用戶端配置要求而重新載入。當用戶端要求較大的顯示蓋解析度時，伺服器會調整解析度，以確保符合此選項所設定的最大寬度和高度值。支援的解析度值上限為 (4096、4096)。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| max-layout-area | integer - DWORD (32 位元） | 自訂 | 0 | 以像素為單位的最大配置區域 — 設定用戶端可請求之顯示配置的最大區域，以像素為單位。將會忽略超過此限制的配置。此最大值旨在提供必須傳送的顯示資料量上限，但不限制顯示器配置幾何。如果設為 0，則不限制配置面積。此設定隨著每次的用戶端配置要求而重新載入。— 從 [2019.1-7423](doc-history-release-notes.md#release.2019.1-7423) 版開始提供。 | 
| max-num-heads | integer - DWORD (32 位元） | 自訂 | 4 | 頭部數量上限 — 指定用戶端可請求的顯示頭部數量上限。顯示蓋等同於主機監視器。此設定隨著每次的用戶端配置要求而重新載入。當用戶端要求更多的顯示蓋時，伺服器會調整顯示蓋數目，以避免值超過此選項所設定的值。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| min-head-resolution | string | 自訂 | (640, 480) | 最小頭解析度 — 設定用戶端可請求的顯示頭的最小解析度。顯示蓋等同於主機監視器。此設定隨著每次的用戶端配置要求而重新載入。當用戶端要求較小的顯示蓋解析度時，伺服器會調整解析度，以確保符合此選項所設定的最小寬度和高度值。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| target-fps | integer - DWORD (32 位元） | 工作階段 | -1 | 每秒目標影格數 — 指定每秒允許的最大影格數。值為 0 表示沒有限制。值 -1 表示目標-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 | 自訂 | (1920, 1080) | Web 用戶端的最大頭解析度 — 設定 Web 用戶端可請求的顯示頭解析度上限。顯示蓋等同於主機監視器。此設定隨著每次的用戶端配置要求而重新載入。如果 Web 用戶端明確設定最大解析度，則會忽略此設定。max-head-resolution 限制選項優先於此選項所設定的最大寬度和高度值。如果值設為 (0, 0)，則會被忽略。— 從 [2020.0-8428](doc-history-release-notes.md#release.2020.0-8428) 版開始提供。 | 

## `display/linux` 參數
<a name="display_linux"></a>

 下表說明 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 顯示 — 指定 DCV 在虛擬工作階段中用於 OpenGL 轉譯的本機 3D 加速 X 顯示和畫面清單。如果缺漏此值，您無法在虛擬工作階段中執行 OpenGL 應用程式。主控台工作階段會忽略此設定。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 

## `extensions` 參數
<a name="extensions"></a>

 下表說明 Linux Amazon DCV 伺服器 `/etc/dcv/dcv.conf` 檔案的 `[extensions]`區段中的組態參數，以及 Windows Amazon DCV 伺服器的`extensions`登錄機碼。


| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 | 
| --- | --- | --- | --- | --- | 
| enabled | true 或 false - DWORD (32 位元） | 連線 | Linux：true - Windows：1 | 是否應啟用延伸功能 — 指定是否啟用延伸功能。如果停用擴充功能功能，使用者將無法為 DCV 使用第三方擴充功能。— 自 2023.0-14852 版開始提供。 [](doc-history-release-notes.md#release.2023.0-14852) | 

## `input` 參數
<a name="input"></a>

 下表說明 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 | 連線 | 「default-off」 | 控制是否使用伺服器端鍵盤配置進行金鑰解釋 — 決定鍵盤輸入是否使用伺服器端鍵盤配置或用戶端鍵盤配置。根據預設，使用「預設關閉」用戶端配置，但使用者可以選擇使用伺服器配置。預設會使用「預設」伺服器配置，但使用者可以選擇使用用戶端配置。一律使用「永遠關閉」用戶端配置時，沒有可用的使用者選擇。一律使用「永遠開啟」伺服器配置時，沒有可用的使用者選擇。— 從 2025.0 版開始提供。 | 

## `license` 參數
<a name="license"></a>

 下表說明 Linux Amazon DCV 伺服器 `/etc/dcv/dcv.conf` 檔案的 `[license]`區段中的組態參數，以及 Windows Amazon DCV 伺服器的`license`登錄機碼。


| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 | 
| --- | --- | --- | --- | --- | 
| license-file | string | 工作階段 | '' | 授權 — 指定在non-EC2 執行個體上執行時，用於 DCV 伺服器的授權。授權是透過 RLM 授權授予。它可以包含授權規格清單，在 Windows 上以 '；' 分隔，在 Linux 上以 '：' 分隔。每個授權規格都可以是延伸評估授權的本機授權檔案，或是以浮動授權的 PORT@HOSTNAME 格式指定的 RLM 伺服器連接埠和主機名稱。如果指定多個授權，伺服器將輪流嘗試每個授權，直到驗證第一個授權檔案 （例如，正確識別授權檔案或聯絡遠端 RLM 伺服器）。如果未指定任何值，伺服器會在 Linux 上尋找預設授權檔案 '/usr/share/license/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` 參數
<a name="log"></a>

 下表說明 Linux Amazon DCV 伺服器 `/etc/dcv/dcv.conf` 檔案的 `[log]`區段中的組態參數，以及 Windows Amazon DCV 伺服器的`log`登錄機碼。


| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 | 
| --- | --- | --- | --- | --- | 
| directory | string | 伺服器 | '' | 日誌輸出目錄 — 指定儲存日誌的目的地。如果未指定，則在 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 位元） | 伺服器 | Linux：false - Windows：0 | 啟用傳輸影像的內容稽核 — 指定是否必須將任何傳輸影像的內容儲存在單獨的檔案中。影像將儲存在日誌子目錄中，而檔案名稱將報告在稽核 CSV 檔案中。如果 Transfer-audit 已停用，則會忽略該值。— 從 [2023.0-14852](doc-history-release-notes.md#release.2023.0-14852) 版開始提供。 | 
| level | string | 自訂 | '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 位元） | 伺服器 | 0 | 輪換前以 MegaBytes 為單位的日誌檔案大小上限 — 指定輪換觸發前的日誌檔案大小上限。如果值為 '0'，則會停用依大小輪換，而是在重新排序產生檔案的程序時輪換檔案。— 從 [2022.1-13067](doc-history-release-notes.md#release.2022.1-13067) 版開始提供。 | 
| rotate | integer - DWORD (32 位元） | 伺服器 | 10 | 日誌檔案輪換次數 — 指定日誌檔案在移除之前輪換的次數。如果值為 0，會直接移除舊版本而不進行輪換。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| 輪換間隔 | string | 伺服器 | 'none' | 兩個連續日誌檔案輪換之間的最大時間間隔 — 指定兩個連續日誌檔案輪換之間的最大時間間隔。如果值為「無」，則檔案不會根據時間輪換。其他可能的值為「每分鐘」、「every-twenty-minutes」、「每小時」和「每天」。— 從 [2022.1-13067](doc-history-release-notes.md#release.2022.1-13067) 版開始提供。 | 
| 輪換尾碼 | string | 伺服器 | '計數器' | 要附加到輪換日誌檔案的尾碼 — 指定要附加到輪換日誌檔案的尾碼。如果指定「計數器」，則每個輪換的日誌檔案都會附加一個簡單的增加計數器尾碼。如果指定 'timestamp'，格式為 'YYYY-MM-DD-HH-MM' 的時間戳記會套用至日誌檔案。如果日誌資料夾中已存在具有該時間戳記的輪換檔案，則時間戳記會附加額外的數值計數器。— 自 2022.1-13067 版開始提供。 [](doc-history-release-notes.md#release.2022.1-13067) | 
| transfer-audit | string | 伺服器 | 'none' | 轉移方向至稽核 — 指定要稽核的轉移方向。如果啟用此參數，則會在伺服器和用戶端之間傳輸新的 CSV 檔案日誌。允許使用的值為：'none'、'server-to-client'、'client-to-server' 和 'all'。如果這個值遺失或等於 'none'，則會停用傳輸稽核且不會建立任何檔案。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 

## `printer` 參數
<a name="printer"></a>

 下表說明 Linux Amazon DCV 伺服器 `/etc/dcv/dcv.conf` 檔案的 `[printer]`區段中的組態參數，以及 Windows Amazon DCV 伺服器的`printer`登錄機碼。


| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 | 
| --- | --- | --- | --- | --- | 
| file-printer-name | string | 自訂 | 'DCV 印表機' | 用於檔案下載的虛擬 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」，則會設定從用戶端傳送的預設印表機。如果用戶端未傳送預設印表機，則會設定 'file-printer-name' 區段 'printer' 下指定的印表機。預設值為 'client-decides'。目前僅支援 Windows。— 自 2022.2-13907 版開始提供。 [](doc-history-release-notes.md#release.2022.2-13907) | 

## `redirection` 參數
<a name="redirection"></a>

 下表說明 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-off'，伺服器會向用戶端顯示自己的時區。將捨棄任何用戶端時區訊息。如果設定為「client-decides」，則優先使用者用戶端可以將時區傳送至伺服器，並成為伺服器的時區。用戶端可以選擇不將其時區傳送至伺服器。預設值為 'client-decides'。— 從 [2022.2-13907](doc-history-release-notes.md#release.2022.2-13907) 版開始提供。 | 

## `security` 參數
<a name="security"></a>

 下表說明 Linux Amazon DCV 伺服器 `/etc/dcv/dcv.conf` 檔案的 `[security]`區段中的組態參數，以及 Windows Amazon DCV 伺服器的`security`登錄機碼。


| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 | 
| --- | --- | --- | --- | --- | 
| allowed-http-host-regex | string | 伺服器 | '^.\$1\$1' | 允許主機規則表達式 — 指定規則表達式模式，代表此 DCV 伺服器可以提供的主機名稱。如果傳入的 HTTP 請求之 Host 標頭不符合此模式，請求本身會失敗並出現 403 禁止狀態碼。這是一個安全措施，旨在阻擋 HTTP Host 標頭攻擊。模式必須為有效且與 Javascript 類似的規則表達式。模式中的字母與大寫和小寫字母相符。範例：'^(www\$1.)？example\$1.com\$1'。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| allowed-ws-origin-regex | string | 伺服器 | '^https://.\$1\$1' | 允許原始伺服器 — 指定規則表達式模式，代表此 DCV 伺服器接受的原始伺服器。建立 WebSocket 連線時，用戶端交握的 Origin 標頭欄位會指出建立連接的指令碼來源。如果傳入的 HTTP 請求之來源標頭不符合此模式，請求本身會失敗並出現 403 禁止狀態碼。這是一個安全措施，旨在防止跨網站 WebSocket 攔截 (CSWSH) 攻擊。模式必須為有效且與 Javascript 類似的規則表達式。模式中的字母與大寫和小寫字母相符。Origin 標頭的格式：<scheme> "://" <host> [ ":" <port> ]。範例：'^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 位元） | 伺服器 | 120 | 身分驗證通道連線設定逾時 — 指定在逾時之前，允許完成身分驗證通道連線設定程序的時間量 （以秒為單位）。如果程序超過設定的時間，則會關閉該頻道。如果設定為 0，停用身分驗證頻道連線設定逾時。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| auth-token-verifier | string | 伺服器 | '' | 身分驗證字符驗證器的端點 — 指定 DCV 伺服器使用的身分驗證字符驗證器的端點 (URL)。如果為空，則會使用內部身分驗證符記驗證器。如果不是空的，則會立即套用端點的有效變更，而不需要重新啟動伺服器 （無法在未重新啟動的情況下變更為空）。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| auth-token-verifier-timeout | integer - DWORD (32 位元） | 伺服器 | 100 | 身分驗證字符驗證器的逾時 （以秒為單位）。— 指定等待 DCV 伺服器使用的身分驗證字符驗證器的時間 （以秒為單位）。— 從 [2023.0-14852](doc-history-release-notes.md#release.2023.0-14852) 版開始提供。 | 
| authentication | string | 伺服器 | 'system' | 身分驗證方法 — 指定 DCV 伺服器使用的用戶端身分驗證方法。使用 'system' 以將用戶端身分驗證委派給基礎作業系統進行。使用 'none' 以停用用戶端身分驗證並將存取授權給所有用戶端。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| authentication-threshold | integer - DWORD (32 位元） | 伺服器 | 3 | 身分驗證閾值 — 指定在伺服器關閉連線之前，每個用戶端可以失敗身分驗證的次數。若要允許不限次數的身分驗證嘗試，請使用 0。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| ca-file | string | 自訂 | '' | CA 檔案 — 指定包含 DCV 伺服器信任的憑證授權單位 (CAs的檔案。如果為空，則會使用系統提供的預設信任存放區。— 從 [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 | 伺服器 | '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 位元） | 伺服器 | 5 | 連線建立逾時 — 指定在逾時之前，允許完成連線程序的時間量 （以秒為單位）。如果程序超過設定的時間，則會關閉該連線。如果設定為 0，連線建立不會逾時。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| connection-setup-timeout | integer - DWORD (32 位元） | 伺服器 | 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 位元） | 伺服器 | 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 位元） | 伺服器 | 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 | 是否要在最後一個用戶端連線結束時鎖定作業系統工作階段 — 如果啟用，則會在最後一個用戶端連線關閉時鎖定作業系統工作階段。— 從 [2017.1-5777](doc-history-release-notes.md#release.2017.1-5777) 版開始提供。 | 
| pam-service-name | string | 伺服器 | '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 | 伺服器 | '' | 密碼檔案 — 指定用於檢查使用者登入資料的密碼檔案 （僅限 dcv 身分驗證模式）。如果為空，請使用此處的預設檔案：Linux 為 \$1\$1XDG\$1CONFIG\$1HOME\$1/NICE/dcv/passwd，Windows 為 %CSIDL\$1LOCAL\$1APPDATA%\$1NICE\$1dcv\$1passwd。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 | 
| server-fqdn | string | 伺服器 | '' | 伺服器 FQDN — 指定伺服器的完整網域名稱。空白表示 gethostname()。— 從 [2017.3-6698](doc-history-release-notes.md#release.2017.3-6698) 版開始提供。 | 
| service-name | string | 伺服器 | 'dcv' | 服務名稱 — 服務的註冊名稱 （通常是通訊協定名稱）。— 從 [2020.0-8428](doc-history-release-notes.md#release.2020.0-8428) 版開始提供。 | 
| 監督控制 | string | 自訂 | 'disabled' | 工作階段的監督控制類型 — 指定工作階段的監督控制類型。可能的值為「停用」和「強制執行」。如果此值設定為「強制執行」，則可以將非監督式存取許可設定為允許或拒絕協作工作階段中使用者的無擁有者存取。如果使用者允許非監督式存取，則使用者可以在沒有擁有者的情況下存取工作階段。根據預設，擁有者以外的所有使用者都會拒絕此許可。當此值設為 'disabled' （預設） 時，伺服器不會強制執行此監督控制和許可。新值會在組態中變更後立即生效。— 從 [2021.3-11591](doc-history-release-notes.md#release.2021.3-11591) 版開始提供。 | 
| user-realm | string | 伺服器 | '' | 伺服器使用者領域 — 指定伺服器的使用者領域。— 從 [2017.3-6698](doc-history-release-notes.md#release.2017.3-6698) 版開始提供。 | 

## `session-management` 參數
<a name="session_management"></a>

 下表說明 Linux Amazon DCV 伺服器 `/etc/dcv/dcv.conf` 檔案的 `[session-management]`區段中的組態參數，以及 Windows Amazon DCV 伺服器的`session-management`登錄機碼。


| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 | 
| --- | --- | --- | --- | --- | 
| create-session | true 或 false - DWORD (32 位元） | 伺服器 | Linux：false - Windows：0 | 在伺服器啟動時建立主控台工作階段 — 指定是否要在伺服器啟動時自動建立主控台工作階段 (ID 為「主控台」)。— 從 [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 位元） | 伺服器 | 0 | 並行工作階段數目上限 — 指定允許的並行工作階段數目上限。此限制目前僅適用於虛擬工作階段，因為主控台工作階段本質上僅限於一個工作階段。指定 0 不強制執行任何限制。— 從 [2019.0-7318](doc-history-release-notes.md#release.2019.0-7318) 版開始提供。 | 
| max-sessions-per-user | integer - DWORD (32 位元） | 伺服器 | 0 | 每個使用者的工作階段數目上限 — 指定每個使用者可擁有的允許並行工作階段數目上限。此限制目前僅適用於虛擬工作階段。指定 0 不強制執行任何限制。— 自 2021.0-10242 版起提供。 [](doc-history-release-notes.md#release.2021.0-10242) | 
| 效能設定檔 | string | 自訂 | 'none' | 指定某些功能初始化期間使用的設定檔 — 根據執行個體的效能設定檔調整某些功能的預設設定。未選取設定檔時，系統會根據 CPUs 數量和 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>, 'h':<768>, 'x':<800>, 'y':<0>\$1] 對於此設定，監視器數目上限 (在 virtual-session-monitors 中設定) 優先於陣列中的元素數目。例如，如果已設定五個監視器，但監視器數目上限為四個，則只會建立前四個監視器。如果設定此機碼，則會忽略已啟用的監視器數目 (在 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 | 是否要在初始虛擬工作階段設定期間來源使用者設定檔 — 控制 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` 參數
<a name="session_management_automatic_console_session"></a>

 下表說明 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 | 伺服器 | '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 位元） | 伺服器 | -1 | 每個工作階段的並行用戶端數目上限 — 指定每個工作階段允許的並行用戶端數目上限。如果設定為 -1，則無限制。— 從 [2017.0-5600 ](doc-history-release-notes.md#release.2017.0-5600)版開始提供。 | 
| owner | string | 伺服器 | '' | 自動建立的「主控台」工作階段擁有者 — 指定「主控台」工作階段擁有者的使用者名稱。如果為空，擁有者會是啟動 DCV 伺服器的使用者。只有當 create-session 設定設為 true 時，此設定才會套用至伺服器啟動時自動建立的「主控台」工作階段。— 從 [2017.0-5600 ](doc-history-release-notes.md#release.2017.0-5600)版開始提供。 | 
| permissions-file | string | 伺服器 | '' | 自動「主控台」工作階段的許可檔案 — 指定許可檔案的路徑，用於檢查使用者對 DCV 功能的存取。如果為空，只有擁有者能夠完整存取工作階段。— 從 [2017.0-5600 ](doc-history-release-notes.md#release.2017.0-5600)版開始提供。 | 
| storage-root | string | 伺服器 | '' | 檔案儲存根資料夾的路徑 — 指定要用於主控台工作階段儲存之資料夾的完整路徑。如果 storage-root 空白或資料夾不存在，則會停用檔案儲存。— 從 [2017.0-5600 ](doc-history-release-notes.md#release.2017.0-5600)版開始提供。 | 

## `session-management/defaults` 參數
<a name="session_management_defaults"></a>

 下表說明 Linux Amazon DCV 伺服器 `/etc/dcv/dcv.conf` 檔案的 `[session-management/defaults]`區段中的組態參數，以及 Windows Amazon DCV 伺服器的`session-management/defaults`登錄機碼。


| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 | 
| --- | --- | --- | --- | --- | 
| permissions-file | string | 工作階段 | '' | 所有工作階段中包含的預設許可 — 指定要自動與使用者為每個工作階段選取的許可合併的許可檔案路徑。如果為空，請使用 'default.perm' 檔案，其位於 Linux 的 /etc/dcv/ 或 DCV 安裝資料夾 (例如，Windows 是 'C:\$1Program Files\$1NICE\$1DCV\$1Server\$1conf')。— 從 [2017.0-5600 ](doc-history-release-notes.md#release.2017.0-5600)版開始提供。 | 

## `smartcard` 參數
<a name="smartcard"></a>

 下表說明 Linux Amazon DCV 伺服器 `/etc/dcv/dcv.conf` 檔案的 `[smartcard]`區段中的組態參數，以及 Windows Amazon DCV 伺服器的`smartcard`登錄機碼。


| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 | 
| --- | --- | --- | --- | --- | 
| enable-cache | string | 自訂 | 'default-on' | 是否啟用智慧卡快取訊息 — 啟用或停用智慧卡快取。啟用時，DCV 伺服器會快取從用戶端智慧卡收到的最後一個值。後續的呼叫是直接從伺服器快取中擷取，而不是從用戶端。這有助於降低用戶端與伺服器之間的傳輸流量和改善效能。允許的值包括「always-on」、「always-off」、「default-on」和「default-off」。每次啟動用戶端智慧卡應用程式時會從組態中讀取此值。— 從 [2017.2-6182](doc-history-release-notes.md#release.2017.2-6182) 版開始提供。 | 

## `webauthn` 參數
<a name="webauthn"></a>

 下表說明 Linux Amazon DCV 伺服器 `/etc/dcv/dcv.conf` 檔案的 `[webauthn]`區段中的組態參數，以及 Windows Amazon DCV 伺服器的`webauthn`登錄機碼。


| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 | 
| --- | --- | --- | --- | --- | 
| enabled | true 或 false - DWORD (32 位元） | 工作階段 | Linux：true - Windows：1 | 是否應該啟用 Webauthn 重新導向功能 — 此設定控制 WebAuthn 請求的重新導向。啟用時，它允許使用者使用其本機驗證器來驗證 Web 資源，例如 YubiKey、Windows Hello 或其他。如果您停用此設定，WebAuthn 重新導向將會停用，使用者將無法使用其本機驗證器。— 從 [2023.1-16220](doc-history-release-notes.md#release.2023.1-16220) 版開始提供。 | 

## `webcam` 參數
<a name="webcam"></a>

 下表說明 Linux Amazon DCV 伺服器 `/etc/dcv/dcv.conf` 檔案的 `[webcam]`區段中的組態參數，以及 Windows Amazon DCV 伺服器的`webcam`登錄機碼。


| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 | 
| --- | --- | --- | --- | --- | 
| 最大解析度 | string | 連線 | (0、0) | 最大網路攝影機解析度 — 指定可在公開給應用程式的用戶端提供的解析度中選擇的最大網路攝影機解析度。如果缺少此值或 (0， 0)，則會使用預設值。預設值：1280x720 代表高和中等效能設定檔，640x480 代表低效能設定檔。— 自 2021.0-10242 版起提供。 [](doc-history-release-notes.md#release.2021.0-10242) | 
| preferred-resolution | string | 連線 | (0、0) | 偏好的網路攝影機解析度 — 在用戶端提供的解析度中指定偏好的網路攝影機解析度。如果不支援指定的解析度，則會選取最接近的相符解析度。如果缺少此值或 (0， 0)，則會使用預設值。預設值：高和中等效能設定檔為 640x360，低效能設定檔為 424x240。— 從 [2021.0-10242](doc-history-release-notes.md#release.2021.0-10242) 版開始提供。 | 

## `windows` 參數
<a name="windows"></a>

 下表說明 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 不會變更目前的預設印表機。已棄用：使用 'printer' 區段的 'file-printer-name'。— 從 [2017.0-4100](doc-history-release-notes.md#release.2017.0-4100) 版開始提供。 |