Uso de un archivo de conexión

Con el cliente nativo de Windows, Linux o macOS, puede crear un archivo de conexión que puede usar para conectarse instantáneamente a una NICE DCV sesión.

Crear el archivo de conexión

El archivo de conexión es un archivo de texto con una extensión de archivo .dcv. El formato del archivo .dcv es similar al de un archivo .ini. El archivo incluye [groups], seguido de los parámetros y sus valores. Los grupos y parámetros adoptan el siguiente formato:

[group_name]
parameter_name=parameter_value
    

Por ejemplo:

[options]
fullscreen=true
    

Puede crear un archivo de conexión para una NICE DCV sesión específica directamente desde el cliente. También puede crear un archivo de conexión desde cero con un editor de texto

nota

El procedimiento para crear un archivo de conexión desde cero con un editor de texto es el mismo para los clientes de Windows, Linux y macOS.

Para crear un archivo de conexión desde el cliente

1. Abra el cliente de .

2. Conéctese al servidor y a la sesión donde va a crear el archivo.

3. Seleccione el nombre de host del NICE DCV servidor en la esquina superior derecha y elija Guardar conexión como.

4. En la ventana Save As (Guardar como), proporcione un nombre de archivo y una carpeta de destino, y elija Save (Guardar).

De forma predeterminada, cuando se crea un archivo de conexión, este incluye los parámetros format, host, port, user, y proxytype. Estos parámetros son necesarios para conectarse a la sesión desde la que se creó el archivo. Puede personalizar o agregar parámetros manualmente en cualquier momento editando el archivo mediante un editor de texto.

Para crear un archivo de conexión desde cero con un editor de texto

1. Cree un archivo .dcv con el siguiente formato de nombre de archivo: file_name.dcv

2. Abra el archivo .dcv con el editor de texto que prefiera.

3. Agregue el grupo [version] y el parámetro format a la parte superior del archivo con el siguiente formato:

   [version]
   format=1.0

   importante

   Si el archivo .dcv no incluye el grupo [version] y el parámetro format, se produce un error de análisis.

4. Añada los grupos de parámetros necesarios con el siguiente formato:

   [group_name]

   Para obtener más información acerca de los grupos de parámetros, consulte Parámetros admitidos.

5. Añada los parámetros y valores de parámetros después de los grupos con el siguiente formato:

   parameter_name=parameter_value

   nota

   • Los nombres de los parámetros distinguen entre mayúsculas y minúsculas.

   • No encierre los valores de los parámetros de cadena entre comillas.

   Para obtener más información acerca de los parámetros y valores de los parámetros, consulte Parámetros admitidos.

6. Guarde los cambios y cierre el archivo .dcv.

También puede utilizar este procedimiento para agregar parámetros adicionales a un archivo de conexión existente en cualquier momento.

Parámetros admitidos

Actualmente, el archivo .dcv admite parámetros de tres grupos de parámetros: [version], [connect] y [options]. En las siguientes tablas se incluyen los grupos y sus parámetros disponibles.

Grupos

• Parámetros [version]
• Parámetros [connect]
• Parámetros [options]

Parámetros [version]

importante

Este grupo es obligatorio. Si el archivo .dcv no incluye este grupo, se producirá un error de análisis.

En la siguiente tabla se incluyen los parámetros que se pueden especificar en el grupo [version].

Parámetro	Tipo	Valor predeterminado	Descripción
formato	cadena		importante Este es un parámetro obligatorio. El valor del parámetro debe ser 1.0. Si el archivo .dcv no incluye este parámetro, se producirá un error de análisis.

Parámetros [connect]

En la siguiente tabla se incluyen los parámetros que se pueden especificar en el grupo [connect].

Parámetro	Tipo	Valor predeterminado	Descripción
host	Cadena		El nombre de host del NICE DCV servidor que aloja la sesión.
port	Entero	8443	El puerto que se va a utilizar al conectarse al NICE DCV servidor.
weburlpath	Cadena		Una ruta personalizada en el NICE DCV servidor para la conexión. Por ejemplo, si especifica customPath, el cliente intenta conectarse a host:port/customPath.
sessionid	Cadena		El ID de la NICE DCV sesión a la que se va a conectar.
authtoken	Cadena		El token de autenticación que se utilizará para la conexión. Si especifica un authtoken, también debe especificar un sessionid. Al utilizar authtoken, puede omitir los parámetros user y password.
usuario	Cadena		El nombre de usuario que se va a utilizar al conectarse al NICE DCV servidor.
password	Cadena		La contraseña que se debe usar al conectarse al NICE DCV servidor. La contraseña no está cifrada.
proxytype	Cadena	SYSTEM	El tipo de proxy que se va a utilizar. Los valores válidos son: HTTPS, HTTP, SOCKS5|SOCKS, SYSTEM o NONE|DIRECT. Si especifica SYSTEM, se utilizará la configuración del proxy del equipo.
proxyhost	Cadena		La dirección del servidor proxy que se utilizará si se conecta a través de un servidor proxy.
proxyport	Entero		El puerto que se utilizará si se conecta a través de un servidor proxy.
proxyuser	Cadena		Nombre de usuario que se utilizará para la autenticación del proxy.
proxypassword	Cadena		La contraseña que se utilizará para la autenticación del proxy. La contraseña no está cifrada.
transporte	Cadena	auto	Protocolo que se va a utilizar para el transporte de datos. Con auto el cliente, primero intenta conectarse mediante el protocolo QUIC (UDP). Si se produce un error en la QUIC conexión, el transporte vuelve automáticamente awebsocket. Especifique websocket el uso del protocolo WebSocket (TCP) para el transporte de datos o especifique quic el uso del protocolo QUIC (UDP) para el transporte de datos. Si lo habilitaQUIC, el QUIC protocolo se utiliza para el transporte de datos y WebSocket para el tráfico de autenticación. Si lo habilita WebSocket, el WebSocket protocolo se utiliza tanto para el transporte de datos como para el tráfico de autenticación.
webport	Entero	8443	El puerto que se va a usar para el tráfico WebSocket (TCP).
quicport	Entero	8443	El puerto que se va a usar para el tráfico QUIC (UDP).
certificatevalidationpolicy	Cadena	ask-user	Política para validar un certificado que no es de confianza. Los valores incluyen strict, accept-untrusted, y ask-user.

Parámetros [options]

En la siguiente tabla se incluyen los parámetros que se pueden especificar en el grupo [options].

Parámetro	Tipo	Valor predeterminado	Descripción
fullscreen	Booleano	false	Indica si el cliente se inicia en modo de pantalla completa.
useallmonitors	Booleano	false	Indica si el cliente utiliza todos los monitores al iniciar el modo de pantalla completa.
promptreconnect	Booleano	true	Indica si el cliente le solicita que vuelva a conectarse después de desconectarse de una sesión. Si el parámetro se establece en true, se le redirigirá a la pantalla de inicio de sesión cuando se desconecte. Si el parámetro está establecido en false, el cliente se cierra cuando se desconecta.
enableyuv444decoding	Booleano	false	Indica si se debe habilitar la alta precisión de color (YUV4:4:4) al codificar contenido de vídeo dinámico.

Ejecutar el archivo de conexión

Para ejecutar un archivo de conexión de .dcv, desplácese hasta el archivo y haga doble clic en él.

O bien, especifique la ruta del archivo como argumento para el comando dcvviewer.

• Cliente de Windows

  C:\> dcvviewer.exe path\connection_file_name.dcv

• Cliente de Linux y macOS

  $ dcvviewer path/connection_file_name.dcv