> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-deployment.md).

# Configuração e atribuições de pacotes

Subscrições de pacotes RealmJoin e tipos de atribuição como Main (Required) e Available, para implementar software via RealmJoin ou Intune, e como as atribuições conflitantes de utilizador e dispositivo são prioriti

{% embed url="<https://www.youtube.com/watch?v=BdF3rvMbjFs>" %}

## Subscrição gerida

Os pacotes subscritos como geridos vêm com grupos de utilizadores geridos. Existem diferentes tipos de grupos disponíveis que podem ser escolhidos com base no seu cenário.

{% hint style="info" %}
Os pacotes geridos são a forma preferencial de implementar software para os seus utilizadores. Pode combiná-los com atualizações automáticas de pacotes e ciclo de vida para garantir que os seus utilizadores recebem as funcionalidades e correções mais recentes.
{% endhint %}

### **Principal (Obrigatório)**

O RealmJoin ou o Intune instalarão automaticamente a aplicação. Estas aplicações são obrigatórias e ambas as soluções tentarão continuamente instalar a aplicação, caso não seja encontrada no dispositivo.

### **Disponível**

{% tabs %}
{% tab title="RealmJoin" %}
A aplicação aparecerá na área da bandeja do RealmJoin Agent e exigirá que o utilizador inicie manualmente a transferência e a instalação.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FQkUe67EPZRg2mfEceVou%2Fimage.png?alt=media&amp;token=219923c1-59bb-47c0-857d-7ecdcd7fb94e" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Intune" %}
A aplicação aparecerá em Company Portal -> Apps e exigirá que o utilizador inicie manualmente a transferência e a instalação.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FtYyz0zHDoH8pVUeVeEBX%2Fimage.png?alt=media&amp;token=eb278ba8-9e42-4b45-a4e0-bcd3d428fcf0" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Pré-visualização

Os utilizadores e dispositivos no grupo Pré-visualização receberão a versão mais recente do pacote antes dos outros grupos. As definições de Pré-visualização são configuráveis através do [separador Automação](/pt/gestao-de-aplicacoes/packages/package-details.md#automation).

### Desinstalar

O RealmJoin ou o Intune desinstalarão o pacote dos utilizadores e dispositivos atribuídos. Adicionar um utilizador ou dispositivo ao grupo Desinstalar irá removê-los de todos os outros grupos.

Uma atribuição de Desinstalar tem precedência sobre as atribuições Principal e Disponível, independentemente do nível em que é feita: um dispositivo no grupo Desinstalar faz com que o pacote seja desinstalado mesmo que o utilizador com sessão iniciada esteja no grupo Principal, e vice-versa. Apenas uma [Excluir](#exclude) atribuição tem prioridade superior, veja [Prioridade da atribuição](#assignment-priority-and-conflicts).

### Atualização

O grupo Atualização é criado sob demanda e incorpora automaticamente instalações avulsas de um título de software na gestão, para que novas versões — incluindo correções de segurança — também cheguem a esses dispositivos. É o mecanismo que mantém as aplicações do Intune **Disponível** atualizadas, ao atribuir temporariamente dispositivos desatualizados como **Obrigatório**.

Para detalhes, veja [Grupo de Atualização](/pt/gestao-de-aplicacoes/packages/update-group.md).

### Excluir

Precisa de ser ativado explicitamente através de "Mais" > "Atribuições de exclusão" (como mostrado na [imagem abaixo](#enable-additional-and-restore-default-groups)). Os utilizadores e dispositivos no grupo especificado serão excluídos das atribuições em todo o pacote e grupos geridos associados.

{% hint style="info" %}
Esta opção deve ser usada apenas em casos específicos e não se destina a ser utilizada para gerir conflitos de atribuição. Deve gerir sempre as atribuições com atribuições claras de utilizador para grupo, sem necessidade de usar um mecanismo de exclusão. Aconselhamos fortemente contra estruturas de atribuição em várias camadas.
{% endhint %}

#### Utilização

A atribuição de exclusão de grupos é usada para garantir que os utilizadores no grupo de exclusão atribuído não sejam geridos dentro dos grupos geridos do pacote. Não removerá os utilizadores de grupos geridos dentro do mesmo pacote. Em vez disso, garante que determinados pacotes nunca são atribuídos ao mesmo utilizador simultaneamente.

Por exemplo, pode usar a função Excluir para impedir que um utilizador, atribuído a um grupo de pacote Adobe Reader de 64 bits, receba também a versão de 32 bits. Basta atribuir o grupo de pacote de 64 bits utilizado como exclusão para o pacote de 32 bits.

{% hint style="warning" %}
Excluir é avaliado antes de qualquer outra coisa. Se o utilizador com sessão iniciada *ou* o dispositivo for membro de um grupo de exclusão de um pacote, nenhuma outra atribuição desse pacote é avaliada — nem Principal, Disponível, Pré-visualização, Atualização, uma atribuição direta de utilizador, nem **Desinstalar** também. O pacote é simplesmente ignorado nesse dispositivo: não é instalado nem desinstalado. Veja [Prioridade da atribuição](#assignment-priority-and-conflicts).
{% endhint %}

#### Atribuições de exclusão para aplicações Intune

As aplicações Intune também podem ser excluídas de grupos. Na página de detalhes da aplicação, abra "Mais" > "Atribuições de exclusão" na *Grupos diretos* lista, escolha a finalidade da qual o grupo deve ser excluído (**Obrigatório**, **Disponível** ou **Desinstalar**) e adicione o grupo. O RealmJoin cria uma exclusão nativa do Intune, pelo que o grupo aparece em *Grupos excluídos* desse objetivo no centro de administração do Intune também. A opção está disponível para todas as aplicações Intune, quer estejam subscritas como geridas ou não.

As exclusões são listadas juntamente com as outras atribuições em *Grupos diretos*. Remover uma exclusão remove-a apenas para essa finalidade; as exclusões do mesmo grupo para outras finalidades mantêm-se. A adição e remoção de exclusões é registada no registo de auditoria.

O Intune, e não o RealmJoin, avalia estas exclusões:

* **Por finalidade** — uma exclusão aplica-se apenas à finalidade para a qual foi criada. Excluir um grupo de *Obrigatório* não oculta a aplicação do Company Portal se o grupo também estiver atribuído como *Disponível*.
* **A exclusão prevalece** — na mesma finalidade, um grupo excluído tem precedência sobre grupos incluídos, incluindo *Todos os utilizadores* e *Todos os dispositivos* atribuições. Um grupo não pode ser incluído e excluído para a mesma finalidade ao mesmo tempo, por isso o seletor lista apenas grupos que ainda não têm atribuição para a finalidade selecionada.
* **Mesmo tipo de grupo** — exclua grupos de utilizadores de atribuições direcionadas a utilizadores e grupos de dispositivos de atribuições direcionadas a dispositivos. O Intune não suporta excluir grupos de dispositivos de atribuições de utilizadores ou vice-versa.
* **Sem desinstalação** — uma exclusão apenas interrompe a atribuição. A aplicação permanece instalada nos dispositivos que já a têm; use uma *Desinstalar* atribuição para a remover.
* **Apenas a aplicação principal** — as exclusões são criadas na aplicação principal do Intune. Durante uma atualização gerida, a aplicação de pré-visualização mantém as suas próprias atribuições.

As alterações chegam aos dispositivos no próximo check-in do Intune. Veja a [documentação da Microsoft sobre atribuições de aplicações](https://learn.microsoft.com/en-us/intune/intune-service/apps/apps-deploy) para detalhes.

### Prioridade e conflitos de atribuição

Os pacotes geridos podem ser atribuídos a utilizadores (via grupos de utilizadores ou diretamente) e a dispositivos (via grupos de dispositivos, veja [Atribuir pacotes a dispositivos](/pt/agente-realmjoin/realmjoin-client/multi-user-devices.md#option-a-assign-packages-to-devices)). Como um dispositivo e o respetivo utilizador com sessão iniciada podem acabar em grupos diferentes do mesmo pacote, o backend do RealmJoin resolve conflitos de forma determinística quando apresenta a configuração para um dispositivo.

Em pacotes geridos, a gestão de grupos é tratada pelo RealmJoin Portal, que usa o GUID de cada grupo após a criação. Isto permite ao portal identificar o tipo de aprovisionamento associado a cada grupo e priorizar entre eles. Isto garante um comportamento determinístico em cenários em que um utilizador ou dispositivo é atribuído por engano a vários grupos de aprovisionamento.

Para cada pacote, as atribuições do utilizador com sessão iniciada, dos grupos do utilizador e dos grupos do dispositivo são recolhidas e avaliadas por esta ordem:

1. **Excluir** — se *qualquer* uma das atribuições recolhidas for uma atribuição de exclusão, o pacote é descartado por completo. Nada mais é avaliado, incluindo Desinstalar.
2. **Desinstalar** — se *qualquer* das atribuições restantes for uma atribuição de Desinstalar, o pacote é desinstalado, independentemente de vir de um grupo de utilizadores, um grupo de dispositivos ou uma atribuição direta de utilizador.
3. **Atribuição direta de utilizador** — um pacote atribuído diretamente ao utilizador (e não através de um grupo) tem precedência sobre todas as atribuições de grupo, sejam de grupos de utilizadores ou de grupos de dispositivos.
4. **Atribuições de grupo** — os grupos de utilizadores e os grupos de dispositivos são tratados da mesma forma e ordenados pelo respetivo tipo de aprovisionamento (de alto para baixo):\
   \[Atualização] - Pré-visualização - Disponível - Obrigatório\
   Se o grupo do utilizador e o grupo do dispositivo tiverem o mesmo tipo de aprovisionamento, é usada a atribuição do grupo do utilizador.

Na prática, a ordem de priorização é (de alto para baixo):

\[Excluir] - Desinstalar - \[Atualização] - Pré-visualização - Disponível - Obrigatório

#### Cascata de prioridade gerida e clássica

A ordem acima é a cascata gerida predefinida **cascata gerida**, na qual uma atribuição Disponível prevalece sobre uma atribuição Principal (Obrigatório). Se preferir o oposto — um utilizador ou dispositivo que esteja tanto no grupo Principal como no grupo Disponível recebe o pacote instalado como obrigatório — mude para a **cascata clássica**:

* **Cascata gerida** (predefinição): \[Excluir] - Desinstalar - \[Atualização] - Pré-visualização - **Disponível** - **Obrigatório**
* **Cascata clássica**: \[Excluir] - Desinstalar - \[Atualização] - Pré-visualização - **Obrigatório** - **Disponível**

A cascata pode ser definida em dois níveis:

* **Em todo o Tenant** — em Definições > Geral > Configuração da aplicação, ative *Cascata clássica de prioridade para aplicações geridas*. Alterar o interruptor pede confirmação e tem efeito imediato para todos os utilizadores e para todos os pacotes que não tenham substituição por pacote. Veja [Cascata de prioridade de aplicação gerida](/pt/administracao-e-definicoes/general.md#managed-app-priority-cascade).
* **Por pacote** — nas [Definições avançadas](/pt/gestao-de-aplicacoes/packages/package-settings.md#expert-settings), a *cascata de prioridade* definição substitui o padrão do Tenant apenas para esse pacote: *Usar o padrão do Tenant* (recomendado), *Cascata gerida* ou *Cascata clássica*.

O interruptor afeta apenas pacotes geridos e apenas a ordenação de Principal face a Disponível. Excluir, Desinstalar, Atualização e Pré-visualização mantêm a sua posição, e os pacotes básicos instalam-se sempre como obrigatórios quando qualquer uma das suas atribuições é Obrigatório.

{% hint style="info" %}
As atribuições de grupos de dispositivos só são avaliadas se a atribuição de dispositivos estiver ativada para o seu Tenant. Por favor, pergunte ao suporte RJ se a funcionalidade de atribuição de dispositivos está ativa no seu Tenant. Sem isso, as associações do dispositivo a grupos — incluindo grupos de exclusão e desinstalação — não são tidas em conta.

Uma atribuição de Excluir ou Desinstalar é ignorada se a própria atribuição for filtrada pelas suas definições avançadas no dispositivo atual (por exemplo, *Apenas em VDI* / *Ignorar em VDI*, *Apenas em dispositivos unidos em modo híbrido* / *Ignorar em dispositivos unidos em modo híbrido*, *Ignorar em dispositivos privados*), veja [Definições avançadas](/pt/gestao-de-aplicacoes/packages/package-settings.md#expert-settings).
{% endhint %}

{% hint style="warning" %}
As regras acima descrevem como o RealmJoin Agent resolve as atribuições. Para pacotes implementados via Intune, os mesmos grupos são atribuídos à aplicação Intune e o Intune aplica a sua própria resolução de conflitos. Em particular, o Intune não suporta excluir um grupo de dispositivos de uma atribuição de grupo de utilizadores ou vice-versa, veja [Atribuições de exclusão para aplicações Intune](#exclude-assignments-for-intune-apps). Consulte a [documentação da Microsoft sobre conflitos de atribuição de aplicações](https://learn.microsoft.com/en-us/intune/intune-service/apps/apps-deploy#how-conflicts-between-app-intents-are-resolved) para detalhes.
{% endhint %}

### Ativar grupos adicionais e restaurar os grupos predefinidos

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Ft9P4J6LHAbAkgcaZPbQQ%2Fimage.png?alt=media&amp;token=a0593e78-3f33-4fca-8d07-c6a480de1e95" alt=""><figcaption></figcaption></figure>

Através do botão "Mais" pode ativar o grupo de atualização opcional, gerir atribuições de exclusão e também restaurar os grupos geridos predefinidos caso tenham sido eliminados.

### Alterar atribuições

{% hint style="warning" %}
Os utilizadores e dispositivos devem estar apenas num grupo gerido do RealmJoin em qualquer momento.
{% endhint %}

Os utilizadores e dispositivos podem ser facilmente movidos entre grupos usando a *Utilizadores geridos* função.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FcPjlPHy1HpdhBA5ed9Rg%2Fimage.png?alt=media&amp;token=9910f82a-9492-4ab6-87c9-a2cb519a44ed" alt=""><figcaption></figcaption></figure>

Selecionar Principal, Pré-visualização, Disponível e Desinstalar adicionará o utilizador ao grupo escolhido e removerá o utilizador de todos os outros grupos relevantes para o pacote.

Selecionar Atribuir adicionará os utilizadores ao grupo Principal por predefinição.

## Subscrição básica (legado)

Os pacotes básicos não têm quaisquer grupos Microsoft Entra associados. Terá de atribuir manualmente grupos, dispositivos ou utilizadores.

Os grupos, dispositivos e utilizadores atribuídos a um pacote básico serão atribuídos como Disponível por predefinição e podem ser alterados usando o botão \[alterar definições].

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FPaBdqESviHIokxBnQA5Y%2Fimage.png?alt=media&amp;token=a4f392b9-dc49-438d-b373-320477e51987" alt=""><figcaption></figcaption></figure>

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FwNCcuDXYYbQu0yLBm8Qr%2Fimage.png?alt=media&amp;token=77b1f499-24d8-401e-83cb-7b7325c82c76" alt=""><figcaption></figcaption></figure>

#### Migração de subscrições básicas para geridas

Para migrar uma subscrição de pacote básico legado para o formato gerido padrão, o RealmJoin Portal fornece uma função de conversão integrada. Na secção de grupos atribuídos do pacote de aplicação subscrito básico, a opção "Converter para aplicação gerida" está disponível através do botão "Mais".

Esta funcionalidade cria os grupos predefinidos da subscrição gerida, nos quais os utilizadores legados podem ser adicionados via operação em massa ou aninhamento.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FId9Dj1bIlGSwXPeTmVj2%2Fimage.png?alt=media&amp;token=b0e938d4-4eee-4731-989d-482c3f4c04ca" alt=""><figcaption><p>Preparação para migrar uma aplicação básica para uma aplicação gerida</p></figcaption></figure>

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FR2NwuLIyXhQctr2xAVen%2Fimage.png?alt=media&amp;token=4b1ef854-bc96-4825-8c0b-9495465816d2" alt=""><figcaption><p>Resultado do processo de migração</p></figcaption></figure>


---

# 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.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-deployment.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.