> 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

Esta página detalha as diferentes definições disponíveis para pacotes implementados

## Automação

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F1Duh3V6W8VZAADCEeeym%2Fimage.png?alt=media&amp;token=124897e6-9769-49f0-a84b-0249fcd7653f" alt=""><figcaption><p>Automação de Pacotes</p></figcaption></figure>

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

* **Automatizar Canal Principal** - Implantar automaticamente novas versões deste pacote para os seus utilizadores. (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 mais recente do software depois de implantar a versão atual em Pré-visualização para o Canal Principal.

Isto é o comportamento pretendido para garantir que um processo de teste/revisão que use o Canal de Pré-visualização não seja invalidado acidentalmente por uma versão mais recente do 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, transferindo 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 da implantação. 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 Loja de Pacotes diretamente para **Pré-visualização** ou **Canal Principal** para ignorar uma versão que não pretende publicar.
{% endhint %}

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

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

## Configuração

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

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

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

Para receber **e-mails de notificação automatizados** de atualizações de pacotes, pode **ativar** o interruptor abaixo também.

### Argumentos

**Argumentos** permitem-lhe passar opções de linha de comando 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 atual 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** estiver **DESATIVADA** 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 **ATIVADA**, 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)

#### Argumentos especiais para pacotes Intunewin

Para pacotes Intunewin, oferecemos uma notificação de interface de utilizador configurável para atualização do pacote que permite ao utilizador interagir com a instalação/atualização de uma aplicação e controlar 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 nenhuma ação do utilizador é executada -> adiamento automático após x segundos (se o adiamento for permitido), 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>

### Definições Avançadas

{% hint style="info" %}
É necessária a implantação da app 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 Agent</th></tr></thead><tbody><tr><td>Permitir reinstalação</td><td>Esta opção permite ao utilizador <strong>reinstalar</strong> e, portanto, substituir a sua instalação atual do <strong>pacote</strong> a qualquer momento.<br>Ex.: adequado para pacotes que ajudam a resolver problemas do cliente através de autosserviço (sincronização de hora, ...).</td><td>Sim</td></tr><tr><td>Permitir instalação em segundo plano</td><td>Executa <strong>atualizações do pacote diretamente</strong> após terem sido detetadas atualizações de configuração no dispositivo correspondente (intervalo de sincronização RJ padrão: 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 isso pode interromper os utilizadores ao usar 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 é <strong>considerado "em conformidade"</strong>. Isto pode interromper a implementação por algum tempo. A instalação do pacote e de todos os outros pacotes obrigatórios com números de ordem superiores são colocadas em fila e só são instaladas quando o cliente estiver em conformidade.</td><td>Sim</td></tr><tr><td>Pré-lançamento</td><td>Definição legada - 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 volta a executar o pacote para o atualizar.</p><p><br>Desative esta opção para pacotes com os seus próprios mecanismos de atualização (p. ex.: cliente VPN atualizado via gateway). Quando desativada, apenas novas instalações em dispositivos recebem a versão atualizada.<br><br><strong>Comportamento por plataforma:</strong></p><p><strong>RealmJoin Agent:</strong> Atualiza os pacotes obrigatórios <em>e</em> disponíveis.<br><strong>Intune:</strong> Atualiza apenas pacotes obrigatórios. Para manter <strong>Disponíveis</strong> atualizadas no Intune, ative o <a href="/pt/gestao-de-aplicacoes/packages/update-group.md">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 apenas em <strong>VDI</strong> (W365 e Azure Virtual Desktop/WVD) ou exclua-os da instalação.</td><td>Sim</td></tr><tr><td>Apenas em dispositivos ligados em modo híbrido / Ignorar em dispositivos ligados em modo híbrido</td><td>Execute este pacote apenas em <strong>dispositivos ligados em modo híbrido</strong> apenas ou exclua-os da instalação.</td><td>Sim</td></tr><tr><td>Ignorar em dispositivos privados</td><td><strong>Excluir dispositivos privados</strong> (não ligados ao Entra ID) da instalação.</td><td>Sim</td></tr><tr><td>Nome do grupo</td><td><strong>Categoria</strong> na qual o pacote aparecerá no menu da bandeja do RealmJoin.</td><td>Sim</td></tr><tr><td>Depende de</td><td><p>Especifica pacotes pré-requisitos 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 (p. ex., marcados como disponíveis).<br>Exemplo: um ambiente de execução como "Microsoft VC Redistributable Runtime" necessário para um software ser executado.</p><p><br>Introduza o ID do pacote (veja o "Unique RJ ID" no portal RJ no pacote pretendido) no seguinte formato:<br><code>["package-id"]</code></p><p>Para vários pacotes:<br><code>["package-id1","package-id2"]</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 executam primeiro (p. ex., <strong>10</strong> instala antes de <strong>100</strong>).<br>Um valor de <strong>0</strong> significa “sem sequência” e é executado apenas depois de todos os pacotes numerados.<br>Os números de ordem são aplicados <strong>apenas durante a implementação inicial do cliente</strong>.</td><td>Sim</td></tr><tr><td>Cascata de prioridade</td><td>Apenas pacotes geridos. Decide que atribuição vence quando um utilizador ou dispositivo corresponde simultaneamente ao grupo Principal e ao grupo Disponível deste pacote:<br><strong>Usar predefinição do Tenant</strong> (recomendado) - segue a opção em todo o Tenant em Definições > Geral > Configuração da App.<br><strong>Cascata gerida</strong> - Disponível vence sobre Principal (desinstalar > atualizar > pré-visualização > disponível > obrigatório).<br><strong>Cascata clássica</strong> - Principal vence sobre Disponível (desinstalar > atualizar > pré-visualização > obrigatório > disponível).<br>Ver <a href="/pt/gestao-de-aplicacoes/packages/package-deployment.md#managed-and-classic-priority-cascade">Cascata de prioridade</a> para detalhes.</td><td>Sim</td></tr><tr><td></td><td><p><strong>Não usar </strong><em><strong>Dependência</strong></em><strong> e </strong><em><strong>Ordem</strong></em><strong> no mesmo pacote.</strong><br>Durante a implementação inicial (ou qualquer implementação obrigatória após início de sessão), o RealmJoin instala primeiro todos os pacotes de dependência e depois instala os pacotes originais. Este processo em duas etapas 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 estiverem atribuídos como obrigatórios, a sequência de instalação será C, A, B</li></ul><p>As definições de utilizador dentro de pacotes de aplicação 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á armazenada como valor fixo. Os utilizadores podem adiar até essa data. Depois disso, a instalação será simplesmente executada sem controlo adicional. Note que a data não é dinâmica (ou seja, não depende da última hora de verificação do cliente).<br><strong>Nota:</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 implementação mais suave e utiliza eficazmente as funcionalidades BC/DO.</td><td>Sim</td></tr><tr><td>Restrições principais da app</td><td><p>Esta opção permite definir <strong>quem</strong> pode executar uma instalação de pacote e <strong>quando</strong> isso 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 do RealmJoin), apenas para utilizadores secundários ou para ambos.</p><p>Escolha entre as seguintes fases ou combinações das mesmas. O padrão é "Normal, Initial &#x26; Manual".<br></p><p><strong>Início de sessão</strong>: O pacote é executado depois de o utilizador ter iniciado sessão.</p><p><strong>Manual</strong>: O pacote será executado quando o utilizador iniciar manualmente a instalação através do menu da bandeja.</p><p><strong>Inicial</strong>: O pacote só é executado durante a implementação inicial do cliente.</p><p><strong>Normal</strong>: Nem 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 disponível para o pacote correspondente). Ex.: contém definições ou scripts executados sob o utilizador atual ("utilizador" em vez de "âmbito do sistema").</td><td>Sim</td></tr></tbody></table>

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


---

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