URI를 사용하여 Horizon Client 구성

URI(Uniform Resource Identifier)를 사용하여 최종 사용자가 Horizon Client를 시작하거나, 서버에 연결하거나, 원격 데스크톱 또는 게시된 애플리케이션을 열기 위해 클릭할 수 있는 웹 페이지 또는 이메일 링크를 생성할 수 있습니다.

다음 정보의 일부 또는 전체를 제공하는 URI를 구성하여 이러한 링크를 생성해야 최종 사용자가 정보를 제공할 필요가 없어집니다.

• 서버 주소
• 서버의 포트 번호
• Active Directory 사용자 이름
• 도메인 이름
• 원격 데스크톱 또는 게시된 애플리케이션 디스플레이 이름
• 창 크기
• 세션 재설정, 로그아웃, 시작 등의 작업
• 디스플레이 프로토콜

URI를 구성하려면 Horizon Client 특정 경로 및 쿼리 부분으로 vmware-view URI 구성표를 사용합니다.

URI를 사용하여 Horizon Client를 시작하려면 Horizon Client가 클라이언트 컴퓨터에 이미 설치되어 있어야 합니다.

vmware-view URI 생성을 위한 구문

URI 구문에는 vmware-view URI 구성표, 원격 데스크톱 또는 게시된 애플리케이션을 지정하는 경로 부분 및 선택적으로 원격 데스크톱 또는 게시된 애플리케이션 작업이나 구성 옵션을 지정하는 쿼리가 있습니다.

URI 사양

URI를 만들면 전체 Horizon URI 문자열이 인수로 간주되어 기본적으로 vmware-view가 호출됩니다.

다음 구문을 사용하여 Horizon Client 시작에 필요한 URI를 만듭니다.

vmware-view://[authority-part][/path-part][?query-part]

필수 요소는 URI 구성표 vmware-view뿐입니다. 일부 클라이언트 운영 체제의 일부 버전에서는 구성표 이름의 대/소문자를 구분하므로 vmware-view를 입력합니다.

중요: 모든 부분의 비ASCII 문자는 우선 UTF-8[STD63]에 따라 인코딩되어야 하며 해당 UTF-8 시퀀스의 각 8진수는 URI 문자로 표현되도록 퍼센트로 인코딩되어야 합니다.

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 인코딩 메커니즘을 사용하여 공백을 나타냅니다.

또는 데스크톱이나 애플리케이션 풀 ID를 포함하는 경로 문자열에 해당하는 데스크톱 또는 애플리케이션 ID를 지정할 수 있습니다. 데스크톱 또는 애플리케이션 ID를 찾으려면 연결 서버 호스트에서 ADSI Edit를 열고 DC=vdi,dc=vmware,dc=int로 이동한 후 OU=Applications 노드를 선택합니다. 모든 데스크톱 및 애플리케이션 풀이 나열됩니다. distinguishedName 특성은 ID 값을 지정합니다. ID 값을 URI에 지정하기 전에 인코딩해야 합니다(예: cn%3Dwin7-32%2Cou%3Dapplications%2Cdc%3Dvdi%2Cdc%3Dvmware%2Cdc%3Dint).

참고: 둘 이상의 원격 데스크톱 또는 게시된 애플리케이션의 디스플레이 이름은 동일하지만 데스크톱 및 애플리케이션 ID는 고유합니다. 특정 원격 데스크톱 또는 게시된 애플리케이션을 지정하려면 디스플레이 이름 대신 데스크톱 또는 애플리케이션 ID를 사용합니다.

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 구문을 사용합니다.

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를 사용할 수 있습니다.

launchMinimized

최소화 모드로 Horizon Client를 시작합니다. Horizon Client 창은 사용자 지정 원격 데스크톱 또는 게시된 애플리케이션을 시작하는 동안 백그라운드에서 최소화되어 숨겨진 상태로 유지됩니다. 구문은 launchMinimized=true입니다. 기본값은 false입니다.

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 링크를 클릭할 경우 나타나는 내용에 대한 설명이 이어집니다.

1. vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session

   Horizon Client가 시작되며 view.mycompany.com 서버에 연결됩니다. 로그인 대화상자에 사용자에게 사용자 이름, 도메인 이름 및 암호를 묻는 메시지가 표시됩니다. 로그인이 성공적으로 수행되면 클라이언트는 디스플레이 이름이 Primary Desktop(기본 데스크톱)인 원격 데스크톱에 연결되고 사용자는 게스트 운영 체제에 로그인됩니다.

   참고: 이 예에서는 기본 디스플레이 프로토콜 및 창 크기가 사용됩니다. 기본 디스플레이 프로토콜은 PCoIP이며 기본 창 크기는 전체 화면입니다.

   기본값을 변경할 수 있습니다. vmware-view 명령줄 인터페이스 및 구성 파일 사용의 내용을 참조하십시오.

2. 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)인 원격 데스크톱에 연결됩니다.

3. vmware-view://view.mycompany.com:7555/Primary%20Desktop

   예를 들어 연결 서버 인스턴스의 비기본 포트 7555를 사용하는 것을 제외하면 이 URI는 이전 예와 동일한 효과를 가집니다. 기본 포트는 443입니다. 원격 데스크톱 식별자가 제공되므로 start-session 작업이 URI에 포함되지 않아도 원격 데스크톱이 열립니다.

4. vmware-view://[email protected]/Finance%20Desktop?desktopProtocol=PCOIP

   Horizon Client가 시작되며 view.mycompany.com 서버에 연결됩니다. 로그인 대화상자에서 사용자 이름 텍스트 상자에 fred가 채워집니다. 사용자는 도메인 이름 및 암호를 제공해야 합니다. 로그인이 성공적으로 수행되면 클라이언트는 디스플레이 이름이 Finance Desktop(재무 데스크톱)인 원격 데스크톱에 연결되고 사용자는 게스트 운영 체제에 로그인됩니다. 연결에는 PCoIP 디스플레이 프로토콜이 사용됩니다.

5. vmware-view://view.mycompany.com/Calculator?action=start-session&appProtocol=BLAST

   Horizon Client가 시작되며 view.mycompany.com 서버에 연결됩니다. 로그인 대화상자에 사용자가 이름, 도메인 이름 및 암호를 입력해야 합니다. 로그인이 성공적으로 수행되면 클라이언트는 디스플레이 이름이 Calculator(계산기)인 게시된 애플리케이션에 연결 합니다. 이 연결은 VMware Blast 디스플레이 프로토콜을 사용합니다.

6. vmware-view://[email protected]/Finance%20Desktop?domainName=mycompany

   Horizon Client가 시작되며 view.mycompany.com 서버에 연결됩니다. 로그인 대화상자에서 사용자 이름 텍스트 상자에 fred로 채워지고 도메인 텍스트 상자는 mycompany로 채워집니다. 사용자는 암호만 제공해야 합니다. 로그인이 성공적으로 수행되면 클라이언트는 디스플레이 이름이 Finance Desktop(재무 데스크톱)인 원격 데스크톱에 연결되고 사용자는 게스트 운영 체제에 로그인됩니다.

7. vmware-view://view.mycompany.com/

   Horizon Client가 시작되며 view.mycompany.com 서버에 연결하기 위한 로그인 메시지가 나타납니다.

8. vmware-view://view.mycompany.com/Primary%20Desktop?action=reset

   Horizon Client가 시작되며 view.mycompany.com 서버에 연결됩니다. 로그인 대화상자에 사용자에게 사용자 이름, 도메인 이름 및 암호를 묻는 메시지가 표시됩니다. 로그인에 성공한 후 Horizon Client는 지정된 데스크톱을 재설정합니다.

   참고: Horizon 관리자가 원격 데스크톱의 재설정 기능을 사용하도록 설정한 경우에만 이 작업을 사용할 수 있습니다.

9. vmware-view://view.mycompany.com/Primary%20Desktop?action=restart

   Horizon Client가 시작되며 view.mycompany.com 서버에 연결됩니다. 로그인 대화상자에 사용자에게 사용자 이름, 도메인 이름 및 암호를 묻는 메시지가 표시됩니다. 로그인에 성공한 후 Horizon Client는 지정된 데스크톱을 다시 시작합니다.

   참고: Horizon 관리자가 데스크톱에 대해 다시 시작 기능을 사용하도록 설정한 경우에만 이 작업을 사용할 수 있습니다.

10. vmware-view://

    Horizon Client가 시작되며 사용자는 서버 주소를 입력하는 페이지로 이동됩니다.

11. vmware-view://10.10.10.10/My%20Notepad++?args=%22My%20new%20file.txt%22

    서버 10.10.10.10에서 My Notepad++를 시작하고 게시된 애플리케이션 시작 명령에 인수 My new file.txt를 전달합니다. 파일 이름은 공백을 포함하므로 큰따옴표로 묶입니다.

12. 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 파일 하나만 열립니다.

13. vmware-view://view.mycompany.com/Notepad?unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous1

    Horizon Client가 시작되고 anonymous1 사용자 계정을 사용하여 view.mycompany.com 서버에 연결됩니다. 로그인 자격 증명을 제공하라는 메시지가 표시되지 않고 메모장 애플리케이션이 시작됩니다.

HTML 코드 예

URI를 사용하여 이메일 또는 웹 페이지에 포함할 하이퍼텍스트 링크 및 버튼을 만들 수 있습니다. 다음 예는 첫 번째 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>