Usar URI para configurar Omnissa Horizon Client

Puede utilizar identificadores uniformes de recursos (URI) para crear páginas web o vínculos de correos electrónicos para que los usuarios finales puedan hacer clic para iniciar Horizon Client, conectarse a un servidor o abrir un escritorio remoto o una aplicación publicada.

Para ello, deberá crear URI que ofrezcan toda la información (o parte de ella) que se indica a continuación para que los usuarios finales no tengan que proporcionarla.

• Dirección del servidor
• Número de puerto del servidor
• Nombre de usuario de Active Directory
• Nombre de dominio
• Nombre para mostrar del escritorio remoto o la aplicación publicada
• Tamaño de ventana
• Acciones como restablecer, cerrar sesión e iniciar sesión
• Protocolo de visualización

Para crear un URI, deberá utiliza el esquema URI horizon-client con la ruta y las partes de consulta específicas de Horizon Client.

Si desea usar un URI para iniciar Horizon Client, Horizon Client debe estar instalado en los equipos cliente.

Sintaxis para crear URI de horizon-client

La sintaxis de los URI incluye el esquema URI horizon-client, una parte de la ruta que se utiliza para especificar el escritorio remoto o la aplicación publicada y, de forma opcional, una consulta que se utiliza para indicar acciones de la aplicación publicada, el escritorio remoto u opciones de configuración.

Especificación de URI

Al crear un URI, básicamente está llamando a horizon-client con la cadena de ruta y consulta completa como un argumento.

Utilice la siguiente sintaxis para crear los URI e iniciar Horizon Client.

horizon-client://[authority-part][/path-part][?query-part]

El único elemento necesario es el esquema del URI, horizon-client. Como el nombre del esquema distingue entre mayúsculas y minúsculas en algunas versiones de ciertos sistemas operativos cliente, escriba horizon-client.

Importante: En todas las partes, se deben codificar primero los caracteres que no sean ASCII según UTF-8 [STD63]. A continuación, cada octeto de la secuencia UTF-8 correspondiente se debe codificar con porcentaje para representarse como caracteres URI.

Para obtener información sobre la codificación de caracteres ASCII, consulte la referencia de codificación de URL en http://www.utf8-chartable.de/.

• authority-part

  La dirección del servidor y, de manera opcional, un nombre de usuario, un número de puerto no predeterminado o ambos. Los nombres de los servidores no admiten guiones bajos (_). Los nombres de servidor deben adaptarse a la sintaxis de DNS.

  Para especificar un nombre de usuario, utilice la siguiente sintaxis.

  user1@server-address
  

  No se puede especificar una dirección UPN, que incluye el dominio. Para especificar el dominio, puede utilizar la parte de la consulta domainName en el URI.

  Para especificar un número de puerto, utilice la siguiente sintaxis.

  server-address:port-number
  

• path-part

  El nombre para mostrar del escritorio remoto o de la aplicación publicada. El nombre para mostrar se especifica en Omnissa Horizon Console cuando se crea el grupo de escritorios o de aplicaciones. Si el nombre para mostrar contiene un espacio, utilice el mecanismo de codificación %20 para representar el espacio.

  Opcionalmente, puede especificar un identificador de aplicación o de escritorio, que es una cadena de ruta que incluye el identificador del grupo de aplicaciones o escritorios. Para buscar un identificador de escritorio o aplicación, abra el Editor ADSI en el host de Omnissa Horizon Connection Server, acceda a la ubicación de DC adecuada y seleccione el nodo OU=Applications. Se mostrarán todos los grupos de aplicaciones y escritorios. El atributo distinguishedName especifica el valor del identificador. Debe codificar el valor del identificador antes de especificarlo en un URI.

  Nota: Varios escritorios remotos o aplicaciones publicadas pueden tener el mismo nombre para mostrar, pero el identificador de cada aplicación y cada escritorio son únicos. Para especificar un escritorio remoto o una aplicación publicada en particular, utilice el identificador de la aplicación o el escritorio en lugar del nombre para mostrar.

• query-part

  Las opciones de configuración que se usarán o las acciones que realizarán las aplicaciones publicadas o los escritorios remotos. Las solicitudes no distinguen entre mayúsculas y minúsculas. Para utilizar varias consultas, utilice el carácter & entre las consultas. Si existe algún conflicto en las consultas, Horizon Client usará la última consulta de la lista. Utilice la siguiente sintaxis.

  query1=value1[&query2=value2...]
  

Consultas admitidas

Se admiten las siguientes consultas para este tipo de Horizon Client. Si va a crear URI para varios tipos de clientes (por ejemplo, clientes móviles y de escritorio), puede consultar la lista de consultas admitidas en el documento de la guía correspondiente a cada tipo de sistema cliente.

• action
  Los siguientes valores se pueden utilizar con la consulta action.

  Valor	Descripción
  browse	Muestra una lista de las aplicaciones publicadas y los escritorios remotos disponibles y alojados en el servidor especificado. No tendrá que especificar un escritorio remoto ni una aplicación publicada al utilizar esta acción.
  start-session	Abre la aplicación publicada o el escritorio remoto especificados. Si no se proporciona ninguna consulta action y se facilita el nombre de la aplicación publicada o del escritorio remoto, start-session será la acción predeterminada.
  reset	Apaga y reinicia la aplicación publicada o el escritorio remoto especificados. Se pierden los datos que no se hayan guardado. La acción de reiniciar un escritorio remoto es equivalente a pulsar el botón Reiniciar en un equipo físico.
  restart	Cierra y reinicia el escritorio remoto especificado. Reiniciar un escritorio remoto equivale al comando de reinicio del sistema operativo Windows. El sistema operativo normalmente le pedirá al usuario que guarde los datos que no haya guardado antes de reiniciar.
  logoff	Cierra la sesión del usuario del sistema operativo invitado en el escritorio remoto. Si especifica una aplicación publicada, la acción se ignorará o el usuario final verá el mensaje de error "Acción de URI no válida".

• args

  Especifica los argumentos de la línea de comandos que se agregan cuando se inicia la aplicación publicada. Utilice la sintaxis args=valor, donde "valor" es una cadena. Utilice la codificación porcentual para los siguientes caracteres:

  • Para los dos puntos (:), utilice %3A
  • Para una barra diagonal inversa (\), utilice %5C
  • Para un espacio ( ), utilice %20
  • Para unas comillas dobles ("), utilice %22 (por ejemplo, para especificar el nombre de archivo "My new file.txt" para la aplicación Notepad++, utilice %22My%20new%20file.txt%22)

• appProtocol

  Para las aplicaciones publicadas, los valores válidos son PCOIP y BLAST. Por ejemplo, para especificar PCoIP, utilice la sintaxis appProtocol=PCOIP.

• desktopLayout

  Establece el tamaño de la ventana del escritorio remoto. Para utilizar esta consulta, debe establecer la consulta action en start-session o no tener una consulta action.

  Los siguientes valores se pueden utilizar para la consulta desktopLayout.

  Valor	Descripción
  fullscreen	Pantalla completa en un monitor. Este es el valor predeterminado.
  multimonitor	Pantalla completa en todos los monitores.
  windowLarge	Ventana grande.
  windowSmall	Ventana pequeña.
  WxH	Resolución personalizada, donde se especifica la anchura por la altura (en píxeles). Un ejemplo de sintaxis es desktopLayout=1280x800.

• desktopProtocol

  Para los escritorios remotos, los valores válidos son PCOIP y BLAST. Por ejemplo, para especificar PCoIP, utilice la sintaxis desktopProtocol=PCOIP.

• domainName

  Especifica el nombre de dominio NETBIOS asociado al usuario que se conecta a la aplicación publicada o al escritorio remoto. Por ejemplo, puede usar mycompany en lugar de mycompany.com.

• launchMinimized

  Inicia Horizon Client en modo minimizado. La ventana de Horizon Client permanece minimizada y oculta en segundo plano mientras se inicia la aplicación publicada o el escritorio remoto especificados por el usuario. La sintaxis es launchMinimized=true. El valor predeterminado es false.

• useExisting

  Si se establece el parámetro -useExisting, podrá controlar si se pueden ejecutar varias instancias de Horizon Client de forma simultánea. Cuando se establece este parámetro, Horizon Client mantendrá una única instancia y solicitará que se cierren todas las sesiones abiertas antes de iniciar una nueva.

  Cuando el parámetro -useExisting está establecido, se mostrará un indicador para usar una única instancia del cliente. Aparecerá un mensaje para cerrar la sesión en la instancia abierta. Una vez aceptado, se abrirá la nueva.

  Cuando el parámetro -useExisting no está establecido, se podrán abrir nuevas instancias del cliente.

  Ejemplo: <IP>?useExisting=true o <IP>?useExisting=false Inserte su IP especificada donde se muestra IP.

• unauthenticatedAccessEnabled

  • Si esta opción está establecida como true, la función Acceso sin autenticar estará activada. La opción Archivo > Acceso sin autenticar está visible en la interfaz de usuario y estará seleccionada.
  • Si esta opción está establecida como false, la función Acceso sin autenticar estará desactivada. La opción Archivo > Acceso sin autenticar estará visible en la interfaz de usuario y no estará seleccionada.
  • Cuando esta opción está establecida como "", la función Acceso sin autenticar estará desactivada y la opción Archivo > Acceso sin autenticar estará visible en la interfaz de usuario y no estará seleccionada. Un ejemplo de sintaxis es unauthenticatedAccessEnabled=true.

• unauthenticatedAccessAccount

  Si la función Acceso sin autenticar está activada, establece la cuenta que se usará. Si la función Acceso sin autenticar está desactivada, esta consulta se ignorará. Un ejemplo de sintaxis con la cuenta de usuario anonymous1 es unauthenticatedAccessAccount=anonymous1.

Ejemplos de URI de horizon-client

Puede usar el esquema URI horizon-client para crear botones o vínculos de hipertexto, e incluir estos vínculos en un correo electrónico o en una página web. Por ejemplo, un usuario final puede hacer clic en un enlace URI para iniciar un escritorio remoto con las opciones de inicio que usted especifique.

Cada ejemplo de URI va seguido de una descripción de lo que ve el usuario final después de hacer clic en el enlace URI.

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

   Horizon Client se inicia y se conecta al servidor horizon.mycompany.com. El cuadro de diálogo de inicio de sesión solicita al usuario un nombre de usuario, un nombre de dominio y una contraseña. Tras iniciar sesión correctamente, el cliente se conecta al escritorio remoto cuyo nombre para mostrar es Primary Desktop, y el usuario inicia sesión en el sistema operativo invitado.

   Nota: En este ejemplo, se utilizan el protocolo de visualización y el tamaño de ventana predeterminados. El protocolo de visualización predeterminado es PCoIP y el tamaño predeterminado de la ventana es pantalla completa.

   Los valores predeterminados se pueden cambiar. Consulte Utilizar los archivos de configuración y la interfaz de línea de comandos de horizon-client.

2. horizon-client://horizon.mycompany.com:7555/Primary%20Desktop
   

   Este URI tiene el mismo efecto que el ejemplo anterior, excepto que usa el puerto 7555 no predeterminado para la instancia de Horizon Connection Server. (El puerto por defecto es el 443.) Como se proporciona el identificador del escritorio remoto, este se abre aunque la acción start-session no se incluya en el URI.

3. horizon-client://fred@horizon.mycompany.com/Finance%20Desktop?desktopProtocol=PCOIP
   

   Horizon Client se inicia y se conecta al servidor horizon.mycompany.com. En el cuadro de diálogo de inicio de sesión, el cuadro de texto Nombre de usuario se rellena con fred. El usuario debe proporcionar el nombre de dominio y la contraseña. Tras iniciar sesión correctamente, el cliente se conecta al escritorio remoto cuyo nombre para mostrar es Finance Desktop, y el usuario inicia sesión en el sistema operativo invitado. La conexión utiliza el protocolo de visualización PCoIP.

4. horizon-client://horizon.mycompany.com/Calculator?action=start-session&appProtocol=BLAST
   

   Horizon Client se inicia y se conecta al servidor horizon.mycompany.com. En el cuadro de diálogo de inicio de sesión, el usuario debe proporcionar el nombre de usuario, de dominio y la contraseña. Después de iniciar sesión correctamente, el cliente se conecta a la aplicación publicada que tiene el nombre para mostrar Calculator. La conexión utiliza el protocolo de visualización Omnissa Horizon Blast.

5. horizon-client://fred@horizon.mycompany.com/Finance%20Desktop?domainName=mycompany
   

   Horizon Client se inicia y se conecta al servidor horizon.mycompany.com. En el cuadro de diálogo de inicio de sesión, el cuadro de texto Nombre de usuario se rellena con fred y el cuadro de texto Dominio se rellena con mycompany. El usuario solo debe proporcionar una contraseña. Tras iniciar sesión correctamente, el cliente se conecta al escritorio remoto cuyo nombre para mostrar es Finance Desktop, y el usuario inicia sesión en el sistema operativo invitado.

6. horizon-client://horizon.mycompany.com/
   

   Horizon Client se inicia y se muestra la solicitud de inicio de sesión para que el usuario se conecte al servidor horizon.mycompany.com.

7. horizon-client://horizon.mycompany.com/Primary%20Desktop?action=reset
   

   Horizon Client se inicia y se conecta al servidor horizon.mycompany.com. El cuadro de diálogo de inicio de sesión solicita al usuario un nombre de usuario, un nombre de dominio y una contraseña. Después de iniciar sesión correctamente, Horizon Client restablecerá el escritorio especificado.

   Nota: Esta acción solo está disponible si un administrador activó la función de restablecimiento para el escritorio remoto.

8. horizon-client://horizon.mycompany.com/Primary%20Desktop?action=restart
   

   Horizon Client se inicia y se conecta al servidor horizon.mycompany.com. El cuadro de diálogo de inicio de sesión solicita al usuario un nombre de usuario, un nombre de dominio y una contraseña. Después de iniciar sesión correctamente, Horizon Client reiniciará el escritorio especificado.

   Nota: Esta acción solo está disponible si un administrador activó la función de reinicio para el escritorio remoto.

9. horizon-client://
   

   Horizon Client se inicia y aparece la página en la que el usuario tiene que introducir la dirección de un servidor.

10. horizon-client://10.10.10.10/My%20Notepad++?args=%22My%20new%20file.txt%22
    

    Inicia My Notepad++ en el servidor 10.10.10.10 y envía el argumento My new file.txt al comando del inicio de la aplicación publicada. El nombre del archivo aparece entre comillas dobles porque contiene espacios.

11. horizon-client://10.10.10.10/Notepad++%2012?args=a.txt%20b.txt
    

    Inicia Notepad++ 12 en el servidor 10.10.10.10 y envía el argumento a.text b.txt al comando del inicio de la aplicación publicada. Como el argumento no va entre comillas, un espacio separa los nombres de los archivos y los dos archivos se abren por separado en Notepad++.

    Nota: Las aplicaciones publicadas pueden utilizar los argumentos de la línea de comandos de forma diferente. Por ejemplo, si envía el argumento a.txt b.txt a WordPad, este último solo abrirá un archivo, a.txt.

12. horizon-client://horizon.mycompany.com/Notepad?unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous1
    

    Horizon Client se inicia y se conecta al servidor horizon.mycompany.com con la cuenta de usuario anonymous1. Se inicia la aplicación Bloc de notas sin solicitar al usuario que proporcione las credenciales de inicio de sesión.

Ejemplos de código HTML

Puede utilizar los URI para crear enlaces de hipertexto y botones para incluirlos en correos electrónicos o páginas web. Los siguientes ejemplos muestran cómo usar el URI en el primer ejemplo de URI para codificar un vínculo de hipertexto etiquetado como Test Link y un botón etiquetado como TestButton.

<html>
<body>

<a href="horizon-client://horizon.mycompany.com/Primary%20Desktop?action=start-session">Test Link</a><br>

<form><input type="button" value="TestButton" onClick="window.location.href=
'horizon-client://horizon.mycompany.com/Primary%20Desktop?action=start-session'"></form> <br>

</body>
</html>