Skip to main content

2026 年 7 月 28 日

設定 USB 組態屬性

您可以在 /etc/omnissa/config/usr/lib/omnissa/config~/.omnissa/config 組態檔中設定 USB 組態屬性。

使用下列語法在組態檔中設定 USB 組態屬性。

viewusb.property1 = "value1"

透過 USB 組態屬性,您可以控制是否重新導向特定類型的裝置。此外,也提供篩選屬性,讓您能夠包含或排除特定類型的裝置,並提供可分割複合裝置的相關屬性設定。

某些屬性值需指定 USB 裝置的 VID (廠商識別碼) 和 PID (產品識別碼)。若要查詢 VID 和 PID,您可以在網際網路上以產品名稱搭配 vidpid 關鍵字進行搜尋。或者,當 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 組態屬性。

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 重新導向的相關主題。

此頁面對您有幫助嗎?

針對本主題提供意見回饋

本主題對您有幫助嗎?

請勿填寫任何個人或機密資訊。

正在產生連結…