Skip to main content

30 de julio de 2026

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

Utilice la siguiente sintaxis para crear los URI e iniciar Omnissa 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, desplácese hasta el contexto de nombre distintivo de Horizon Connection Server 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 la guía de instalación y configuración correspondiente a cada tipo de sistema cliente.

  • action

    Valores que pueden utilizarse con la consulta action

    ValorDescripción
    browseMuestra 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. Si utiliza la acción browse y especifica un escritorio remoto o una aplicación publicada, estos se destacarán en la lista de elementos disponibles.
    start-sessionAbre 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.
    restartCierra 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.
    logoffCierra 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.

  • connectUSBOnInsert

    Conecta un dispositivo USB a la aplicación publicada o al escritorio remoto en segundo plano al conectar el dispositivo. Esta consulta se establece de forma implícita si especifica la consulta unattended para un escritorio remoto. Para utilizar esta consulta, debe establecer la consulta action en start-session, o bien no tener una consulta action. Los valores válidos son true y false. Un ejemplo de sintaxis es connectUSBOnInsert=true.

  • connectUSBOnStartup

    Redirecciona al escritorio remoto o la aplicación publicada todos los dispositivos USB conectados actualmente al sistema cliente. Esta consulta se establece de forma implícita si especifica la consulta unattended para un escritorio remoto. Para utilizar esta consulta, debe establecer la consulta action en start-session, o bien no tener una consulta action. Los valores válidos son true y false. Un ejemplo de sintaxis es connectUSBOnStartup=true.

  • desktopLayout

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

    Valores válidos para la consulta desktopLayout

    ValorDescripción
    fullscreenPantalla completa en un monitor.
    multimonitorPantalla completa en todos los monitores.
    windowLargeVentana grande.
    windowSmallVentana pequeña.
    WxHResolució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.

  • filePath

    Especifica la ruta del archivo del sistema local que desea abrir con la aplicación publicada. Puede especificar la ruta completa o una ruta relativa, como ~/username/test%20file.txt. 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 Por ejemplo, para representar la ruta de archivo /Users/username/test file.txt, utilice /User/username/test%20file.txt.

¿Le resultó útil esta página?

Enviar comentarios sobre este tema

¿Le resultó útil este tema?

No incluya información personal ni confidencial.

Generando el enlace…