Usar um arquivo de conexão

Usando clientes nativos Windows, Linux e macOS, você pode criar um arquivo de conexão que é possível usar para se conectar instantaneamente a uma sessão NICE DCV.

Criar um arquivo de conexão

O arquivo de conexão é um arquivo baseado em texto com uma extensão de arquivo .dcv. O formato do arquivo .dcv é semelhante ao de um arquivo .ini. O arquivo inclui [groups] seguido pelos parâmetros e os respectivos valores. Os grupos e parâmetros têm o seguinte formato:

[group_name]
parameter_name=parameter_value
    

Por exemplo: .

[options]
fullscreen=true
    

É possível criar um arquivo de conexão para uma sessão NICE DCV específica direto do cliente. Outra opção é criar do zero um arquivo de conexão em um editor de texto.

nota

O procedimento para criar um arquivo de conexão do zero usando um editor de texto é o mesmo para os clientes Windows, Linux e macOS.

Criar um arquivo de conexão do cliente

1. Abra o cliente.

2. Conecte-se ao servidor e à sessão em que você está criando o arquivo.

3. Selecione o nome do host do servidor NICE DCV no canto superior direito e escolha Salvar conexão como.

4. Na janela Salvar como, insira um nome de arquivo e uma pasta de destino e escolha Salvar.

Por padrão, quando você cria um arquivo de conexão, o arquivo inclui os parâmetros format, host, port, user e proxytype. Esses parâmetros são necessários para se conectar à sessão a partir da qual o arquivo foi criado. É possível personalizar ou adicionar parâmetros manualmente a qualquer momento editando o arquivo com um editor de texto.

Como criar um arquivo de conexão do zero usando um editor de texto

1. Crie um arquivo .dcv com o seguinte formato de nome de arquivo: file_name.dcv

2. Abra o arquivo .dcv usando o editor de texto de sua preferência.

3. Adicione o grupo [version] e o parâmetro format à parte superior do arquivo no seguinte formato:

   [version]
   format=1.0

   Importante

   Se o arquivo .dcv não incluir o grupo [version] e o parâmetro format, a análise não funcionará.

4. Adicione os grupos de parâmetros necessários usando o seguinte formato:

   [group_name]

   Para obter mais informações sobre os grupos de parâmetros, consulte Parâmetros compatíveis.

5. Adicione os parâmetros e valores de parâmetros após os grupos usando o seguinte formato:

   parameter_name=parameter_value

   nota

   • Nomes dos parâmetros diferenciam maiúsculas de minúsculas.

   • Não coloque os valores de parâmetro de string entre aspas.

   Para obter mais informações sobre os parâmetros e valores de parâmetros, consulte Parâmetros compatíveis.

6. Salve as alterações e feche o arquivo .dcv.

Também é possível usar esse procedimento para adicionar parâmetros adicionais a um arquivo de conexão existente a qualquer momento.

Parâmetros compatíveis

Atualmente, o arquivo .dcv é compatível com parâmetros em três grupos de parâmetros — [version], [connect] e [options]. As tabelas a seguir listam os grupos e seus parâmetros disponíveis.

Grupos

• [version] parameters
• [connect] parameters
• [options] parameters

[version] parameters

Importante

Este é um grupo obrigatório. Se o arquivo .dcv não incluir esse grupo, a análise não funcionará.

A tabela a seguir lista os parâmetros que podem ser especificados no grupo [version].

Parâmetro	Tipo	Valor padrão	Descrição
format	string		Importante Este é um parâmetro obrigatório. O valor do parâmetro deve ser 1.0. Se o arquivo .dcv não incluir esse parâmetro, a análise não funcionará.

[connect] parameters

A tabela a seguir lista os parâmetros que podem ser especificados no grupo [connect].

Parâmetro	Tipo	Valor padrão	Descrição
host	String		O nome do host do servidor NICE DCV que hospeda a sessão.
porta	Inteiro	8443	A porta a ser usada ao se conectar ao servidor NICE DCV.
weburlpath	String		Um caminho personalizado no servidor NICE DCV para a conexão. Por exemplo, se você especificar customPath, o cliente tentará se conectar a host:port/customPath.
sessionid	String		O ID da sessão NICE DCV à qual se conectar.
authtoken	String		O token de autenticação a ser usado para a conexão. Se você especificar um authtoken, também deverá especificar um sessionid. Ao usar o authtoken, é possível omitir os parâmetros de password e user.
usuário	String		O nome de usuário a ser usado ao se conectar ao servidor NICE DCV.
password	String		A senha a ser usada ao se conectar ao servidor NICE DCV. A senha não está criptografada.
proxytype	String	SYSTEM	O tipo de proxy a ser usado. Os valores válidos incluem HTTPS, HTTP, SOCKS5|SOCKS, SYSTEM ou NONE|DIRECT. Se você especificar SYSTEM, as configurações de proxy do computador serão usadas.
proxyhost	String		O endereço do servidor de proxy a ser usado se estiver se conectando por meio de um servidor de proxy.
proxyport	Inteiro		A porta a ser usada se estiver se conectando por meio de um servidor de proxy.
proxyuser	String		O nome de usuário a ser usado para a autenticação de proxy.
proxypassword	String		A senha a ser usada para autenticação de proxy. A senha não está criptografada.
transport	String	websocket	O protocolo a ser usado para o transporte de dados. Especifique websocket o uso do protocolo WebSocket (TCP) para transporte de dados ou especifique quic o uso do protocolo QUIC (UDP) para transporte de dados. Se você habilitar o QUIC, o protocolo QUIC será usado para transporte de dados e WebSocket para tráfego de autenticação. Se você habilitar WebSocket, o WebSocket protocolo será usado tanto para transporte de dados quanto para tráfego de autenticação.
webport	Inteiro	8443	A porta a ser usada para tráfego WebSocket (TCP).
quicport	Inteiro	8443	A porta a ser usada para tráfego QUIC (UDP).
certificatevalidationpolicy	String	ask-user	A política para validar um certificado não confiável. Os valores incluem strict, accept-untrusted e ask-user.

[options] parameters

A tabela a seguir lista os parâmetros que podem ser especificados no grupo [options].

Parâmetro	Tipo	Valor padrão	Descrição
fullscreen	Booliano	false	Indica se o cliente inicia no modo de tela cheia.
useallmonitors	Booliano	false	Indica se o cliente usa todos os monitores ao iniciar o modo de tela cheia.
promptreconnect	Booleano	true	Indica se o cliente solicita que você se reconecte depois que se desconectar de uma sessão. Se o parâmetro estiver definido como true, você será redirecionado para a tela de entrada quando se desconectar. Se o parâmetro estiver definido como false, o cliente será encerrado quando você se desconectar.
enableyuv444decoding	Booleano	false	Indica se a Alta precisão de cores (YUV 4:4:4) será habilitada na codificação de conteúdo de vídeo dinâmico.

Executar o arquivo de conexão

Para executar um arquivo de conexão .dcv, navegue até o arquivo e clique duas vezes nele.

Ou especifique o caminho do arquivo como um argumento para o comando dcvviewer.

• Cliente Windows

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

• Cliente Linux e macOS

  $ dcvviewer path/connection_file_name.dcv