對於 Linux 桌面平台，您可以修改 /etc/vmware/config 檔案、/etc/vmware/viewagent-custom.conf 檔案和 /etc/vmware/viewagent-greeter.conf 檔案中的項目，以設定某些選項。

在 Horizon Agent 安裝期間，安裝程式會將以下組態範本檔複製到 /etc/vmware：

  • config.template
  • viewagent-custom.conf.template
  • viewagent-greeter.conf.template

此外，如果 /etc/vmware/config、/etc/vmware/viewagent-custom.conf 和 /etc/vmware/viewagent-greeter.conf 不存在，安裝程式會執行下列動作：

  • 將 config.template 複製到 config
  • 將 viewagent-custom.conf.template 複製到 viewagent-custom.conf
  • 將 viewagent-greeter.conf.template 複製到 /etc/vmware/viewagent-greeter.conf

組態檔會列出並記錄所有 Horizon Agent for Linux 組態選項。若要設定選項，請移除註解並適當地變更值。

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

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

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

VMware BlastServer 和 BlastProxy 處理程序及其相關的外掛程式和處理程序，都會使用 /etc/vmware/config 組態檔。
備註： 下表的說明包含 Horizon Agent組態檔中由每個代理程式強制執行的 USB 裝置原則設定。 Horizon Agent 會使用這些設定， Horizon Agent 還會將這些設定傳遞至 Horizon Client 進行解譯並強制執行。強制執行是根據您是指定合併 ( (m)) 修飾詞來套用 Horizon Agent 篩選原則設定以及 Horizon Client 篩選原則設定，還是指定覆寫 (o) 修飾詞以使用 Horizon Agent 篩選原則設定而非 Horizon Client 篩選原則設定，來強制執行。
表 1. /etc/vmware/config 中的組態選項
值/格式 預設值 說明
appScanner.logLevel error、warn、info 或 debug info

使用此選項可指定 appScanner 記錄檔中報告的詳細資料層級，而這會記錄遠端應用程式工作階段的相關活動。有效值的範圍從最不詳細的「錯誤」層級，以至於最詳細的「偵錯」層級。

您可以在 /tmp/vmware-root/vmware-appScanner-<pid>.log 中找到 appScanner 記錄，其中 <pid> 是 appScanner 處理程序的識別碼。
選項 error、warn、info、verbose、debug 或 trace info

使用此選項，可指定在 BlastProxy 記錄檔中報告的詳細資料層級。有效值的範圍從最不詳細的「錯誤」層級，以至於最詳細的「追蹤」層級。

您可以在 /tmp/vmware-root/vmware-BlastProxy-<pid>.log 中找到 BlastProxy 記錄，其中 <pid> 是 BlastProxy 處理程序的識別碼。
BlastProxy.UdpEnabled true 或 false true 使用此選項，可指定 BlastProxy 是否會透過受保護的連接埠 22443 將 UDP 要求轉送至 Horizon Agent。true 會啟用 UDP 轉送。false 會停用 UDP 轉送。
cdrserver.cacheEnable true 或 false true 設定此選項，可啟用或停用從代理程式到用戶端的寫入快取功能。
cdrserver.customizedSharedFolderPath folder_path /home/ 使用此選項可將用戶端磁碟機重新導向共用資料夾位置從預設的 /home/user/tsclient 目錄變更為自訂目錄。

例如，如果使用者 test 要將用戶端磁碟機重新導向共用資料夾放在 /mnt/test/tsclient (而不是 /home/test/tsclient) 中，則該使用者可以指定 cdrserver.customizedSharedFolderPath=/mnt/。

備註： 為了讓此選項生效，指定的資料夾必須存在且已使用正確的使用者權限進行設定。
cdrserver.forcedByAdmin true 或 false false 設定此選項，可控制用戶端是否可以共用未使用 cdrserver.shareFolders 選項指定的資料夾。
cdrserver.logLevel error、warn、info、debug、trace 或 verbose info 使用此選項，可設定 vmware-CDRserver.log 檔案的記錄層級。
cdrserver.permissions R RW 使用此選項，可在 Horizon Agent 所具備 Horizon Client 共用的資料夾上套用讀取/寫入權限。例如：
  • 如果 Horizon Client共用的資料夾具有 read 和 write 權限，而您設定 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
Clipboard.Direction 0, 1, 2, 或 3 2 使用此選項來指定剪貼簿重新導向原則。有效值如下：
  • 0 - 停用剪貼簿重新導向。
  • 1 - 啟用雙向剪貼簿重新導向。
  • 2 - 僅啟用從用戶端到遠端桌面平台的剪貼簿重新導向。
  • 3 - 僅啟用從遠端桌面平台到用戶端的剪貼簿重新導向。
collaboration.enableControlPassing true 或 false true 設定此選項，可允許或限制協作者對 Linux 桌面平台進行控制。若要指定唯讀協作工作階段，請將此選項設為 false。
collaboration.enableEmail true 或 false true 設定此選項，可啟用或停用使用已安裝的電子郵件應用程式傳送協作邀請。當此選項停用時，即使已安裝電子郵件應用程式，您仍無法使用電子郵件來邀請協作者。
collaboration.logLevel error、info 或 debug info 使用此選項，可設定協作工作階段所使用的記錄層級。如果記錄層級為 debug，則會記錄對 collabui 函數進行的所有呼叫和 collabor 清單的內容。
collaboration.maxCollabors 小於或等於 20 的整數 5 指定您可以邀請加入工作階段的協作者數目上限。
collaboration.serverUrl [URL] 未定義 指定要納入協作邀請的伺服器 URL。
Desktop.displayNumberMax 整數 159

指定要配置給使用者工作階段的 X Window 系統顯示號碼的範圍上限。SLED/SLES 桌面平台上不支援此功能。

若要將配置限制為單一顯示號碼，請將 Desktop.displayNumberMax 和 Desktop.displayNumberMin 設定為相同的值。

備註： 如果您指定的範圍包含 0 到 9 的任何顯示號碼，則 X 伺服器可能會發生衝突。請使用 VMware 知識庫 (KB) 文章 81704 中所述的因應措施。
Desktop.displayNumberMin 整數 100

指定要配置給使用者工作階段的 X Window 系統顯示號碼的範圍下限。SLED/SLES 桌面平台上不支援此功能。

若要將配置限制為單一顯示號碼，請將 Desktop.displayNumberMax 和 Desktop.displayNumberMin 設定為相同的值。

備註： 如果您指定的範圍包含 0 到 9 的任何顯示號碼，則 X 伺服器可能會發生衝突。請使用 VMware 知識庫 (KB) 文章 81704 中所述的因應措施。
mksVNCServer.useUInputButtonMapping true 或 false false

設定此選項，以便在 Ubuntu 和 SLED/SLES 桌面平台上以及執行 MATE 的 RHEL 桌面平台上，啟用「左手使用滑鼠」支援。如需詳細資訊，請參閱 VMware 知識庫 (KB) 文章 90098。
mksvhan.clipboardSize 整數 1024 使用此選項，可指定所要複製及貼上的剪貼簿大小上限。
pcscd.maxReaderContext 整數 使用 PC/SC 智慧卡精靈 (pcscd) 定義的值 指定進行智慧卡重新導向時，所允許的讀卡機內容數或插槽數上限。使用此選項，可確保讀卡機內容數上限與自訂 PC/SC Lite 程式庫指定的值相符。
pcscd.readBody true 或 false 使用 PC/SC 智慧卡精靈 (pcscd) 定義的值

指定是否在 CMD_WAIT_READER_STATE_CHANGE 或 CMD_STOP_WAITING_READER_STATE_CHANGE PC/SC Lite 訊息處理常式中讀取 wait_reader_state_change 的內文。

指定 true，表示讀取訊息內文。指定 false，表示跳過讀取訊息內文。

使用此選項，可確保智慧卡重新導向功能的訊息讀取設定，與自訂 PC/SC Lite 程式庫指定的設定相符。只有在設定了 pcscd.maxReaderContext 時，此選項才會生效。
printSvc.customizedPpd printer_name_1=ppd_path_1;printer_name_2=ppd_path_2... 未定義

使用此選項，為透過 VMware Integrated Printing 重新導向的印表機指定自訂 PPD 檔案的檔案路徑。您必須為沒有使用原生印表機驅動程式 (NPD) 或通用印表機驅動程式 (UPD) 的每一部印表機定義自訂 PPD 檔案路徑。

輸入用戶端系統上所定義的印表機名稱，並輸入代理程式機器上自訂 PPD 檔案的絕對檔案路徑。請在清單中的項目之間使用分號。
printSvc.defaultPrintOptions

以空格分隔的列印設定清單：

ColorMode=Color 或 Mono

Duplex=None、DuplexTumble 或 DuplexNoTumble

PageSize= 字串代表媒體大小

number-up= 整數

number-up-layout= None、lrtb、lrbt、rltb、rlbt、tblr、tbrl、btlr 或 btrl

OutputOrder=Normal 或 Reverse

page-set= all、even 或 odd

noCollate 或 Collate

ColorMode=Color

Duplex=None

PageSize=A4

number-up=1

number-up-layout=None

OutputOrder=Normal

page-set=all

noCollate

使用此選項來指定預設列印設定，以便在來源應用程式偵測不到列印設定時，用於透過 VMware Integrated Printing 的列印輸出。輸入區分大小寫的值，並使用空格分隔清單中的項目。

備註： 僅當從 Windows 版 Horizon Client、Linux 版 Horizon Client 或 Mac 版 Horizon Client 列印時，才支援此選項。
  • ColorMode 指定是彩色列印還是灰階列印 (Mono)。
  • Duplex 指定是要僅在紙張的單面上列印 (None)、雙面列印且短邊翻轉 (DuplexTumble)，還是雙面列印且長邊翻轉 (DuplexNoTumble)。
  • PageSize 指定紙張的頁面尺寸。如需允許的值，請參閱 Adobe PostScript 印表機描述檔案格式規格中列出的已註冊 mediaOption 關鍵字。
  • number-up 指定要在排版版面配置中排列在一張紙上的頁面數。
  • number-up-layout 指定要在排版版面配置中使用的排列方式。例如，如果 number-up=4 和 number-up-layout=lrtb，則將第 1 頁放在紙張的左上角，將第 2 頁放在右上角，將第 3 頁放在左下角，然後將第 4 頁放在右下角。
  • OutputOrder 指定是要從第一頁開始列印到最後一頁 (Normal)，還是從最後一頁開始列印到第一頁 (Reverse)。
  • page-set 指定是要列印所有頁 (all)、僅列印偶數頁 (even)，還是僅列印奇數頁 (odd)。
  • noCollate/Collate 指定是否要在多份列印作業中自動分頁。
printSvc.enable true 或 false true

啟用或停用 VMware Integrated Printing 功能，其中包括用戶端印表機重新導向。

備註： 若要啟用 VMware Integrated Printing，您必須將下列這 兩個組態選項設定為 true：
  • /etc/vmware/config 中的 printSvc.enable
  • /etc/vmware/viewagent-custom.conf 中的 PrintRedirEnable

如果將其中任一選項設定為 false，即使另一個選項設定為 true，也會停用 VMware Integrated Printing。
printSvc.logLevel error、warn、info 或 debug info 設定 VMware Integrated Printing 事件記錄的記錄層級。
printSvc.paperListFile 包含可列印紙張大小清單組態檔案的檔案路徑 未定義

使用此選項可定義紙張大小清單，以用於透過 VMware Integrated Printing 的列印輸出。指定格式正確的組態檔案路徑時，只有組態檔案中列出的那些紙張大小才可用作列印時的選項。

備註： 僅在從 Windows 版 Horizon Client 列印時才支援此選項。此選項會全域套用至 Windows 用戶端系統上的所有重新導向印表機。

建立組態檔案時，必須遵循以下格式規則。

  • 組態檔案中的每一行都對應一個特定的紙張大小定義，且必須採用以下格式：keyword, name, widthMm*10, heightMm*10, widthPts, heightPts
  • keyword：輸入用於識別紙張大小的唯一字串。關鍵字的最大長度為 40 個字元，並且只能包含十進位 33 到十進位 126 (含) 範圍內的可列印 ASCII 字元。如需產業標準關鍵字字串的準則，請參閱 Adobe PostScript 印表機描述檔案格式規格中列出的已註冊 mediaOption 關鍵字。
  • name：指定您要顯示在應用程式列印設定之紙張大小的顯示名稱。
  • widthMm*10：輸入紙張的寬度 (以公釐為單位) 並乘以 10。
  • heightMm*10：輸入紙張的高度 (以公釐為單位) 並乘以 10。
  • widthPts：輸入紙張的寬度 (以點為單位)。
  • heightPts：輸入紙張的高度 (以點為單位)。

請參閱以下格式正確的組態檔案範例：

Letter, Letter, 2159, 2794, 612, 792
A3, A3, 2970, 4200, 842, 1191
A4, A4, 2100, 2970, 595, 842
printSvc.printerFilter 一或多個搜尋查詢的邏輯組合 未定義

使用此選項可定義篩選器，以用來指定要從 VMware Integrated Printing 重新導向中排除的用戶端印表機。篩選器中指定的印表機將不會重新導向，且不會在 Linux 桌面平台上顯示為可用印表機。

定義印表機篩選器時，請遵循下列準則。

  • 您可以根據印表機名稱 (PrinterName)、驅動程式名稱 (DriverName) 或驅動程式廠商名稱 (DriverVendorName)，來建構搜尋查詢。
  • 支援規則運算式和萬用字元。
    • 若要指定字元範圍，請使用方括弧 [ ]，例如 [a-z]。
    • 若要指定萬用字元，請使用 .* 或 .?
  • 支援以下邏輯運算子：
    • =
    • AND
    • OR
    • NOT 和 !=
  • 用單引號括住個別的比對運算式。
  • 用雙引號括住整個搜尋查詢。
例如，下列篩選器會排除其印表機名稱中包含前面帶有萬用字元的字串「Port」或「DFCreator」以及其驅動程式名稱中包含字串「Acme」的所有印表機。 
printSvc.printerFilter="(PrinterName='Port' OR  PrinterName='.?DFCreator') AND DriverName='Acme'"
printSvc.usePdfFilter true 或 false true 更新或不更新重新導向印表機的 PPD 檔案，以使用 PDF 作為列印格式。
備註： 僅當從 Linux 版 Horizon Client 或 Mac 版 Horizon Client 列印時，才支援此選項。此選項會全域套用至 Linux 或 Mac 用戶端系統上的所有重新導向印表機。
rdeSvc.allowDisplayScaling true 或 false false 設定此選項可啟用或停用顯示調整值，以變更文字、圖示和導覽元素的大小。
rdeSvc.blockedWindows 列出以分號分隔的應用程式可執行檔路徑 N/A

使用此選項，可讓特定應用程式無法啟動為遠端應用程式工作階段。

請指定每個應用程式可執行檔的路徑，並使用分號分隔清單中的項目。例如：rdeSvc.blockedWindows=/usr/libexec/gnome-terminal-server;
rdeSvc.enableOptimizedResize true 或 false true 設定此選項，可在 Windows 版 Horizon Client 中啟用或停用已發佈應用程式工作階段的最佳化視窗大小調整。啟用此選項時，Windows 用戶端使用者可以調整已發佈的應用程式視窗的大小，而不會遇到畫面構件。
rdeSvc.enableWatermark true 或 false false 啟用或停用數位浮水印功能。如需功能的相關資訊，請參閱VMware Horizon 8 中 Linux 桌面平台的功能。
rdeSvc.watermark.fit

0：並排

1：置中

2：多重

 0 定義畫面上數位浮水印的配置，分成九個方格：
  • 0 = 並排：浮水印會出現在所有的九個方格中。應用程式工作階段一律會使用此配置。
  • 1 = 置中：浮水印會出現在中心方格中。
  • 2 = 多重：浮水印會出現在中心和四個角落的方格中。如果浮水印大小超過方形大小，則會予以調整以維持外觀比例。
rdeSvc.watermark.font

serif

sans-serif

cursive

fantasy

monospace

 serif 定義針對數位浮水印使用的字型。
rdeSvc.watermark.fontSize 值範圍內的整數：8–72 12 定義數位浮水印的字型大小 (以點為單位)。
rdeSvc.watermark.margin 值範圍內的整數：0–1024 50 定義「並排」配置中圍繞數位浮水印的空間量 (以像素為單位)。隨著浮水印調整，邊緣也會按比例調整。
rdeSvc.watermark.opacity 值範圍內的整數：0–255 50 定義數位浮水印文字的透明度等級。
rdeSvc.watermark.rotation 值範圍內的整數：0–360 45 定義數位浮水印文字的顯示角度。
rdeSvc.watermark.template 使用任何可用資訊變數建構的字串：

$BROKER_USER_NAME

$BROKER_DOMAIN_NAME

$USER_NAME

$USER_DOMAIN

$MACHINE_NAME

$REMOTE_CLIENT_IP

$CLIENT_CONNECT_TIME

$USER_DOMAIN\

$USER_NAME\n

$MACHINE_NAME

On

$CLIENT_CONNECT_TIME

\n$REMOTE_CLIENT_IP

 定義您要顯示作為數位浮水印的文字。使用資訊變數的任意組合和順序來建構浮水印。擴充後的字元限制為 1024 個字元和 4096 個字元。如果文字超過長度上限，則系統會將其截斷。
RemoteDisplay.allowAudio true 或 false true 設定此選項可啟用或停用音訊輸出。
RemoteDisplay.allowH264 true 或 false true 設定此選項，可啟用或停用 H.264 編碼。
RemoteDisplay.allowH264YUV444 true 或 false true 設定此選項，可啟用或停用具有高色彩準確度的 H.264 YUV 4:4:4 編碼 (如果用戶端支援)。
RemoteDisplay.allowHEVC true 或 false true 設定此選項，可啟用或停用高效率視訊編碼 (HEVC)。
RemoteDisplay.allowHEVCYUV444 true 或 false true 設定此選項，可啟用或停用具有高色彩準確度的 HEVC YUV 4:4:4 (如果用戶端支援)。
RemoteDisplay.allowVMWKeyEvent2Unicode true 或 false true

設定此選項，可允許或不允許 Horizon Agent 處理代表來自用戶端之鍵盤輸入的 Unicode 事件。

此選項啟用時，用戶端系統會將代表鍵盤輸入的 Unicode 值傳送至遠端桌面平台。由於 Linux 對於 Unicode 輸入不提供原生支援，因此 Horizon Agent 會先將 Unicode 值轉換為 KeyCode，然後再將 KeyCode 傳送至作業系統，以顯示適當的 Unicode 字元。

此選項停用時，Horizon Agent 不會處理任何從用戶端傳送的 Unicode 事件。
RemoteDisplay.buildToPNG true 或 false false 圖形應用程式，特別是圖形設計應用程式，會需要在 Linux 桌面平台的用戶端有像素精準的影像呈現。您可以針對 Linux 桌面平台上產生和在用戶端裝置上呈現的影像和視訊播放，設定無失真建立 PNG 模式。此功能會在用戶端和 ESXi 主機之間使用額外的頻寬。啟用此選項會停用 H.264 編碼。
RemoteDisplay.enableNetworkContinuity true 或 false true 設定此選項，可啟用或停用 Horizon Agent for Linux 中的網路持續性功能。
RemoteDisplay.enableNetworkIntelligence true 或 false true 設定此選項，可啟用或停用 Horizon Agent for Linux 中的網路智慧功能。
RemoteDisplay.enableStats true 或 false false 在 mks 記錄中啟用或停用 VMware Blast 顯示通訊協定統計資料，例如頻寬、FPS、RTT 等。
RemoteDisplay.enableUDP true 或 false true 設定此選項，可啟用或停用 Horizon Agent for Linux 中的 UDP 通訊協定支援。
RemoteDisplay.maxBandwidthBurstMsec 整數 1000

為傳送至用戶端的資料，指定頻寬高載間隔。這個選項用來設定網路頻寬可暫時超出 RemoteDisplay.maxBandwidthKbps 所設定之頻寬上限的時間間隔 (以毫秒為單位)。

例如，RemoteDisplay.maxBandwidthKbps = 4000，且 RemoteDisplay.maxBandwidthBurstMsec = 1000，則在一秒間隔之內，輸出不得超過 4 Kb。但是，這些 4 Kb 資料可以在一秒間隔開始時以集中突增方式輸出，也可以在一秒間隔內視需要散發。
RemoteDisplay.maxBandwidthKbps 整數 1000000

指定 VMware Blast 工作階段的最大頻寬 (Kbps)。頻寬包括所有影像處理、音訊、虛擬通道和 VMware Blast 控制流量。有效值必須小於 4 Gbps (4096000)。

備註： 實際允許的最大頻寬是下列值中的 較小者：
  • 在 RemoteDisplay.maxBandwidthKbps 中明確設定的最大頻寬
  • 根據 RemoteDisplay.maxBandwidthKbpsPerMegaPixelOffset 和 RemoteDisplay.maxBandwidthKbpsPerMegaPixelSlope 所算出的最大頻寬上限
RemoteDisplay.maxBandwidthKbpsPerMegaPixelOffset 整數 0

根據可用於 VMware Blast 工作階段的總螢幕區域，指定用來決定該工作階段最大頻寬上限的偏移和斜率值 (以每秒 kb (Kbps) 為單位)。此最大頻寬上限是根據下列方程式得出

MaxBandwidthCap = Offset + (Slope * ScreenArea)

其中

  • Offset 是 RemoteDisplay.maxBandwidthKbpsPerMegaPixelOffset 所定義的值 (以 Kbps 為單位)
  • Slope 是 RemoteDisplay.maxBandwidthKbpsPerMegaPixelSlope 所定義的值 (以每百萬像素的 Kbps 為單位)
  • ScreenArea 是指用來顯示 Blast 工作階段之監視器的可用總螢幕區域 (以百萬像素為單位)。在工作階段期間會自動偵測到此百萬像素螢幕區域。
備註： 實際允許的最大頻寬是下列值中的 較小者：
  • 在 RemoteDisplay.maxBandwidthKbps 中明確設定的最大頻寬
  • 根據 RemoteDisplay.maxBandwidthKbpsPerMegaPixelOffset 和 RemoteDisplay.maxBandwidthKbpsPerMegaPixelSlope 所算出的最大頻寬上限
RemoteDisplay.maxBandwidthKbpsPerMegaPixelSlope 100 到 100000 之間的整數 6200
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 或 HEVC 編碼之遠端顯示的最佳影像畫質。將該值設定為大於針對 RemoteDisplay.qpminH264 設定的值。
RemoteDisplay.qpminH264 可用值範圍：0-51 10 使用此選項可設定 H264maxQP 量化參數，以指定設定為使用 H.264 或 HEVC 編碼之遠端顯示的最低影像畫質。將該值設定為小於針對 RemoteDisplay.qpmaxH264 設定的值。
RemoteDisplay.updateCacheSizeKB 整數 256000 使用此選項可設定編碼器影像快取的大小上限 (KB)。
  • 快取的最終大小是此處設定的值與用戶端的關聯組態中較小者。
  • 快取的最終大小不能超過執行 Horizon Agent for Linux 的機器上可用 RAM 的一半。
UsbRedirPlugin.log.logLevel error、warn、info、debug、trace 或 verbose info 使用此選項，可設定 USB 重新導向外掛程式的記錄層級。
UsbRedirServer.log.logLevel error、warn、info、debug、trace 或 verbose info 使用此選項，可設定 USB 重新導向伺服器的記錄層級。
vdpservice.log.logLevel fatalerror、warn、info、debug 或 trace 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 篩選器當中，例如 IncludeVidPid 或 IncludePath。
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 8 便會檢查複合 USB 裝置每個介面的裝置系列，以確認必須排除的介面。如果您已經停用自動裝置分割，Horizon 8 會檢查整個複合 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-0f

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 8 不會包含您尚未明確自動排除的元件。您必須指定篩選原則，例如 納入 VidPid 裝置，以納入那些元件。
VMWPkcs11Plugin.log.enable true 或 false false 設定此選項可啟用或停用 True SSO 功能的記錄模式。
VMWPkcs11Plugin.log.logLevel error、warn、info、debug、trace 或 verbose info 使用此選項，可設定 True SSO 功能的記錄層級。
VVC.logLevel fatalerror、warn、info、debug 或 trace info 使用此選項以設定 VVC Proxy 節點的記錄層級。
VVC.RTAV.Enable true 或 false true 設定此選項，以啟用/停用即時影音重新導向。
VVC.RTAV.WebcamDefaultResHeight 可用值範圍：32-2160 未定義 使用此選項，以設定用於即時影音重新導向的預設影像高度 (以像素為單位)。
VVC.RTAV.WebcamDefaultResWidth 可用值範圍：32-4096 未定義 使用此選項，以設定用於即時影音重新導向的預設影像寬度 (以像素為單位)。
VVC.RTAV.WebcamMaxFrameRate 可用值範圍：1-30 未定義，相當於不限制最大畫面播放速率 使用此選項，以設定即時影音重新導向允許的最大畫面播放速率 (單位為畫面數/秒，即 fps)。
VVC.RTAV.WebcamMaxResHeight 可用值範圍：32-2160 未定義，相當於不限制最大影像高度 使用此該選項，以設定即時影音重新導向允許的最大影像高度 (以像素為單位)。
VVC.RTAV.WebcamMaxResWidth 可用值範圍：32-4096 未定義，相當於不限制最大影像寬度 使用此該選項，以設定即時影音重新導向允許的最大影像寬度 (以像素為單位)。
VVC.ScRedir.Enable true 或 false true 設定此選項可啟用/停用智慧卡重新導向。

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

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

表 2. /etc/vmware/viewagent-custom.conf 中的組態選項
選項 值 預設值 說明
CDREnable true 或 false true 使用此選項，可啟用或停用用戶端磁碟機重新導向功能。
AppEnable true 或 false true 使用此選項，以啟用或停用單一工作階段應用程式集區支援。
BlockScreenCaptureEnable true 或 false false 使用此選項來阻止使用者使用 Windows 或 macOS 裝置從其端點擷取其虛擬桌面平台或已發佈應用程式的螢幕擷取畫面。
CollaborationEnable true 或 false true 使用此選項，可啟用或停用 Linux 桌面平台上的工作階段協作功能。
DPISyncEnable true 或 false true 設定此選項來啟用或停用 DPI 同步功能，以確保遠端桌面平台中的 DPI 設定符合用戶端系統的 DPI 設定。
EndpointVPNEnable true 或 false false 設定此選項，可在對Dynamic Environment Manager主控台中所使用端點 IP 位址的範圍評估端點 IP 位址時，指定要使用用戶端的實體網路卡 IP 位址或 VPN IP 位址。如果將該選項設定為 false，將使用用戶端的實體網路卡 IP 位址。否則，即會使用 VPN IP 位址。
HelpDeskEnable true 或 false true 設定此選項，可啟用或停用「服務台工具」功能。
KeyboardLayoutSync true 或 false true 使用此選項，可指定是否將用戶端的系統地區設定清單和目前的鍵盤配置與 Horizon Agent for Linux 桌面平台同步。

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

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

LogCnt 整數 -1 使用此選項以設定 /tmp/vmware-root 中保留的記錄檔計數。
  • -1 - 全部保留
  • 0 - 全部刪除
  • > 0 - 保留的記錄檔計數。
MaxSessionsBuffer

一個整數，介於 1 與在伺服器陣列組態精靈中為每部 RDS 主機的最大工作階段指定的值之間。

5 或 1

在設定伺服器陣列時，請使用此選項來指定每部主機的預先啟動工作階段數目。正確設定後，這個選項有助於加快桌面平台和應用程式工作階段的啟動速度。

對於非 vGPU 伺服器陣列，預設值為 5；對於 vGPU 伺服器陣列，預設值為 1。值越大，意味著 vGPU 或非 vGPU 環境中預先耗用的資源越多。

在使用較低 vGPU 設定檔的負載平衡 vGPU 環境中，不建議設定高值，因為預先耗用 vGPU 資源的比率過高，會影響負載平衡器的行為。例如，如果在負載平衡環境中使用設定檔 2Q，若使用的 MaxSessionBuffer 值較高，可能會阻止負載平衡器從該伺服器陣列指派桌面平台和應用程式。

請參閱Linux 伺服器陣列、已發佈桌面平台和已發佈應用程式的考量事項。
NetbiosDomain 全大寫字母的文字字串 未定義 設定 True SSO 時，使用此選項來設定您組織的網域的 NetBIOS 名稱。
OfflineJoinDomain pbis 或 samba pbis 使用此選項可設定即時複製離線網域加入。執行離線網域加入的可用方法包括 PowerBroker Identity Services Open (PBISO) 驗證和 Samba 離線網域加入。如果此屬性的值不是 pbis 或 samba，則會忽略離線網域加入。
PrintRedirEnable true 或 false true

啟用或停用 VMware Integrated Printing 功能，其中包括用戶端印表機重新導向。

備註： 若要啟用 VMware Integrated Printing，您必須將下列這 兩個組態選項設定為 true：
  • /etc/vmware/config 中的 printSvc.enable
  • /etc/vmware/viewagent-custom.conf 中的 PrintRedirEnable

如果將其中任一選項設定為 false，即使另一個選項設定為 true，也會停用 VMware Integrated Printing。
RunOnceScript 用來將虛擬機器加入 Active Directory 的指令碼 未定義

使用此選項可將複製的虛擬機器重新加入至 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 使用此選項來指定加密清單。您必須使用 OpenSSL 標準所定義的格式。若要尋找 OpenSSL 定義格式的相關資訊，請在網際網路搜尋引擎中輸入下列關鍵字：openssl 加密字串。
SSLProtocols 文字字串 TLSv1_1:TLSv1_2 使用此選項來指定安全性通訊協定。支援的通訊協定為 TLSv1.1 和 TLSv1.2。
SSODesktopType UseGnomeClassic、UseGnomeFlashback、UseGnomeUbuntu、UseMATE 或 UseKdePlasma 未定義

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

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

備註： RHEL 9.x/8.x 桌面平台不支援此選項。 Horizon 8 僅支援 RHEL 9.x/8.x 桌面平台上的 Gnome 桌面平台環境。
SSOEnable true 或 false true 設定此選項，可啟用/停用單一登入 (SSO)。
SSOUserFormat 文字字串 [username] 使用此選項來指定 Single Sign-On 登入名稱的格式。預設值為僅使用者名稱。如果也需要網域名稱，請設定此選項。一般來說，登入名稱為網域名稱加上特殊字元並接著使用者名稱。如果特殊字元為反斜線，您必須使用另一個反斜線來逸出。登入名稱格式的範例如下所示：
  • SSOUserFormat=[domain]\\[username]
  • SSOUserFormat=[domain]+[username]
  • SSOUserFormat=[username]@[domain]
子網路 採用 CIDR IP 位址格式的值 [subnet] 如果啟用了 IPv4 支援，請將此選項設定為可供其他機器用來連線至 Horizon Agent for Linux 的 IPv4 子網路。如果有多個具有不同子網路的本機 IP 位址，則會使用已設定子網路中的本機 IP 位址來連線至 Horizon Agent for Linux。您必須使用 CIDR IP 位址格式來指定值。例如，Subnet=123.456.7.8/24。
Subnet6 採用首碼/長度 IP 位址格式的值 [subnet6] 如果啟用了 IPv6 支援，請將此選項設定為可供其他機器用來連線至 Horizon Agent for Linux 的 IPv6 子網路。如果有多個具有不同子網路的本機 IP 位址，則會使用已設定子網路中的本機 IP 位址來連線至 Horizon Agent for Linux。您必須使用首碼/長度 IP 位址格式來指定值。例如 Subnet6=2001:db8:abcd:0012::0/64。
DEMEnable true 或 false false 設定此選項，可啟用或停用在 Dynamic Environment Manager 中建立的智慧型原則。如果此選項設定為啟用，則在符合智慧型原則中的條件時，即會強制執行原則。
DEMNetworkPath 文字字串 未定義

設定此選項時，必須與 Dynamic Environment Manager 主控台中所設定的網路路徑相同。路徑的格式必須類似於 //10.111.22.333/view/LinuxAgent/DEMConfig。

網路路徑必須對應於不需要使用者名稱和密碼認證即可進行存取的公用、共用資料夾。
備註： VMwareBlastServer 處理程序會使用 SSLCiphers、SSLProtocols 和 SSLCipherServerPreference 安全性選項。啟動 VMwareBlastServer 處理程序時，Java Standalone Agent 會將這些選項傳入為參數。啟用 Blast 安全閘道 (BSG) 時，這些選項會影響 BSG 與 Linux 桌面平台之間的連線。BSG 未啟用時，這些選項會影響用戶端與 Linux 桌面平台之間的連線。

/etc/vmware/viewagent-greeter.conf 中的組態設定

/etc/vmware/viewagent-greeter.conf 檔案中的設定支援 True SSO 和智慧卡 SSO 功能失敗情況。組態檔包含兩個區段：[SSOFailed] 和 [PKCS11]。

[SSOFailed] 下的 defaultUsername 設定指定萬一 True SSO 或智慧卡 SSO 失敗，VMware Greeter 如何擷取預設使用者名稱。

[PKCS11] 下的設定用於在智慧卡 SSO 驗證失敗時，從智慧卡憑證中擷取預設使用者名稱。

備註： 只有在將 defaultUsername 設定為 false 時， [PKCS11] 設定才會生效。
表 3. /etc/vmware/viewagent-greeter.conf 中的組態設定
區段 設定 值/格式 預設值 說明
[SSOFailed] defaultUsername true 或 false true

使用此設定時，可指定在 Single Sign-On 處理程序失敗時，要如何取得使用者名稱。此設定的行為在 True SSO 和智慧卡 SSO 之間有所不同。

當 True SSO 失敗時 -

  • 如果設定為 true，Greeter 會取得用來登入 Horizon Connection Server 的預設使用者名稱。
  • 如果設定為 false，Greeter 不會嘗試取得預設使用者名稱。使用者必須在 Greeter 畫面中手動輸入使用者名稱。

當智慧卡 SSO 失敗時 -

  • 如果設定為 true，Greeter 會取得用來登入 Horizon Connection Server 的預設使用者名稱。
  • 如果設定為 false，Greeter 會從智慧卡上的憑證來取得預設使用者名稱，但前提是 /etc/vmware/viewagent-greeter.conf 中的 PKCS #11 設定必須設定正確。然後，Greeter 會提示使用者輸入智慧卡 PIN。
備註： 只有在將 defaultUsername 設定為 false 時，PKCS #11 設定才會生效。
[SSOFailed] scAuthTimeout 整數 120 使用此設定來指定智慧卡 SSO 驗證的逾時期間 (以秒為單位)。下列準則適用：
  • 如果將值設定為 0，則會無限期嘗試智慧卡 SSO 驗證，不會逾時。
  • 如果不設定此設定，則智慧卡 SSO 會使用預設逾時 120 秒。
[PKCS11] module 檔案路徑 未定義 使用此設定時，可指定智慧卡驅動程式的路徑。此設定是必要的。
[PKCS11] slotDescription 文字字串 未定義

使用此設定時，可指定智慧卡讀卡機所使用的插槽標籤。指定 "none" 時，則第一個插槽會與可用的驗證 Token 搭配使用。此設定為選用。

備註： 您可以使用 slotDescription 或 slotNum 設定來指定插槽。下列準則適用：
  • 如果同時指定這兩項設定，則 slotDescription 設定優先採用。
  • 如果未指定這兩項設定，Greeter 會將第一個插槽與可用的 Token 搭配使用。
[PKCS11] slotNum 整數 -1 (未定義插槽號碼)

使用此設定時，可指定智慧卡讀卡機所使用的插槽號碼。此設定為選用。

有關此設定與 slotDescription 設定有何關係的資訊，請參閱此資料表中的上一筆項目。

備註： 僅當您的 PKCS #11 實作可確定插槽編號一致時，才使用此設定。
[PKCS11] service 檔案路徑 未定義 使用此設定時，可指定用於智慧卡驗證的 PAM 模組的路徑。此設定是必要的。
[PKCS11] mapper 檔案路徑 未定義 使用此設定時，可指定用於智慧卡驗證的一般名稱 (CN) 對應程式檔案的路徑。此設定是必要的。
[PKCS11] waitForToken 整數 10000

使用此設定時，可指定一個時段 (以毫秒 (ms) 為單位)，以便在這段時間偵測智慧卡插槽中的驗證 Token。如果 Greeter 在這個期間內無法偵測到 Token，則會取消目前的嘗試，且 Greeter 會開始新的偵測嘗試。

請遵循以下所述：

  • 如果將該值設定為 -1，則 Greeter 會無限期地嘗試偵測 Token，而不會發生逾時。
  • 如果未設定，此設定將使用預設的逾時值 10000 毫秒。