> 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 do pacote

As subscrições de pacotes do RealmJoin e os tipos de atribuição como Main (Required) e Available, para implementar software através do RealmJoin ou do Intune, e como as atribuições conflitantes de utilizador e dispositivo são priorizadas

{% 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 automatizadas de pacotes e ciclo de vida para garantir que os seus utilizadores recebem as funcionalidades e correções mais recentes.
{% endhint %}

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

RealmJoin ou 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, se não a encontrarem no dispositivo.

### **Disponível**

{% tabs %}
{% tab title="RealmJoin" %}
A aplicação aparecerá na bandeja do agente RealmJoin 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 de 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 Automatização](/pt/gestao-de-aplicacoes/packages/package-details.md#automation).

### Desinstalar

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

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

### Atualização

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

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

### Excluir

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

{% hint style="info" %}
Esta opção só deve ser usada em casos específicos e não se destina a 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 vivamente contra construções de atribuição em várias camadas.
{% endhint %}

#### Utilização

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

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 ao pacote de 32 bits.

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

### prioridade de atribuição e conflitos

Os pacotes geridos podem ser atribuídos a utilizadores (através de grupos de utilizadores ou diretamente) e a dispositivos (através de grupos de dispositivos, consulte [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 de um dispositivo.

Nos pacotes geridos, a gestão de grupos é tratada pelo Portal RealmJoin, que utiliza 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 *alguma* das atribuições recolhidas for uma atribuição Excluir, o pacote é descartado por completo. Nada mais é avaliado, incluindo Desinstalar.
2. **Desinstalar** — se *alguma* das atribuições restantes for uma atribuição Desinstalar, o pacote é desinstalado, independentemente de vir de um grupo de utilizadores, de um grupo de dispositivos ou de uma atribuição direta ao utilizador.
3. **Atribuição direta ao 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, quer provenientes de grupos de utilizadores quer 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 classificados pelo respetivo tipo de aprovisionamento (do mais alto para o mais 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 é (do mais alto para o mais 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**, em que uma atribuição Disponível prevalece sobre uma atribuição Principal (Obrigatório). Se preferir o oposto — um utilizador ou dispositivo que esteja simultaneamente nos grupos Principal e 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:

* **Ao nível do Tenant** — em Definições > Geral > App Config, ative *Cascata de prioridade clássica para aplicações geridas*. A alteração da opção pede confirmação e entra em vigor imediatamente para todos os utilizadores e todos os pacotes que não tenham substituição por pacote. Consulte [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*.

A opção só afeta pacotes geridos e apenas a classificação de Principal em relação 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 for Obrigatório.

{% hint style="info" %}
As atribuições de grupo de dispositivos só são avaliadas se a atribuição de dispositivos estiver ativada para o seu Tenant. Peça ajuda ao suporte RJ se a funcionalidade de atribuição de dispositivos estiver ativa no seu Tenant. Sem ela, as pertenças do dispositivo aos grupos — incluindo os grupos Excluir e Desinstalar — não são tidas em conta.

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

{% hint style="warning" %}
As regras acima descrevem como o agente RealmJoin resolve atribuições. Para pacotes implementados via Intune, os mesmos grupos são atribuídos à app 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, nem vice-versa. Consulte a [documentação da Microsoft sobre conflitos de atribuição de apps](https://learn.microsoft.com/en-us/intune/intune-service/apps/apps-deploy#how-conflicts-between-app-intents-are-resolved) para mais 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 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>

Ao selecionar Principal, Pré-visualização, Disponível e Desinstalar, o utilizador será adicionado ao grupo escolhido e removido de todos os outros grupos relevantes para o pacote.

Ao selecionar Atribuir, os utilizadores serão adicionados 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 grupos, dispositivos ou utilizadores manualmente.

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>

#### Migrar de subscrições Básicas para geridas

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

Esta funcionalidade cria os grupos de subscrição gerida predefinidos, nos quais os utilizadores legados podem ser adicionados por 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 app básica para uma app 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-deployment.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.