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 문자는 우선 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를 지정하는 경우에는 ADSI Edit에서 데스크톱 또는 애플리케이션 ID에 대문자가 포함된 경우에도 소문자만 사용해야 합니다.

참고: 둘 이상의 원격 데스크톱 또는 게시된 애플리케이션의 디스플레이 이름은 동일하지만 데스크톱 및 애플리케이션 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 구문을 사용합니다.

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입니다.