구문에는 서버를 지정하는 경로 부분과 필요한 경우 사용자, 원격 데스크톱 또는 게시된 애플리케이션, 작업 또는 구성 옵션을 지정하는 쿼리가 포함됩니다.
URI 규격
다음 구문을 사용하여 HTML Access 시작에 필요한 URI를 만듭니다.
https://authority-part[/?query-part]
- authority-part
-
서버 주소를 지정하고 필요한 경우 기본값이 아닌 포트 번호를 지정합니다. 서버 이름은 DNS 구문에 따라야 합니다.
포트 번호를 지정하려면 다음 구문을 사용하십시오.
server-address:port-number
- query-part
-
사용할 구성 옵션이나 수행할 작업을 지정합니다. 쿼리는 대소문자를 구분하지 않습니다. 여러 쿼리를 사용하려면 쿼리 사이에 앰퍼샌드(&)를 사용합니다. 쿼리가 서로 충돌할 경우, 목록의 마지막 쿼리가 사용됩니다. 다음 구문을 사용하십시오.
query1=value1[&query2=value2...]
쿼리 부분을 생성할 때는 다음 지침을 따라야 합니다.
- 지원되는 쿼리를 하나 이상 사용하지 않을 경우 기본 VMware Horizon 웹 포털 페이지가 표시됩니다.
- 쿼리 부분에서는 일부 특수 문자가 지원되지 않으며 해당 문제에 대해 URL 인코딩 형식을 사용해야 합니다. 즉, 파운드 기호(#)에는 %23을, 퍼센트 기호(%)에는 %25를, 앰퍼샌드(&)에는 %26을, at 기호(@)에는 %40을, 백슬래시(\)에는 %5C를 사용해야 합니다.
URL 인코딩에 대한 자세한 내용은 http://www.w3schools.com/tags/ref_urlencode.asp를 참조하십시오.
- 쿼리 부분의 비 ASCII 문자는 우선 UTF-8[STD63]에 따라 인코딩되어야 하며 해당 UTF-8 시퀀스의 각 8진수는 URI 문자로 표현되도록 퍼센트로 인코딩되어야 합니다.
ASCII 문자 인코딩에 대한 자세한 내용은 http://www.utf8-chartable.de/의 URL 인코딩 참조를 참고하십시오.
지원되는 쿼리
이 항목에서는 HTML Access에 지원되는 쿼리를 나열합니다. 데스크톱 클라이언트 및 모바일 클라이언트 등과 같은 여러 유형의 클라이언트에 대한 URI를 생성하는 경우 각 유형의 클라이언트 시스템에 대한 설치 및 설정 문서를 참조하십시오.
- 작업
-
표 1. 작업 쿼리와 함께 사용할 수 있는 값 값 설명 browse 지정된 서버에서 호스트된 사용 가능한 원격 데스크톱 및 게시된 애플리케이션 목록을 표시합니다. 이 작업을 사용하면서 원격 데스크톱 또는 게시된 애플리케이션을 지정할 필요는 없습니다. start-session 지정된 원격 데스크톱 또는 게시된 애플리케이션을 시작합니다. 작업 쿼리가 제공되지 않고 원격 데스크톱 또는 게시된 애플리케이션 이름이 제공되는 경우, start-session이 기본 작업입니다. reset 지정된 원격 데스크톱을 종료하고 다시 시작합니다. 저장하지 않은 데이터는 손실됩니다. 원격 데스크톱 재설정은 PC에 있는 재설정 버튼을 누르는 것과 같습니다. 이 작업은 게시된 애플리케이션에 유효하지 않습니다. logoff 원격 데스크톱의 게스트 운영 체제에서 사용자를 로그아웃시킵니다. 이 작업은 게시된 애플리케이션에 유효하지 않습니다. restart 사용자가 다시 시작 작업 요청을 확인한 후 기본 원격 데스크톱을 종료하고 다시 시작합니다. 이 작업은 게시된 애플리케이션에 유효하지 않습니다. - applicationId
- 게시된 애플리케이션 표시 이름입니다. 표시 이름은 애플리케이션 풀이 생성될 때 Horizon Console에서 지정한 이름입니다. 표시 이름에 공백이 포함되어 있으면 브라우저는 %20을 사용하여 공백을 나타냅니다.
- args
-
게시된 애플리케이션이 시작될 때 추가할 명령줄 인수를 지정합니다. 구문
args=
값을 사용합니다. 여기서
값은 문자열입니다. 다음 문자에는 % 인코딩을 사용하십시오.
- 콜론(:)에는 %3A를 사용합니다.
- 백슬래시(\)에는 %5C를 사용합니다.
- 공백( )에는 %20을 사용합니다.
- 큰따옴표 표시(”)에는 %22를 사용합니다.
예를 들어 Notepad++ 애플리케이션에 대해 파일 이름 "My new file.txt"를 지정하려면 %22My%20new%20file.txt%22를 사용합니다.
- desktopId
- 원격 데스크톱 표시 이름입니다. 표시 이름은 데스크톱 풀이 생성될 때 Horizon Console에서 지정한 이름입니다. 표시 이름에 공백이 포함되어 있으면 브라우저는 %20을 사용하여 공백을 나타냅니다.
- domainName
- 원격 데스크톱 또는 게시된 애플리케이션에 연결 중인 사용자와 연결된 NETBIOS 도메인 이름입니다. 예를 들어 mycompany.com보다는 mycompany를 사용합니다.
- tokenUserName
- RSA 또는 RADIUS 사용자 이름입니다. RSA 또는 RADIUS 사용자 이름이 Active Directory 사용자 이름과 다른 경우에만 이 쿼리를 사용합니다. 이 쿼리를 지정하지 않고 RSA 또는 RADIUS 인증이 필요한 경우, Windows 사용자 이름을 사용합니다.
- userName
-
원격 데스크톱 또는 게시된 애플리케이션에 연결 중인 Active Directory 사용자입니다. 사용자 이름은 다음 형식 중 하나로 표시할 수 있습니다.
- userName
- domainName%5CuserName
- UPN(사용자 계정 이름) 즉, userName@domainName
- unauthenticatedAccessEnabled
- 이 옵션을 true로 설정하면 인증되지 않은 액세스 기능이 기본적으로 사용되도록 설정됩니다. HTML Access가 시작되고 익명 사용자 계정이 표시됩니다. 구문 예는 unauthenticatedAccessEnabled=true입니다.
- unauthenticatedAccessAccount
- 인증되지 않은 액세스 기능이 사용되도록 설정되면 사용할 계정을 설정합니다. 인증되지 않은 액세스가 사용되지 않도록 설정되면 이 쿼리는 무시됩니다. anonymous1 사용자 계정을 사용할 때의 구문 예는 unauthenticatedAccessAccount=anonymous1입니다.