Extensão para Amazon WorkSpaces

Instalação da extensão

A Extensão UiPath permite que você automatize desktops virtuais do Amazon WorkSpaces de forma nativa. A extensão pode ser instalada a partir do UiPath Studio ou do prompt de comando.

Pré-requisitos

Antes de instalar a extensão, certifique-se de instalar o cliente Amazon WorkSpaces.

Você pode optar por instalar a extensão para o usuário atual ou para todos os usuários. Os tipos de instalação devem corresponder, ou seja, o tipo de instalação da extensão deve corresponder ao tipo de instalação do cliente do Amazon WorkSpaces. Se os tipos de instalações não corresponderem, a instalação da extensão falhará.

Observação:

O Amazon WorkSpaces pode ser configurado com o protocolo PCoIP (PC sobre IP) ou o protocolo DCV (Desktop Cloud Visualization).

• A automação do Amazon WorkSpaces usando o PCoIP requer UiPath.UIAutomation.Activities, UiPath Studio e UiPath Remote Runtime v24.10 ou superior.

• A automação do Amazon WorkSpaces usando o DCV requer UiPath.UIAutomation.Activities, UiPath Studio e UiPath Remote Runtime v25.2 ou superior.

Configuração da extensão para DCV

Os Amazon WorkSpaces que usam o protocolo DCV exigem que as extensões DCV sejam habilitadas. Como o suporte para extensões WorkSpaces é desabilitado por padrão, você deve definir a configuração Configurar extensões para Servidor e cliente – Habilitar extensões para o servidor e o cliente.

Para configurar a extensão para uma política de grupo de DCV, consulte Gerenciar configurações de política de grupo para DCV na documentação do Amazon WorkSpace.

Depois de habilitar a política de grupo, as seguintes chaves de registro do Windows são gravadas:

Windows Registry Editor Version 5.00  

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon\WSP] "hc_toggle_extensions"=dword:00000001 "hc_toggle_extension_options"=dword:00000000

Você também pode configurar extensões a partir de um arquivo de permissões, fazendo referência aos seguintes recursos:

• extensions-client - Permite que você inicie as extensões instaladas no cliente Amazon DCV.

• extensions-server - Permite que você inicie as extensões instaladas no servidor Amazon DCV.

Para obter mais informações, consulte Adição de permissões na documentação do Amazon DCV.

A partir do UiPath Studio

1. Abra o UiPath Studio.
2. Navegue até Exibição Backstage > Ferramentas > Extensões UiPath.
3. No Amazon WorkSpaces, selecione o tipo de instalação preferido no menu suspenso:
   • Todos os usuários devem instalar a extensão para todos os usuários desta máquina. Para esse tipo de instalação, você deve ter privilégios de Administrador locais, e o cliente Amazon WorkSpaces precisa ser instalado para todos os usuários.
   • Usuário atual para instalar a extensão para o usuário atual. Para esse tipo de instalação, você não precisa de privilégios de Administrador locais, mas o cliente Amazon WorkSpaces precisa ser instalado por usuário.
4. Selecione Instalar. Uma caixa de diálogo de confirmação é exibida.
5. Reinicie seu cliente do Amazon WorkSpaces para que as alterações entrem em vigor.
6. A Extensão UiPath para Amazon WorkSpaces agora está instalada e está localizada em C:\Program Files (x86)\Common Files\UiPath\UiPath.Common\.

A partir do Prompt de Comando

1. Selecione o botão Iniciação do Windows e digite cmd no campo de pesquisa.
2. Clique com o botão direito do mouse no Prompt de Comando e execute-o como administrador.
3. Altere o diretório para a pasta de instalação UiPath:
   • cd C:\Program Files\UiPath\Studio\UiPath para instalações do Studio por máquina.
   • cd %localappdata%\Programs\UiPath\Studio\UiPath para instalações do Studio por usuário.
4. Use o comando SetupExtensions.exe /amazon-workspaces-client para instalar a extensão por usuário ou SetupExtensions.exe /amazon-workspaces-client-global para instalá-la por máquina (para todos os usuários). Uma caixa de diálogo de confirmação é exibida.
5. Reinicie seu cliente do Amazon WorkSpaces para que as alterações entrem em vigor.
6. A Extensão UiPath para Amazon WorkSpaces agora está instalada.

To generate native selectors for Amazon WorkSpaces technologies, you also need to deploy the UiPath Remote Runtime component on all your Amazon WorkSpaces virtual desktops, as explained on UiPath Remote Runtime.

O instalador UiPathRemoteRuntime.msi pode ser baixado em:

• Downloads de produtos no UiPath Customer Portal.
• Central de Recursos na UiPath Automation Cloud. Para acessar o Resource Center, faça login em sua Organização do Automation Cloud, clique no botão Ajuda na barra de navegação e escolha a opção Downloads.

Desinstalação da extensão

A partir do UiPath Studio

1. Feche seu cliente em execução do Amazon WorkSpaces.
2. Abra o UiPath Studio.
3. Navegue até Exibição Backstage > Ferramentas > Extensões UiPath.
4. Selecione Amazon WorkSpaces > Desinstalar e confirme sua escolha.

A extensão é desinstalada para o tipo de instalação selecionado (Todos os usuários ou Usuário Atual).

A partir do Prompt de Comando

1. Feche todos os seus desktops virtuais em execução do Amazon WorkSpaces.
2. Selecione o botão Iniciação do Windows e digite cmd no campo de pesquisa.
3. Clique com o botão direito do mouse no Prompt de Comando e execute-o como administrador.
4. Altere o diretório para a pasta de instalação UiPath:
   • cd C:\Program Files\UiPath\Studio\UiPath para instalações do Studio por máquina.
   • cd %localappdata%\Programs\UiPath\Studio\UiPath para instalações do Studio por usuário.
5. Use o comando SetupExtensions.exe /amazon-workspaces-client /uninstall para desinstalar a extensão para o usuário atual ou SetupExtensions.exe /amazon-workspaces-client-global /uninstall para desinstalá-la para todos os usuários (por máquina). Uma caixa de diálogo de confirmação é exibida.

A Extensão UiPath para Amazon WorkSpaces é desinstalada.