URI(Uniform Resource Identifier)를 사용하여 최종 사용자가 Horizon Client를 시작하거나, 서버에 연결하거나, 원격 데스크톱 또는 게시된 애플리케이션을 열기 위해 클릭할 수 있는 웹 페이지 또는 이메일 링크를 생성할 수 있습니다.
다음 정보의 일부 또는 전체를 제공하는 URI를 구성하여 이러한 링크를 생성해야 최종 사용자가 정보를 제공할 필요가 없어집니다.
- 서버 주소
- 서버의 포트 번호
- Active Directory 사용자 이름
- RADIUS 또는 RSA SecurID 사용자 이름(Active Directory 사용자 이름과 다른 경우)
- 도메인 이름
- 원격 데스크톱 또는 게시된 애플리케이션 디스플레이 이름
- 창 크기
- 세션 재설정, 로그아웃, 시작 등의 작업
- 디스플레이 프로토콜
- USB 디바이스 리디렉션 옵션
URI를 구성하려면 Horizon Client 특정 경로 및 쿼리 부분으로 vmware-view URI 구성표를 사용합니다.
URI를 사용하여 Horizon Client를 시작하려면 Horizon Client가 클라이언트 컴퓨터에 이미 설치되어 있어야 합니다.
vmware-view URI 생성을 위한 구문
URI 구문에는 vmware-view URI 구성표, 원격 데스크톱 또는 게시된 애플리케이션을 지정하는 경로 부분 및 선택적으로 원격 데스크톱 또는 게시된 애플리케이션 작업이나 구성 옵션을 지정하는 쿼리가 있습니다.
URI 사양
다음 구문을 사용하여 Horizon Client 시작에 필요한 URI를 만듭니다.
vmware-view://[authority-part][/path-part][?query-part]
필수 요소는 URI 구성표 vmware-view뿐입니다. 일부 클라이언트 운영 체제의 일부 버전에서는 구성표 이름의 대/소문자를 구분하므로 vmware-view를 입력합니다.
ASCII 문자 인코딩에 대한 자세한 내용은 http://www.utf8-chartable.de/의 URL 인코딩 참조를 참고하십시오.
- authority-part
-
서버 주소를 지정하고 선택적으로 사용자 이름, 기본값이 아닌 포트 번호 또는 두 가지 모두. 서버 이름에는 밑줄(_)을 사용할 수 없습니다. 서버 이름은 DNS 구문에 따라야 합니다.
사용자 이름을 지정하려면 다음 구문을 사용하십시오.
user1@server-address
도메인을 포함하는 UPN 주소는 지정할 수 없습니다. 도메인을 지정하려면 URI에서 domainName 쿼리 부분을 사용할 수 있습니다.
포트 번호를 지정하려면 다음 구문을 사용하십시오.
server-address:port-number
- path-part
- 원격 데스크톱 또는 게시된 애플리케이션의 디스플레이 이름입니다. 디스플레이 이름은 데스크톱 풀 또는 애플리케이션 풀이 생성될 때 Horizon Console에서 지정됩니다. 디스플레이 이름에 공백이 있는 경우 %20 인코딩 메커니즘을 사용하여 공백을 나타냅니다.
- query-part
-
사용할 구성 옵션 또는 수행할 원격 데스크톱 또는 게시된 애플리케이션 작업. 쿼리는 대소문자를 구분하지 않습니다. 여러 쿼리를 사용하려면 쿼리 사이에 앰퍼샌드(&)를 사용합니다. 쿼리가 충돌하는 경우
Horizon Client는 목록의 마지막 쿼리를 사용합니다. 다음 구문을 사용하십시오.
query1=value1[&query2=value2...]
지원되는 쿼리
다음 쿼리는 이 유형의 Horizon Client에 지원됩니다. 여러 유형의 클라이언트(예: 데스크톱 클라이언트 및 모바일 클라이언트)에 대한 URI를 생성하는 경우 각 유형의 클라이언트 시스템에 대한 설치 및 설정 가이드에서 지원되는 쿼리 목록을 참조하십시오.
- 작업
-
표 1. 작업 쿼리와 함께 사용할 수 있는 값 값 설명 browse 지정된 서버에서 호스트된 사용 가능한 원격 데스크톱 및 게시된 애플리케이션 목록을 표시합니다. 이 작업을 사용하면서 원격 데스크톱 또는 게시된 애플리케이션을 지정할 필요는 없습니다. start-session 지정된 원격 데스크톱 또는 게시된 애플리케이션을 엽니다. 작업 쿼리가 제공되지 않고 원격 데스크톱 또는 게시된 애플리케이션 이름이 제공되는 경우, start-session이 기본 작업입니다. reset 지정된 원격 데스크톱 또는 게시된 애플리케이션을 종료하고 다시 시작합니다. 저장하지 않은 데이터는 손실됩니다. 원격 데스크톱 재설정은 물리적 PC에 있는 리셋 버튼을 누르는 것과 같습니다.
restart 지정된 원격 데스크톱을 종료하고 다시 시작합니다. 원격 데스크톱을 다시 시작하는 것은 Windows 운영 체제 다시 시작 명령을 사용하는 것과 같습니다. 다시 시작되기 전에 저장하지 않은 데이터를 저장하라는 메시지가 일반적으로 운영 체제에 표시됩니다. logoff 원격 데스크톱의 게스트 운영 체제에서 사용자를 로그아웃시킵니다. 게시된 애플리케이션을 지정하는 경우 작업을 무시하거나 최종 사용자에게 "잘못된 URI 작업"이라는 경고 메시지가 나타납니다. - args
-
게시된 애플리케이션이 시작될 때 추가할 명령줄 인수를 지정합니다. 구문
args=
값을 사용합니다. 여기서
값은 문자열입니다. 다음 문자에는 % 인코딩을 사용하십시오.
- 콜론(:)에는 %3A를 사용합니다.
- 백슬래시(\)에는 %5C를 사용합니다.
- 공백( )에는 %20을 사용합니다.
- 큰따옴표 표시(”)에는 %22를 사용합니다.
예를 들어 Notepad++ 애플리케이션에 대해 파일 이름 "My new file.txt"를 지정하려면 %22My%20new%20file.txt%22를 사용합니다.
- appProtocol
- 게시된 애플리케이션의 경우 올바른 값은 PCOIP 및 BLAST입니다. 예를 들어 PCoIP를 지정하려면 appProtocol=PCOIP 구문을 사용합니다.
- connectUSBOnInsert
- 디바이스를 플러그인할 때 USB 디바이스를 포그라운드 원격 데스크톱 또는 게시된 애플리케이션에 연결합니다. 이 쿼리는 원격 데스크톱에 대한 unattended 쿼리를 지정할 경우 암시적으로 설정됩니다. 이 쿼리를 사용하려면 action 쿼리를 start-session으로 설정하거나 아니면 action 쿼리가 없어야 합니다. 올바른 값은 true와 false입니다. 구문의 예는 connectUSBOnInsert=true입니다.
- connectUSBOnStartup
- 클라이언트 시스템에 현재 연결되어 있는 모든 USB 디바이스를 원격 데스크톱 또는 게시된 애플리케이션으로 리디렉션합니다. 이 쿼리는 원격 데스크톱에 대한 unattended 쿼리를 지정할 경우 암시적으로 설정됩니다. 이 쿼리를 사용하려면 action 쿼리를 start-session으로 설정하거나 아니면 action 쿼리가 없어야 합니다. 올바른 값은 true와 false입니다. 구문의 예는 connectUSBOnStartup=true입니다.
- desktopLayout
-
원격 데스크톱 창의 크기를 설정합니다. 이 쿼리를 사용하려면
action 쿼리를
start-session으로 설정해야 하며, 그렇지 않으면
action 쿼리가 없어야 합니다.
표 2. desktopLayout 쿼리의 올바른 값 값 설명 fullscreen 한 모니터에 전체 화면으로 표시합니다. 이 값은 기본값입니다. multimonitor 모든 모니터에 전체 화면으로 표시합니다. windowLarge 큰 창입니다. windowSmall 작은 창입니다. WxH 너비와 높이를 픽셀 단위로 지정하는 사용자 지정 해상도입니다. 구문의 예는 desktopLayout=1280x800입니다. - desktopProtocol
- 원격 데스크톱의 경우 올바른 값은 RDP, PCOIP 및 BLAST입니다. 예를 들어 PCoIP를 지정하려면 desktopProtocol=PCOIP 구문을 사용합니다.
- domainName
- 원격 데스크톱 또는 게시된 애플리케이션에 연결 중인 사용자와 연결된 NETBIOS 도메인 이름을 지정합니다. 예를 들어 mycompany.com 대신 mycompany를 사용할 수 있습니다.
- filePath
-
게시된 애플리케이션에서 열려는 파일의 로컬 시스템 경로를 지정합니다. 드라이브 문자를 포함하는 전체 경로를 지정해야 합니다. 다음 문자에는 % 인코딩을 사용하십시오.
- 콜론(:)에는 %3A를 사용합니다.
- 백슬래시(\)에는 %5C를 사용합니다.
- 공백( )에는 %20을 사용합니다.
예를 들어 파일 경로 C:\test file.txt를 나타내려면 C%3A%5Ctest%20file.txt를 사용하십시오.
- launchMinimized
- 최소화 모드로 Horizon Client를 시작합니다. 지정된 원격 데스크톱 또는 게시된 애플리케이션이 시작될 때까지 Horizon Client는 최소화된 상태를 유지합니다. 구문은 launchMinimized=true입니다. unattended 쿼리와 함께 이 쿼리를 사용할 수 없습니다.
- tokenUserName
- RSA 또는 RADIUS 사용자 이름을 지정합니다. RSA 또는 RADIUS 사용자 이름이 Active Directory 사용자 이름과 다른 경우에만 이 쿼리를 사용합니다. 이 쿼리를 지정하지 않고 RSA 또는 RADIUS 인증이 필요한 경우, Horizon Client에서 Windows 사용자 이름을 사용합니다. 구문은 tokenUserName=name입니다.
- unattended
- 키오스크 모드에서 원격 데스크톱에 대해 서버 연결을 설정합니다. 이 쿼리를 사용하는 경우 클라이언트 디바이스의 MAC 주소에서 계정 이름을 생성했다면 사용자 정보를 지정하지 마십시오. "custom-"으로 시작하는 이름과 같이 ADAM에서 사용자 지정 계정 이름을 생성한 경우 계정 정보를 지정해야 합니다.
- useExisting
- 이 옵션이 true로 설정되어 있으면 Horizon Client 인스턴스를 하나만 실행할 수 있습니다. 사용자가 두 번째 서버에 연결하려고 할 경우에는 첫 번째 서버에서 로그아웃하여 원격 데스크톱 및 게시된 애플리케이션 세션을 연결 해제해야 합니다. 이 옵션이 false로 설정되어 있으면 여러 Horizon Client 인스턴스를 실행할 수 있으며 사용자가 동시에 여러 서버에 연결할 수 있습니다. 기본값은 true입니다. 구문의 예는 useExisting=false입니다.
- unauthenticatedAccessEnabled
- 이 옵션을 true로 설정하면 인증되지 않은 액세스 기능이 기본적으로 사용되도록 설정됩니다. 인증되지 않은 액세스 옵션이 사용자 인터페이스에 표시되며 선택됩니다. 이 옵션을 false로 설정하면 인증되지 않은 액세스 기능이 비활성화됩니다. 인증되지 않은 액세스 설정이 숨겨지고 비활성화됩니다. 이 옵션을 ""로 설정하면 인증되지 않은 액세스 기능이 비활성화되고 인증되지 않은 액세스 설정이 사용자 인터페이스에서 숨겨지고 비활성화됩니다. 구문 예는 unauthenticatedAccessEnabled=true입니다.
- unauthenticatedAccessAccount
- 인증되지 않은 액세스 기능을 사용하도록 설정하는 경우 사용할 계정을 설정합니다. 인증되지 않은 액세스가 비활성화되면 이 쿼리는 무시됩니다. anonymous1 사용자 계정을 사용할 때의 구문 예는 unauthenticatedAccessAccount=anonymous1입니다.
vmware-view URI의 예
vmware-view URI 구성표를 사용하면 하이퍼텍스트 링크나 버튼을 만들고 이메일 또는 웹 페이지에 이러한 링크를 포함할 수 있습니다. 예를 들어 최종 사용자는 URI 링크를 클릭하여 지정된 시작 옵션으로 원격 데스크톱을 시작할 수 있습니다.
각 URI 예에는 최종 사용자가 URI 링크를 클릭할 경우 나타나는 내용에 대한 설명이 이어집니다.
-
vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session
Horizon Client가 시작되며 view.mycompany.com 서버에 연결됩니다. 로그인 대화상자에 사용자에게 사용자 이름, 도메인 이름 및 암호를 묻는 메시지가 표시됩니다. 로그인이 성공적으로 수행되면 클라이언트는 디스플레이 이름이 Primary Desktop(기본 데스크톱)인 원격 데스크톱에 연결되고 사용자는 게스트 운영 체제에 로그인됩니다.
참고: 이 예에서는 기본 디스플레이 프로토콜 및 창 크기가 사용됩니다. 기본 디스플레이 프로토콜은 PCoIP이며 기본 창 크기는 전체 화면입니다. -
vmware-view://view.mycompany.com/cn%3Dwin7-32%2Cou%3Dapplications%2Cdc%3Dvdi%2Cdc%3Dvmware%2Cdc%3Dint
Horizon Client가 시작되며 view.mycompany.com 서버에 연결됩니다. 로그인 대화상자에 사용자에게 사용자 이름, 도메인 이름 및 암호를 묻는 메시지가 표시됩니다. 로그인에 성공하면 클라이언트는 데스크톱 ID CN=win7-32,OU=Applications,DC=vdi,DC=vmware,DC=int(인코딩된 값 cn%3Dwin7-32%2Cou%3Dapplications%2Cdc%3Dvdi%2Cdc%3Dvmware%2Cdc%3Dint)인 원격 데스크톱에 연결됩니다.
-
vmware-view://view.mycompany.com:7555/Primary%20Desktop
예를 들어 연결 서버 인스턴스의 비기본 포트 7555를 사용하는 것을 제외하면 이 URI는 이전 예와 동일한 효과를 가집니다. 기본 포트는 443입니다. 원격 데스크톱 식별자가 제공되므로 start-session 작업이 URI에 포함되지 않아도 원격 데스크톱이 열립니다.
-
vmware-view://[email protected]/Finance%20Desktop?desktopProtocol=PCOIP
Horizon Client가 시작되며 view.mycompany.com 서버에 연결됩니다. 로그인 대화상자에서 사용자 이름 텍스트 상자에 fred가 채워집니다. 사용자는 도메인 이름 및 암호를 제공해야 합니다. 로그인이 성공적으로 수행되면 클라이언트는 디스플레이 이름이 Finance Desktop(재무 데스크톱)인 원격 데스크톱에 연결되고 사용자는 게스트 운영 체제에 로그인됩니다. 연결에는 PCoIP 디스플레이 프로토콜이 사용됩니다.
-
vmware-view://view.mycompany.com/Calculator?action=start-session&appProtocol=BLAST
Horizon Client가 시작되며 view.mycompany.com 서버에 연결됩니다. 로그인 대화상자에 사용자가 이름, 도메인 이름 및 암호를 입력해야 합니다. 로그인이 성공적으로 수행되면 클라이언트는 디스플레이 이름이 Calculator(계산기)인 게시된 애플리케이션에 연결 합니다. 이 연결은 VMware Blast 디스플레이 프로토콜을 사용합니다.
-
vmware-view://[email protected]/Finance%20Desktop?domainName=mycompany
Horizon Client가 시작되며 view.mycompany.com 서버에 연결됩니다. 로그인 대화상자에서 사용자 이름 텍스트 상자에 fred로 채워지고 도메인 텍스트 상자는 mycompany로 채워집니다. 사용자는 암호만 제공해야 합니다. 로그인이 성공적으로 수행되면 클라이언트는 디스플레이 이름이 Finance Desktop(재무 데스크톱)인 원격 데스크톱에 연결되고 사용자는 게스트 운영 체제에 로그인됩니다.
-
vmware-view://view.mycompany.com/
Horizon Client가 시작되며 view.mycompany.com 서버에 연결하기 위한 로그인 메시지가 나타납니다.
-
vmware-view://view.mycompany.com/Primary%20Desktop?action=reset
Horizon Client가 시작되며 view.mycompany.com 서버에 연결됩니다. 로그인 대화상자에 사용자에게 사용자 이름, 도메인 이름 및 암호를 묻는 메시지가 표시됩니다. 로그인에 성공한 후 Horizon Client는 지정된 데스크톱을 재설정합니다.
참고: Horizon 관리자가 원격 데스크톱의 재설정 기능을 사용하도록 설정한 경우에만 이 작업을 사용할 수 있습니다. -
vmware-view://view.mycompany.com/Primary%20Desktop?action=restart
Horizon Client가 시작되며 view.mycompany.com 서버에 연결됩니다. 로그인 대화상자에 사용자에게 사용자 이름, 도메인 이름 및 암호를 묻는 메시지가 표시됩니다. 로그인에 성공한 후 Horizon Client는 지정된 데스크톱을 다시 시작합니다.
참고: Horizon 관리자가 데스크톱에 대해 다시 시작 기능을 사용하도록 설정한 경우에만 이 작업을 사용할 수 있습니다. -
vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session&connectUSBOnStartup=true
이 URI는 첫 번째 예와 동일한 효과를 가지며 클라이언트 시스템에 연결된 모든 USB 디바이스는 원격 데스크톱에 리디렉션됩니다. -
vmware-view://
Horizon Client가 실행되고 있지 않으면 시작됩니다. Horizon Client가 이미 실행되고 있으면 포그라운드로 전환됩니다.
-
vmware-view://10.10.10.10/My%20Notepad++?args=%22My%20new%20file.txt%22
서버 10.10.10.10에서 My Notepad++를 시작하고 게시된 애플리케이션 시작 명령에 인수 My new file.txt를 전달합니다. 공백 및 큰따옴표는 퍼센트 이스케이프를 사용합니다. 파일 이름은 공백을 포함하므로 큰따옴표로 묶입니다.
다음 구문을 사용하여 Windows 명령줄 프롬프트에 이 명령을 입력할 수도 있습니다.vmware-view.exe --serverURL 10.10.10.10 --appName "My Notepad++" --args "\"my new.txt\""
이 예제에서 큰따옴표는 \" 문자로 이스케이프됩니다. -
vmware-view://10.10.10.10/Notepad++%2012?args=a.txt%20b.txt
서버 10.10.10.10에서 Notepad++ 12를 시작하고 게시된 애플리케이션 시작 명령에 a.text b.txt 인수를 전달합니다. 인수가 큰따옴표로 묶여 있지 않기 때문에 파일 이름이 공백으로 구분되며, Notepad++에서 두 파일이 따로 열립니다.
참고: 명령줄 인수를 사용하는 방식은 게시된 애플리케이션마다 다를 수 있습니다. 예를 들어 워드패드에 인수 a.txt b.txt를 전달하면 워드패드에서 a.txt 파일 하나만 열립니다. -
vmware-view://view.mycompany.com/Notepad?unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous1
Horizon Client가 시작되고 anonymous1 사용자 계정을 사용하여 view.mycompany.com 서버에 연결됩니다. 로그인 자격 증명을 제공하라는 메시지가 표시되지 않고 메모장 애플리케이션이 시작됩니다.
HTML 코드 예
URI를 사용하여 e-메일 또는 웹 페이지에 포함할 하이퍼텍스트 링크 및 버튼을 만들 수 있습니다. 다음 예는 첫 번째 URI 예를 사용하여 Test Link라는 하이퍼텍스트 링크와 TestButton이라는 버튼을 코딩하는 방법을 보여줍니다.
<html> <body> <a href="vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session">Test Link</a><br> <form><input type="button" value="TestButton" onClick="window.location.href= 'vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session'"></form> <br> </body> </html>
