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 de servidor
- Número de puerto para el servidor de conexión
- Nombre de usuario de Active Directory
- Nombre de dominio
- Nombre para mostrar del escritorio remoto o la aplicación publicada
- Tamaño de la ventana
- Acciones (como restablecer e iniciar o cerrar sesión)
- Protocolo de visualización
Para construir una URI, utilice el esquema de URI vmware-view con la ruta y las partes de consulta específicas de Horizon Client.
Para utilizar los URI para iniciar Horizon Client, primero debe instalar Horizon Client en los equipos cliente.
Sintaxis para crear URI de vmware-view
La sintaxis de URI incluye el esquema URI vmware-view, 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, está llamando a vmware-view con la cadena completa de URI de Horizon como un argumento.
Utilice la siguiente sintaxis para crear los URI e iniciar Horizon Client.
vmware-view://[authority-part][/path-part][?query-part]
El único elemento necesario es el esquema URI, vmware-view. Como el nombre del esquema distingue entre mayúsculas y minúsculas en algunas versiones de ciertos sistemas operativos cliente, escriba vmware-view.
Para obtener información sobre la codificación de caracteres ASCII, consulte la referencia de codificación de URL de 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 puede especificar una dirección UPN, que incluye el dominio. Para especificar el dominio, puede utilizar la parte de la consulta domainName en la 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 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.
- 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 consultas no distinguen entre mayúsculas y minúsculas. Para utilizar varias consultas, utilice el signo et (&) entre ellas. Si existe algún conflicto en las consultas,
Horizon Client usa 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 cliente, como clientes de escritorio y clientes móviles, consulte la guía de instalación y configuración para cada tipo de sistema cliente de la lista de consultas admitidas.
- action
-
Tabla 1. Valores que 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 es 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 Apaga y reinicia el escritorio remoto especificado. Reiniciar un escritorio remoto es el equivalente del comando de reinicio del sistema operativo Windows. El sistema operativo suele solicitar al usuario que guarde los datos que no se guardaran antes de reiniciar. logoff Cierra la sesión del usuario en el sistema operativo invitado del 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=
value, en el que
value es una cadena. Utilice la codificación con porcentajes 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 ("), use %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 ninguna consulta
action.
Tabla 2. Valores válidos para la consulta desktopLayout Valor Descripción fullscreen Pantalla completa en un monitor. Este valor es el predeterminado. multimonitor Pantalla completa en todos los monitores. windowLarge Ventana grande. windowSmall Ventana pequeña. WxH Resolución personalizada, en la que puede especificar el ancho y el alto en píxeles. Un ejemplo de sintaxis es desktopLayout=1280x800. - desktopProtocol
- Para los escritorios remotos, los valores válidos son RDP, 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 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 a esta opción se le asigna el valor true, solo se podrá ejecutar una instancia de Horizon Client. Si los usuarios intentan conectarse a un segundo servidor, deberán cerrar sesión en el primero, lo que provocará que las sesiones de aplicaciones publicadas y escritorios remotos se desconecten. Si a esta opción se le asigna el valor false, se podrán ejecutar varias instancias de Horizon Client y los usuarios se podrán conectar a varios servidores a la vez. El valor predeterminado es true. Un ejemplo de sintaxis es useExisting=false.
- unauthenticatedAccessEnabled
-
- Si esta opción está establecida como true, la función Acceso sin autenticar está habilitada. La opción está visible en la interfaz de usuario y está seleccionada.
- Si esta opción está establecida como false, la función Acceso sin autenticar está desactivada. La opción está visible en la interfaz de usuario y no está seleccionada.
- Cuando esta opción está establecida como "", la función Acceso sin autenticar está desactivada y la opción está visible en la interfaz de usuario y no está seleccionada.
Un ejemplo de sintaxis es unauthenticatedAccessEnabled=true.
- unauthenticatedAccessAccount
- Si la función Acceso sin autenticar está habilitada, configura la cuenta que se usará. Si la función Acceso sin autenticar está desactivada, esta consulta se ignora. Un ejemplo de sintaxis con la cuenta de usuario anonymous1 es unauthenticatedAccessAccount=anonymous1.
Ejemplos de URI vmware-view
Puede usar el esquema URI vmware-view 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 vínculo URI para iniciar un escritorio remoto con las opciones de inicio que especifique.
Cada ejemplo de URI aparece con una descripción sobre qué es lo que el usuario final ve después de hacer clic en el vínculo del URI.
-
vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session
Horizon Client se inicia y se conecta al servidor view.mycompany.com. El cuadro de diálogo de inicio de sesión solicita un nombre de usuario, de dominio y una contraseña. Tras iniciar sesión correctamente, el cliente se conecta al escritorio remoto cuyo nombre para mostrar es Escritorio primario y el usuario inicia sesión en el sistema operativo cliente.
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.Es posible cambiar estos valores predeterminados. Consulte Utilizar los archivos de configuración y la interfaz de línea de comandos de vmware-view.
-
vmware-view://view.mycompany.com/cn%3Dwin7-32%2Cou%3Dapplications%2Cdc%3Dvdi%2Cdc%3Dvmware%2Cdc%3Dint
Horizon Client se inicia y se conecta al servidor view.mycompany.com. El cuadro de diálogo de inicio de sesión solicita un nombre de usuario, de dominio y una contraseña. Después de iniciar sesión correctamente, el cliente se conectará al escritorio remoto que tiene el identificador de escritorio CN=win7-32,OU=Applications,DC=vdi,DC=vmware,DC=int (valor codificado cn%3Dwin7-32%2Cou%3Dapplications%2Cdc%3Dvdi%2Cdc%3Dvmware%2Cdc%3Dint).
-
vmware-view://view.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 del servidor de conexión. (El puerto predeterminado es 443). Dado que se proporciona el identificador del escritorio remoto, este se abre aunque la acción start-session no se incluya en el URI.
-
vmware-view://[email protected]/Finance%20Desktop?desktopProtocol=PCOIP
Horizon Client se inicia y se conecta al servidor view.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 Escritorio de finanzas y el usuario inicia sesión en el sistema operativo cliente. La conexión utiliza el protocolo de visualización PCoIP.
-
vmware-view://view.mycompany.com/Calculator?action=start-session&appProtocol=BLAST
Horizon Client se inicia y se conecta al servidor view.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 Calculadora. La conexión utiliza el protocolo de visualización VMware Blast.
-
vmware-view://[email protected]/Finance%20Desktop?domainName=mycompany
Horizon Client se inicia y se conecta al servidor view.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 Escritorio de finanzas y el usuario inicia sesión en el sistema operativo cliente.
-
vmware-view://view.mycompany.com/
Horizon Client se inicia y se muestra la solicitud de inicio de sesión para que el usuario se conecte al servidor view.mycompany.com.
-
vmware-view://view.mycompany.com/Primary%20Desktop?action=reset
Horizon Client se inicia y se conecta al servidor view.mycompany.com. El cuadro de diálogo de inicio de sesión solicita un nombre de usuario, 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 Horizon Administrator habilitó la función de restablecimiento para el escritorio remoto. -
vmware-view://view.mycompany.com/Primary%20Desktop?action=restart
Horizon Client se inicia y se conecta al servidor view.mycompany.com. El cuadro de diálogo de inicio de sesión solicita un nombre de usuario, 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 Horizon Administrator habilitó la función de restablecimiento para el escritorio remoto. -
vmware-view://
Horizon Client se inicia y aparece la página en la que el usuario tiene que introducir la dirección de un servidor.
-
vmware-view://10.10.10.10/My%20Notepad++?args=%22My%20new%20file.txt%22
Inicia 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.
-
vmware-view://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. Dado que los argumentos no están entre comillas, un espacio separa los nombres de los archivos y ambos archivos se abren de forma independiente 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. -
vmware-view://view.mycompany.com/Notepad?unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous1
Horizon Client se inicia y se conecta al servidor view.mycompany.com utilizando 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ódigos HTML
Si lo desea, puede utilizar los URI para hacer que los botones y los vínculos de hipertexto se incluyan en correos electrónicos o en 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="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>