> 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-settings.md).

# Definições do pacote

O separador Config de um pacote: Proprietários técnicos da aplicação, argumentos de instalação, definições avançadas para pacotes RealmJoin e Intune, e como as dependências e a ordem de instalação são resolvidas.

O **Configuração** aba da [página de detalhes do pacote](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-details.md) contém as definições de um pacote subscrito. As atualizações automáticas são configuradas no separador Automação, veja [Automação](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-updates.md#automation).

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FIumq8BgrSfEdoH2huMgd%2Fimage.png?alt=media&amp;token=31335002-b7da-4447-a5d0-e2bc79e519a6" alt=""><figcaption><p>Configuração do pacote</p></figcaption></figure>

A aba mostra estes cartões:

* **Proprietários técnicos da aplicação** - Quem é notificado sobre este pacote.
* **Aplicação principal** - As definições do pacote principal: argumentos, um comentário interno da equipa (apenas RealmJoin) e o **definições avançadas** botão.
* **Aplicação de pré-visualização** - As mesmas definições para o pacote de pré-visualização, mostradas enquanto uma [pré-visualização](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-updates.md#staged-updates-with-preview) está em execução.

As definições feitas aqui aplicam-se a todo o pacote. As atribuições individuais podem divergir delas, veja [Definições de atribuição](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-deployment.md#assignment-settings).

## Proprietários técnicos da aplicação

Pode atribuir vários **Proprietários técnicos da aplicação** (TAO) a um pacote, adicionando os respetivos endereços de e-mail com **Adicionar destinatário**.

Para lhes enviar **e-mails de notificação automatizados** sobre atualizações do pacote, ative o **Ativar** interruptor.

## Argumentos

**Argumentos na execução do cliente** permitem-lhe passar opções da linha de comandos para a instalação de uma aplicação. Isto é normalmente usado para personalizar o seu pacote com opções de idioma, uma chave de licença, etc., que precisam de estar presentes no momento da instalação.

{% hint style="info" %}
Se um utilizador já tiver instalada a versão subscrita atual de um pacote e os argumentos do pacote forem atualizados, o pacote será executado novamente automaticamente para esse utilizador usando a nova configuração.

Se **Atualização automática** estiver **DESATIVADO** e o utilizador tiver instalada uma versão mais antiga do que a atualmente atribuída, a nova configuração **não** será aplicada.\
Se **Atualização automática** estiver **ATIVADO**, o utilizador receberá tanto a nova versão como a configuração atualizada.
{% endhint %}

Alguns pacotes incluem uma **Ajuda técnica**, para explicar possíveis **Argumentos** e outros Requisitos.

![Ajuda técnica para um pacote](https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FBQ0DoCwXsQULYLeOZ2FR%2Fimage.png?alt=media\&token=48e2eda5-8f66-484e-a97a-0c67ed3b4611)

Os pacotes Intune para macOS não têm argumentos.

### Argumentos especiais para pacotes Intunewin

Para pacotes Intunewin, oferecemos uma notificação de IU de atualização de pacote configurável que permite ao utilizador interagir com a instalação / atualização de uma aplicação e dá controlo sobre o processo.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FfGXTlIPtznwVHF9ZIOBo%2FScreenshot%202026-03-04%20at%2014.39.28.png?alt=media&amp;token=6f821f56-035c-4c0f-b584-29138010cb92" alt=""><figcaption></figcaption></figure>

Pode configurar esta caixa de diálogo com as seguintes definições na secção de argumentos:

```
--rjNotifyUser // Ativar diálogo
```

```
--rjNotifyAllowDefer[=n] // opção de adiar com x adiamentos possíveis
```

```
--rjNotifyTimeout=n // quando não for realizada qualquer ação do utilizador -> adiamento automático após x segundos (se for permitido adiar), caso contrário, atualização
```

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FRCPahlMIxbPoGYbjjC7w%2Fimage.png?alt=media&amp;token=84e31e79-2399-4139-8540-6a7f99cbc53a" alt=""><figcaption></figcaption></figure>

## Comentário interno da equipa

Para pacotes RealmJoin, o **Comentário interno da equipa** campo contém notas para os seus administradores. Não é mostrado aos utilizadores.

## Definições avançadas

O **definições avançadas** botão no cartão da aplicação principal ou da aplicação de pré-visualização abre opções avançadas para o pacote. Os pacotes RealmJoin e Intune oferecem definições diferentes. Para as visualizar é necessário `CanSeeAppExpertSettings`, para as alterar `CanEditAppExpertSettings`.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F0Cu7aHFnwGvafgiw4otd%2Fimage.png?alt=media&amp;token=638cf81a-efee-4afe-bcc9-d161426c80da" alt=""><figcaption><p>Definições avançadas</p></figcaption></figure>

{% tabs %}
{% tab title="pacotes RealmJoin" %}

<table><thead><tr><th width="200">Definição</th><th>Explicação</th></tr></thead><tbody><tr><td>Permitir reinstalação</td><td>Permite ao utilizador <strong>reinstalar</strong> o pacote em qualquer momento, substituindo a instalação atual.<br>Ex.: adequado para pacotes que ajudam a resolver problemas do cliente através de autoatendimento (sincronização de hora, ...).</td></tr><tr><td>Permitir instalação em segundo plano</td><td>Executa <strong>as atualizações do pacote diretamente</strong> após serem detetadas atualizações da configuração no dispositivo (intervalo de sincronização padrão do RealmJoin: 30 minutos). As atualizações começam sem aviso (sem opção de adiamento).<br>Não utilize esta opção para pacotes normais, pois isto pode interromper os utilizadores enquanto usam o software.</td></tr><tr><td>Exigir conformidade</td><td>O pacote só é <strong>instalado</strong> quando o RealmJoin puder verificar que o dispositivo está <strong>em conformidade</strong> no Intune. Isto pode atrasar a implementação durante algum tempo. A instalação do pacote e de todos os outros pacotes obrigatórios com números de ordem superiores fica em fila e só é instalada quando o dispositivo estiver em conformidade.</td></tr><tr><td>Pré-lançamento</td><td>Definição legada, não disponível para pacotes geridos. Veja <a href="https://docs-classic.realmjoin.com/rj-portal/software-packages">RealmJoin Classic</a>.</td></tr><tr><td>Atualização automática</td><td><p><strong>Atualiza automaticamente</strong> instalações existentes quando uma <strong>versão mais recente</strong> é atribuída. Se a versão atribuída for superior à existente no dispositivo, o RealmJoin executa novamente o pacote para o atualizar.</p><p>Desative esta opção para pacotes com os seus próprios mecanismos de atualização (por exemplo: cliente VPN atualizado através do gateway). Quando desativado, apenas as novas instalações recebem a versão mais recente.</p><p>Atualizações do RealmJoin Agent necessárias <em>e</em> Pacotes disponíveis.</p></td></tr><tr><td>Permitir desinstalação para Disponível</td><td>Permite aos utilizadores <strong>desinstalar</strong> o pacote quando é atribuído como <strong>Disponível</strong>.</td></tr><tr><td>Apenas em VDI / Ignorar em VDI</td><td>Executar este pacote em <strong>VDI</strong> dispositivos (Windows 365 e Azure Virtual Desktop) apenas, ou ignorá-lo aí.</td></tr><tr><td>Apenas em dispositivos associados em modo híbrido / Ignorar em dispositivos associados em modo híbrido</td><td>Executar este pacote em <strong>dispositivos associados em modo híbrido</strong> apenas, ou ignorá-lo aí.</td></tr><tr><td>Ignorar em dispositivos privados</td><td>Ignorar <strong>privados</strong> dispositivos (não associados ao Entra ID).</td></tr><tr><td>Nome do grupo</td><td>O <strong>categoria</strong> na qual o pacote aparece no menu da Bandeja do RealmJoin.</td></tr><tr><td>Depende de</td><td><p>Pacotes que o RealmJoin Agent instala <strong>antes de</strong> este pacote, por exemplo, um runtime como o Microsoft Visual C++ Redistributable.</p><p>Introduza o <strong>ID RJ único</strong> de um pacote, ou uma matriz JSON de IDs:<br><code>["generic-microsoft-vcredist-2019","generic-microsoft-net-core-desktop-runtime-6"]</code></p><p>Cada dependência tem de ser atribuída aos mesmos utilizadores ou dispositivos (Obrigatório ou Disponível). Veja <a href="#dependencies-and-installation-order">Dependências e ordem de instalação</a>.</p></td></tr><tr><td>Ordem</td><td>Inteiro que ordena a instalação dentro de um <a href="#installation-order">nível de dependência</a>. Os números mais baixos são executados primeiro (por ex. <strong>10</strong> antes de <strong>100</strong>). <strong>0</strong> significa "sem ordem" e é executado depois de todos os pacotes numerados do mesmo nível.</td></tr><tr><td>Cascata de prioridade</td><td>Apenas pacotes geridos. Decide qual atribuição prevalece quando um utilizador ou dispositivo corresponde aos grupos Principal e Disponível deste pacote:<br><strong>Usar predefinição do Tenant (recomendado)</strong> - segue o interruptor global do Tenant em Definições > Geral > Configuração da aplicação.<br><strong>Cascata gerida</strong> - Disponível prevalece sobre Principal.<br><strong>Cascata clássica</strong> - Principal prevalece sobre Disponível.<br>Veja <a href="https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-deployment.md#managed-and-classic-priority-cascade">Cascata de prioridade</a> para mais detalhes.</td></tr><tr><td>Taxa de implementação</td><td><p>Permite aos utilizadores <strong>adiar</strong> a instalação até a uma data fixa. As opções são <strong>NoChange</strong> (sem adiamento), <strong>Amanhã</strong> (+1 dia), <strong>Rápido</strong> (+3 dias) e <strong>Lento</strong> (+7 dias). Para Rápido e Lento, uma data num fim de semana é transferida para depois do fim de semana. A caixa de diálogo mostra a data resultante.</p><p>A data é armazenada como um valor fixo quando guarda, não se move com o último check-in do dispositivo. Depois dessa data, a instalação é executada sem mais adiamentos.</p><p><strong>Nota:</strong> As instalações são faseadas: são acionadas várias vezes por dia com uma determinada probabilidade por acionamento. Isto garante uma implementação mais suave e faz bom uso do BranchCache e da Otimização de Entrega.</p></td></tr><tr><td>Restrições da aplicação principal</td><td><p>Define <strong>quem</strong> executa o pacote e <strong>quando</strong> (<strong>fase</strong>).</p><p>Utilizadores: <strong>Apenas o utilizador principal</strong> (o utilizador principal do dispositivo, conforme mostrado no RealmJoin Portal), <strong>Apenas utilizadores secundários</strong> ou <strong>Ambos</strong>.</p><p>Fases (predefinição: <em>Normal, Inicial e Manual</em>):</p><p><strong>Início de sessão</strong>: O pacote é executado depois de o utilizador iniciar sessão.<br><strong>Manual</strong>: O pacote é executado quando o utilizador inicia a instalação manualmente através do menu da bandeja.<br><strong>Inicial</strong>: O pacote é executado durante a implementação inicial do cliente.<br><strong>Normal</strong>: Nem Início de sessão, nem Manual, nem Inicial; implementação durante o uso normal de um dispositivo.</p></td></tr><tr><td>Restrições da parte do utilizador</td><td>As mesmas opções que antes, mas para a parte do utilizador do pacote (se tiver uma), por exemplo, definições ou scripts executados no contexto do utilizador em vez do contexto do sistema.</td></tr></tbody></table>
{% endtab %}

{% tab title="Pacotes Intune" %}

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-897bb3596b68d8c1145188f5888940342ad15caa%2Fpkg-expert-settings-intune.png?alt=media" alt="Expert settings dialog of an Intune Windows app"><figcaption><p>Definições avançadas de uma aplicação Intune para Windows</p></figcaption></figure>

<table><thead><tr><th width="200">Definição</th><th>Explicação</th></tr></thead><tbody><tr><td>Atualização automática</td><td><strong>Atualiza automaticamente</strong> instalações existentes quando uma versão mais recente é atribuída. O Intune só atualiza <strong>Obrigatório</strong> atribuições. Para manter <strong>Disponível</strong> as aplicações atualizadas, ative o <a href="https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/update-group.md">Grupo de atualização</a>.</td></tr><tr><td>Aplicação em destaque</td><td>Mostra a aplicação como uma aplicação em destaque no Company Portal.</td></tr><tr><td>Permitir desinstalação para Disponível</td><td>Apenas Windows. Permite aos utilizadores desinstalar a aplicação do Company Portal quando é atribuída como Disponível.</td></tr><tr><td>Tempo de execução necessário da instalação (min)</td><td>Apenas Windows. O tempo máximo de execução da instalação.</td></tr><tr><td>Script pré-instalação / Script pós-instalação</td><td>Apenas aplicações PKG do macOS. Scripts de shell que são executados antes da instalação ou após uma instalação bem-sucedida. Deixe em branco para usar o predefinido do pacote, se existir.</td></tr><tr><td>Categorias</td><td>As categorias sob as quais a aplicação aparece no Company Portal. Só é mostrado se o seu Tenant tiver <a href="https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-store/package-store-details.md#app-categories">categorias de aplicações</a>.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

### Dependências e ordem de instalação

*Depende de* e *Ordem* decidem que pacotes o RealmJoin Agent instala antes de um pacote RealmJoin e em que sequência. O agente resolve ambos no dispositivo, em relação aos pacotes na configuração RealmJoin do dispositivo. Essa configuração contém apenas os pacotes RealmJoin atribuídos ao dispositivo e ao respetivo utilizador. As aplicações Intune não fazem parte dela e não podem ser dependências.

#### Introduza dependências

1. Abra o pacote que precisa da dependência, por exemplo, a aplicação.
2. Procure o **ID RJ único** de cada dependência em [propriedades do pacote](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-details.md#package-properties) no lado esquerdo da página do pacote dessa dependência, por ex. `generic-7zip`. Se a dependência tiver sido subscrita com um sufixo, o sufixo faz parte do ID.
3. Abra **Configuração** > **definições avançadas** do pacote dependente e introduza os IDs em **Depende de**:
   * um pacote: `generic-microsoft-vcredist-2019`
   * vários pacotes: uma matriz JSON com aspas duplas, `["generic-microsoft-vcredist-2019","generic-microsoft-net-core-desktop-runtime-6"]`
4. Guarde. A **Pacotes dependentes** secção no [separador Visão geral](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-details.md#overview) do pacote dependente agora lista cada ID introduzido que corresponda a um pacote no seu Tenant, ligado a esse pacote.

A caixa de diálogo aceita letras, dígitos, `.`, `#`, `_` e `-` num ID, e até 511 caracteres no total. Uma lista separada por vírgulas, aspas simples ou espaços são rejeitados com *O Depende de tem de ser um nome de pacote ou uma matriz JSON de nomes de pacotes.* A caixa de diálogo não verifica se um ID existe ou está atribuído. Um ID em falta em **Pacotes dependentes** após guardar não corresponde a nenhum pacote no seu Tenant.

O **Aplicação principal** e o **Aplicação de pré-visualização** têm definições avançadas separadas. Se o pacote tiver um [pré-visualização](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-updates.md#staged-updates-with-preview), introduza as dependências em ambos.

#### Requisitos no dispositivo

* **Atribua cada dependência** aos mesmos utilizadores ou dispositivos que o pacote dependente, como Obrigatório ou Disponível. Disponível é suficiente: o agente instala uma dependência Disponível logo que seja instalado um pacote que dela precise. Para manter uma dependência fora do menu da bandeja, ative **Oculto** nas suas [definições de atribuição](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-deployment.md#assignment-settings).
* **Uma dependência que não esteja na configuração é ignorada**, e o pacote dependente é instalado sem ela. Este é o caso se a dependência não estiver atribuída, o ID estiver incorreto, o utilizador ou dispositivo estiver no seu [Excluir](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-deployment.md#exclude) grupo, estiver atribuída para [Desinstalar](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-deployment.md#uninstall), ou se for filtrada por *Apenas em VDI / Ignorar em VDI*, *Apenas em dispositivos associados em modo híbrido / Ignorar em dispositivos associados em modo híbrido* ou *Ignorar em dispositivos privados*.
* **Uma dependência restrita bloqueia o pacote dependente.** Se uma dependência que ainda não está instalada não tiver permissão para ser executada na fase atual ou para o utilizador atual (*Restrições da aplicação principal*, por exemplo, apenas *Manual* ou apenas o utilizador principal), o agente também não instala o pacote dependente. Atribua às dependências as mesmas restrições ou restrições mais abrangentes do que os pacotes que delas precisam.
* **Instalação em segundo plano** instala apenas pacotes que têm *Permitir instalação em segundo plano* ativado por si próprios. Uma dependência sem esta definição não é instalada nesse tipo de execução; o pacote dependente é. Ative a definição nas dependências dos pacotes que a utilizam.
* **As dependências são resolvidas recursivamente**: uma dependência pode ter as suas próprias dependências. Uma dependência circular (A precisa de B, B precisa de A) é detetada e esse ciclo é ignorado; ambos os pacotes continuam a ser instalados.

#### Ordem de instalação

Antes de cada execução de instalação, o agente cria uma árvore a partir de todos os pacotes atribuídos:

* Cada pacote atribuído está no **nível 0**, as suas dependências no nível 1, as dependências destas no nível 2, e assim por diante.
* Um pacote que aparece em vários níveis, por exemplo, um runtime necessário por várias aplicações, conta no seu **nível mais profundo** apenas e é instalado uma vez.

O agente instala então os pacotes um após o outro: primeiro o nível mais profundo e, dentro de um nível, ordenados por **Ordem** (os mais baixos primeiro, 0 por último). *Ordem* portanto não pode colocar um pacote à frente de pacotes num nível mais profundo. Esta ordenação aplica-se a cada execução de instalação; o seu efeito é mais visível durante a implementação inicial, quando todos os pacotes Obrigatórios são instalados numa única execução. O [RealmJoin ESP](https://docs.realmjoin.com/pt/agente-realmjoin/realmjoin-client/realmjoin-esp.md) usa a mesma sequência.

Exemplo, todos os pacotes atribuídos como Obrigatório:

| Pacote | Ordem | Depende de | Nível |
| ------ | ----- | ---------- | ----- |
| A      | 1     | –          | 0     |
| B      | 101   | C          | 0     |
| C      | 100   | –          | 1     |

A sequência de instalação é **C, A, B**: C está no nível 1 e é instalado antes de todos os pacotes do nível 0, embora o seu número de ordem seja superior ao de A.

#### Atualizações, falhas e desinstalação

* **Atualizações e argumentos alterados:** Sempre que o agente instala o pacote dependente (primeira instalação, [Atualização automática](#expert-settings), alterados [argumentos](#arguments), reinstalação a partir da bandeja), instala primeiro todas as dependências que não estão no seu estado atribuído: não instalada, uma versão mais antiga ou com argumentos alterados. Isto acontece independentemente da própria *Atualização automática* .
* **Dependência com falha:** A execução continua com o pacote seguinte, incluindo o pacote dependente. O agente volta a instalar a dependência com falha numa execução posterior enquanto o pacote dependente ainda tiver de ser instalado, ou se a própria dependência estiver atribuída como Obrigatório. Atribua as dependências como Obrigatório se tiverem de ser novamente tentadas de forma independente.
* **Desinstalação:** As dependências não são consideradas. Desinstalar um pacote deixa as suas dependências instaladas. Uma [Desinstalar](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-deployment.md#uninstall) atribuição numa dependência remove-a da configuração, pelo que os pacotes que dela precisam são instalados sem ela daí em diante.

#### Dependências definidas pelo RealmJoin

* A parte do utilizador de um pacote (*Restrições da parte do utilizador*) depende sempre do seu pacote principal, pelo que o pacote principal é instalado primeiro.
* Se a [RealmJoin Core Choco Extension](https://docs.realmjoin.com/pt/agente-realmjoin/recommended-packages.md#realmjoin-core-choco-extension) estiver atribuída, todos os pacotes Chocolatey dependem dela automaticamente.

#### Resolução de problemas

O agente escreve as operações planeadas de cada execução de instalação em [`tray.log`](https://docs.realmjoin.com/pt/resolucao-de-problemas-e-faq/troubleshooting/package-installation-issues/logfiles-structure.md) como uma tabela *Operações em n pacotes*. Mostra o nível, a ordem, a operação planeada e as restrições de cada pacote: `Dependência` assinala um pacote instalado como dependência, `DependencyRestricted` um pacote bloqueado por uma dependência restrita. Ao nível de registo de rastreio, a árvore de dependências é registada como *A analisar dependências*; os IDs que não estão na configuração aparecem aí como `<id>: Dependência não encontrada!`, dependências circulares como `Dependência recursiva!`.


---

# 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-settings.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.
