> 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

## Automação

<figure><img src="/files/020cff1108f3beada27eb260660fc92e70fb21ed" alt=""><figcaption><p>Automação de Pacotes</p></figcaption></figure>

Para pacotes geridos, o separador Automatização permite configurar a implementação automática das versões mais recentes do pacote a partir da loja de pacotes para o seu ambiente.

* **Automatizar Canal Principal** - Implantar automaticamente novas versões deste pacote para os seus usuários. (subscrição "Main")
* **Automatizar Canal de Pré-visualização** - Implantar automaticamente novas versões deste pacote para os seus utilizadores-piloto. (subscrição "Preview")

{% hint style="info" %}
O Canal de Pré-visualização só avançará para uma versão de software mais recente após implementar a versão atual em Pré-visualização no Canal Principal.

Este é o comportamento pretendido para garantir que um processo de teste/revisão que usa o Canal de Pré-visualização não seja invalidado acidentalmente por uma nova versão de software entrar em Pré-visualização.
{% endhint %}

O Canal de Pré-visualização irá obter a versão mais recente disponível na App Store, enviando a sua versão atual para o Canal Principal.

{% hint style="success" %}
Recomendação:

* Automatizar apenas **Canal Principal** para software que pode ser atualizado sem testes prévios, como navegadores web de grandes fornecedores.
* Automatizar apenas **Canal de Pré-visualização** para software que pretende testar antes de implementar. Envie a versão validada para o Canal Principal após os testes e comece a testar a próxima versão em Pré-visualização.

Pode sempre enviar manualmente uma versão mais recente disponível na Package Store diretamente para **Pré-visualização** ou **Canal Principal** para saltar uma versão que não quer publicar.
{% endhint %}

* **... adiar X dias** - Aguarde este número de dias antes de publicar uma nova versão no canal. Isto é útil para evitar stress para utilizadores/clientes se várias versões do pacote forem publicadas rapidamente.
* **Implementar à noite** - Agendar a implementação automática durante a noite
* **Selecione o fuso horário de destino** - Se utilizar **Implementar à noite**, utilize este fuso horário para indicar quando é "à noite".

Estes valores podem ser pré-configurados globalmente para pacotes recém-importados em [Configurações](/pt/administracao-e-definicoes/settings.md). Configurá-los por pacote irá substituir os valores predefinidos globais.

## Config

<figure><img src="/files/83a569e24433fcb43b660c93bf48927d7946ba91" alt=""><figcaption><p>Configuração do Pacote</p></figcaption></figure>

### Proprietários Técnicos da Aplicação

Se desejar, pode atribuir vários **Proprietários Técnicos da Aplicação** (TAO) a um pacote, guardando os respetivos endereços de e-mail.

Para receber **e-mails de notificação automáticos** sobre atualizações de pacotes, pode **ativar** o seletor abaixo, adicionalmente.

### Argumentos

**Argumentos** permitem passar parâmetros de linha de comandos para uma instalação de 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 atualmente subscrita 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** é **DESLIGADO** e o utilizador tiver instalada uma versão mais antiga do que a atualmente atribuída, a nova configuração será **não** aplicada.\
Se **Atualização automática** é **LIGADO**, 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](/files/acc60ec35f6a70f667fece35b30f998f11a28e72)

#### Argumentos especiais para pacotes Intunewin

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

<figure><img src="/files/6125d3d04a89d93c1266ba6a2927d91cf1f06b16" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="/files/f2e54a32f0d579f3f6a092a978bdbf45473bbcf3" alt=""><figcaption></figcaption></figure>

### Definições de Especialista

{% hint style="info" %}
É necessária a implementação da App do RealmJoin.\
Para o conjunto completo de funcionalidades de "Definições avançadas": é necessário o RealmJoin Agent.
{% endhint %}

<table><thead><tr><th width="154">Definição</th><th width="478">Explicação</th><th>Apenas agente</th></tr></thead><tbody><tr><td>Permitir reinstalação</td><td>Esta opção permite ao utilizador <strong>reinstalar</strong> e, por conseguinte, substituir a instalação atual do <strong>pacote</strong> a qualquer momento.<br>Ex.: adequado para pacotes que ajudam a corrigir problemas do cliente através de self-service (sincronização de hora, ...).</td><td>Sim</td></tr><tr><td>Permitir instalação em segundo plano</td><td>Executa <strong>atualizações de pacotes diretamente</strong> após terem sido detetadas atualizações de configuração no dispositivo correspondente (intervalo de sincronização RJ standard: 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 correspondente.</td><td>Sim</td></tr><tr><td>Exigir conformidade</td><td>O pacote é <strong>instalado</strong> assim que o RealmJoin conseguir verificar que o dispositivo está <strong>considerado "conforme"</strong>. Isto pode interromper a distribuição durante algum tempo. A instalação do pacote e de todos os outros pacotes obrigatórios com números de ordem superiores ficam em fila de espera e só são instalados quando o cliente estiver conforme.</td><td>Sim</td></tr><tr><td>Pré-lançamento</td><td>Definição herdada - ver <a href="https://docs-classic.realmjoin.com/rj-portal/software-packages">RealmJoin Classic</a>.</td><td>Sim</td></tr><tr><td>Atualização automática</td><td><p><strong>Atualiza automaticamente</strong> um pacote quando uma <strong>versão mais recente</strong> fica disponível. Se a versão subscrita for superior à que está no dispositivo, o RealmJoin executa novamente o pacote para o atualizar.</p><p><br>Desative esta opção para pacotes com os seus próprios mecanismos de atualização (por exemplo: cliente VPN atualizado via gateway). Quando desativada, apenas as novas instalações em dispositivos recebem a versão atualizada.<br><br><strong>Comportamento por plataforma:</strong></p><p><strong>RealmJoin Agent:</strong> Atualizações obrigatórias <em>e</em> pacotes disponíveis.<br><strong>Intune:</strong> Atualiza apenas pacotes obrigatórios. Para manter <strong>Disponíveis</strong> as aplicações atualizadas no Intune, ative o <a href="/pages/9f066747e7e879fb83c5830cc6c792ee9098e798">Grupo de Atualização</a>.</p></td><td>Não</td></tr><tr><td>Apenas em VDI / Ignorar em VDI</td><td>Execute este pacote em <strong>VDIs</strong> (W365 e Azure Virtual Desktop/WVD) apenas em dispositivos ou exclua-os da instalação.</td><td>Sim</td></tr><tr><td>Apenas em dispositivos híbridos associados / Ignorar em dispositivos híbridos associados</td><td>Execute este pacote em <strong>dispositivos híbridos associados</strong> apenas ou exclua-os da instalação.</td><td>Sim</td></tr><tr><td>Ignorar em dispositivos pessoais</td><td><strong>Excluir dispositivos</strong> privados (não associados ao Entra ID) da instalação.</td><td>Sim</td></tr><tr><td>Nome do grupo</td><td><strong>Categoria</strong> em que o pacote aparecerá no menu da área de notificação do RealmJoin.</td><td>Sim</td></tr><tr><td>Depende de</td><td><p>Especifica pacotes pré-requisito que têm de ser instalados antes deste pacote. O RealmJoin instala primeiro todas as dependências listadas. Certifique-se de que os pacotes dependentes também estão atribuídos (por exemplo, marcados como disponíveis).<br>Exemplo: um ambiente de execução como "Microsoft VC Redistributable Runtime" necessário para um software funcionar.</p><p><br>Introduza o ID do pacote (consulte no portal RJ o "Unique RJ ID" no pacote pretendido) no seguinte formato:<br><code>["id-do-pacote"]</code></p><p>Para vários pacotes:<br><code>["id-do-pacote1","id-do-pacote2"]</code></p><p>Exemplo:<br><code>["generic-microsoft-vcredist-2019","generic-microsoft-net-core-desktop-runtime-6"]</code></p></td><td>Sim</td></tr><tr><td>Ordem</td><td>Define a sequência de instalação usando um valor inteiro. Números mais baixos são executados primeiro (por exemplo, <strong>10</strong> é instalado antes de <strong>100</strong>).<br>Um valor de <strong>0</strong> significa "sem sequência" e é executado apenas após todos os pacotes numerados.<br>Os números de ordem são aplicados <strong>apenas durante a distribuição inicial ao cliente</strong>.</td><td>Sim</td></tr><tr><td></td><td><p><strong>Não utilize </strong><em><strong>Dependência</strong></em><strong> e </strong><em><strong>Ordem</strong></em><strong> no mesmo pacote.</strong><br>Durante a distribuição inicial (ou qualquer distribuição obrigatória após o início de sessão), o RealmJoin instala primeiro todos os pacotes de dependências e depois instala os pacotes originais. Este processo em duas fases substitui e pode anular quaisquer números de ordem definidos.</p><p><strong>Por exemplo:</strong></p><ul><li>Pacote A, ordem 1</li><li>Pacote B, ordem 101 e dependente do Pacote C, ordem 100.</li><li>Se todos os pacotes forem atribuídos como obrigatórios, a sequência de instalação será C, A, B</li></ul><p>As definições do utilizador dentro dos pacotes de aplicações são tratadas como uma dependência definida.</p></td><td></td></tr><tr><td>Taxa de implementação</td><td>Selecione a taxa de implementação que <strong>permite ou bloqueia</strong> os utilizadores de <strong>adiar</strong> o pacote <strong>instalação</strong> até à data apresentada. Tem a escolha entre "Lento" (+7), "Rápido" (+3) e "Amanhã" (+1).<br>Exemplo: ao escolher "Amanhã", a data atual + um dia será guardada como valor fixo. Os utilizadores podem adiar até essa data. Depois disso, a instalação será simplesmente executada sem mais controlo. Note que a data não é dinâmica (ou seja, não depende da última hora de verificação do cliente).<br><strong>Observação:</strong> A instalação em dispositivos inclui um mecanismo faseado: as instalações ocorrerão várias vezes por dia com uma probabilidade específica por acionamento. Isto garante uma distribuição mais suave e utiliza eficazmente as funcionalidades BC/DO.</td><td>Sim</td></tr><tr><td>Restrições da aplicação principal</td><td><p>Esta opção permite definir <strong>quem</strong> pode executar uma instalação de pacote e <strong>quando</strong> isso irá acontecer (<strong>fase</strong>).</p><p>Defina se este pacote deve ser executado apenas para o utilizador principal de um dispositivo (visível e alterável no portal RealmJoin), apenas para utilizadores secundários ou para ambos.</p><p>Escolha entre as seguintes fases ou combinações delas. O valor predefinido é "Normal, Inicial e Manual".<br></p><p><strong>Logon</strong>: O pacote é executado depois de o utilizador iniciar sessão.</p><p><strong>Manual</strong>: O pacote será executado quando o utilizador iniciar a instalação manualmente através do menu da área de notificação.</p><p><strong>Inicial</strong>: O pacote só é executado durante a implementação inicial do cliente.</p><p><strong>Normal</strong>: Nem no início de sessão, nem Manual, nem Inicial. Implementação durante a utilização normal de um cliente.</p></td><td>Sim</td></tr><tr><td>Restrições da parte do utilizador</td><td>As mesmas opções de antes - mas para a parte do utilizador (se estiver disponível para o pacote correspondente). Ex.: contém definições ou scripts executados sob o utilizador atual ("user" em vez de "system scope").</td><td>Sim</td></tr></tbody></table>

<figure><img src="/files/0788c4a8d9c054c4da02ffae4eac13f824d09c88" alt=""><figcaption><p>Definições de Especialista</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-settings.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.