# 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 Automação permite-lhe configurar a implementação automática das versões mais recentes dos pacotes da loja de pacotes para o seu ambiente.

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

{% hint style="info" %}
O Canal de Pré-visualização só avançará para uma versão de software mais recente depois de 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 utilizando o Canal de Pré-visualização não seja acidentalmente invalidado por uma versão de software mais recente 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:

* Automatize apenas **Canal Principal** para software que possa ser atualizado sem testes prévios, como navegadores web de grandes fornecedores.
* Automatize 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 o teste 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évia** 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 de pacotes forem publicadas rapidamente.
* **Implementar à Noite** - Agendar implementação automática durante a noite
* **Selecionar 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 recentemente importados em [Settings](/pt/definicoes-do-realmjoin/settings.md). Configurá-los por pacote irá substituir os valores predefinidos globais.

## Configuração

<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 através do armazenamento dos respetivos endereços de e-mail.

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

### Argumentos

**Argumentos** permitem-lhe passar parâmetros de linha de comandos para a instalação de uma aplicação. Isto é normalmente utilizado 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á automaticamente executado novamente para esse utilizador utilizando a nova configuração.

Se **Atualização automática** não é **DESLIGADO** e o utilizador tiver uma versão mais antiga instalada do que a atualmente atribuída, a nova configuração **irá** será aplicada.\
Se **Atualização automática** não é **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 para atualização de pacotes, 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 esta caixa de diálogo com as seguintes definições na secção de argumentos:

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

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

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

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

### Definições Avançadas

{% hint style="info" %}
Implementação da aplicação RealmJoin necessária.\
Para o conjunto completo de funcionalidades de "Definições avançadas": RealmJoin Agent necessário.
{% 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, assim, substituir a sua 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 da hora, ...).</td><td>Sim</td></tr><tr><td>Permitir instalação em segundo plano</td><td>Executa <strong>atualizações de pacotes diretamente</strong> depois de 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 prévio (sem opção de adiar).<br>Não utilize esta opção para pacotes regulares, pois isto pode interromper os utilizadores quando estiverem a utilizar o software correspondente.</td><td>Sim</td></tr><tr><td>Exigir conformidade</td><td>O pacote é <strong>instalado</strong> assim que RealmJoin consiga verificar que o dispositivo é <strong>considerado "compatível"</strong>. Isto pode interromper a implementação durante algum tempo. A instalação do pacote e de todos os outros pacotes obrigatórios com números de ordem mais altos ficam em fila de espera e só são instalados quando o cliente estiver em conformidade.</td><td>Sim</td></tr><tr><td>Pré-lançamento</td><td>Definição antiga - 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 à existente no dispositivo, 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 (ex.: cliente VPN atualizado através do 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 os pacotes obrigatórios.</p></td><td>Sem</td></tr><tr><td>Apenas em VDI / Ignorar em VDI</td><td>Executar este pacote em <strong>VDIs</strong> (W365 e Azure Virtual Desktop/WVD) apenas em dispositivos ou excluí-los da instalação.</td><td>Sim</td></tr><tr><td>Apenas em dispositivos com associação híbrida / Ignorar em dispositivos com associação híbrida</td><td>Executar este pacote em <strong>dispositivos com associação híbrida</strong> apenas ou excluí-los da instalação.</td><td>Sim</td></tr><tr><td>Ignorar em dispositivos privados</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 bandeja do RealmJoin.</td><td>Sim</td></tr><tr><td>Depende de</td><td><p>Especifica os 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 (por exemplo, marcados como disponíveis).<br>Exemplo: um ambiente de runtime como "Microsoft VC Redistributable Runtime" necessário para um software funcionar.</p><p><br>Introduza o ID do pacote (veja "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 utilizando um valor inteiro. Números mais baixos são executados primeiro (por exemplo, <strong>10</strong> instala antes de <strong>100</strong>).<br>Um valor de <strong>0</strong> significa “sem sequência” e só é executado 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></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 implementação inicial (ou qualquer implementação obrigatória após o 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 fases sobrepõe-se 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 dependendo 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 do utilizador dentro dos 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> a <strong>instalação do pacote</strong> até à data apresentada. Pode escolher 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 mais controlo. Note que a data não é dinâmica (ou seja, não depende da última hora de check-in do cliente).<br><strong>Nota:</strong> A instalação nos dispositivos inclui um mecanismo faseado: as instalações ocorrerão várias vezes por dia com uma probabilidade específica por acionador. Isto assegura uma implementaçã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 a instalação de um 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 RealmJoin), apenas utilizadores secundários ou para ambos.</p><p>Escolha entre as seguintes fases ou combinações das mesmas. O padrão é "Normal, Inicial e Manual".<br></p><p><strong>Início de sessão</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 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>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 no utilizador atual ("utilizador" em vez de "âmbito do sistema").</td><td>Sim</td></tr></tbody></table>

<figure><img src="/files/0788c4a8d9c054c4da02ffae4eac13f824d09c88" alt=""><figcaption><p>Definições Avançadas</p></figcaption></figure>


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.