Você pode usar identificadores uniformes de recursos (URIs) para criar links de página da Web ou de e-mail nos quais os usuários finais podem clicar para iniciar o Horizon Client, conectar-se a um servidor ou abrir uma área de trabalho remota ou um aplicativo publicado.

Você cria esses links construindo URIs que fornecem algumas ou todas as informações a seguir para que os usuários finais não precisem fornecê-las.

  • Endereço do servidor
  • Número da porta do servidor
  • Active Directory nome de usuário
  • nome de usuário RADIUS ou RSA SecurID, se diferente do nome de usuário Active Directory
  • Nome de domínio
  • Área de trabalho remota ou nome de exibição do aplicativo publicado
  • Tamanho da janela
  • Ações, incluindo redefinir, fazer logout e iniciar sessão
    • Exibir protocolo
  • Opções para redirecionar dispositivos USB

Para construir um URI, use o esquema de URI vmware-view com Horizon Client partes de caminho e consulta específicas.

Para usar URIs para iniciar o Horizon Client, o Horizon Client já deve estar instalado nos computadores clientes.

Sintaxe para criar URIs do vmware-view

A sintaxe do URI inclui o esquema de URI vmware-view, uma parte do caminho para especificar a área de trabalho remota ou o aplicativo publicado e, opcionalmente, uma consulta para especificar as ações ou opções de configuração da área de trabalho remota ou do aplicativo publicado.

Especificação de URI

Use a seguinte sintaxe para criar URIs para iniciar Horizon Client.

vmware-view://[authority-part][/path-part][?query-part]

O único elemento necessário é o esquema de URI, vmware-view. Como o nome do esquema faz distinção entre maiúsculas e minúsculas para algumas versões de alguns sistemas operacionais cliente, digite vmware-view.

Importante: Em todas as partes, os caracteres não ASCII devem primeiro ser codificados de acordo com UTF-8 [STD63] e, em seguida, cada octeto da sequência UTF-8 correspondente deve ser codificado por porcentagem para ser representado como caracteres URI.

Para obter informações sobre a codificação de caracteres ASCII, consulte a referência de codificação de URL em http://www.utf8-chartable.de/.

authority-part
O endereço do servidor e, opcionalmente, um nome de usuário, um número de porta não padrão ou ambos. Não há suporte para sublinhados (_) em nomes de servidor. Os nomes de servidor devem estar em conformidade com a sintaxe do DNS.

Para especificar um nome de usuário, use a seguinte sintaxe.

user1@server-address

Você não pode especificar um endereço UPN, que inclui o domínio. Para especificar o domínio, você pode usar a parte de consulta domainName no URI.

Para especificar um número de porta, use a seguinte sintaxe.

server-address:port-number
path-part
O nome para exibição da área de trabalho remota ou do aplicativo publicado. O nome para exibição é especificado em Horizon Console quando o pool de áreas de trabalho ou o pool de aplicativos é criado. Se o nome para exibição contiver um espaço, use o mecanismo de codificação %20 para representar o espaço.
Como alternativa, você pode especificar uma ID de área de trabalho ou aplicativo, que é uma cadeia de caracteres de caminho que inclui a ID da área de trabalho ou do pool de aplicativos. Para encontrar uma ID de área de trabalho ou de aplicativo, abra o ADSI Edit no host do Servidor de Conexão, navegue até DC=vdi,dc=vmware,dc=int e selecione o nó OU=Applications . Todos os pools de desktops e aplicativos são listados. O atributo distinguishedName especifica o valor do ID. Você deve codificar o valor da ID antes de especificá-lo em um URI, por exemplo, cn%3Dwin7-32%2Cou%3Dapplications%2Cdc%3Dvdi%2Cdc%3Dvmware%2Cdc%3Dint.
Se você especificar uma ID de área de trabalho ou de aplicativo, deverá usar apenas letras minúsculas, mesmo se a ID de área de trabalho ou de aplicativo contiver letras maiúsculas no ADSI Edit.
Observação: Mais de uma área de trabalho remota ou aplicativo publicado pode ter o mesmo nome de exibição, mas a ID da área de trabalho e do aplicativo é exclusiva. Para especificar uma determinada área de trabalho remota ou aplicativo publicado, use a ID da área de trabalho ou do aplicativo em vez do nome para exibição.
query-part
As opções de configuração a serem usadas ou as ações da área de trabalho remota ou do aplicativo publicado a serem executadas. As consultas não diferenciam maiúsculas de minúsculas. Para usar várias consultas, use um e comercial (&) entre as consultas. Se as consultas entrarem em conflito, Horizon Client usará a última consulta na lista. Use a seguinte sintaxe.
query1=value1[&query2=value2...]

Consultas compatíveis

As consultas a seguir são compatíveis com esse tipo de Horizon Client. Se você estiver criando URIs para vários tipos de clientes, como clientes de desktop e clientes móveis, consulte o documento de guia para cada tipo de sistema de cliente para obter a lista de consultas com suporte.

ação
Tabela 1. Valores que podem ser usados com a ação Consultar
Valor Descrição
browse Exibe uma lista de áreas de trabalho remotas disponíveis e aplicativos publicados hospedados no servidor especificado. Você não é obrigado a especificar uma área de trabalho remota ou um aplicativo publicado ao usar esta ação.
start-session Abre a área de trabalho remota ou o aplicativo publicado especificado. Se nenhuma consulta de ação for fornecida e o nome da área de trabalho remota ou do aplicativo publicado for fornecido, start-session será a ação padrão.
reset Desliga e reinicia a área de trabalho remota ou o aplicativo publicado especificado. Os dados não salvos são perdidos. Redefinir uma área de trabalho remota é o mesmo que pressionar o botão Redefinir em um PC físico.
restart Desliga e reinicia a área de trabalho remota especificada. Reiniciar uma área de trabalho remota é o mesmo que o comando de reinicialização do sistema operacional Windows. O sistema operacional geralmente solicita que o usuário salve os dados não salvos antes de ser reiniciado.
logoff Desconecta o usuário do sistema operacional convidado na área de trabalho remota. Se você especificar um aplicativo publicado, a ação será ignorada ou o usuário final verá a mensagem de aviso "Ação de URI inválida".
argumentos
Especifica os argumentos de linha de comando a serem adicionados quando o aplicativo publicado é iniciado. Use a sintaxe args= value, em que value é uma string. Use a codificação de porcentagem para os seguintes caracteres:
  • Para dois-pontos (:), use %3A
  • Para uma barra invertida (\), use %5C
  • Para um espaço ( ), use %20
  • Para aspas duplas ("), use %22

Por exemplo, para especificar o nome de arquivo "Meu novo arquivo.txt" para o aplicativo Notepad++, use %22My%20new%20file.txt%22.

appProtocol
Para aplicativos publicados, os valores válidos são PCOIP e BLAST. Por exemplo, para especificar PCoIP, use a sintaxe appProtocol=PCOIP.
connectUSBOnInsert
Conecta um dispositivo USB à área de trabalho remota em primeiro plano ou ao aplicativo publicado quando você conecta o dispositivo. Essa consulta será definida implicitamente se você especificar a consulta unattended para uma área de trabalho remota. Para usar essa consulta, você deve definir a consulta action como start-session ou não terá uma consulta action. Os valores válidos são true e false. Um exemplo da sintaxe é connectUSBOnInsert=true.
connectUSBOnStartup
Redireciona todos os dispositivos USB que estão conectados no momento ao sistema cliente para a área de trabalho remota ou o aplicativo publicado. Essa consulta será definida implicitamente se você especificar a consulta unattended para uma área de trabalho remota. Para usar essa consulta, você deve definir a consulta action como start-session ou não terá uma consulta action. Os valores válidos são true e false. Um exemplo da sintaxe é connectUSBOnStartup=true.
desktopLayout
Define o tamanho da janela da área de trabalho remota. Para usar essa consulta, você deve definir a consulta action como start-session ou não ter uma consulta action.
Tabela 2. Valores válidos para a consulta desktopLayout
Valor Descrição
fullscreen Tela cheia em um monitor. Esse valor é o padrão.
multimonitor Tela cheia em todos os monitores.
windowLarge Grande janela.
windowSmall Janela pequena.
WxH Resolução personalizada, em que você especifica a largura por altura, em pixels. Um exemplo da sintaxe é desktopLayout=1280x800.
desktopProtocol
Para áreas de trabalho remotas, os valores válidos são RDP, PCOIP e BLAST. Por exemplo, para especificar PCoIP, use a sintaxe desktopProtocol=PCOIP.
domainName
Especifica o nome de domínio NETBIOS associado ao usuário que está se conectando à área de trabalho remota ou ao aplicativo publicado. Por exemplo, você pode usar mycompany em vez de mycompany.com.
filePath
Especifica o caminho para o arquivo no sistema local que você deseja abrir com o aplicativo publicado. Você deve especificar o caminho completo, incluindo a letra da unidade. Use a codificação de porcentagem para os seguintes caracteres:
  • Para dois-pontos (:), use %3A
  • Para uma barra invertida (\), use %5C
  • Para um espaço ( ), use %20

Por exemplo, para representar o caminho do arquivo C:\test file.txt, use C%3A%5Ctest%20file.txt.

launchMinimized
Inicia Horizon Client no modo minimizado. Horizon Client permanece minimizado até que a área de trabalho remota ou o aplicativo publicado especificado seja iniciado. A sintaxe é launchMinimized=true. Você não pode usar essa consulta com a consulta autônoma (unattended).
tokenUserName
Especifica o nome de usuário RSA ou RADIUS. Use essa consulta somente se o nome de usuário RSA ou RADIUS for diferente do nome de usuário Active Directory. Se você não especificar essa consulta e a autenticação RSA ou RADIUS for necessária, Horizon Client usará o nome de usuário Windows. A sintaxe é tokenUserName=name.
autônomo
Cria uma conexão de servidor com uma área de trabalho remota no modo de quiosque. Se você usar essa consulta, não especifique as informações do usuário se tiver gerado o nome da conta do endereço MAC do dispositivo do cliente. Se você tiver criado nomes de conta personalizados no ADAM, como nomes que começam com "personalizado-", deverá especificar as informações da conta.
useExistente
Se essa opção for definida como true, apenas uma instância Horizon Client poderá ser executada. Se os usuários tentarem se conectar a um segundo servidor, eles deverão fazer logout do primeiro servidor, fazendo com que as sessões de área de trabalho remota e de aplicativo publicado sejam desconectadas. Se essa opção for definida como false, várias instâncias de Horizon Client poderão ser executadas e os usuários poderão se conectar a vários servidores ao mesmo tempo. O padrão é true. Um exemplo da sintaxe é useExisting=false.
unauhenticatedAccessEnabled
Se essa opção estiver definida como true, o recurso Acesso não autenticado será ativado por padrão. A opção Acesso não autenticado (Unauthenticated Access) fica visível na interface do usuário e está selecionada. Se essa opção for definida como false, o recurso Acesso não autenticado será desativado. A configuração Acesso não autenticado (Unauthenticated Access) está oculta e desativada. Quando essa opção é definida como "", o recurso Acesso não autenticado é desativado e a configuração Acesso não autenticado (Unauthenticated Access) é ocultada da interface do usuário e desativada. Um exemplo da sintaxe é unauthenticatedAccessEnabled=true.
não autenticadoAccessAccount
Se o recurso Acesso não autenticado estiver ativado, define a conta a ser usada. Se o Acesso não autenticado estiver desativado, essa consulta será ignorada. Um exemplo de sintaxe usando a conta de usuário anonymous1 é unauthenticatedAccessAccount=anonymous1.

Exemplos de URIs do vmware-view

Você pode usar o esquema de URI vmware-view para criar links ou botões de hipertexto e incluir esses links no e-mail ou em uma página Web. Por exemplo, um usuário final pode clicar em um link de URI para iniciar uma área de trabalho remota com as opções de inicialização que você especificar.

Cada exemplo de URI é seguido por uma descrição do que o usuário final vê depois de clicar no link do URI.

  1. vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session

    Horizon Client inicia e se conecta ao servidor view.mycompany.com. A caixa de diálogo de logon solicita ao usuário um nome de usuário, um nome de domínio e uma senha. Após um login bem-sucedido, o cliente se conecta à área de trabalho remota que tem o nome de exibição Área de Trabalho Primária, e o usuário é conectado ao sistema operacional convidado.

    Observação: Neste exemplo, o protocolo de exibição padrão e o tamanho da janela são usados. O protocolo de exibição padrão é PCoIP e o tamanho padrão da janela é tela cheia.
  2. vmware-view://view.mycompany.com/cn%3Dwin7-32%2Cou%3Dapplications%2Cdc%3Dvdi%2Cdc%3Dvmware%2Cdc%3Dint

    Horizon Client inicia e se conecta ao servidor view.mycompany.com. A caixa de diálogo de logon solicita ao usuário um nome de usuário, um nome de domínio e uma senha. Após um login bem-sucedido, o cliente se conecta à área de trabalho remota que tem a ID de área de trabalho CN=win7-32,OU=Applications,DC=vdi,DC=vmware,DC=int (valor codificado cn%3Dwin7-32%2Cou%3Dapplications%2Cdc%3Dvdi%2Cdc%3Dvmware%2Cdc%3Dint).

  3. vmware-view://view.mycompany.com:7555/Primary%20Desktop

    Esse URI tem o mesmo efeito que o exemplo anterior, exceto que ele usa a porta não padrão de 7555 para a instância do Servidor de Conexão. (A porta padrão é 443.) Como um identificador de área de trabalho remota é fornecido, a área de trabalho remota é aberta, mesmo que a ação start-session não esteja incluída no URI.

  4. vmware-view://fred@view.mycompany.com/Finance%20Desktop?desktopProtocol=PCOIP

    Horizon Client inicia e se conecta ao servidor view.mycompany.com. Na caixa de diálogo de login, a caixa de texto Nome de usuário (User name) é preenchida com fred. O usuário deve fornecer o nome de domínio e a senha. Após um login bem-sucedido, o cliente se conecta à área de trabalho remota que tem o nome de exibição Finance Desktop, e o usuário é conectado ao sistema operacional convidado. A conexão usa o protocolo de exibição PCoIP.

  5. vmware-view://view.mycompany.com/Calculator?action=start-session&appProtocol=BLAST

    Horizon Client inicia e se conecta ao servidor view.mycompany.com. Na caixa de diálogo de logon, o usuário deve fornecer o nome de usuário, o nome de domínio e a senha. Após um login bem-sucedido, o cliente se conecta ao aplicativo publicado que tem o nome de exibição Calculadora. A conexão usa o protocolo de exibição VMware Blast.

  6. vmware-view://fred@view.mycompany.com/Finance%20Desktop?domainName=mycompany

    Horizon Client inicia e se conecta ao servidor view.mycompany.com. Na caixa de diálogo de login, a caixa de texto Nome de usuário (User name) é preenchida com fred, e a caixa de texto Domínio (Domain) é preenchida com minha empresa. O usuário deve fornecer apenas uma senha. Após um login bem-sucedido, o cliente se conecta à área de trabalho remota que tem o nome de exibição Finance Desktop, e o usuário é conectado ao sistema operacional convidado.

  7. vmware-view://view.mycompany.com/

    Horizon Client é iniciado e o usuário é levado ao prompt de login para se conectar ao servidor view.mycompany.com.

  8. vmware-view://view.mycompany.com/Primary%20Desktop?action=reset

    Horizon Client inicia e se conecta ao servidor view.mycompany.com. A caixa de diálogo de logon solicita ao usuário um nome de usuário, um nome de domínio e uma senha. Após um login bem-sucedido, Horizon Client redefine a área de trabalho especificada.

    Observação: Essa ação estará disponível somente se um administrador tiver ativado o recurso de redefinição para a área de trabalho remota.
  9. vmware-view://view.mycompany.com/Primary%20Desktop?action=restart

    Horizon Client inicia e se conecta ao servidor view.mycompany.com. A caixa de diálogo de logon solicita ao usuário um nome de usuário, um nome de domínio e uma senha. Após um login bem-sucedido, Horizon Client reinicia a área de trabalho especificada.

    Observação: Essa ação estará disponível somente se um administrador tiver ativado o recurso de reinicialização para a área de trabalho remota.
  10. vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session&connectUSBOnStartup=true
    Esse URI tem o mesmo efeito que o primeiro exemplo, e todos os dispositivos USB conectados ao sistema do cliente são redirecionados para a área de trabalho remota.
  11. vmware-view://

    Se Horizon Client não estiver em execução, ele será iniciado. Se Horizon Client já estiver em execução, ele será exibido em primeiro plano.

  12. vmware-view://10.10.10.10/My%20Notepad++?args=%22My%20new%20file.txt%22

    Inicia o My Notepad++ no servidor 10.10.10.10 e passa o argumento Meu novo arquivo.txt no comando de início do aplicativo publicado. Espaços e aspas duplas usam o escape de porcentagem. O nome do arquivo está entre aspas porque contém espaços.

    Você também pode digitar esse comando no prompt de linha de comando Windows usando a seguinte sintaxe:
    vmware-view.exe --serverURL 10.10.10.10 --appName "My Notepad++" --args "\"my new.txt\""
    Neste exemplo, as aspas duplas são escapadas usando os caracteres \".
  13. vmware-view://10.10.10.10/Notepad++%2012?args=a.txt%20b.txt

    Inicia o Notepad++ 12 no servidor 10.10.10.10 e passa o argumento a.text b.txt no comando de início do aplicativo publicado. Como o argumento não está entre aspas, um espaço separa os nomes dos arquivos e os dois arquivos são abertos separadamente no Notepad++.

    Observação: Os aplicativos publicados podem diferir na maneira como usam argumentos de linha de comando. Por exemplo, se você passar o argumento a.txt b.txt para o WordPad, o WordPad abrirá apenas um arquivo, a.txt.
  14. vmware-view://view.mycompany.com/Notepad?unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous1

    Horizon Client inicia e se conecta ao servidor view.mycompany.com usando a conta de usuário anonymous1. O aplicativo Bloco de Notas é iniciado sem solicitar que o usuário forneça as credenciais de login.

Exemplos de código HTML

Você pode usar URIs para criar links de hipertexto e botões para incluir em e-mails ou em páginas Web. Os exemplos a seguir mostram como usar o URI do primeiro exemplo de URI para codificar o link de hipertexto rotulado Test Link e um botão rotulado 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>