특정 Horizon Client 기능을 구성하려면 common-setting 섹션의 설정을 사용할 수 있습니다. editable 속성은 사용자가 변경할 수 있는 설정의 가용성을 지정합니다. 다음 표에서 별표는 편집 가능 목록에서 구성할 수 있는 설정을 나타냅니다.

참고: 수정된 설정을 적용하려면 사용자가 Horizon Client를 다시 시작해야 합니다.
설정 설명
editable Horizon Client 설정 목록을 구성하고 사용자가 특정 일반 설정을 수정할 수 있는지를 지정합니다. 일반적으로 각 서버의 정책에 따라 설정 값이 결정됩니다. 이 표에서 별표(*)로 표시된 모든 클라이언트 기능을 추가할 수 있습니다.

editable 속성에 나열된 설정 값이 false이면 해당 설정을 사용할 수 없습니다. 사용자는 해당 설정을 변경할 수 없습니다. 사용자 인터페이스가 회색으로 표시됩니다. 변경하기 위해 시스템 관리자는 서버에서 정책 설정을 업데이트할 수 있습니다.

설정이 editable 속성 목록에 있고 true로 설정된 경우 해당 설정을 사용자 인터페이스에서 사용할 수 있습니다. 사용자가 변경할 수 있습니다.

참고: 처음 사용할 때 클라이언트는 서버 정책의 모든 설정을 적용합니다. 그 후에 설정을 편집할 수 있고 사용자가 변경한 경우 클라이언트는 해당 설정을 사용합니다.
allowDataSharing* 데이터 공유 기능을 구성합니다. 공유를 사용하도록 설정하거나 비활성화하려면 값을 설정합니다. 유효한 값은 true(사용)와 false(비활성화)입니다.
allowFileDownload

사용자가 파일 전송 기능을 사용하여 원격 데스크톱에서 클라이언트 디바이스로 파일을 다운로드할 수 있는지를 구성합니다. 파일 다운로드를 사용하거나 차단하려면 값을 설정합니다.

유효한 값은 true(사용)와 false(차단)입니다. 기본값은 true입니다.

참고: 파일 전송 기능을 사용하여 파일 다운로드를 사용하도록 설정하려면 클라이언트 측에서 allowFileDownload를 사용하도록 설정하고 에이전트 측에서 파일 다운로드를 허용하도록 파일 전송 구성 GPO 설정도 지정해야 합니다. " Horizon 원격 데스크톱 기능 및 GPO" 항목을 참조하십시오.
allowFileUpload

사용자가 파일 전송 기능을 사용하여 클라이언트 디바이스에서 원격 데스크톱으로 파일을 업로드할 수 있는지를 구성합니다. 파일 업로드를 사용하거나 차단하려면 값을 설정합니다.

유효한 값은 true(사용)와 false(차단)입니다. 기본값은 true입니다.

참고: 파일 전송 기능을 사용하여 파일 업로드를 사용하도록 설정하려면 클라이언트 측에서 allowFileUpload를 사용하도록 설정하고 에이전트 측에서 파일 업로드를 허용하도록 파일 전송 구성 GPO 설정도 지정해야 합니다. " Horizon 원격 데스크톱 기능 및 GPO" 항목을 참조하십시오.
autoForwardUSB* 자동 USB 리디렉션을 활성화하거나 비활성화합니다. 이 값은 자동 USB 리디렉션을 활성화할지 또는 비활성화할지를 지정합니다. editable 속성은 사용자가 [설정] 창에서 USB 자동 연결 설정을 변경할 수 있는지를 지정합니다. 두 속성의 유효한 값은 truefalse입니다.
display* 클라이언트에서 사용할 수 있는 로컬 모니터의 사용을 구성합니다. 이 설정은 클라이언트 창의 크기를 지정할 수 있습니다. 이 설정은 원격 데스크톱을 시작할 때 활성화됩니다.
사용 가능한 옵션:
  • useAllMonitor: 사용 가능한 모든 모니터에서 렌더링합니다.
  • singleMonitor: 기본 창 크기를 사용하여 한 대의 모니터에서 렌더링합니다.
  • singleMonitorFullscreen: 전체 화면을 사용하여 단일 모니터에서 렌더링합니다.
  • singleMonitorSmallWindow: 작은 창 크기(640x480)를 사용하여 단일 모니터에서 렌더링합니다.
  • singleMonitorLargeWindow: 큰 창 크기(1680x983)를 사용하여 단일 모니터에서 렌더링합니다.
  • {width:mmm, height:nnn}: 제공한 크기를 사용하여 한 대의 모니터에서 렌더링합니다. (mmmxnnn)

이 설정은 editable 속성의 목록에 display가 없거나 false로 설정된 경우 잠깁니다. editable 속성에서 true로 설정하면 사용자가 설정을 변경할 수 있습니다. .

enableAdvancedTouch

터치패드, 터치스크린, 키패드 및 마우스 제스처에 설명된 대로 고급 터치 기능에 대한 지원을 활성화하거나 비활성화합니다.

유효한 값은 true(활성화)와 false(비활성화)입니다. 기본값은 true입니다.

enableAnonymousLogin* 설정 대화상자에 인증되지 않은 액세스 기능을 사용하여 익명으로 로그인으로 표시되는 인증되지 않은 액세스 기능을 구성합니다. value 속성은 기능을 사용하도록 설정할지 또는 비활성화할지를 지정합니다. 유효한 값은 truefalse입니다.
enableFileAssociation

파일 연결 설정에 설명된 파일 연결 기능의 활성화 상태를 구성합니다. 유효한 값은 다음과 같습니다.

  • true: 파일 연결을 사용하도록 설정됩니다.
  • false: 파일 연결이 비활성화됩니다. 로컬 파일을 마우스 오른쪽 버튼으로 클릭하고 Chrome용 VMware Horizon Client를 선택할 수 있지만 사용 가능한 애플리케이션 목록 대신 경고 메시지가 나타납니다.

enableFileAssociation이 구성되지 않은 경우 파일 연결을 기본적으로 사용하도록 설정됩니다.

enableHighResolution* 고해상도 모드 기능을 구성합니다. value 속성은 기능을 활성화할지 또는 비활성화할지를 지정합니다. 편집 가능 속성은 사용자가 Horizon Client에서 고해상도 모드 설정을 변경할 수 있는지 여부를 지정합니다. 두 속성의 유효한 값은 truefalse입니다.
enableMediaStream

클라이언트 사용자가 Chrome 클라이언트의 브라우저 리디렉션 기능과 Microsoft Teams에 대한 미디어 최적화 기능에 관해 카메라 및 마이크 사용 권한을 구성할 수 있는지를 결정합니다. 유효한 값은 다음과 같습니다.

  • true: 클라이언트 사용자는 브라우저 리디렉션 중에 클라이언트 카메라 및 마이크에 대한 원격 브라우저 액세스를 허용하거나 거부하는 설정을 구성하고 프롬프트에 응답할 수 있습니다.
  • false: 카메라 및 마이크 사용 권한과 관련된 모든 설정 및 프롬프트가 클라이언트 사용자에게 숨겨집니다. 사용자는 이러한 사용 권한을 구성할 수 없습니다. 원격 브라우저는 브라우저 리디렉션 중에 클라이언트 카메라 및 마이크에 대한 액세스가 자동으로 거부됩니다.

기본값은 true입니다. 자세한 내용은 브라우저 리디렉션 구성 및 "Horizon 원격 데스크톱 기능 및 GPO" 문서의 "Microsoft Teams에 대한 미디어 최적화" 섹션을 참조하십시오.

enableRTAVH264Codec

실시간 오디오-비디오에 대해 H.264 코덱을 활성화 또는 비활성화합니다. 유효한 값은 true(H.264 활성화)와 false(H.264 비활성화)입니다.

기본값은 true입니다.

자세한 내용은 웹캠, 마이크 및 스피커에 대한 실시간 오디오-비디오 기능 사용 항목을 참조하십시오.

enableNetworkIndicator

불안정한 네트워크 연결 감지의 설명과 같이 네트워크 알림 기능을 활성화 또는 비활성화합니다. 유효한 값은 true(기능 활성화)와 false(기능 비활성화)입니다.

값을 false로 설정하면 설정 창에서 네트워크 상태 표시 사용 안 함 옵션이 제거됩니다.

기본값은 true입니다.

enableScreenSharing*

게시된 애플리케이션을 사용할 때 사용자가 로컬 화면의 컨텐츠를 공유할 수 있도록 허용하거나 허용하지 않습니다. 유효한 값은 true(허용)와 false(허용 안 함)입니다.

editable 속성은 사용자가 [설정] 창에서 화면 공유 권한을 제어할 수 있는지 여부를 지정합니다.

enableWebRTCRedirection*

WebRTC 기반 애플리케이션에 대한 미디어 최적화 기능을 활성화하거나 비활성화합니다.

이 기능을 활성화하면 원격 데스크톱 내 WebRTC 기반 애플리케이션에서 오디오, 비디오 및 화면 공유 스트림이 최적화됩니다. 이 기능은 가상 회의 및 전화 회의 중 사용자의 전반적인 오디오-시각적 환경을 향상시킵니다.

유효한 값은 true(기능 활성화)와 false(기능 비활성화)입니다.

editable 속성은 사용자가 [설정] 창에서 WebRTC 미디어 최적화의 활성화 상태를 제어할 수 있는지 여부를 지정합니다.

enableWindowsKey* 원격 데스크톱에 대해 Windows 키를 활성화하거나 비활성화합니다. value는속성은 기능을 활성화할지 또는 비활성화할지를 지정합니다. 편집 가능 속성은 사용자가 Horizon Client에서 데스크톱용 Windows 키 사용 설정을 변경할 수 있는지 여부를 지정합니다. 두 속성의 유효한 값은 truefalse입니다.
hardwareAccelerationOption

실시간 오디오-비디오에 대한 클라이언트 측 GPU 하드웨어 가속을 구성합니다. 자세한 내용은 웹캠, 마이크 및 스피커에 대한 실시간 오디오-비디오 기능 사용 항목을 참조하십시오.

유효한 값은 다음과 같습니다.

  • no-preference를 사용하면 클라이언트가 시스템 및 구성에 가장 적합한 기능을 기반으로 하드웨어 가속 또는 소프트웨어 가속을 유연하게 사용할 수 있습니다. 이것이 기본값입니다.
  • prefer-hardware는 하드웨어 가속을 켭니다.
  • prefer-software는 하드웨어 가속을 끄고 대신 소프트웨어 가속을 사용합니다.
hideSecondaryServer

Horizon Client는 기본 및 보조 서버 호스트 이름 모두에 대해 서버 아이콘을 표시하거나 기본 서버 호스트 이름에 대해서만 표시합니다.

유효한 값은 true(기본 호스트 이름에만 단일 아이콘 표시) 및 false입니다.

  • true로 설정하면 Horizon Client는 기본 호스트 이름에 대해서만 아이콘을 표시합니다.
  • false로 설정하면 Horizon Client는 기본 및 보조 서버 호스트 이름 모두에 대해 서버 아이콘을 표시합니다. 이 설정은 동일한 서버에 대해 두 개의 아이콘을 표시할 수 있습니다. 예를 들어 로드 밸런서가 기본 호스트로 작동하고 UAG(Unified Access Gateway)가 보조 호스트로 작동하는 경우 Horizon Client는 로드 밸런서 호스트 이름에 대한 아이콘과 UAG 호스트 이름에 대한 중복된 아이콘을 표시합니다.

기본값은 true입니다.

ignoreCertErrors

브라우저 리디렉션 기능이 SSL 또는 보안 인증서 오류가 포함된 페이지를 열지 여부를 구성합니다. 유효한 값은 다음과 같습니다.

  • false: 브라우저 리디렉션 기능이 SSL 또는 인증서 오류가 있는 페이지를 열지 않습니다. 페이지가 리디렉션되지 않고 Horizon Client에 SSL 또는 인증서 오류에 대한 메시지가 표시됩니다.
  • true: 브라우저 리디렉션 기능이 SSL 또는 인증서 오류가 있는 페이지를 계속 엽니다. 오류가 무시되고 페이지가 리디렉션됩니다.

기본값은 false입니다. 자세한 내용은 브라우저 리디렉션 구성 항목을 참조하십시오.

networkStateConfig

Horizon Client에서 네트워크 품질 점수를 계산하고 네트워크 안정성을 결정하는 데 사용하는 임계값 매개 변수를 지정합니다. Horizon Client에서 이러한 매개 변수를 사용하는 방법에 대한 자세한 내용은 불안정한 네트워크 연결 감지 항목을 참조하십시오.

이 설정에는 다음과 같은 속성이 포함됩니다.

  • networkStateTcpRttMSLow: 네트워크 품질 점수를 계산하는 데 사용되는 낮은 RTT 임계값을 지정합니다. 값은 networkStateTcpRttMSHigh 값보다 작은 양의 정수여야 합니다. 기본값은 2입니다.
  • networkStateTcpRttMSHigh: 네트워크 품질 점수를 계산하는 데 사용되는 높은 RTT 임계값을 지정합니다. 값은 networkStateTcpRttMSLow 값보다 큰 양의 정수여야 합니다. 기본값은 400입니다.
  • networkStateQualityScoreTcpThresholdGood: 네트워크 안정성이 양호함을 나타내는 데 필요한 최소 점수를 지정합니다. 유효한 값은 0에서 100 사이여야 하며 networkStateQualityScoreTcpThresholdPoor 값보다 커야 합니다. 기본값은 85입니다.
  • networkStateQualityScoreTcpThresholdPoor: 네트워크 안정성이 좋지 않음을 나타내는 점수 범위의 상한을 지정합니다. 유효한 값은 0에서 100 사이여야 하며 networkStateQualityScoreTcpThresholdGood 값보다 작아야 합니다. 기본값은 40입니다.
  • networkStateRttCheckPeriodMs: 네트워크 RTT가 모니터링되는 시간 간격(밀리초)을 지정합니다. 유효한 값은 2000보다 커야 합니다. 기본값은 15000입니다.
powerSetting 원격 세션의 사용자 비활성에 대한 응답으로 디바이스가 절전 모드로 전환되지 않도록 합니다. 기본적으로 Chrome 디바이스는 10분 후에 절전 모드로 전환됩니다. powerSetting을 구성할 때 마지막 원격 세션이 종료될 때까지 디바이스가 절전 모드로 전환되지 않습니다.

keepAwakeLevel 속성은 전원 정책의 수준을 지정합니다. keepAwakeLevel 속성에 대해 다음 값이 유효합니다.

  • system: 사용자 비활성 상태에 대한 응답으로 시스템이 절전 모드로 전환되지 않도록 합니다. 이 값은 기본값입니다.
  • display: 사용자 비활성 상태에 대한 응답으로 디스플레이를 끄거나 흐리게 표시하지 못하게 하고 시스템이 절전 모드로 전환되지 않도록 합니다.
splitUSB

복합 USB 디바이스 분할에 설명된 대로 USB 디바이스에 대한 분할 리디렉션 동작을 지정합니다.

이 설정에는 다음과 같은 속성이 포함됩니다.

  • allowList는 리디렉션을 위해 분할할 수 있는 복합 디바이스를 지정합니다. 디바이스가 나열되지 않으면 분할되지 않은 것입니다. 다음 키-값 쌍을 사용하여 값을 데이터 개체 어레이로 설정합니다.
    • device는 복합 디바이스의 ID를 지정합니다. 유효한 값은 <vid>:<pid>입니다. 여기서 <vid>는 벤더 ID를 지정하고 <pid>는 디바이스의 제품 ID를 지정합니다.
    • excludedInterface는 리디렉션되지 않아야 하는 디바이스의 인터페이스를 지정합니다. 값을 제외된 인터페이스 ID의 어레이로 구성합니다.
  • blockList는 리디렉션을 위해 분할되지 않도록 차단된 복합 디바이스를 지정합니다. <vid>:<pid> 형식을 사용하여 값을 개체 어레이로 구성합니다. 여기서 <vid>는 벤더 ID를 지정하고 <pid>는 디바이스의 제품 ID를 지정합니다.

이 설정이 사용되는 경우 동일한 에이전트 그룹 정책 설정(Vid/Pid 디바이스 분할)이 무시됩니다.

urlFiltering

클라이언트에 대한 URL 컨텐츠 리디렉션 규칙을 구성합니다. URL 컨텐츠 리디렉션 기능을 사용하려면 에이전트 측 구성도 필요합니다. 자세한 내용은 "Horizon 원격 데스크톱 기능 및 GPO" 문서의 URL 컨텐츠 리디렉션 사용에 대한 요구 사항 및 "URL 컨텐츠 리디렉션 구성"을 참조하십시오.

참고: 수정된 규칙이 적용되려면 Horizon Client를 다시 시작해야 합니다.
참고: 연결 서버 인스턴스에서 vdmutil 명령줄 인터페이스를 사용하여 구성된 URL 컨텐츠 리디렉션 규칙은 urlFiltering 설정을 사용하여 구성된 URL 컨텐츠 리디렉션보다 우선합니다.

urlFiltering 설정에는 단일 속성인 protocols가 있으며, 다음과 같은 속성이 있는 개체 어레이로 설정됩니다.

  • brokerHostname: URL을 리디렉션할 때 사용할 연결 서버 호스트의 IP 주소 또는 FQDN(정규화된 도메인 이름)입니다.
  • protocol: 리디렉션할 URL 프로토콜입니다.
  • remoteItem: agentRules에 지정된 URL을 처리할 수 있는 원격 데스크톱 또는 애플리케이션 풀의 표시 이름입니다.
  • agentRules: remoteItem에 지정된 원격 데스크톱 또는 애플리케이션으로 리디렉션되는 URL입니다. 예를 들어 agentRules.*mycompany.com으로 설정하면 문자열 mycompany.com을 포함하는 모든 URL이 원격 데스크톱 또는 애플리케이션으로 리디렉션됩니다.
참고: 리디렉션된 URL의 범위는 agentRules에 대해 사용하는 규칙 구문에 따라 다를 수 있습니다.
  • 규칙 구문 .*mycompany.comhttp://mycompany.com을 포함하여 문자열 mycompany.com이 포함된 모든 URL의 리디렉션을 지원합니다.
  • 규칙 구문 .*.mycompany.com은 문자열 .mycompany.com을 포함하는 모든 URL의 리디렉션을 지원합니다. 그러나 루트 URL의 리디렉션은 지원하지 않습니다. 예를 들어 http://mycompany.com은 리디렉션되지 않습니다.
useAssetIdReplaceMachineName

클라이언트 자산 ID(물리적 컴퓨터 이름)를 해당 Horizon 환경 변수에 전달하는 방법을 구성합니다. 자세한 내용은 VMware KB(기술 자료) 문서 92513을 참조하십시오.

유효한 값은 다음과 같습니다.

  • false: 자산 ID가 ViewClient_Asset_ID 환경 변수로 전달됩니다.
  • true: 자산 ID가 ViewClient_Machine_Name 환경 변수로 전달됩니다.

기본값은 false입니다.

ws1WebviewMode

사용자가 관리형 애플리케이션(예: Unified Access GatewayWorkspace ONE에서 관리되는 애플리케이션)으로 실행되는 Horizon Client에서 인증을 받을 수 있는지를 구성합니다. 유효한 값은 다음과 같습니다.

  • secure-webview: Horizon Client를 관리형 애플리케이션으로 실행하여 사용자를 인증하고 인증이 완료된 후 캐시 및 쿠키를 지웁니다.
  • persistent-webview: Horizon Client를 관리형 애플리케이션으로 실행하여 사용자를 인증할 수 있지만 인증이 완료된 후 캐시 및 쿠키를 지우지 않습니다. 이 값은 인증 정보의 저장을 허용합니다.
  • browser: 사용자 인증을 위해 브라우저 창을 열어야 합니다. 이 값을 사용하면 Horizon Client가 관리형 애플리케이션으로 실행되지 않습니다.

기본값은 secure-webview입니다.

JSON 구성 파일의 다음 예는 편집 가능한 속성의 일반적인 설정 및 사용량을 보여 줍니다. 이 예에서는 최적의 사용자 환경을 위해 성능과 효율성을 최대화하는 권장 설정을 보여 줍니다.

{
  "broker_list": {
    "Value": {
      "settings": {
        "server-list": [
          {
            "server": "viewserver0.mydomain.com",
            "default": true,
            "description": "View Server 0",
            "username": "User0",
            "domain": "TestDomain0"
          }
        ],
        "common-setting": {
          "powerSetting": {
            "keepAwakeLevel": "display"
          },
          "allowDataSharing": true,
          "enableAdvancedTouch": true,
          "enableAnonymousLogin": false,
          "allowFileDownload": true,
          "allowFileUpload": true,
          "enableWindowsKey": true,
          "enableFileAssociation": false,
          "enableRTAVH264Codec": true,
          "hardwareAccelerationOption": "no-preference",
          "ignoreCertErrors": false,
          "ws1WebviewMode": "secure-webview",
          "autoForwardUSB": true,
          "display": "useAllMonitor",
          "enableHighResolution": false,
          "useAssetIdReplaceMachineName": false,
          "splitUSB": {
            "allowList": [
              {
                "device": "0554:1001",
                "excludedInterface": [
                  "00",
                  "01",
                  "02"
                ]
              }
            ]
          },
          "hideSecondaryServer": true,
          "enableAdvancedTouch": false,
          "enableMediaStream": false,
          "enableScreenSharing": true,
          "enableNetworkIndicator": true,
          "networkStateConfig": {
            "networkStateTcpRttMSLow": 2,
            "networkStateTcpRttMSHigh": 400,
            "networkStateQualityScoreTcpThresholdGood": 85,
            "networkStateQualityScoreTcpThresholdPoor": 40,
            "networkStateRttCheckPeriodMs": 15000
          },
          "urlFiltering": {
            "protocols": [
              {
                "brokerHostname": "10.117.24.28",
                "protocol": "http",
                "remoteItem": "win2022_RDSH",
                "agentRules": ".*example1.com"
              },
              {
                "brokerHostname": "10.117.161.109",
                "protocol": "https",
                "remoteItem": "win10_VDI",
                "agentRules": ".*example2.com"
              }
            ]
          },
          "editable": {
            "allowDataSharing": true,
            "enableAnonymousLogin": true,
            "enableHighResolution": true,
            "autoForwardUSB": true,
            "enableWebRTCRedirection": true,
            "display": true,
            "enableScreenSharing": true
          }
        }
      }
    }
  }
}