Etapa 4: criar um arquivo de conexão (opcional) - Amazon DCV
Criar um arquivo de conexãoParâmetros compatíveisExecutar o arquivo de conexão

Etapa 4: criar um arquivo de conexão (opcional)

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 do Amazon 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 do Amazon 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 Amazon 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.

[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
formato 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 Amazon DCV que hospeda a sessão.
porta Inteiro 8443 A porta a ser usada ao se conectar ao servidor Amazon DCV.
weburlpath String Um caminho personalizado no servidor Amazon 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 do Amazon 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 Amazon DCV.
password String A senha a ser usada ao se conectar ao servidor Amazon 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 auto

O protocolo a ser usado para o transporte de dados. Com auto, o cliente primeiro tenta se conectar usando o protocolo QUIC (UDP). Se a conexão QUIC falhar, o transporte retorna automaticamente para websocket.

Especifique websocket para usar o protocolo WebSocket (TCP) para o transporte de dados ou quic para o protocolo QUIC (UDP). Se você habilitar o QUIC, o protocolo QUIC será usado para transporte de dados e o WebSocket para tráfego de autenticação. Se você habilitar o WebSocket, o protocolo WebSocket será usado para transporte de dados e 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 Booleano false Indica se o cliente inicia no modo de tela cheia.
useallmonitors Booleano 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