對於 Linux 桌面平台,您可以透過編輯 config 檔案、viewagent-custom.conf 檔案和 viewagent-greeter.conf 檔案中的項目來設定特定選項。
在安裝 Horizon Agent 的過程中,安裝程式會將以下組態範本檔複製到 /etc 目錄下的子目錄中:
config.templateviewagent-custom.conf.templateviewagent-greeter.conf.template
此外,如果 config、viewagent-custom.conf 和 viewagent-greeter.conf 不存在,安裝程式會執行下列動作:
- 將
config.template複製到config - 將
viewagent-custom.conf.template複製到viewagent-custom.conf - 將
viewagent-greeter.conf.template複製到viewagent-greeter.conf
這些組態檔會列出並記錄所有 Horizon Agent for Linux 組態選項。若要設定選項,請移除註解並適當地變更值。
例如,config 中的下列行會啟用建置為無失真 PNG 模式。
RemoteDisplay.buildToLossless=TRUE
進行組態變更之後,請將 Linux 重新開機以使變更生效。
組態中的組態選項
BlastServer 和 BlastProxy 程序及其相關的外掛程式與程序會使用 config 組態檔。
**附註:**下表包含 Horizon Agent 組態檔中各項代理程式強制執行的 USB 裝置原則設定說明。Horizon Agent 會使用這些設定,並將其傳遞給 Horizon Client 以進行解譯和強制執行。強制執行的方式取決於您是否指定合併修飾詞 ((m)),以在套用 Horizon Client 篩選原則設定的同時套用 Horizon Agent 篩選原則設定,或是指定覆寫修飾詞 ((o)),以使用 Horizon Agent 篩選原則設定取代 Horizon Client 篩選原則設定。
組態檔中的組態選項
| 值/格式 | 預設值 | 說明 | |
|---|---|---|---|
| appScanner.logLevel | error、warn、info 或 debug | info |
使用此選項可指定 appScanner 記錄檔中報告的詳細資料層級,而這會記錄遠端應用程式工作階段的相關活動。有效值的範圍從最不詳細的「錯誤」層級,以至於最詳細的「偵錯」層級。
您可以在檔名包含字串 appScanner-pid.log 的檔案中找到 appScanner 登入資訊,其中 pid 為 appScanner 程序的識別碼。記錄檔位於機器的 /tmp 檔案結構中。 |
| 選項 | error、warn、info、verbose、debug 或 trace | info |
使用此選項可指定在 BlastProxy 記錄檔中回報的詳細層級。有效值範圍從最簡略的「error」層級到最詳細的「trace」層級。
您可以在檔名包含字串 BlastProxy-pid.log 的檔案中找到 BlastProxy 登入資訊,其中 pid 為 BlastProxy 程序的識別碼。記錄檔位於機器的 /tmp 檔案結構中。 |
| 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 | 使用此選項可設定 CDRserver.log 檔案的記錄層級。 |
| cdrserver.permissions | R | RW | 使用此選項可套用 Horizon Agent 在 Horizon Client 所共用資料夾上的讀寫權限。例如:
|
| cdrserver.sharedFolders | file_path1,R;file-path2,; file_path3,R; ... | 未定義 | 指定用戶端可以與 Linux 桌面平台共用的一或多個資料夾的檔案路徑。例如:
|
| Clipboard.Direction | 0、1、2 或 3 | 2 | 使用此選項來指定剪貼簿重新導向原則。有效值如下:
|
| 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 伺服器發生衝突。請使用知識庫 (KB) 文章 81704 中所述的因應措施。 |
| Desktop.displayNumberMin | 整數 | 100 | 指定要配置給使用者工作階段的 X Window 系統顯示號碼的範圍下限。SLED/SLES 桌面平台上不支援此功能。 若要將配置限制為單一顯示號碼,請將 Desktop.displayNumberMax 和 Desktop.displayNumberMin 設定為相同的值。 附註:如果您指定的範圍包含顯示號碼 0 至 9,可能會與 X 伺服器發生衝突。請使用知識庫 (KB) 文章 81704 中所述的因應措施。 |
| DesktopWorker.ttyNum | 介於 2 到 12 之間的整數 | 7 | 指派用於在 Linux 實體主機上顯示圖形桌面平台的 TTY 功能鍵。預設值為 7,即指派 Ctrl+Alt+F7 鍵作為顯示圖形桌面平台的快捷方式。 該選項僅適用於實體主機。 |
| mksVNCServer.useUInputButtonMapping | true 或 false | false | 設定此選項,以便在 Ubuntu 和 SLED/SLES 桌面平台上以及執行 MATE 的 RHEL 桌面平台上,啟用「左手使用滑鼠」支援。如需詳細資訊,請參閱知識庫 (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... | 未定義 | 使用此選項可指定透過 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 |
如果來源應用程式無法偵測列印設定,請使用此選項來指定透過 Integrated Printing 輸出時的預設列印設定。輸入區分大小寫的值,並在清單項目之間以空格分隔。
附註:此選項僅支援從 Windows 版、Linux 版或 Mac 版 Horizon Client 進行列印時使用。
|
| printSvc.enable | true 或 false | true |
啟用或停用包含用戶端印表機重新導向功能的 Integrated Printing 功能。
附註:若要啟用 Integrated Printing,您必須將以下兩個組態選項皆設定為 true:
|
| printSvc.jobOwnerAsLocal | true 或 false | false | 定義在 Integrated Printing 功能中,應將哪個使用者名稱設為列印作業擁有者名稱。指定為 true 會將本機使用者名稱設為列印作業擁有者名稱。指定為 false 會將登入遠端工作階段時所使用的名稱設為列印作業擁有者名稱。 |
| printSvc.logLevel | error、warn、info 或 debug | info | 設定 Integrated Printing 事件記錄的記錄層級。 |
| printSvc.paperListFile | 包含可列印紙張大小清單組態檔案的檔案路徑 | 未定義 |
使用此選項可定義可透過 Integrated Printing 輸出列印所使用的紙張大小清單。當您指定正確格式的組態檔路徑時,列印時僅能使用該組態檔中列出的紙張尺寸作為可用選項。
附註:此選項僅支援從 Windows 版 Horizon Client 進行列印。此選項會全域套用至 Windows 用戶端系統上的所有重新導向印表機。
建立組態檔案時,必須遵循以下格式規則。
|
| printSvc.printerFilter | 一或多個搜尋查詢的邏輯組合 | 未定義 |
使用此選項可定義篩選器,以指定要從 Integrated Printing 重新導向中排除的用戶端印表機。篩選器中指定的印表機將不會重新導向,且不會在 Linux 桌面平台上顯示為可用印表機。
定義印表機篩選器時,請遵循下列準則。
|
| printSvc.usePdfFilter | true 或 false | true | 更新或不更新重新導向印表機的 PPD 檔,以使用 PDF 作為列印格式。 附註:此選項僅支援從 Linux 版或 Mac 版 Horizon Client 進行列印。此選項會全域套用至 Linux 或 Mac 用戶端系統上的所有重新導向印表機。 |
| printSvc.watermarkEnabled | true 或 false | false | 設定此選項可啟用或停用在使用 Integrated Printing 列印作業時加入浮水印的功能。如需詳細資訊,請參閱在 Linux 桌面平台上使用 Integrated Printing 新增浮水印。 |
| rdeSvc.allowDisplayScaling | true 或 false | false | 設定此選項可啟用或停用顯示調整值,以變更文字、圖示和導覽元素的大小。 |
| rdeSvc.blockedWindows | 列出以分號分隔的應用程式可執行檔路徑 | 不適用 |
使用此選項,可讓特定應用程式無法啟動為遠端應用程式工作階段。
請指定每個應用程式可執行檔的路徑,並使用分號分隔清單中的項目。例如:rdeSvc.blockedWindows=/usr/libexec/gnome-terminal-server; |
| rdeSvc.enableOptimizedResize | true 或 false | true | 設定此選項,可在 Windows 版 Horizon Client 中啟用或停用已發佈應用程式工作階段的最佳化視窗大小調整。啟用此選項時,Windows 用戶端使用者可以調整已發佈的應用程式視窗的大小,而不會遇到畫面構件。 |
| rdeSvc.enableWatermark | true 或 false | false | 啟用或停用數位浮水印功能。如需此功能的相關資訊,請參閱 Omnissa Horizon 8 中的 Linux 桌面平台功能。 |
| rdeSvc.watermark.fit | 0:並排 1:置中 2:多重 | 0 | 定義畫面上數位浮水印的配置,分成九個方格:
|
| 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 選項可用於設定用戶端傳送的鍵盤輸入是否以 Unicode 事件表示。 | true 或 false | true | 請連絡 Omnissa 支援團隊,以取得您的 Horizon 版本特定的選項名稱。設定此選項可允許或不允許 Horizon Agent 處理代表來自用戶端鍵盤輸入的 Unicode 事件。 此選項啟用時,用戶端系統會將代表鍵盤輸入的 Unicode 值傳送至遠端桌面平台。由於 Linux 本身不支援 Unicode 輸入,Horizon Agent 會先將 Unicode 值轉換為 KeyCode,然後再將這些 KeyCode 傳送至作業系統,以顯示對應的 Unicode 字元。 停用此選項時,Horizon Agent 不會處理任何由用戶端傳送的 Unicode 事件。 |
| RemoteDisplay.buildToLossless | true 或 false | false | 圖形應用程式,特別是圖形設計應用程式,會需要在 Linux 桌面平台的用戶端有像素精準的影像呈現。您可以針對 Linux 桌面平台上產生並在用戶端裝置上呈現的影像和視訊播放,設定不失真建置模式。此功能會在用戶端和 ESXi 主機之間使用額外的頻寬。啟用此選項會停用 H.264 編碼。 |
| RemoteDisplay.cursorWarpingMaxDelayMsec | 大於或等於 250 的整數 | 1000 | 此設定可調整滑鼠游標異常移動的偵測。此數值表示自使用者最近一次滑鼠互動起算的最長延遲時間;在此時間內,代理程式端會偵測滑鼠移動是否為游標異常移動。較高的數值可提升游標異常移動偵測的準確度,並避免代理程式與用戶端的滑鼠移動互相干擾。較低的數值可加快偵測非源自 Horizon Client 的滑鼠移動,例如在使用 Zoom 或 Microsoft Teams 分享螢幕畫面時,遠端使用者的滑鼠移動。 |
| RemoteDisplay.cursorWarpingSimulateUserInput | true 或 false | false | 此設定可因應不支援游標異常移動的應用程式限制,例如 Microsoft Teams 和 Zoom 的螢幕畫面分享功能。如果設為 true,當 Horizon Agent 偵測到滑鼠游標異常移動 (例如滑鼠移動突然由 Horizon Agent 而非 Horizon Client 產生) 時,系統會模擬該滑鼠動作,就如同是由 Horizon Client 所觸發。當使用者透過 Microsoft Teams 或 Zoom 分享 Horizon Agent 桌面平台螢幕時,若希望共享對象也能看到游標異常移動,這項功能會很有幫助。 |
| RemoteDisplay.enableCursorWarping | true 或 false | false | 將此選項設為 true 以啟用游標異常移動偵測功能。啟用此設定時,遠端代理程式會偵測代理程式上起始的突然滑鼠位置變更,並透過移動使用者的本機滑鼠游標將其反映至用戶端。停用此設定時,用戶端會忽略遠端代理程式中突然的游標移動。此設定依預設為停用 (設為 false)。 |
| RemoteDisplay.enableNetworkContinuity | true 或 false | true | 將此選項設為 true 以啟用,或設為 false 以停用 Horizon Agent for Linux 的網路連續性功能。 |
| RemoteDisplay.enableNetworkIntelligence | true 或 false | true | 將此選項設為 true 以啟用,或設為 false 以停用 Horizon Agent for Linux 的網路智慧功能。 |
| RemoteDisplay.enableStats | true 或 false | false | 在 mks 記錄中啟用或停用 Omnissa Horizon Blast Protocol 統計資訊,例如頻寬、FPS、RTT 等。 |
| RemoteDisplay.enableUDP | true 或 false | true | 將此選項設為 true 以啟用,或設為 false 以停用 Horizon Agent for Linux 的 UDP 通訊協定支援。 |
| RemoteDisplay.maxBandwidthBurstMsec | 整數 | 1000 | 為傳送至用戶端的資料,指定頻寬高載間隔。此選項可設定時間間隔 (以毫秒為單位),在此期間內網路頻寬可暫時超過 RemoteDisplay.maxBandwidthKbps 所設定的頻寬上限。 例如,若 RemoteDisplay.maxBandwidthKbps = 4000,且 RemoteDisplay.maxBandwidthBurstMsec = 1000,則在一秒的時間間隔內,輸出不得超過 4 Kb。但是,這些 4 Kb 資料可以在一秒間隔開始時以集中突增方式輸出,也可以在一秒間隔內視需要散發。 |
| RemoteDisplay.maxBandwidthKbps | 整數 | 1000000 |
指定 Horizon Blast 工作階段的最大頻寬,單位為每秒千位元 (Kbps)。此頻寬包含所有影像、音訊、虛擬通道以及 Horizon Blast 控制流量。有效值必須小於 4 Gbps (4096000)。
附註:實際允許的最大頻寬為以下數值中的較小者:
|
| RemoteDisplay.maxBandwidthKbpsPerMegaPixelOffset | 整數 | 0 |
指定用於決定 Horizon Blast 工作階段最大頻寬上限的偏移值與斜率值 (單位為千位元/秒,即 Kbps),其計算依據為該工作階段可用的螢幕總面積。此最大頻寬上限的計算方式如下:
其中
|
| RemoteDisplay.maxBandwidthKbpsPerMegaPixelSlope | 100 到 100000 之間的整數 | 6200 | |
| RemoteDisplay.minBandwidthKbps | 整數 | 256 | 指定 Horizon Blast 工作階段的最小頻寬,單位為千位元/秒 (Kbps)。此頻寬包含所有影像、音訊、虛擬通道以及 Horizon Blast 控制流量。 |
| RemoteDisplay.maxFPS | 整數 | 30 | 指定畫面更新的最大速率。使用此設定,可管理使用者所使用的平均頻寬。有效值範圍為 3 到 120。依預設為每秒 30 個畫面。 需要額外的組態才能支援 120 FPS 的工作階段。請參閱其他最大畫面播放速率資訊 |
| 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)。
|
| 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 | fatal error、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 不會自動包含您未明確排除的元件。您必須指定篩選原則,例如 Include VidPid Device,才能將這些元件納入。 |
| Pkcs11Plugin 相關的記錄選項 | true 或 false | false | 請連絡 Omnissa 支援團隊,以取得您的 Horizon 版本特定的選項名稱。設定此選項可啟用或停用 True SSO 功能的記錄模式。 |
| VPkcs11Plugin 相關的記錄層級選項 | error、warn、info、debug、trace 或 verbose | info | 請連絡 Omnissa 支援團隊,以取得您的 Horizon 版本特定的選項名稱。使用此與 Pkcs11Plugin 相關的選項可設定 True SSO 功能的記錄層級。 |
| VVC.logLevel | fatal error、warn、info、debug 或 trace | info | 使用此選項以設定 VVC Proxy 節點的記錄層級。 |
| VVC.RTAV.Enable | true 或 false | true | 設定此選項,以啟用/停用即時影音 (RTAV) 重新導向。 |
| VVC.RTAV.WebcamDefaultResHeight | 可用值範圍:32-2160 | 未定義 | 使用此選項,以設定用於即時影音 (RTAV) 重新導向的預設影像高度 (以像素為單位)。 |
| VVC.RTAV.WebcamDefaultResWidth | 可用值範圍:32-4096 | 未定義 | 使用此選項,以設定用於即時影音 (RTAV) 重新導向的預設影像寬度 (以像素為單位)。 |
| VVC.RTAV.WebcamMaxFrameRate | 可用值範圍:1-30 | 未定義,相當於不限制最大畫面播放速率 | 使用此選項,以設定即時影音 (RTAV) 重新導向允許的最大畫面播放速率 (單位為畫面數/秒,即 fps)。 |
| VVC.RTAV.WebcamMaxResHeight | 可用值範圍:32-2160 | 未定義,相當於不限制最大影像高度 | 使用此該選項,以設定即時影音 (RTAV) 重新導向允許的最大影像高度 (以像素為單位)。 |
| VVC.RTAV.WebcamMaxResWidth | 可用值範圍:32-4096 | 未定義,相當於不限制最大影像寬度 | 使用此該選項,以設定即時影音 (RTAV) 重新導向允許的最大影像寬度 (以像素為單位)。 |
| VVC.ScRedir.Enable | true 或 false | true | 設定此選項可啟用/停用智慧卡重新導向。 |
viewagent-custom.conf 中的組態選項
Java Standalone Agent 使用組態檔 viewagent-custom.conf。
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 Console 中評估端點 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 目錄中名稱包含 root 的子目錄內,設定保留的記錄檔數量。
|
| MaxSessionsBuffer | 一個整數,介於 1 與在伺服器陣列組態精靈中為每部 RDS 主機的最大工作階段指定的值之間。 | 5 或 1 | 在設定伺服器陣列時,請使用此選項來指定每部主機的預先啟動工作階段數目。正確設定後,這個選項有助於加快桌面平台和應用程式工作階段的啟動速度。 對於非 vGPU 伺服器陣列,預設值為 5;對於 vGPU 伺服器陣列,預設值為 1。值越大,意味著 vGPU 或非 vGPU 環境中預先耗用的資源越多。 在使用較低 vGPU 設定檔的負載平衡 vGPU 環境中,不建議設定高值,因為預先耗用 vGPU 資源的比率過高,會影響負載平衡器的行為。例如,如果在負載平衡環境中使用設定檔 2Q,若使用的 MaxSessionBuffer 值較高,可能會阻止負載平衡器從該伺服器陣列指派桌面平台和應用程式。 |
| NetbiosDomain | 全大寫字母的文字字串 | 未定義 | 設定 True SSO 時,使用此選項來設定您組織的網域的 NetBIOS 名稱。 |
| OfflineJoinDomain | pbis 或 samba | pbis | 使用此選項可設定即時複製離線網域加入。執行離線網域加入的可用方法包括 PowerBroker Identity Services Open (PBISO) 驗證和 Samba 離線網域加入。如果此屬性的值不是 pbis 或 samba,則會忽略離線網域加入。 |
| PrintRedirEnable | true 或 false | true |
啟用或停用包含用戶端印表機重新導向功能的 Integrated Printing 功能。
附註:若要啟用 Integrated Printing,您必須將以下兩個組態選項皆設定為 true:
|
| 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 | |
| SSLCertName | 文字字串 | 附註:您必須向 Omnissa 支援團隊取得適用於您 Horizon 版本的字串,才能用於此選項。 |
使用 DeployBlastCert.sh 指令碼部署 BlastServer 憑證時,可使用此選項指定憑證名稱,該名稱將顯示於 Linux 金鑰環中。
如需詳細資訊,請參閱在 Linux 機器上為 BlastServer 精靈安裝 CA 簽署憑證。 |
| SSLKeyName | 文字字串 | 附註:您必須向 Omnissa 支援團隊取得適用於您 Horizon 版本的字串,才能用於此選項。 |
使用 DeployBlastCert.sh 指令碼部署 BlastServer 憑證時,可使用此選項指定私密金鑰名稱,該名稱將顯示於 Linux 金鑰環中。
如需詳細資訊,請參閱在 Linux 機器上為 BlastServer 精靈安裝 CA 簽署憑證。 |
| SSLCiphers | 文字字串 | kECDH+AESGCM:ECDH+AESGCM:RSA+AESGCM:kECDH+AES:ECDH+AES:RSA+AES:TLS13-AES-256-GCM-SHA384:TLS13-AES-128-GCM-SHA256 |
使用此選項可指定搭配 TLSv1.1 和 TLSv1.2 使用的加密清單。此選項僅在您將 SSLProtocols 設定為 TLSv1.1 或 TLSv1.2 時生效。
加密清單包含一或多個依喜好設定順序的加密字串,並以冒號分隔。加密字串須區分大小寫。
您必須使用 OpenSSL 標準所定義的格式。若要查詢有關 OpenSSL 定義格式的資訊,請在網際網路搜尋引擎中輸入以下關鍵字:openssl cipher string。 |
| SSLProtocols | 文字字串 | TLSv1.3:TLSv1.2 (在非 FIPS 模式中) TLSv1.2 (在 FIPS 模式中) | 使用此選項來指定安全性通訊協定。支援的通訊協定包括 TLSv1.1、TLSv1.2 和 TLSv1.3。 |
| TLSCipherSuites | 文字字串 | TLS_AES_256_GCM_SHA384:TLS_AES_128_GCM_SHA256 |
使用此選項可指定搭配 TLSv1.3 使用的加密清單。此選項僅在您將 SSLProtocols 設定為 TLSv1.3 時生效。
加密清單包含一或多個依喜好設定順序的加密字串,並以冒號分隔。加密字串須區分大小寫。
您必須使用 OpenSSL 標準所定義的格式。若要查詢有關 OpenSSL 定義格式的資訊,請在網際網路搜尋引擎中輸入以下關鍵字:openssl cipher string。 |
| SSODesktopType | UseGnomeClassic、UseGnomeFlashback、UseGnomeUbuntu、UseMATE 或 UseKdePlasma | 未定義 | 此選項會指定 SSO 啟用時所要使用的桌面平台環境,而不是預設桌面平台環境。 在指定要使用選取的桌面平台環境之前,您必須先確定您的桌面平台已安裝該環境。如果您在 Ubuntu 桌面平台中設定此選項,無論 SSO 功能是否啟用,此選項都會生效。 附註:此選項在 RHEL 9.x/8.x 桌面平台上不受支援。Horizon 8 僅支援 RHEL 9.x/8.x 桌面平台上的 Gnome 桌面平台環境。 |
| SSOEnable | true 或 false | true | 設定此選項,可啟用/停用 Single Sign-On (SSO)。 |
| SSOUserFormat | 文字字串 | [username] | 使用此選項來指定 Single Sign-On 登入名稱的格式。預設值為僅使用者名稱。如果也需要網域名稱,請設定此選項。一般來說,登入名稱為網域名稱加上特殊字元並接著使用者名稱。如果特殊字元為反斜線,您必須使用另一個反斜線來逸出。登入名稱格式的範例如下所示:
|
| 子網路 | 採用 CIDR IP 位址格式的值 | [subnet] | 啟用 IPv4 支援後,將此選項設為一個 IPv4 子網路,供其他機器用來連線至 Horizon Agent for Linux。如果存在多個屬於不同子網路的本機 IP 位址,則會使用已設定子網路中的本機 IP 位址來連線至 Horizon Agent for Linux。您必須使用 CIDR IP 位址格式來指定值。例如,Subnet=123.456.7.8/24。 |
| Subnet6 | 採用首碼/長度 IP 位址格式的值 | [subnet6] | 啟用 IPv6 支援後,將此選項設為一個 IPv6 子網路,供其他機器用來連線至 Horizon Agent for Linux。如果存在多個屬於不同子網路的本機 IP 位址,則會使用已設定子網路中的本機 IP 位址來連線至 Horizon Agent for Linux。您必須使用首碼/長度 IP 位址格式來指定值。例如 Subnet6=2001:db8:abcd:0012::0/64。 |
| DEMEnable | true 或 false | true | 將此選項設為啟用或停用在 Dynamic Environment Manager 中建立的智慧型原則。 若要讓 Dynamic Environment Manager 原則生效,您必須將此選項設為 true,並設定 DEMNetworkPath 選項。 當 Dynamic Environment Manager 原則生效且符合智慧型原則中的條件時,該原則便會被套用。 |
| DEMNetworkPath | 文字字串 | 未定義 |
您必須將此選項設為與 Dynamic Environment Manager Console 中所設定的網路路徑相同。路徑的格式必須類似於 //10.111.22.333/view/LinuxAgent/DEMConfig.
網路路徑必須對應於不需要使用者名稱和密碼認證即可進行存取的公用、共用資料夾。 |
**附註:**BlastServer 行程會使用 SSLCiphers、SSLProtocols 和 SSLCipherServerPreference 安全性選項。啟動 BlastServer 處理程序時,Java Standalone Agent 會將這些選項作為參數傳遞。啟用 Blast 安全閘道 (BSG) 時,這些選項會影響 BSG 與 Linux 桌面平台之間的連線。BSG 未啟用時,這些選項會影響用戶端與 Linux 桌面平台之間的連線。
viewagent-greeter.conf 中的組態設定
viewagent-greeter.conf 檔案中的設定支援 True SSO 與智慧卡 SSO 功能。當 SSO 停用時,這些設定同樣適用於 Horizon Greeter。此組態檔包含兩個區段:[SSOFailed] 和 [PKCS11]。
[SSOFailed] 區段下的 defaultUsername 設定會指定 Horizon Greeter 在 True SSO 或智慧卡 SSO 失敗時,如何擷取預設使用者名稱。
[PKCS11] 下的設定用於在智慧卡 SSO 驗證失敗時,從智慧卡憑證中擷取預設使用者名稱。
附註:****[PKCS11] 設定僅在您將 defaultUsername 設為 false 時才會生效。
viewagent-greeter.conf 中的組態設定
| 區段 | 設定 | 值/格式 | 預設值 | 說明 |
|---|---|---|---|---|
| [SSOFailed] | defaultUsername | true 或 false | true |
使用此設定時,可指定在 Single Sign-On 處理程序失敗時,要如何取得使用者名稱。此設定在 True SSO 與智慧卡 SSO 之間的行為有所不同。
當 True SSO 失敗時 -
|
| [SSOFailed] | scAuthTimeout | 整數 | 120 | 使用此設定來指定智慧卡 SSO 驗證的逾時期間 (以秒為單位)。適用下列指引:
|
| [PKCS11] | module | 檔案路徑 | 未定義 | 使用此設定時,可指定智慧卡驅動程式的路徑。此設定是必要的。 |
| [PKCS11] | slotDescription | 文字字串 | 未定義 |
使用此設定時,可指定智慧卡讀卡機所使用的插槽標籤。指定「none」以使用第一個具有可用驗證權杖的插槽。此設定為選用。
附註:您可以使用 slotDescription 或 slotNum 設定來指定插槽。適用下列指引:
|
| [PKCS11] | slotNum | 整數 | -1 (未定義插槽號碼) | 使用此設定時,可指定智慧卡讀卡機所使用的插槽號碼。此設定為選用。 如需瞭解此設定與 slotDescription 設定之間的關係,請參閱本表格中的前一項。 附註:僅當您的 PKCS #11 實作能確保插槽編號一致時,才可使用此設定。 |
| [PKCS11] | service | 檔案路徑 | 未定義 | 使用此設定時,可指定用於智慧卡驗證的 PAM 模組的路徑。此設定是必要的。 |
| [PKCS11] | mapper | 檔案路徑 | 未定義 | 使用此設定時,可指定用於智慧卡驗證的一般名稱 (CN) 對應程式檔案的路徑。此設定是必要的。 |
| [PKCS11] | waitForToken | 整數 | 10000 |
使用此設定時,可指定一個時段 (以毫秒 (ms) 為單位),以便在這段時間偵測智慧卡插槽中的驗證權杖。如果 Greeter 在這個期間內無法偵測到權杖,則會取消目前的嘗試,且 Greeter 會開始新的偵測嘗試。
請遵循以下所述:
|
此頁面對您有幫助嗎?