> 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/administracao-e-definicoes/general.md).

# Geral

Definições gerais do RealmJoin, incluindo a sincronização do runbook, opções da interface do portal, como o logótipo do banner do Tenant, predefinições de automação de pacotes e notificações de atualização.

## Sincronização de runbooks

Se você configurar [Automação de processos / runbooks](https://docs.realmjoin.com/pt/automatizacao/runbooks.md) no seu ambiente, você pode clicar em "Sincronizar runbooks..." para atualizar seus runbooks a partir do repositório público do RealmJoin.

![](https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fz5nf9NPVzlUnzXuT1QMv%2Fimage.png?alt=media\&token=dea2e8b6-3dff-4717-85a6-b2a00a8427ba)

Isso garantirá que você tenha o estado atual dos nossos runbooks, incluindo correções de bugs e novas funcionalidades. Se necessário, isso também instalará os módulos do PowerShell necessários na sua conta do Azure Automation.

## Configuração da UI

O *Configuração da UI* o cartão contém as configurações de exibição em todo o Tenant do RealmJoin Portal. Elas se aplicam a todos os usuários do tenant. Alterá-las requer o `CanChangeTenantSettings` permissão.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-242c2d507c04888db275b97e1b20a5952863bc03%2Fsettings-general-ui-config.png?alt=media" alt="UI Config card"><figcaption><p>cartão de Configuração da UI</p></figcaption></figure>

### Mostrar informações avançadas

Desativado por padrão. Quando ativado, as páginas de detalhes mostram os dados brutos [fontes de dados](https://docs.realmjoin.com/pt/ugd-management/user-group-device-management.md#data-sources) como JSON, como ícones ou abas à direita da barra de abas:

| Página de detalhes                                                                      | Visualizações de dados brutos                                                            |
| --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| [Dispositivo](https://docs.realmjoin.com/pt/ugd-management/user-list/device-details.md) | Dados do Entra ID, dados do Intune, dados do Autopilot, dados do MDE, dados do RealmJoin |
| [User](https://docs.realmjoin.com/pt/ugd-management/user-list/user-details.md)          | Dados do Entra ID, dados de início de sessão, dados do RealmJoin                         |
| [Grupo](https://docs.realmjoin.com/pt/ugd-management/user-list/group-details.md)        | Dados do Entra ID, RealmJoin                                                             |
| Pacote                                                                                  | JSON do app do Intune, app do RealmJoin e da entrada do Package Store                    |
| [Organização](https://docs.realmjoin.com/pt/ugd-management/organization-details.md)     | Dados do Entra ID                                                                        |

As abas são mostradas apenas aos usuários com a **Admin**, **Auditor** ou **Advanced Supporter** função e aos Administradores Globais do Entra ID. As permissões subjacentes são as `CanSee...Json` permissões e `CanSeeUserSignIns`, consulte [Permissões Disponíveis](https://docs.realmjoin.com/pt/administracao-e-definicoes/permission/custom-roles/available-permissions.md).

### logotipo de banner do Tenant

O RealmJoin Portal pode exibir o logotipo da sua empresa na barra de ferramentas no topo de cada página e na [Detalhes da organização](https://docs.realmjoin.com/pt/ugd-management/organization-details.md) página. Escolha onde o logotipo aparece:

| Opção                                        | Barra de ferramentas | Página da organização |
| -------------------------------------------- | -------------------- | --------------------- |
| Barra de ferramentas + página da organização | ✓                    | ✓                     |
| Apenas barra de ferramentas                  | ✓                    | –                     |
| Apenas página da organização                 | –                    | ✓                     |
| Apenas barra de ferramentas, fundo branco    | ✓                    | –                     |
| Ambos, fundo branco                          | ✓                    | ✓                     |
| Sem banner                                   | –                    | –                     |

*Barra de ferramentas + página da organização* é o padrão. A barra de ferramentas tem fundo escuro. As duas *fundo branco* opções exibem o logotipo na barra de ferramentas sobre um fundo branco, para logotipos que não são legíveis em fundos escuros. Na página Detalhes da organização, o logotipo é sempre mostrado sem fundo.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-737a418cfb267aa4e7b1c12557aa36bbef72410e%2Fsettings-general-banner-logo-both.png?alt=media" alt="Toolbar + Organization page: logo in the toolbar and on the Organization Details page"><figcaption><p>Barra de ferramentas + página da organização: logotipo na barra de ferramentas e na página Detalhes da organização</p></figcaption></figure>

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-3b67dfc5d1fcb999a3c8c38e0a2114b8f110c632%2Fsettings-general-banner-logo-toolbar-white.png?alt=media" alt="Toolbar only, white backdrop: logo only in the toolbar, on a white background"><figcaption><p>Apenas barra de ferramentas, fundo branco: logotipo apenas na barra de ferramentas, sobre um fundo branco</p></figcaption></figure>

O logotipo é o **logotipo de banner** da experiência de início de sessão padrão na [identidade visual da empresa do Entra ID do seu Tenant](https://learn.microsoft.com/en-us/entra/fundamentals/how-to-customize-branding). O RealmJoin Portal o lê do Graph (`GET /organization/{tenantId}/branding/localizations/default/bannerLogo`) e não armazena uma cópia. Os logotipos de banner das localizações específicas de idioma não são usados. Para alterar o logotipo, carregue um novo logotipo de banner no centro de administração do Entra em **Identidade visual da empresa**.

{% hint style="info" %}
Se a experiência de início de sessão padrão não tiver um logotipo de banner, nenhum logotipo será mostrado e as pré-visualizações no cartão mostrarão um espaço reservado. O RealmJoin Portal armazena em cache o logotipo por uma hora, então um logotipo de banner alterado pode levar até uma hora para aparecer.
{% endhint %}

## Padrões de Automação de Pacotes

Se você obtiver pacotes do [Package Store](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-store.md), você pode usar [automação ](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-updates.md#automation)para manter esses pacotes sempre atualizados.

![Padrões de automação para um pacote](https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FDhQHQdSFB6xbPZkJQyB6%2Fimage.png?alt=media\&token=18b9fc66-40e2-427e-b4a3-bf56658b8dc4)

As configurações são:

* **AutoDeployMain** - Implantar automaticamente novas versões deste pacote para seus usuários. (assinatura "Main")
* **AutoDeployMainDeferInDays** - Aguarde este número de dias antes de publicar uma nova versão em "main". Isso é útil para evitar sobrecarga para usuários/clientes se várias versões do pacote forem publicadas rapidamente.
* **AutoDeployPreview** - Implantar automaticamente novas versões deste pacote para seus usuários-piloto. (assinatura "Preview")
* **AutoDeployPreviewDeferInDays** - Aguarde este número de dias antes de publicar uma nova versão em "preview".
* **AutoDeployAtNight** - Agendar implantação automática durante a noite
* **Selecione o fuso horário de destino** - Se você usar AutoDeployAtNight, use este fuso horário para indicar quando é "durante a noite".

Consulte [Atualizações de pacotes e automação](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-updates.md#automation) para mais informações sobre Automação de Pacotes.

## Esquema de nomenclatura de grupos

O RealmJoin Portal pode criar e gerenciar dinamicamente grupos do Entra para recursos como [atribuição de pacotes](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-deployment.md) e [atribuição de scripts de remediação](https://docs.realmjoin.com/pt/automatizacao/remediation-scripts.md#assignment).

### Implantação de apps / pacotes

O RealmJoin pode criar grupos de atribuição para pacotes do Intune e do cliente RealmJoin. Use isso para definir o padrão de nomenclatura dos grupos.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FY83K9kHGg76D0xOvTzLH%2Fimage.png?alt=media&amp;token=9b472c6c-7d3a-4978-a5ca-ba3b797f5db9" alt=""><figcaption><p>Esquema de nomenclatura de grupos de implantação de pacotes</p></figcaption></figure>

Você pode usar as seguintes variáveis:

* **$vendor** - Nome do fornecedor do software (se disponível)
* **$product** - Nome do título do software
* **$appName** - Nome completo (fornecedor e produto) do software
* **$version** - Versão do pacote
* **$platform** - Plataforma do pacote: `Win`, `macOS` ou `Android`
* **$modifier** - nada, "available", "preview", "uninstall" ou "update"
* **$groupName** - (apenas na descrição) Nome do Grupo Gerenciado

Se nenhum modelo estiver definido, o RealmJoin usa `app - $platform - $appName ($modifier)`. Os parênteses vazios são removidos, então o grupo Main não tem sufixo.

### Scripts de remediação

Se usar [scripts de remediação do Managed Intune gerenciados pelo RealmJoin](https://docs.realmjoin.com/pt/automatizacao/remediation-scripts.md#managed-scripts), você pode definir o esquema de nomenclatura para [Grupos Gerenciados](https://docs.realmjoin.com/pt/automatizacao/remediation-scripts.md#managed-groups).

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FMvpEkzqw9qkw3hLOGzSV%2Fimage.png?alt=media&amp;token=6899800d-9227-4147-bc2f-44846a1ef399" alt=""><figcaption><p>Esquema de nomenclatura de grupos de scripts de remediação</p></figcaption></figure>

Você pode usar as seguintes variáveis:

* **$healthScriptName** - Nome do Script de Remediação Gerenciado
* **$modifier** - "incluído" ou "excluído" (Atribuição vs. Exceção)
* **$groupName** - (apenas na descrição) Nome do Grupo Gerenciado

## Notificações adicionais de atualização

Para pacotes obtidos do [Package Store](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-store.md), o backend do RealmJoin compara regularmente as versões implantadas com o Package Store e envia um e-mail por pacote quando seu status muda:

* **Nova versão disponível** - uma versão mais recente do pacote foi publicada no Package Store.
* **Implantação manual** - uma ação de atualização (atualizar Main, atualizar Preview, criar Preview ou mover Preview para Main) está disponível e precisa ser acionada manualmente.
* **Implantação planejada** - [automação de pacotes](#package-automation-defaults) agendou uma ação de atualização. O e-mail contém a ação e o horário agendado.

O campo **Enviar notificações adicionais de atualização para …** no *Configuração do app* o cartão usa endereços de e-mail que recebem esses e-mails para **cada** pacote no Tenant. Separe vários endereços com ponto e vírgula, por exemplo `foo@example.com; bar@example.com`.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-e20e53bbeb10037a3a25adc72590f81b342f3282%2Fsettings-general-app-config.png?alt=media" alt="App Config card with an additional update notification recipient"><figcaption><p>cartão de Configuração do app com um destinatário adicional de notificação de atualização</p></figcaption></figure>

Isto complementa os [Proprietários Técnicos da Aplicação](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-settings.md#technical-application-owners) (TAO) de um pacote:

* **Proprietários Técnicos da Aplicação** são definidos por pacote e recebem notificações apenas para esse pacote, e somente se as notificações estiverem ativadas na Config do pacote.
* **Destinatários adicionais de notificações de atualização** são definidos em todo o Tenant e recebem as notificações de todos os pacotes, independentemente das configurações de TAO.

{% hint style="info" %}
Endereços de e-mail inválidos são descartados sem erro ao salvar, então verifique o campo após salvar. Os endereços são armazenados como uma matriz JSON com comprimento máximo de 200 caracteres. Para mais destinatários, use uma lista de distribuição.
{% endhint %}

## Cascata de prioridade de aplicações geridas

O *Configuração do app* o cartão também contém o interruptor em todo o Tenant **Cascata de prioridade clássica para aplicações geridas**. Ele decide qual atribuição vence quando um usuário ou dispositivo é membro tanto do grupo Main (Obrigatório) quanto do grupo Available de um pacote gerenciado:

* **Desativado** (padrão) - cascata gerenciada: Available vence sobre Main (uninstall > update > preview > available > mandatory).
* **Ativada** - cascata clássica: Main vence sobre Available (uninstall > update > preview > mandatory > available).

Alterar o interruptor solicita confirmação e entra em vigor imediatamente para cada usuário e para cada pacote gerenciado que não tenha substituição por pacote. Pacotes individuais podem divergir do padrão do Tenant por meio da *definição de cascata de prioridade* configuração em seus [Definições de Especialista](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-settings.md#expert-settings).

Consulte [Prioridade e conflitos das atribuições](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-deployment.md#assignment-priority-and-conflicts) para a ordem completa de avaliação, incluindo Excluir e Desinstalar.

## Configuração do cliente

Com esta configuração do Tenant, você pode configurar o intervalo de tempo em que o Agente do RealmJoin detecta o usuário primário.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FPSwOyylVON6zGTUDF43f%2Fimage.png?alt=media&amp;token=b2d22859-0757-4b6f-b66f-ee6174609234" alt=""><figcaption></figcaption></figure>

## Configuração do LAPS

Com esta configuração do Tenant, você pode configurar o tempo de expiração da Conta de Suporte LAPS do RealmJoin.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FTYWiDOwpfJm9YhoVz3dT%2Fimage.png?alt=media&amp;token=88d25d9d-f4e2-404d-83c6-f1087b8962d8" alt=""><figcaption></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 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/administracao-e-definicoes/general.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.
