您可以透過新增項目到檔案 /etc/vmware/config/etc/vmware/viewagent-custom.conf 來設定某些選項。

Horizon Agent的安裝期間,安裝程式會將兩個組態範本檔 config.templateviewagent-custom.conf.template 複製到 /etc/vmware。此外,如果 /etc/vmware/config/etc/vmware/viewagent-custom.conf 不存在,則安裝程式會將 config.template 複製到 config,並將 viewagent-custom.conf.template 複製到 viewagent-custom.conf。範本檔中會列出並記載所有組態選項。若要設定選項,只需移除註解並適當變更值。

例如, /etc/vmware/config 中的下列程式行可啟用無失真建立 PNG 模式。
RemoteDisplay.buildToPNG=TRUE

進行組態變更之後,請將 Linux 重新開機以讓變更生效。

/etc/vmware/config 中的組態選項

VMwareBlastServer 和其相關外掛程式使用組態檔 /etc/vmware/config
備註: 下表的說明包含 Horizon Agent組態檔中由每個代理程式強制執行的 USB 原則設定。 Horizon Agent會使用這些設定來決定是否可以將某個 USB 轉送至主機。 Horizon Agent也會將這些設定傳遞至 Horizon Client 進行解譯並強制執行。強制執行是根據您是指定合併 (m) 修飾詞來套用 Horizon Agent 篩選原則設定以及 Horizon Client 篩選原則設定,或是指定覆寫 (o) 修飾詞以使用 Horizon Agent 篩選原則設定而非 Horizon Client 篩選原則設定來進行解譯和強制執行。
表 1. /etc/vmware/config 中的組態選項
選項 值/格式 預設值 說明
Clipboard.Direction 0, 1, 2,3 2 使用此選項來指定剪貼簿重新導向原則。有效值如下:
  • 0 - 停用剪貼簿重新導向。
  • 1 - 啟用雙向剪貼簿重新導向。
  • 2 - 僅啟用從用戶端到遠端桌面平台的剪貼簿重新導向。
  • 3 - 僅啟用從遠端桌面平台到用戶端的剪貼簿重新導向。
RemoteDisplay.allowAudio truefalse true 設定此選項可啟用/停用音訊輸出。
RemoteDisplay.allowH264 truefalse true 設定此選項,可啟用或停用 H.264 編碼。
RemoteDisplay.buildToPNG truefalse false 圖形應用程式,特別是圖形設計應用程式,會需要在 Linux 桌面平台的用戶端有像素精準的影像呈現。您可以針對 Linux 桌面平台上產生和在用戶端裝置上呈現的影像和視訊播放,設定無失真建立 PNG 模式。此功能會在用戶端和 ESXi 主機之間使用額外的頻寬。啟用此選項會停用 H.264 編碼。
RemoteDisplay.enableNetworkContinuity truefalse true 設定此選項,可啟用或停用 Horizon Agent for Linux 中的網路持續性功能。
RemoteDisplay.enableNetworkIntelligence truefalse true 設定此選項,可啟用或停用 Horizon Agent for Linux 中的網路智慧功能。
RemoteDisplay.enableStats truefalse false 在 mks 記錄中啟用或停用 VMware Blast 顯示通訊協定統計資料,例如頻寬、FPS、RTT 等。
RemoteDisplay.enableUDP truefalse true 設定此選項,可啟用或停用 Horizon Agent for Linux 中的 UDP 通訊協定支援。
RemoteDisplay.maxBandwidthKbps 整數 1000000 指定 VMware Blast 工作階段的最大頻寬 (單位為千位元/秒,即 kbps)。頻寬包括所有影像處理、音訊、虛擬通道和 VMware Blast 控制流量。有效值必須小於 4 Gbps (4096000)。
RemoteDisplay.minBandwidthKbps 整數 256 指定 VMware Blast 工作階段的最小頻寬 (單位為千位元/秒,即 kbps)。頻寬包括所有影像處理、音訊、虛擬通道和 VMware Blast 控制流量。
RemoteDisplay.maxFPS 整數 30 指定畫面更新的最大速率。使用此設定,可管理使用者所使用的平均頻寬。有效值必須介於 3 與 60 之間。預設值為每秒 30 次更新。
RemoteDisplay.maxQualityJPEG 可用值範圍:1-100 90 指定用於 JPEG/PNG 編碼的桌面平台顯示的影像畫質。高畫質設定用於較為靜態的畫面區域,可產生較佳影像畫質。
RemoteDisplay.midQualityJPEG 可用值範圍:1-100 35 指定用於 JPEG/PNG 編碼的桌面平台顯示的影像畫質。用來設定桌面平台顯示的中等畫質設定。
RemoteDisplay.minQualityJPEG 可用值範圍:1-100 25 指定用於 JPEG/PNG 編碼的桌面平台顯示的影像畫質。低畫質設定用於經常變動的畫面區域,例如,在執行捲動時。
RemoteDisplay.qpmaxH264 可用值範圍:0-51 36 使用此選項來設定 H264minQP 量化參數,其指定設定為使用 H.264 編碼的遠端顯示的最佳影像畫質。將該值設定為大於針對 RemoteDisplay.qpminH264 設定的值。
RemoteDisplay.qpminH264 可用值範圍:0-51 10 使用此選項來設定 H264maxQP 量化參數,其指定設定為使用 H.264 編碼的遠端顯示的最低影像畫質。將該值設定為小於針對 RemoteDisplay.qpmaxH264 設定的值。
UsbRedirPlugin.log.logLevel errorwarninfodebugtraceverbose info 使用此選項,可設定 USB 重新導向外掛程式的記錄層級。
UsbRedirServer.log.logLevel errorwarninfodebugtraceverbose info 使用此選項,可設定 USB 重新導向伺服器的記錄層級。
VMWPkcs11Plugin.log.enable truefalse false 設定此選項可啟用或停用 True SSO 功能的記錄模式。
VMWPkcs11Plugin.log.logLevel errorwarninfodebugtraceverbose info 使用此選項,可設定 True SSO 功能的記錄層級。
VVC.RTAV.Enable truefalse true 設定此選項可啟用/停用音訊輸入。
VVC.ScRedir.Enable truefalse true 設定此選項可啟用/停用智慧卡重新導向。
VVC.logLevel fatalerrorwarninfodebugtrace info 使用此選項以設定 VVC Proxy 節點的記錄層級。
cdrserver.cacheEnable truefalse true 設定此選項,可啟用或停用從代理程式到用戶端的寫入快取功能。
cdrserver.customizedSharedFolderPath folder_path /home/ 使用此選項可將用戶端磁碟機重新導向 (CDR) 共用資料夾位置從預設的 /home/user/tsclient 目錄變更為自訂目錄。

例如,如果使用者 test 要將 CDR 共用資料夾放在 /mnt/test/tsclient (而不是 /home/test/tsclient) 中,則該使用者可以指定 cdrserver.customizedSharedFolderPath=/mnt/

備註: 為了使此選項生效,指定的資料夾必須存在且已使用正確的使用者權限進行設定。
cdrserver.forcedByAdmin truefalse false 設定此選項,可控制用戶端是否可以共用未使用 cdrserver.shareFolders選項指定的其他資料夾。
cdrserver.logLevel errorwarninfodebugtraceverbose info 使用此選項,可設定 vmware-CDRserver.log 檔案的記錄層級。
cdrserver.permissions R RW 使用此選項,可在 Horizon Agent所具備Horizon Client 共用的資料夾上套用其他的讀取/寫入權限。例如:
  • 如果 Horizon Client共用的資料夾具有 readwrite 權限,而您設定 cdrserver.permissions=R,則 Horizon Agent 僅具有 read 存取權限。
  • 如果 Horizon Client共用的資料夾僅具有 read 權限,而您設定 cdrserver.permissions=RW,則 Horizon Agent 仍僅有read 存取權限。Horizon Agent無法變更 Horizon Client 所設定的read only (唯讀) 屬性。Horizon Agent僅能移除寫入權限。
一般使用方式如下:
  • cdrserver.permissions=R
  • #cdrserver.permissions=R (例如,註解排除或刪除該項目)
cdrserver.sharedFolders file_path1,R;file-path2,; file_path3,R; ... 未定義 指定用戶端可以與 Linux 桌面平台共用的一或多個資料夾的檔案路徑。例如:
  • 針對 Windows 用戶端:C:\spreadsheets,;D:\ebooks,R
  • 針對非 Windows 用戶端:/tmp/spreadsheets;/tmp/ebooks,;/home/finance,R
collaboration.logLevel errorinfodebug info 使用此選項,可設定協作工作階段所使用的記錄層級。如果記錄層級為 debug,則會記錄對 collabui 函數進行的所有呼叫和 collabor 清單的內容。
collaboration.maxCollabors 小於 10 的整數 5 指定您可以邀請加入工作階段的協作者數目上限。
collaboration.enableEmail truefalse true 設定此選項,可啟用或停用使用已安裝的電子郵件應用程式傳送協作邀請。此選項停用時,即便已安裝電子郵件應用程式,您仍無法使用電子郵件邀請協作者。
collaboration.serverUrl [URL] 未定義 指定要納入協作邀請的伺服器 URL。
collaboration.enableControlPassing truefalse true 設定此選項,可允許或限制協作者對 Linux 桌面平台進行控制。若要指定唯讀協作工作階段,請將此選項設為 false
mksVNCServer.useUInputButtonMapping truefalse false 設定此選項可啟用 Ubuntu 或 RHEL 7.x. CentOS 上的慣用左手滑鼠支援,而 RHEL 6.x 支援左手使用者的滑鼠,您不需要設定此選項。
mksvhan.clipboardSize 整數 1024 使用此選項,可指定所要複製及貼上的剪貼簿大小上限。
vdpservice.log.logLevel fatalerrorwarninfodebugtrace info 使用此選項,可設定 vdpservice的記錄層級。
viewusb.AllowAudioIn {m|o}:{true|false} 未定義,其相當於 true 使用此選項,可允許或不允許將音訊輸入裝置重新導向。範例:o:false
viewusb.AllowAudioOut {m|o}:{true|false} 未定義,其相當於 false 設定此選項,可允許或不允許音訊輸出裝置的重新導向。
viewusb.AllowAutoDeviceSplitting {m|o}:{true|false} 未定義,其相當於 false 設定此選項,可允許或不允許複合 USB 裝置的自動分割。

範例:m:true

viewusb.AllowDevDescFailsafe {m|o}:{true|false} 未定義,其相當於 false 設定此選項後,即便Horizon Client無法取得組態或裝置描述元時,仍可允許或不允許將裝置重新導向。若要在即使無法取得組態或裝置描述元的情形下也允許裝置,請將它納入在 Include 篩選器當中,例如 IncludeVidPidIncludePath
viewusb.AllowHIDBootable {m|o}:{true|false} 未定義,其相當於 true 使用此選項以允許或不允許將鍵盤或滑鼠以外可在開機時使用的輸入裝置 (又稱為 HID 可開機裝置) 重新導向。
viewusb.AllowKeyboardMouse {m|o}:{true|false} 未定義,其相當於 false 使用此選項,可以允許或不允許將具備整合式指向裝置 (例如滑鼠、軌跡球或觸控板) 的鍵盤重新導向。
viewusb.AllowSmartcard {m|o}:{true|false} 未定義,其相當於 false 設定此選項,可允許或不允許將智慧卡裝置重新導向。
viewusb.AllowVideo {m|o}:{true|false} 未定義,其相當於 true 使用此選項,可允許或不允許將視訊裝置重新導向。
viewusb.DisableRemoteConfig {m|o}:{true|false} 未定義,其相當於 false 設定此選項,可停用或啟用在執行 USB 裝置篩選時使用 Horizon Agent設定。
viewusb.ExcludeAllDevices {true|false} 未定義,其相當於 false 使用此選項,可排除或包含所有 USB 裝置,以決定是否進行重新導向。如果設定為 true,您可以使用其他原則設定,以允許將特定裝置或裝置系列重新導向。如果設定為 false,您可以使用其他原則設定,以避免將特定裝置或裝置系列重新導向。如果在 Horizon Agent上將 ExcludeAllDevices 的值設為 true,且此設定已傳遞至 Horizon Client,則 Horizon Agent 設定會覆寫 Horizon Client 設定。
viewusb.ExcludeFamily {m|o}:family_name_1[;family_name_2;...] 未定義 使用此選項,可排除裝置系列以避免進行重新導向。例如:m:bluetooth;smart-card
如果您已經啟用自動裝置分割功能,Horizon 便會檢驗複合 USB 裝置每個介面的裝置系列,以確認必須排除的介面。如果您已經停用自動裝置分割功能,Horizon 便會檢驗整個複合 USB 裝置的裝置系列。
備註: 依預設系統會排除滑鼠和鍵盤不進行重新導向,因此不需使用此設定來排除。
viewusb.ExcludePath {m|o}:bus-x1[/y1].../ port-z1[;bus-x2[/y2].../port-z2;...] 未定義 使用此選項,可排除位於指定集線器或連接埠路徑上的裝置,以避免進行重新導向。您必須以十六進位指定匯流排和連接埠號碼。您不能在路徑中使用萬用字元。

例如:m:bus-1/2/3_port- 02;bus-1/1/1/4_port-ff

viewusb.ExcludeVidPid {m|o}:vid-xxx1_ pid-yyy1[;vid-xxx2_pid-yyy2;..] 未定義 設定此選項,可排除具有特定廠商和產品識別碼的裝置,以避免進行重新導向。您必須以十六進位指定識別碼。您可以在識別碼中使用萬用字元 (*) 以取代個別數字。

例如:o:vid-0781_pid- ****;vid-0561_pid-554c

viewusb.IncludeFamily {m|o}:family_name_1[;family_name_2]... 未定義 設定此選項,可包含能夠重新導向的裝置系列。

例如:o:storage; smart-card

viewusb.IncludePath {m|o}:bus-x1[/y1].../ port-z1[;bus-x2[/y2].../portz2;...] 未定義 使用此選項,可包含指定集線器或連接埠路徑上能夠重新導向的裝置。您必須以十六進位指定匯流排和連接埠號碼。您不能在路徑中使用萬用字元。

例如:m:bus-1/2_port- 02;bus-1/7/1/4_port-0

viewusb.IncludeVidPid {m|o}:vid-xxx1_ pid-yyy1[;vid-xxx2_pid-yyy2;...] 未定義 設定此選項,可包含具有指定廠商和產品識別碼且能夠重新導向的裝置。您必須以十六進位指定識別碼。您可以在識別碼中使用萬用字元 (*) 以取代個別數字。

例如:o:vid-***_pid-0001;vid-0561_pid-554c

viewusb.SplitExcludeVidPid {m|o}:vid-xxx1_pid-yyy1[;vid-xxx2_pid-yyy2;...] 未定義 使用此選項,可排除或包含指定的複合 USB 裝置,以決定是否根據廠商和產品識別碼進行分割。設定的格式為 vid-xxx1_pid-yyy1[;vid-xxx2_pid-yyy2;...]。您必須以十六進位格式指定識別碼。您可以在識別碼中使用萬用字元 (*) 以取代個別數字。

範例:m:vid-0f0f_pid-55**

viewusb.SplitVidPid {m|o}:vid-xxxx_pid-yyyy([exintf:zz[;exintf:ww]])[;...] 未定義 設定此選項,可將根據廠商和產品識別碼指定的複合 USB 裝置元件視為個別裝置。設定的格式為 vid-xxxx_pid-yyyy(exintf:zz[;exintf:ww])

您可以使用 exintf 關鍵字,藉由指定它們的介面號碼來將元件自重新導向清單中排除。您必須以十六進位指定識別碼,及以十進位指定介面號碼,包括任何前置的 0。您可以在識別碼中使用萬用字元 (*) 以取代個別數字。

範例:o:vid-0f0f_pid-***(exintf-01);vid-0781_pid-554c(exintf:01;exintf:02)

備註: Horizon 不會自動包含您未明確排除的元件。您必須指定篩選原則,例如 納入 VidPid 裝置,以納入那些元件。

/etc/vmware/viewagent-custom.conf 中的組態選項

Java Standalone Agent 使用組態檔 /etc/vmware/viewagent-custom.conf

表 2. /etc/vmware/viewagent-custom.conf 中的組態選項
選項 預設值 說明
CDREnable truefalse true 使用此選項,可啟用或停用用戶端磁碟機重新導向 (CDR) 功能。
CollaborationEnable truefalse true 使用此選項,可啟用或停用 Linux 桌面平台上的工作階段協作功能。
EndpointVPNEnable truefalse false 設定此選項,可在對Dynamic Environment Manager主控台中所使用端點 IP 位址的範圍評估端點 IP 位址時,指定要使用用戶端的實體網路卡 IP 位址或 VPN IP 位址。如果選項設為false,則會使用用戶端的實體網路卡 IP 位址。否則,即會使用 VPN IP 位址。
HelpDeskEnable truefalse true 設定此選項,可啟用或停用 Help Desk Tool 功能。
KeyboardLayoutSync truefalse true 使用此選項,可指定是否將用戶端的系統地區設定清單和目前的鍵盤配置與 Linux 版 Horizon Agent桌面平台同步。

當此設定已啟用或未設定時,則允許進行同步化。當此設定已停用時,則不允許進行同步化。

僅 Windows 版 Horizon Client支援此功能,並且僅適用於英文、法文、德文、日文、韓文、西班牙文、簡體中文和繁體中文地區設定。

LogCnt 整數 -1 使用此選項以設定 /tmp/vmware-root 中保留的記錄檔計數。
  • -1 - 全部保留
  • 0 - 全部刪除
  • > 0 - 保留的記錄檔計數。
NetbiosDomain 全大寫字母的文字字串 設定 True SSO 時,使用此選項來設定您組織的網域的 NetBIOS 名稱。
OfflineJoinDomain pbissamba pbis 使用此選項可設定即時複製離線網域加入。執行離線網域加入的可用方法包括 PowerBroker Identity Services Open (PBISO) 驗證和 Samba 離線網域加入。如果此屬性的值不是 pbissamba,則會忽略離線網域加入。
RunOnceScript

使用此選項可將複製的虛擬機器重新加入至 Active Directory。

主機名稱變更後,請設定RunOnceScript選項。指定的指令碼只會在第一次主機名稱變更後執行一次。當代理程式服務啟動,且主機名稱在代理程式安裝後有所變更時,即會以根權限執行指令碼。

以 Winbind 解決方案為例,您必須將基礎虛擬機器加入含有 Winbind 的 Active Directory,並將此選項設定為指令碼路徑。指令碼必須包含網域重新加入命令/usr/bin/net ads join -U <ADUserName>%<ADUserPassword>。在虛擬機器複製之後,作業系統自訂會變更主機名稱。當代理程式服務啟動時,指令碼即會執行,而將複製的虛擬機器加入 Active Directory。

RunOnceScriptTimeout 120 使用此選項來為 RunOnceScript 選項設定逾時時間 (秒)。

例如,設定 RunOnceScriptTimeout=120

SSLCiphers 文字字串 !aNULL:kECDH+AESGCM:ECDH+AESGCM:RSA+AESGCM:kECDH+AES:ECDH+AES:RSA+AES 使用此選項來指定加密清單。您必須使用 https://www.openssl.org/docs/manmaster/man1/ciphers.html中定義的格式。
SSLProtocols 文字字串 TLSv1_1:TLSv1_2 使用此選項來指定安全性通訊協定。支援的通訊協定為 TLSv1.0、TLSv1.1 和 TLSv1.2。
SSODesktopType UseGnomeClassicUseGnomeFlashbackUseGnomeUbuntuUseMATEUseKdePlasma N/A

此選項會指定 SSO 啟用時所要使用的桌面平台環境,而不是預設桌面平台環境。

在指定要使用選取的桌面平台環境之前,您必須先確定您的桌面平台已安裝該環境。在 Ubuntu 桌面平台中設定此選項後,無論 SSO 功能是否啟用,此選項都會生效。如果在 RHEL/CentOS 7.x 桌面平台中指定此選項,則必須在啟用 SSO 後,才會使用選取的桌面平台環境。

RHEL/CentOS 8.x 和 RHEL/CentOS 6.x 桌面平台不支援此選項。Horizon 7 僅支援 RHEL/CentOS 8.x 桌面平台上的 Gnome 桌面平台環境。

SSOEnable truefalse true 設定此選項可啟用/停用單一登入 (SSO)。
SSOUserFormat 文字字串 [username] 使用此選項來指定 Single Sign-On 登入名稱的格式。預設值為僅使用者名稱。如果也需要網域名稱,請設定此選項。一般來說,登入名稱為網域名稱加上特殊字元並接著使用者名稱。如果特殊字元為反斜線,您必須使用另一個反斜線來逸出。登入名稱格式的範例如下所示:
  • SSOUserFormat=[domain]\\[username]
  • SSOUserFormat=[domain]+[username]
  • SSOUserFormat=[username]@[domain]
子網路 採用 CIDR IP 位址格式的值 [subnet] 將此選項設定為子網路,其他機器可用它來連線至 Horizon Agent for Linux。如果有多個具有不同子網路的本機 IP 位址,則會使用已設定子網路中的本機 IP 位址來連線至 Horizon Agent for Linux。您必須以 CIDR IP 位址格式指定該值。例如,Subnet=123.456.7.8/24。
UEMEnable truefalse false 設定此選項,可啟用或停用Dynamic Environment Manager智慧型原則。如果選項設為啟用,且在滿足 Dynamic Environment Manager智慧型原則中的條件時,即會強制執行原則。
UEMNetworkPath 文字字串 此選項必須設定為在 Dynamic Environment Manager 主控台中設定的相同網路路徑。路徑的格式必須類似於 //10.111.22.333/view/LinuxAgent/UEMConfig
備註: SSLCiphers、SSLProtocols 和 SSLCipherServerPreference 這三個安全性選項是用於 VMwareBlastServer 處理程序。啟動 VMwareBlastServer 處理程序時,Java Standalone Agent 會將這些選項傳入為參數。啟用 Blast 安全閘道 (BSG) 時,這些選項會影響 BSG 與 Linux 桌面平台之間的連線。停用 BSG 時,這些選項會影響用戶端與 Linux 桌面平台之間的連線。