Skip to main content

2026년 8월 24일

USB 구성 속성 설정

/etc/omnissa/config, /usr/lib/omnissa/config 및 ~/.omnissa/config 구성 파일에서 USB 구성 속성을 설정할 수 있습니다.

다음 구문을 사용하여 구성 파일에 USB 구성 속성을 설정합니다.

viewusb.property1 = "value1"

USB 구성 속성을 사용하여 특정 유형의 디바이스가 리디렉션될지 여부를 제어할 수 있습니다. 필터링 속성을 사용하여 특정 유형의 디바이스를 포함하거나 제외할 수도 있습니다. 복합 디바이스 분할을 위한 속성도 제공됩니다.

일부 속성 값에는 USB 디바이스의 VID(벤더 ID) 및 PID(제품 ID)가 필요합니다. 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 구성 속성에 대해 설명합니다.

USB 리디렉션을 위한 구성 속성
정책 이름 및 속성설명
자동 디바이스 분할 허용 속성: viewusb.AllowAutoDeviceSplitting복합 USB 디바이스의 자동 분할을 허용합니다. 기본값은 정의되어 있지 않으며 false와 같습니다.
분할에서 Vid/Pid 디바이스 제외 속성: viewusb.SplitExcludeVidPid벤더 및 제품 ID별로 지정된 복합 USB 디바이스를 분할에서 제외합니다. 설정 형식은 vid-xxx1_pid-yyy1[;vid-xxx2_pid-yyy2]...입니다. ID 번호를 16진수로 지정해야 합니다. ID에서 개별 자릿수 대신 와일드카드 문자(*)를 사용할 수 있습니다. 예: vid-0781_pid-55** 기본값은 정의되어 있지 않습니다.
Vid/Pid 디바이스 분할 속성: viewusb.SplitVidPid벤더 및 제품 ID별로 지정된 복합 USB 디바이스의 구성 요소를 개별 디바이스로 처리합니다. 설정 형식은 다음과 같습니다. vid-xxxx_pid-yyyy([exintf:zz[;exintf:ww ]])[;...] exintf 키워드를 사용하면 인터페이스 번호를 지정하여 구성 요소를 리디렉션에서 제외할 수 있습니다. ID 번호를 16진수로, 인터페이스 번호를 앞에 0이 표시되는 10진수로 지정해야 합니다. ID에서 개별 자릿수 대신 와일드카드 문자(*)를 사용할 수 있습니다. 예: vid-0781_pid-554c(exintf:01;exintf:02) 참고: 복합 디바이스에 마우스 및 키보드와 같이 자동으로 제외된 구성 요소가 포함되면 Horizon Client는 명시적으로 제외하지 않은 구성 요소를 자동으로 포함하지 않습니다. Vid/Pid 디바이스 포함과 같은 필터 정책을 지정하여 해당 구성 요소를 포함시켜야 합니다. 기본값은 정의되어 있지 않습니다.
오디오 입력 디바이스 허용 속성: viewusb.AllowAudioIn오디오 입력 디바이스가 리디렉션되도록 허용합니다. 기본값은 정의되어 있지 않으며, 실시간 오디오-비디오 기능이 오디오 입력 및 비디오 디바이스에 사용되는데 이러한 디바이스에는 기본적으로 USB 리디렉션이 사용되지 않기 때문에 false와 같습니다.
오디오 출력 디바이스 허용 속성: viewusb.AllowAudioOut오디오 출력 디바이스가 리디렉션되도록 허용합니다. 기본값은 정의되어 있지 않으며 false와 같습니다.
HID 허용 속성: viewusb.AllowHID키보드나 마우스 이외 입력 디바이스의 리디렉션을 허용합니다. 기본값은 정의되어 있지 않으며 true와 같습니다.
HID 부팅 가능 허용 속성: viewusb.AllowHIDBootable부팅 시 사용할 수 있는 키보드 또는 마우스(HID 부팅 가능 디바이스라고도 부름) 이외의 입력 디바이스가 리디렉션되도록 허용합니다. 기본값은 정의되어 있지 않으며 true와 같습니다.
디바이스 설명자 페일세이프 허용 속성: viewusb.AllowDevDescFailsafeHorizon Client가 config/device 설명자를 가져오지 못할 경우에도 디바이스가 리디렉션되도록 허용합니다. config/desc에 실패한 경우에도 디바이스를 허용하려면 IncludeVidPid 또는 IncludePath와 같은 Include 필터에 포함시킵니다. 기본값은 정의되어 있지 않으며 false와 같습니다.
키보드 및 마우스 디바이스 허용 속성: viewusb.AllowKeyboardMouse통합된 포인팅 디바이스(마우스, 트랙볼 또는 터치 패드)가 있는 키보드가 리디렉션되도록 허용합니다. 기본값은 정의되어 있지 않으며 false와 같습니다.
스마트 카드 허용 속성: viewusb.AllowSmartcard스마트 카드 디바이스가 리디렉션되도록 허용합니다. 기본값은 정의되어 있지 않으며 false와 같습니다.
비디오 디바이스 허용 속성: viewusb.AllowVideo비디오 디바이스가 리디렉션되도록 허용합니다. 기본값은 정의되어 있지 않으며, 실시간 오디오-비디오 기능이 오디오 입력 및 비디오 디바이스에 사용되는데 이러한 디바이스에는 기본적으로 USB 리디렉션이 사용되지 않기 때문에 false와 같습니다.
원격 구성 다운로드 사용 안 함 속성: viewusb.DisableRemoteConfigUSB 디바이스 필터링 수행 시 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지정된 벤더 ID 및 제품 ID를 갖는 디바이스가 리디렉션되지 않도록 제외합니다. 설정 형식은 vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]...입니다. ID 번호를 16진수로 지정해야 합니다. ID에서 개별 자릿수 대신 와일드카드 문자(*)를 사용할 수 있습니다. 예: vid-0781_pid-****;vid-0561_pid-554c 기본값은 정의되어 있지 않습니다.
경로 제외 속성: viewusb.ExcludePath 지정된 허브 또는 포트 경로의 디바이스가 리디렉션되지 않도록 제외합니다. 설정 형식은 bus-x1[/y1]..._port-z1[;bus-x2[/y2]..._port-z2]...입니다. 버스 및 포트 번호를 16진수로 지정해야 합니다. 와일드카드 문자는 경로에 사용할 수 없습니다. 예: 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]...입니다. 버스 및 포트 번호를 16진수로 지정해야 합니다. 와일드카드 문자는 경로에 사용할 수 없습니다. 예: bus-1/2_port-02;bus-1/7/1/4_port-0f 기본값은 정의되어 있지 않습니다.
Vid/Pid 디바이스 포함 속성: viewusb.IncludeVidPid 지정된 벤더 및 제품 ID를 갖는 디바이스가 리디렉션되도록 포함합니다. 설정 형식은 vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]...입니다. ID 번호를 16진수로 지정해야 합니다. ID에서 개별 자릿수 대신 와일드카드 문자(*)를 사용할 수 있습니다. 예: vid-0561_pid-554c 기본값은 정의되어 있지 않습니다.
디바이스 제품군의 자동 전달 제외 속성: viewusb.ExAutoRedirectFamily 디바이스 제품군이 자동으로 전달되지 않도록 제외합니다. 설정 형식은 family_name_1[;family_name_2]...입니다. 예: storage 기본값은 정의되어 있지 않습니다.
Vid/Pid 디바이스의 자동 전달 제외 속성: viewusb.ExAutoRedirectVidPid 특정 벤더 및 제품 ID가 있는 디바이스가 자동으로 전달되지 않도록 제외합니다. 설정 형식은 vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]...입니다. ID 번호를 16진수로 지정해야 합니다. ID에서 개별 자릿수 대신 와일드카드 문자(*)를 사용할 수 있습니다. 예: 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 리디렉션 제어에 대한 항목을 참조하십시오.

Was this page helpful?

Provide feedback for this topic

Was this topic helpful?

Please do not include any personal or confidential information.

Generating link…