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.
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.
- 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 área de trabalho e clientes móveis, consulte o guia de instalação e configuração para cada tipo de sistema do 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 for 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.
-
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. -
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).
-
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.
-
vmware-view://[email protected]/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.
-
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.
-
vmware-view://[email protected]/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.
-
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.
-
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 do Horizon tiver ativado o recurso de redefinição para a área de trabalho remota. -
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 do Horizon tiver ativado o recurso de reinicialização para a área de trabalho remota. -
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. -
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.
-
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 \". -
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. -
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>
