명령줄에서 Windows용 Horizon Agent를 자동 설치할 때 특정 속성을 포함할 수 있습니다. MSI(Microsoft Windows Installer)가 속성 및 값을 해석할 수 있도록 PROPERTY=value 형식을 사용해야 합니다. 자동 업그레이드는 동일한 설치 명령을 사용합니다. 이미 설치된 Horizon Agent 구성 요소를 자동으로 수정할 수도 있습니다.
다음 표에는 명령줄에서 사용할 수 있는 Horizon Agent 자동 설치 속성이 나와 있습니다.
| MSI 속성 | 설명 | 기본값 |
|---|---|---|
| ENABLE_UNC_REDIRECTION | UNC 경로 리디렉션 기능이 설치되어 있는지 여부를 지정합니다. 값이 1이면 기능이 설치됩니다. 그 후에 그룹 정책 설정을 사용하여 리디렉션할 UNC를 구성해야 합니다. "Horizon 원격 데스크톱 기능 및 GPO" 문서에서 "UNC 경로 리디렉션 구성"을 참조하십시오. 이 MSI 속성은 선택 사항입니다. |
0 |
| HORIZON_MONITOR_ENABLED | Horizon 모니터링 모드 사용 여부를 지정합니다. 이 플래그는 환경에 VMware Horizon Cloud Service - next-gen이 설치된 경우에만 작동합니다. 값이 1이면 Horizon 모니터링 모드를 사용하도록 설정됩니다. 값이 0이면 Horizon 모니터링 모드를 사용하지 않도록 설정됩니다. |
0 |
| IGNORE_DOTNET_CHECK | 설치 관리자가 최소 .NET 버전을 확인하는지 여부를 결정합니다. 기본적으로 Horizon Performance Tracker가 선택되면 설치 관리자는 .NET 4.6.2 이상이 설치되어 있는지 확인하는 사전 검사를 수행하고 이 프로그램이 설치되어 있지 않으면 설치를 중지합니다. 값이 1이면 이 사전 검사가 취소됩니다. 값이 0이면 사전 검사를 계속합니다. |
%ProgramFiles%\VMware\VMware View\Agent |
| INSTALLDIR | Horizon Agent 소프트웨어가 설치된 경로 및 폴더입니다. 예: INSTALLDIR=""D:\abc\my folder"" 경로를 둘러싼 큰 따옴표 두 개 세트를 사용하면 MSI 설치 관리자에서 경로의 공백을 무시할 수 있습니다. 이 MSI 속성은 선택 사항입니다. |
|
| RDP_CHOICE | 데스크톱에서 원격 데스크톱 프로토콜(RDP)을 사용하도록 설정할지 결정합니다. 1의 값은 RDP를 사용하도록 설정합니다. 값이 0이면 RDP 설정을 비활성화합니다. 이 MSI 속성은 선택 사항입니다. |
1 |
| SUPPRESS_RUNONCE_CHECK | HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce 및 RunOnceEx 키에서 다음 운영 체제 재부팅 시 수행되도록 예약된 보류 중인 Windows 업데이트 작업을 무시합니다. 이 플래그를 사용하면 동시 설치가 허용되지만 시스템 업데이트가 Horizon Agent 런타임 종속성에 영향을 미칠 경우 설치 결과가 보장되지 않습니다. 이 MSI 속성은 선택 사항입니다. |
없음 |
| URL_FILTERING_ENABLED | URL 컨텐츠 리디렉션 기능이 설치되어 있는지 여부를 지정합니다. 값이 1이면 기능이 설치됩니다. 그 후에 그룹 정책 설정을 사용하여 리디렉션할 URL을 구성해야 합니다. "Horizon 원격 데스크톱 기능 및 GPO" 문서에서 "URL 컨텐츠 리디렉션 구성"을 참조하십시오. 이 MSI 속성은 선택 사항입니다. |
0 |
| VDM_SKIP_BROKER_REGISTRATION | 값이 1이면 관리되지 않는 데스크톱을 건너뜁니다. | 없음 |
| VDM_VC_MANAGED_AGENT | vCenter Server에서 Horizon Agent가 설치된 가상 시스템을 관리하는지 확인합니다. 1의 값은 vCenter Server 관리 가상 시스템으로 데스크톱을 구성합니다. 0의 값은 데스크톱을 vCenter Server에서 관리하지 않는 것으로 구성합니다. 이 MSI 속성은 필수입니다.
참고: 관리되지 않는 설치의 경우 설치 관리자 복구 옵션이 지원되지 않습니다. 이러한 설치를 복구하면 관리되는
Horizon Agent가 설치됩니다.
|
없음 |
| VDM_REINSTALL | 다시 설치할 쉼표로 구분된 이미 설치된 기능 목록을 지정합니다. 자동 모드에서만 적용할 수 있습니다. | 없음 |
| VDM_REINSTALLMODE | 수행할 재설치 유형을 지정하는 문자가 포함된 문자열로, 자동 모드에서만 적용됩니다. 사용할 옵션에 대한 자세한 내용은 https://learn.microsoft.com/ko-kr/windows/win32/msi/reinstallmode를 참조하십시오. | 없음 |
| VDM_SERVER_NAME | Horizon Agent 설치 관리자가 관리되지 않는 데스크톱을 등록하는 연결 서버 인스턴스의 호스트 이름 또는 IP 주소입니다. 이 속성은 관리되지 않는 데스크톱에만 적용됩니다. 예: VDM_SERVER_NAME=10.123.01.01 이 MSI 속성은 관리되지 않는 데스크톱에 필요합니다. vCenter Server에서 관리하는 가상 데스크톱에 이 MSI 속성을 사용하지 마십시오. |
없음 |
| VDM_SERVER_USERNAME | 연결 서버 인스턴스 관리자의 사용자 이름입니다. 이 MSI 속성은 관리되지 않는 데스크톱에만 적용됩니다. 예: VDM_SERVER_USERNAME=domain\username 이 MSI 속성은 관리되지 않는 데스크톱에 필요합니다. vCenter Server에서 관리하는 가상 데스크톱에 이 MSI 속성을 사용하지 마십시오. |
없음 |
| VDM_SERVER_PASSWORD | 연결 서버 관리자 암호입니다. 예: VDM_SERVER_PASSWORD=secret 이 MSI 속성은 관리되지 않는 데스크톱에 필요합니다. vCenter Server에서 관리하는 가상 데스크톱에 이 MSI 속성을 사용하지 마십시오. |
없음 |
| VDM_IP_PROTOCOL_USAGE | Horizon Agent에서 사용하는 IP 버전을 지정합니다. 유효한 값은 IPv4 및 IPv6입니다. | IPv4 |
| VDM_FIPS_ENABLED | FIPS 모드 사용 여부를 지정합니다. 값이 1이면 FIPS 모드를 활성화합니다. 값이 0이면 FIPS 모드를 비활성화합니다. 이 속성을 1로 설정했는데 Windows가 FIPS 모드에 있지 않으면 설치 관리자가 중지됩니다. | 0 |
| VDM_FORCE_DESKTOP_AGENT | Windows Server 시스템에 Horizon Agent를 설치하고 RDS 호스트가 아닌 단일 사용자 Horizon 데스크톱으로 구성하는 경우 이 값을 1로 설정합니다. 이 요구 사항은 vCenter Server에서 관리되는 시스템과 관리되지 않는 시스템에 모두 적용됩니다. 애플리케이션 세션을 호스팅하는 비서버 Windows 게스트의 경우 이 값을 0으로 설정합니다. 이 MSI 속성은 선택 사항입니다. |
0 |
자동 설치 명령에서 ADDLOCAL 속성을 사용하여 Horizon Agent 설치 관리자가 구성하는 옵션을 지정할 수 있습니다.
다음 표에서는 명령줄에 입력할 수 있는 Horizon Agent 옵션을 보여 줍니다. 이러한 옵션에는 대화식 설치 동안 선택 취소하거나 선택할 수 있는 해당 설치 옵션이 있습니다.
명령줄에서 ADDLOCAL 속성을 사용하지 않을 때 게스트 운영 체제에서 지원되는 경우 Horizon Agent는 대화형 설치 중 기본적으로 설치되는 모든 옵션을 설치합니다. ADDLOCAL=ALL을 사용할 때 게스트 운영 체제에서 지원되는 경우 Horizon Agent는 다음과 같이 기본적으로 설정되어 있는 옵션과 기본적으로 해제되어 있는 옵션을 모두 설치합니다.
자세한 내용은 Microsoft Windows Installer 명령줄 옵션의 ADDLOCAL 테이블 항목을 참조하십시오.
ADDLOCAL을 사용하여 기능을 개별적으로 지정하는 경우(ADDLOCAL=ALL을 지정하지 않는 경우)에는 항상 Core를 지정해야 합니다.
Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* |
Select-Object DisplayName, ModifyPath | Where-Object {$_.DisplayName -eq 'VMware Horizon
Agent'} | Format-Table –AutoSize출력:
DisplayName ModifyPath
VMware Horizon Agent MsiExec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111}
다음 예는 기존 설치에서 USB 구성 요소를 수정하고 제거합니다. VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn REMOVE=USB"
다음 예에서는 Horizon Performance Tracker를 Horizon Help Desk Tool VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=HelpDesk REMOVE=PerfTracker”와 바꾸어 에이전트 설치를 수정합니다.
다음 예에서는 직렬 포트 및 스캐너 리디렉션을 추가하여 에이전트 설치를 수정합니다. VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection”
| 자동 설치 옵션 | 대화식 설치의 사용자 지정 설정 옵션 | 대화형으로 설치 또는 ADDLOCAL이 사용되지 않을 때 기본적으로 설치 |
|---|---|---|
| 코어 | 코어 Horizon Agent 기능 ADDLOCAL=ALL을 지정하면 코어 기능이 설치됩니다. |
예 |
| USB | USB 리디렉션 | 아니요 |
| NGVC | 인스턴트 클론 에이전트 | 아니요 |
| RTAV | 실시간 오디오-비디오 | 예 |
| ClientDriveRedirection | 클라이언트 드라이브 리디렉션 | 예 |
| SerialPortRedirection | 직렬 포트 리디렉션 | 아니요 |
| 스캐너 리디렉션 | 스캐너 리디렉션 | 아니요 |
| GEOREDIR | 지리적 위치 리디렉션 | 아니요 |
| V4V | Horizon Monitoring Service Agent | 예 |
| 스마트 카드 | 스마트 카드 이 기능은 대화형 설치 시에는 기본적으로 설치되지 않습니다. |
아니요 |
| VmwVaudio | VMware 오디오(가상 오디오 드라이버) | 예 |
| VmwVidd | VMware 간접 디스플레이 드라이버 | 예
참고: 다음과 같은 경우에만 VmwVidd가 설치되고 레지스트리에서 로컬로 표시됩니다.
VmwVidd는 설치되고 RDS 역할을 사용하여 Windows Server 2019(버전 1809) std 및 데이터 센터의 레지스트리에 Absent로 설정됩니다. VmwVidd는 설치되고 RDS 역할을 사용하여 Windows Server 2022의 레지스트리에 Local로 설정됩니다. |
| TSMMR | Windows Media MMR(멀티미디어 리디렉션) | 예 |
| RDP | 명령줄에서 RDP_CHOICE=1 속성을 사용하거나 데스크톱 풀을 만들거나 편집할 때 기본 디스플레이 프로토콜로 RDP를 선택하는 경우 레지스트리에서 RDP를 사용하도록 설정합니다. 이 기능은 대화형 설치 중에는 숨겨져 있습니다. |
예 |
| RDSH3D | RDS 호스트의 3D 렌더링 | 아니요 |
| BlastUDP | Blast에 대한 UDP 전송 지원 | 예 |
| SdoSensor | SDO 센서 리디렉션 | 아니요 |
| PerfTracker | Horizon Performance Tracker | 아니요 |
| HelpDesk | Horizon Help Desk Tool | 예 |
| PrintRedir | VMware Integrated Printing | 예 |
| PSG | 이 기능은 Horizon Agent가 IPv4와 IPv6 중 어떤 것을 사용하는지를 연결 서버에 알려주는 레지스트리 항목을 설정합니다. | 예 |
