> For the complete documentation index, see [llms.txt](https://docs.plenit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plenit.com/docs-pt/productos/remote-desktop/how-to/how-to-install-and-publish-an-application.md).

# Como Instalar e Publicar uma Aplicação em Desktop Remoto

Instala uma aplicação no servidor do ambiente, publica-a no painel com os seus caminhos e atribui acesso aos utilizadores que a devem usar.

Publicar uma aplicação em Desktop Remoto tem dois lados: instalá-la no servidor que serve as sessões e registá-la no Painel de administração para que os teus utilizadores a vejam e a abram.

O ambiente traz um Marketplace com aplicações de instalação automatizada, mas quando precisas de um programa que não está nessa lista, instalas tu manualmente por RDP.

Este guia cobre o percurso completo, com foco na instalação manual, e termina atribuindo o acesso. Como exemplo usa-se GVim, mas o fluxo é o mesmo para qualquer aplicação.

> #### 👍 O que consegues
>
> Uma aplicação instalada no servidor, publicada no ambiente com os seus caminhos corretos e atribuída aos utilizadores que a devem utilizar.

### Antes de começar

* Aceder ao Painel de administração em [admin.plenit.com](https://admin.plenit.com) com Permissões sobre o ambiente.
* Ter uma Subscrição de Desktop Remoto ativa. Se ainda não a tiveres, configura-a com o [Início Rápido de Desktop Remoto.](https://docs.plenit.com/docs-pt/productos/remote-desktop/quickstart.md)
* Ter copiado para o servidor o instalador da aplicação, se vais instalá-la manualmente.
* Usar um utilizador com privilégios de administração sobre o servidor e acesso por desktop remoto.

### Passo 1. Abre a criação da aplicação

Em [admin.plenit.com](https://admin.plenit.com), vai a **Cloud Services → Desktop Remoto** e entra na Subscrição do ambiente. Abre o separador **Applications**, onde vês as aplicações já provisionadas, com o seu nome, categoria, tipo de instalação, utilizadores com acesso e o menu de ações **(…)**.

No canto superior direito, clica em **Nova Aplicação**. Abre-se o catálogo de aplicações: para dar de alta uma que vais instalar tu, clica em **Publicar nova aplicação**.

![Secção Applications e criação de uma nova aplicação](https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fg1NZrElWiAqHd0erWWFQ%2Fescritorio-remoto-instalar-app-01.png?alt=media\&token=368027c3-d162-455f-b20e-b0c1bd8b1f49)

> #### 📘 Marketplace ou instalação manual
>
> Se a aplicação aparecer nesse catálogo, seleciona-a e usa a instalação automatizada.
>
> O resto deste guia cobre o caso contrário: um programa que não aparece ali e tens de instalar tu por RDP.

### Passo 2. Liga-te ao servidor por RDP e instala

Se a aplicação ainda não estiver no servidor, liga-te por RDP para a instalar. Usa o teu cliente RDP habitual ou o botão **Ligação RDP**, que abre uma interface web: Iniciar sessão no Portal do utilizador quando te for pedido, descarrega o Ficheiro `.rdp` e executa-o, e introduz novamente a Palavra-passe para concluir a ligação.

Já no ambiente de trabalho do servidor, executa o instalador do programa com um utilizador com privilégios de administração e conclui a instalação como em qualquer Windows. Verifica que ficou instalado antes de voltares ao painel.

![Ligação RDP ao servidor para instalar a aplicação](https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FsAK5rOoJdZ54Rradf0cF%2Fescritorio-remoto-instalar-app-02.png?alt=media\&token=fb91957a-fd64-43c8-b442-bde3c7775468)

> #### 🚧 Se a ligação RDP não se completar
>
> Volta a Iniciar sessão no Portal do utilizador, descarrega novamente o Ficheiro `.rdp` e executa-o. Introduz a Palavra-passe apenas quando o portal ou a janela de ligação a pedirem.

> #### 📘 A instalação do software depende de cada aplicação
>
> Este guia não detalha a instalação interna, porque muda conforme o software. O que precisas depois, seja qual for a aplicação, são os seus dois caminhos (Passo 3).

### Passo 3. Localiza os dois caminhos de que precisas

Para publicar a aplicação, o painel vai pedir-te dois caminhos do servidor:

* O **caminho raiz** (diretório de trabalho) onde a aplicação está instalada.
* O **caminho do executável** associado.

Para o do executável, clica com o botão direito no ícone da aplicação, abre **Propriedades** e, no separador **Atalho**, copia o conteúdo do campo **Destino** (Shortcut e Target se o Windows estiver em inglês), sem aspas nem argumentos. O caminho raiz costuma coincidir com o campo Iniciar em (Start in). Verifica depois que o executável está nesse caminho.

![Caminho do executável nas propriedades do atalho](https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2F4M8A3Crg1Og1ODD0cqZz%2Fescritorio-remoto-instalar-app-03.png?alt=media\&token=0694ea57-dfbe-427e-93e3-806f1b5e6e36)

> #### 🚧 O caminho raiz e o executável nem sempre coincidem
>
> O executável não tem de estar na mesma pasta que o caminho raiz da aplicação. Verifica os dois valores separadamente antes de continuares, porque na criação vão em campos diferentes, e um caminho de executável incorreto faz com que a aplicação não abra.

### Passo 4. Dá de alta a aplicação no painel

Volta ao painel, ao Ecrã **Publicar nova aplicação**, deixa em Sim a opção de já estar instalada no teu servidor e completa os campos:

* **Logótipo**: o ícone com que a aplicação será mostrada.
* **Nome**: o nome com que será mostrado no ambiente.
* **Categoria**: o tipo de aplicação (Utilitários, Bases de Dados, etc.).
* **Diretório de trabalho**: o caminho da **raiz** da aplicação (não a pasta do executável).
* **Caminho do executável**: o caminho do **executável**, que pode ser diferente do do diretório.
* **Argumentos do executável**: só se a aplicação precisar de parâmetros de arranque.

Clica em **Guardar**. O progresso aparece na secção de alertas e, ao terminar, a aplicação surge na lista.

![Registo da aplicação com os seus caminhos](https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FsrYX1woqn7hNiG9h1UUO%2Fescritorio-remoto-instalar-app-04.png?alt=media\&token=ca7da6f7-f931-448a-817c-526b691779c2)

### Passo 5. Atribui acesso aos utilizadores

A aplicação já está publicada, mas ainda ninguém a vê: o acesso é atribuído manualmente. Na lista, abre o menu **(…)** da aplicação e clica em **Utilizadores**. Seleciona os utilizadores que a devem usar e clica em **Guardar**.

![Atribuição de utilizadores à aplicação](https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FdeBXnMnmT3EAn9SzGjwy%2Fescritorio-remoto-instalar-app-05.png?alt=media\&token=7de7bd22-6f1c-472e-8865-291d7eba35af)

De volta em **Applications**, verifica que a aplicação aparece disponível e que a coluna de utilizadores mostra quem recebeu acesso.

> #### 👍 Antes de fechar, valida
>
> A aplicação surge na lista de Applications, a coluna de utilizadores mostra os acessos, o Diretório de trabalho aponta para a raiz correta e o Caminho do executável para o executável correto.

### Conclusão

Publicar uma aplicação é ligar dois mundos: o software instalado no servidor e a sua ficha no painel. Se não estiver no Marketplace, instalas manualmente ligando-te por RDP; se estiver, usas a instalação automatizada.

Em ambos os casos, a parte a que o processo dedica mais atenção são os caminhos, porque a raiz da aplicação e a do executável podem não coincidir, e o painel pede-as separadamente.

Uma vez dada de alta, lembra-te de que o acesso não é automático: atribuis manualmente os utilizadores que a devem ver. Com isso, a aplicação fica centralizada no servidor e disponível apenas para quem dela precisa.

### Passos seguintes

* Dá de alta ou atribui utilizadores em lote com a [Carga massiva de utilizadores.](https://docs.plenit.com/docs-pt/productos/remote-desktop/how-to/how-to-bulk-upload-users.md)
* Revê as modalidades de impressão do ambiente em [Impressão.](https://docs.plenit.com/docs-pt/productos/remote-desktop/details/printing.md)
* Administra o resto do ambiente a partir de [Como administrar o teu ambiente de Desktop Remoto.](https://docs.plenit.com/docs-pt/productos/remote-desktop/how-to/how-to-administer-your-remote-desktop.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.plenit.com/docs-pt/productos/remote-desktop/how-to/how-to-install-and-publish-an-application.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
