您可以在 /etc/omnissa/config、/usr/lib/omnissa/config 和 ~/.omnissa/config 組態檔中設定 USB 組態屬性。
使用下列語法在組態檔中設定 USB 組態屬性。
viewusb.property1 = "value1"
透過 USB 組態屬性,您可以控制是否重新導向特定類型的裝置。此外,也提供篩選屬性,讓您能夠包含或排除特定類型的裝置,並提供可分割複合裝置的相關屬性設定。
某些屬性值需指定 USB 裝置的 VID (廠商識別碼) 和 PID (產品識別碼)。若要查詢 VID 和 PID,您可以在網際網路上以產品名稱搭配 vid 和 pid 關鍵字進行搜尋。或者,當 Omnissa Horizon Client 執行中且您將 USB 裝置插入本機系統時,也可以查看 /tmp/omnissa-<current_user>/horizon-client-usbd-*.log 檔案。若要設定此檔案的位置,請在 /etc/omnissa/config 檔案中使用 view-usbd.log.fileName 屬性,例如:
view-usbd.log.fileName = "/tmp/usbd.log"
下表說明可用的 USB 組態屬性。
| 原則名稱和屬性 | 說明 |
|---|---|
允許音訊裝置分割
屬性:
viewusb.AllowAutoDeviceSplitting | 允許複合 USB 裝置的自動分割。
預設值為未定義,等同於 false。 |
排除 Vid/Pid 裝置以避免分割
屬性:
viewusb.SplitExcludeVidPid | 排除依照廠商和產品識別碼指定的複合 USB 裝置,不進行分割。設定格式為 vid-xxx1_pid-yyy1[;vid-xxx2_pid-yyy2]...
您必須以十六進位指定識別碼。您可以使用萬用字元 (*) 來替代識別碼中的個別數字。
例如:vid-0781_pid-55**
該預設值未定義。 |
分割 Vid/Pid 裝置
屬性:
viewusb.SplitVidPid | 將依照廠商和產品識別碼指定的複合 USB 裝置元件視為個別裝置。設定格式為
vid-xxxx_pid-yyyy([exintf:zz[;exintf:ww ]])[;...]
您可以使用 exintf 關鍵字,藉由指定他們的介面號碼來將元件自重新導向清單中排除。您必須以十六進位指定識別碼,及以十進位指定介面號碼,包括任何前置的 0。您可以使用萬用字元 (*) 來替代識別碼中的個別數字。
例如:vid-0781_pid-554c(exintf:01;exintf:02)
附註:如果複合裝置中包含會自動排除的元件,例如滑鼠與鍵盤元件,則 Horizon Client 不會自動包含您未明確排除的其他元件。您必須指定過濾原則,例如 [納入 Vid/Pid 裝置],以將這些元件包含在內。
該預設值未定義。 |
允許音訊輸入裝置
屬性:
viewusb.AllowAudioIn | 允許將音訊輸入裝置重新導向。
預設值為未定義,這等同於 false,因為音訊輸入與視訊裝置會使用即時影音 (RTAV) 功能,但依預設不會針對這些裝置使用 USB 重新導向。 |
允許音訊輸出裝置
屬性:
viewusb.AllowAudioOut | 允許將音訊輸出裝置重新導向。
預設值為未定義,等同於 false。 |
允許 HID
屬性:
viewusb.AllowHID | 允許鍵盤或滑鼠以外的輸入裝置進行重新導向。
預設值為未定義,等同於 true。 |
允許 HIDBootable
屬性:
viewusb.AllowHIDBootable | 允許在開機時可用的輸入裝置 (也稱為 HID 可開機裝置),除了鍵盤與滑鼠以外,也能進行重新導向。
預設值為未定義,等同於 true。 |
允許裝置描述元故障安全防護裝置
屬性:
viewusb.AllowDevDescFailsafe | 即使 Horizon Client 無法取得 config/device 描述元,仍允許裝置進行重新導向。
若要在即使無法取得 config/desc 的情形下也允許裝置,請將其包含在 Include 篩選器當中,例如 IncludeVidPid 或 IncludePath。
預設值為未定義,等同於 false。 |
允許鍵盤和滑鼠裝置
屬性:
viewusb.AllowKeyboardMouse | 允許將整合指向裝置 (例如滑鼠、軌跡球或觸控板) 的鍵盤重新導向。
預設值為未定義,等同於 false。 |
允許智慧卡
屬性:
viewusb.AllowSmartcard | 允許將智慧卡裝置重新導向。
預設值為未定義,等同於 false。 |
允許視訊裝置
屬性:
viewusb.AllowVideo | 允許將視訊裝置重新導向。
預設值為未定義,這等同於 false,因為音訊輸入與視訊裝置會使用即時影音 (RTAV) 功能,但依預設不會針對這些裝置使用 USB 重新導向。 |
停用遠端組態下載
屬性:
viewusb.DisableRemoteConfig | 禁止在執行 USB 裝置篩選時使用 Horizon Agent 的設定。
預設值為未定義,等同於 false。 |
排除所有裝置
屬性:
viewusb.ExcludeAllDevices | 排除所有 USB 裝置,避免重新導向。如果設定為 true,您可以使用其他原則設定,以允許特定裝置或裝置系列進行重新導向。如果設定為 false,您可以使用其他原則設定,以防止特定裝置或裝置系列進行重新導向。
如果您在 Horizon Agent 上將 [排除所有裝置] 的值設為 true,且此設定傳遞至 Horizon Client,則 Horizon Agent 的設定會覆寫 Horizon Client 的設定。
預設值為未定義,等同於 false。 |
排除裝置系列
屬性:
viewusb.ExcludeFamily | 排除裝置系列,避免重新導向。設定的格式為 family_name_1[;family_name_2]...
例如:bluetooth;smart-card
如果您已啟用自動裝置分割功能,Horizon Client 會檢查複合 USB 裝置中各個介面的裝置系列,以判斷哪些介面應予以排除。 如果您已關閉自動裝置分割功能,Horizon Client 會根據整個複合 USB 裝置的裝置系列進行檢查。
該預設值未定義。 |
排除 Vid/Pid 裝置
屬性:
viewusb.ExcludeVidPid | 排除具有指定廠商識別碼和產品識別碼的裝置,使其不進行重新導向。設定的格式為 vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]...
您必須以十六進位指定識別碼。您可以使用萬用字元 (*) 來替代識別碼中的個別數字。
例如:vid-0781_pid-****;vid-0561_pid-554c
該預設值未定義。 |
排除路徑
屬性:
viewusb.ExcludePath |
排除位於特定集線器或連接埠路徑上的裝置,避免重新導向。設定的格式為 bus-x1[/y1]..._port-z1[;bus-x2[/y2]..._port-z2]...
您必須以十六進位格式指定匯流排與連接埠號碼。您不能在路徑中使用萬用字元。
例如:bus-1/2/3_port-02;bus-1/1/1/4_port-ff
該預設值未定義。 |
納入裝置系列
屬性:
viewusb.IncludeFamily |
納入可重新導向的裝置系列。設定的格式為 family_name_1[;family_name_2]...
例如:storage
該預設值未定義。 |
納入路徑
屬性:
viewusb.IncludePath |
納入位於特定集線器或連接埠路徑上並可重新導向的裝置。設定的格式為 bus-x1[/y1]..._port-z1[;bus-x2[/y2]..._port-z2]...
您必須以十六進位格式指定匯流排與連接埠號碼。您不能在路徑中使用萬用字元。
例如:bus-1/2_port-02;bus-1/7/1/4_port-0f
該預設值未定義。 |
納入 Vid/Pid 裝置
屬性:
viewusb.IncludeVidPid |
包含具有指定廠商識別碼和產品識別碼的可重新導向裝置。設定的格式為 vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]...
您必須以十六進位指定識別碼。您可以使用萬用字元 (*) 來替代識別碼中的個別數字。
例如:vid-0561_pid-554c
該預設值未定義。 |
排除裝置系列的自動轉送
屬性:
viewusb.ExAutoRedirectFamily |
排除特定裝置系列,使其不會自動轉送。設定的格式為 family_name_1[;family_name_2]...
例如:storage
該預設值未定義。 |
排除特定 VID/PID 裝置的自動轉送
屬性:
viewusb.ExAutoRedirectVidPid |
排除具有指定廠商識別碼和產品識別碼的裝置,使其不會自動轉送。設定的格式為 vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]...
您必須以十六進位指定識別碼。您可以使用萬用字元 (*) 來替代識別碼中的個別數字。
例如:vid-0561_pid-554c
該預設值未定義。 |
USB 重新導向範例
每個範例後皆附有其對 USB 重新導向影響的說明。
-
包含滑鼠裝置系列中的大多數裝置。
viewusb.IncludeFamily = "mouse" viewusb.ExcludeVidPid = "Vid-0461_Pid-0010;Vid-0461_Pid-4d20"此範例中的第一個屬性設定會指示 Horizon Client 允許將滑鼠裝置重新導向至遠端桌面平台。第二個屬性設定則會覆寫第一個屬性設定,指示 Horizon Client 將兩個特定的滑鼠裝置保留在本機,而不進行重新導向。
-
啟用自動裝置分割功能,但排除某一特定裝置不進行分割。對於另一個特定裝置,將其中一個元件保留在本機,並將其他元件重新導向至遠端桌面平台:
viewusb.AllowAutoDeviceSplitting = "True" viewusb.SplitExcludeVidPid = "Vid-03f0_Pid-2a12" viewusb.SplitVidPid = "Vid-0911_Pid-149a(exintf:03)" viewusb.IncludeVidPid = "Vid-0911_Pid-149a"複合 USB 裝置由兩個以上的裝置組成,例如視訊輸入裝置與儲存裝置的組合。此範例中的第一個屬性設定會啟用複合裝置的自動分割功能。第二個屬性設定則排除指定的複合 USB 裝置 (
Vid-03f0_Pid-2a12) 不進行分割。第三行指示 Horizon Client 將另一個複合裝置 (
Vid-0911_Pid-149a) 的各個元件視為獨立裝置,但排除介面編號為 03 的元件,不進行重新導向。該元件將保留在本機。由於此複合裝置包含預設會被排除的元件 (例如滑鼠或鍵盤),因此必須加入第四行,才能將複合裝置
Vid-0911_Pid-149a中的其他元件重新導向至遠端桌面平台。前三個屬性都是分割屬性。最後一個屬性是篩選屬性。在處理分割屬性之前,會先處理篩選屬性。
**重要:*這些用戶端組態屬性可能會與遠端桌面平台上 Horizon Agent 所設定的對應原則合併,或遭其覆寫。如需用戶端上的 USB 分割與篩選屬性如何與 Horizon Agent 的 USB 原則搭配運作的相關資訊,請參閱《Horizon 遠端桌面平台功能和 GPO》*文件中關於使用原則控制 USB 重新導向的相關主題。
此頁面對您有幫助嗎?