若要設定某些 Horizon Client 功能,可以使用 common-setting 區段中的設定。editable 內容用來指定使用者是否可以變更設定。下表中的星號會指出您可以在可編輯清單中進行的設定。

備註: 為了確保修改後的設定生效,使用者必須重新啟動 Horizon Client
設定 說明
editable 設定 Horizon Client 設定的清單,並指定使用者是否可以修改特定的一般設定。一般來說,來自每個伺服器的原則可判斷設定的值。您可以新增此表中標有星號 (*) 的任何用戶端功能。

如果 editable 內容中所列設定的值為 false,該設定便無法使用。使用者無法變更該設定。使用者介面會顯示為灰色。若要進行變更,系統管理員可以更新伺服器所設定的原則。

如果某個設定在 editable 內容清單中,並設定為 true,則該設定將在使用者介面中可供使用。使用者可以進行變更。

備註: 第一次使用時,用戶端會套用伺服器原則中的任何設定。之後,如果設定可編輯且已由使用者變更,則用戶端將使用該設定。
allowDataSharing* 設定資料共用功能。設定此值可啟用或停用共用功能。有效值為 true (啟用) 和 false (停用)。
allowFileDownload

設定使用者是否可以使用檔案傳輸功能,將檔案從遠端桌面平台下載到用戶端裝置。設定此值可啟用或防止檔案下載。

有效值為 true (啟用) 和 false (防止)。預設值是 true

備註: 若要啟用使用檔案傳輸功能下載檔案,您必須在用戶端啟用 allowFileDownload,並將 設定檔案傳輸 GPO 設定為允許在代理程式端下載檔案。請參閱 《Horizon 遠端桌面平台功能和 GPO》
allowFileUpload

設定使用者是否可以使用檔案傳輸功能,將檔案從用戶端裝置上傳到遠端桌面平台。設定此值可啟用或防止檔案上傳。

有效值為 true (啟用) 和 false (防止)。預設值是 true

備註: 若要啟用使用檔案傳輸功能上傳檔案,您必須在用戶端啟用 allowFileUpload,並將 設定檔案傳輸 GPO 設定為允許在代理程式端上傳檔案。請參閱 《Horizon 遠端桌面平台功能和 GPO》
autoForwardUSB* 啟用或停用自動 USB 重新導向。該值指定是否啟用或停用自動 USB 重新導向。editable 內容用來指定使用者是否可以變更 [設定] 視窗中的 USB 自動連線設定。這兩個內容的有效值為 truefalse
display* 設定用戶端可以使用的本機監視器。這個設定可以指定用戶端視窗大小。此設定會在啟動遠端桌面平台時啟動。
可用的選項:
  • useAllMonitor:在所有可用的監視器中呈現。
  • singleMonitor:使用預設視窗大小在一個監視器中呈現。
  • singleMonitorFullscreen:使用全螢幕在一個監視器中呈現。
  • singleMonitorSmallWindow:使用小型視窗大小 (640x480) 在一個監視器中呈現
  • singleMonitorLargeWindow:使用大型視窗大小 (1680x983) 在一個監視器中呈現。
  • {width:mmm, height:nnn}:使用您提供的大小在一個監視器中呈現。(mmmxnnn)

如果 display 不在 editable 內容清單中或設定為 false,系統便會鎖定這個設定。如果在 editable 內容中設定為 true,使用者就可以變更這個設定。 。

enableAdvancedTouch

啟用或停用對進階觸控手勢的支援,如觸控板、觸控式螢幕、數字鍵台和滑鼠手勢中所述。

有效值為 true (啟用) 和 false (停用)。預設值是 true

enableAnonymousLogin* 針對 [設定] 對話方塊中顯示為使用「未驗證存取」匿名登入的「未驗證存取」功能進行設定。value 內容用來指定啟用或停用該功能。有效值為 truefalse
enableFileAssociation

設定設定檔案關聯中所述的檔案關聯功能的啟用狀態。有效值如下:

  • true:啟用檔案關聯。
  • false:停用檔案關聯。使用者仍然可以對本機檔案按一下滑鼠右鍵,並選取 Chrome 版 VMware Horizon Client,但顯示的會是警告訊息,而不是可用應用程式清單。

如果未設定 enableFileAssociation,依預設,會啟用檔案關聯。

enableHighResolution* 設定高解析度模式功能。value 內容用來指定啟用或停用該功能。editable 內容會指定使用者是否可以變更 Horizon Client 中的高解析度模式設定。這兩個內容的有效值為 truefalse
enableMediaStream

對於 Chrome 用戶端的瀏覽器重新導向功能和 Microsoft Teams 的媒體最佳化功能,決定用戶端使用者是否可以設定相機和麥克風權限。有效值如下:

  • true:用戶端使用者可以設定這些設定,並且可以在瀏覽器重新導向期間,針對提示做出回應,以便允許或拒絕遠端瀏覽器存取用戶端的相機和麥克風。
  • false:隱藏與相機和麥克風權限權相關的所有設定和提示,讓用戶端使用者看不見。使用者無法設定這些權限。在瀏覽器重新導向期間,會自動拒絕遠端瀏覽器存取用戶端相機和麥克風。

預設值是 true。如需詳細資訊,請參閱設定瀏覽器重新導向《Horizon 遠端桌面平台功能和 GPO》文件中的〈Microsoft Teams 的媒體最佳化〉一節。

enableH264 指定轉譯方式是否使用 H.264 視訊模式。用戶端會啟用 H.264 視訊模式。有效值為 truefalse
備註:

此選項僅在您使用縮放比率大於 100% 的一般顯示,且管理員尚未停用該功能時,才會顯示在 [設定] 視窗中。

enableRTAVH264Codec

為即時影音 (RTAV) 啟用或停用 H.264 轉碼器。有效值為 true (啟用 H.264) 和 false (停用 H.264)。

預設值是 true

如需詳細資訊,請參閱使用網路攝影機、麥克風和喇叭的即時影音 (RTAV) 功能

forcePrivateMode

為 Horizon Cloud on Azure next-gen 啟用隱私權模式。使用此設定可強制為使用者啟用隱私權模式。如果啟用此設定,使用者必須進行驗證才能登入。關閉 Horizon Client 或從目前伺服器中斷連線後,系統會將使用者導向至瀏覽器登出頁面。此設定在未設定時處於停用狀態

enableNetworkIndicator

依照偵測不穩定的網路連線中所述啟用或停用網路通知功能。有效值為 true (啟用功能) 和 false (停用功能)。

將值設定為 false 可從設定視窗中移除停用網路狀態顯示選項。

預設值是 true

enableLogoutTriggeredQuit 在登出時觸發用戶端關閉。如果啟用此原則選項,則會在使用者成功登出時觸發用戶端關閉。

此選項接受類型為 truefalse 的布林值。

enableDisconnectionTriggeredQuit 在與最後一個作用中的桌面平台或應用程式中斷連線時,觸發用戶端關閉。如果啟用此原則選項,則會在與最後一個作用中的桌面平台或應用程式中斷連線時,觸發用戶端關閉。

此選項接受類型為 truefalse 的布林值。

enableScreenSharing*

允許或不允許使用者在使用已發佈的應用程式時分享其本機螢幕畫面的內容。有效值為 true (允許) 和 false (不允許)。

editable 內容用來指定使用者是否可以從 [設定] 視窗來控制其螢幕畫面分享權限。

enableWebRTCRedirection*

啟用或停用 WebRTC 型應用程式的媒體最佳化功能。

啟用後,此功能可最佳化遠端桌面平台內 WebRTC 型應用程式的音訊、視訊和螢幕畫面分享串流。此功能可改進使用者在虛擬會議和電話會議期間的整體影音體驗。

有效值為 true (啟用功能) 和 false (停用功能)。

editable 內容用來指定使用者是否可以從 [設定] 視窗來控制 WebRTC 媒體最佳化的啟用狀態。

enableWindowsKey* 啟用或停用遠端桌面平台的 Windows 鍵。此值指定是否啟用或停用該功能。editable 內容會指定使用者是否可以變更 Horizon Client 中的為桌面平台啟用 Windows 鍵設定。這兩個內容的有效值為 truefalse
hardwareAccelerationOption

為即時影音 (RTAV) 設定用戶端 GPU 硬體加速。如需詳細資訊,請參閱使用網路攝影機、麥克風和喇叭的即時影音 (RTAV) 功能

有效值如下:

  • no-preference 允許用戶端根據系統和組態的最佳選項,靈活地使用硬體加速或軟體加速。這是預設值。
  • prefer-hardware 可開啟硬體加速。
  • prefer-software 可關閉硬體加速並改用軟體加速。
hideSecondaryServer

設定 Horizon Client 是同時顯示主要伺服器主機名稱和次要伺服器主機名稱的伺服器圖示,還是僅顯示主要伺服器主機名稱的伺服器圖示。

有效值為 true (僅顯示主要主機名稱的單一圖示) 和 false

  • 設定為 true 時,Horizon Client 只會顯示主要主機名稱的圖示。
  • 設定為 false 時,Horizon Client 會同時顯示主要伺服器主機名稱和次要伺服器主機名稱的圖示。此設定可能會導致為同一伺服器顯示兩個圖示。例如,在負載平衡器作為主要主機,而 Unified Access Gateway (UAG) 作為次要主機的情況下,Horizon Client 會顯示負載平衡器主機名稱的圖示和 UAG 主機名稱的重複圖示。

預設值是 true

ignoreCertErrors

設定瀏覽器重新導向功能是否可以開啟含有 SSL 或安全憑證錯誤的頁面。有效值如下:

  • false:瀏覽器重新導向功能無法開啟含有 SSL 或憑證錯誤的頁面。將不會重新導向此類頁面,且 Horizon Client 會顯示有關 SSL 或憑證錯誤的訊息。
  • true:瀏覽器重新導向功能會繼續開啟含有 SSL 或憑證錯誤的頁面。將忽略這些錯誤,並重新導向這類頁面。

預設值是 false。如需詳細資訊,請參閱設定瀏覽器重新導向

networkStateConfig

指定 Horizon Client 用於計算網路品質分數並確定網路穩定性的臨界值參數。如需 Horizon Client 如何使用這些參數的詳細資訊,請參閱偵測不穩定的網路連線

此設定包括下列內容:

  • networkStateTcpRttMSLow:指定用於計算網路品質分數的低 RTT 臨界值。該值必須是小於 networkStateTcpRttMSHigh 值的正整數。預設值為 2。
  • networkStateTcpRttMSHigh:指定用於計算網路品質分數的高 RTT 臨界值。該值必須是大於 networkStateTcpRttMSLow 值的正整數。預設值為 400。
  • networkStateQualityScoreTcpThresholdGood:指定指示網路穩定性良好的最低分數。有效值必須介於 0 到 100 之間,並且大於 networkStateQualityScoreTcpThresholdPoor 值。預設值為 85。
  • networkStateQualityScoreTcpThresholdPoor:指定指示網路穩定性不佳的分數範圍上限。有效值必須介於 0 到 100 之間,並且小於 networkStateQualityScoreTcpThresholdGood 值。預設值為 40。
  • networkStateRttCheckPeriodMs:指定監控網路 RTT 的時間間隔 (以毫秒為單位)。有效值必須大於 2000。預設值為 15000。
powerSetting 防止裝置進入睡眠,以回應遠端工作階段中的使用者閒置狀態。依預設,Chrome 裝置會在 10 分鐘後進入睡眠狀態。當您設定 powerSetting 時,裝置會在最後一個遠端工作階段結束後才進入睡眠狀態。

keepAwakeLevel 內容會指定電源原則的層級。以下是 keepAwakeLevel 內容的有效值:

  • system:這會防止系統進入睡眠狀態,以回應使用者閒置。此值為預設值。
  • display:這會防止顯示關閉或變暗,或防止系統進入睡眠狀態,以回應使用者閒置。
splitUSB

指定 USB 裝置的分割重新導向行為,如分割複合 USB 裝置中所述。

此設定包括下列內容:

  • allowList 指定允許分割以進行重新導向的複合裝置。如果某個裝置未列出,表示該裝置不會分割。將值設定為具有以下索引鍵-值配對的資料物件陣列:
    • device 指定複合裝置的身分識別。有效值採用 <vid>:<pid> 格式,其中 <vid> 指定廠商識別碼,<pid> 指定裝置的產品識別碼。
    • excludedInterface 指定不應重新導向的裝置介面。將值設定為排除的介面識別碼的陣列。
  • blockList 指定遭到封鎖無法分割以進行重新導向的複合裝置。使用 <vid>:<pid> 格式將值設定為物件陣列,其中 <vid> 指定廠商識別碼,<pid> 指定裝置的產品識別碼。

使用此設定時,系統會忽略同等的代理程式群組原則設定 (分割 Vid/Pid 裝置)。

urlFiltering

為用戶端設定 URL 內容重新導向規則。URL 內容重新導向功能也需要代理程式端組態。如需詳細資訊,請參閱使用 URL 內容重新導向的需求以及《Horizon 遠端桌面平台功能和 GPO》文件中的〈設定 URL 內容重新導向〉。

備註: 必須重新啟動 Horizon Client,任何已修改的規則才會生效。
備註: 在連線伺服器執行個體上使用 vdmutil 命令列介面所設定的 URL 內容重新導向規則,優先於使用 urlFiltering 設定所設定的 URL 內容重新導向規則。

urlFiltering 設定有一個 protocols 內容,會設定成具有下列內容的物件陣列:

  • brokerHostname:重新導向 URL 時要使用的連線伺服器主機 IP 位址或完整網域名稱 (FQDN)。
  • protocol:要重新導向的 URL 通訊協定。
  • remoteItem:可處理指定給 agentRules 之 URL 的遠端桌面平台或應用程式集區的顯示名稱。
  • agentRules:會重新導向至指定給 remoteItem 之遠端桌面平台或應用程式的 URL。例如,如果將 agentRules 設定為 .*mycompany.com,則所有包含 mycompany.com 字串的 URL 都會重新導向至遠端桌面平台或應用程式。
備註: 重新導向 URL 的範圍,可能會因您用於 agentRules 的規則語法而異。
  • 規則語法 .*mycompany.com 支援對所有包含 mycompany.com 字串的 URL 進行重新導向,包括 http://mycompany.com
  • 規則語法 .*.mycompany.com 支援對所有包含 mycompany.com 字串的 URL 進行重新導向。但是,它不支援重新導向根 URL。例如,不會重新導向 http://mycompany.com
useAssetIdReplaceMachineName

設定如何將用戶端資產識別碼 (實體電腦名稱) 傳遞到對應的 Horizon 環境變數。如需詳細資訊,請參閱 VMware 知識庫 (KB) 文章 92513

有效值如下:

  • false:資產識別碼將傳遞到 ViewClient_Asset_ID 環境變數。
  • true:資產識別碼將傳遞到 ViewClient_Machine_Name 環境變數。

預設值是 false

ws1WebviewMode

設定使用者是否可向以受管理應用程式 (例如由 Unified Access GatewayWorkspace ONE 管理) 形式執行的 Horizon Client 進行驗證。有效值如下:

  • secure-webview:允許使用者向作為受管理應用程式的 Horizon Client 進行驗證,並在驗證完成後,清除快取和 Cookie。
  • persistent-webview:允許使用者向作為受管理應用程式的 Horizon Client 進行驗證,但在驗證完成後,不清除快取和 Cookie。此值允許儲存驗證資訊。
  • browser:需要開啟瀏覽器視窗,以進行使用者驗證。此值會阻止 Horizon Client 以受管理應用程式形式執行。

預設值是 secure-webview

以下 JSON 組態檔案的範例顯示 editable 內容的一些常見設定和使用方式。此範例顯示建議的設定,以便最大程度地提高效能和效率,來獲得最佳的使用者體驗。

{
  "broker_list": {
    "Value": {
      "settings": {
        "server-list": [
          {
            "server": "viewserver0.mydomain.com",
            "default": true,
            "description": "View Server 0",
            "username": "User0",
            "domain": "TestDomain0"
          }
        ],
        "common-setting": {
          "allowDataSharing": true,
          "enableAdvancedTouch": true,
          "enableAnonymousLogin": false,
          "allowFileDownload": true,
          "allowFileUpload": true,
          "enableWindowsKey": true,
          "enableFileAssociation": false,
          "enableH264": true,
          "enableRTAVH264Codec": true,
          "forcePrivateMode": true,
          "hardwareAccelerationOption": "no-preference",
          "ignoreCertErrors": false,
          "ws1WebviewMode": "secure-webview",
          "autoForwardUSB": true,
          "display": "useAllMonitor",
          "enableHighResolution": false,
          "useAssetIdReplaceMachineName": false,
          "splitUSB": {
            "allowList": [
              {
                "device": "0554:1001",
                "excludedInterface": [
                  "00",
                  "01",
                  "02"
                ]
              }
            ]
          },
          "hideSecondaryServer": true,
          "enableAdvancedTouch": false,
          "enableMediaStream": false,
          "enableScreenSharing": true,
          "enableNetworkIndicator": true,
          "enableLogoutTriggeredQuit": true,
          "enableDisconnectionTriggeredQuit": true,
           }
          "networkStateConfig": {
            "networkStateTcpRttMSLow": 2,
            "networkStateTcpRttMSHigh": 400,
            "networkStateQualityScoreTcpThresholdGood": 85,
            "networkStateQualityScoreTcpThresholdPoor": 40,
            "networkStateRttCheckPeriodMs": 15000
          },
          "urlFiltering": {
            "protocols": [
              {
                "brokerHostname": "10.117.24.28",
                "protocol": "http",
                "remoteItem": "win2022_RDSH",
                "agentRules": ".*example1.com"
              },
              {
                "brokerHostname": "10.117.161.109",
                "protocol": "https",
                "remoteItem": "win10_VDI",
                "agentRules": ".*example2.com"
              }
            ]
          },
          "editable": {
            "allowDataSharing": true,
            "enableAnonymousLogin": true,
            "enableHighResolution": true,
            "autoForwardUSB": true,
            "enableH264": true,
            "enableWebRTCRedirection": true,
            "display": true,
            "enableScreenSharing": true
          }
        }
      }
    }
  }
}