> 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/automatizacao/runbooks/runbook-references/org/general/add-primary-users-of-devices-to-group_scheduled.md).
# Adicionar utilizadores principais de dispositivos a um grupo agendado
Manter um grupo sincronizado com os utilizadores principais de dispositivos do Intune
{% hint style="info" %}
Este é um runbook agendado. Ele foi projetado para ser executado em um agendamento recorrente, em vez de ser acionado para um único objeto. Veja [Agendamento](/pt/automatizacao/runbooks/scheduling.md) para obter detalhes sobre como configurar os agendamentos do runbook.
{% endhint %}
### Descrição
Recolhe os utilizadores principais de todos os dispositivos Intune das plataformas escolhidas e mantém um grupo do Entra ID sincronizado com eles. Os utilizadores sem um dispositivo correspondente são removidos, a menos que a remoção esteja desativada. Um grupo de inclusão limita quais utilizadores são elegíveis, um grupo de exclusão bloqueia utilizadores. Um modo apenas de relatório antevê as alterações por e-mail sem aplicar nada.
### Casos de uso comuns
* Manter um grupo de destino de distribuição ou Conditional Access alinhado com "quem atualmente tem um dispositivo gerido", filtrado por plataforma, por um filtro OData avançado ou por um âmbito de grupo de inclusão/exclusão.
* Validar um novo filtro ou âmbito alterado antes de ser autorizado a escrever num grupo de produção.
Recomenda-se um agendamento diário.
### Modo apenas de relatório para pilotos e testes
Ativar `ReportOnly` para calcular a mesma diferença de adição/remoção que uma execução real produziria, sem aplicar qualquer alteração ao grupo. Em vez disso, é enviado para `EmailTo`: cada lista (seriam adicionados, seriam removidos) mostra no máximo 10 utilizadores no corpo do e-mail, com um indicador "... e mais N" quando uma lista é mais longa, e as listas completas são anexadas como ficheiro(s) de relatório no formato escolhido por `ReportFileFormat`. Execute uma vez neste modo após alterar a seleção da plataforma, `AdvancedFilter` ou os grupos de inclusão/exclusão, reveja a pré-visualização e depois desative `ReportOnly` para permitir que a sincronização seja aplicada.
### Interações entre parâmetros
* `AdvancedFilter`, quando definido, substitui totalmente a seleção de plataforma Windows/macOS/iOS/Android em vez de a combinar com ela.
* `RemoveUsersWhenNoDeviceMatch` controla tanto a execução real como a `ReportOnly` pré-visualização: quando desativado, não são removidos utilizadores em nenhum dos casos, por isso a pré-visualização reflete sempre o que uma execução real faria.
### Configuração relativa ao envio de emails
O envio de um relatório por e-mail é opcional e só acontece quando a `ReportOnly` opção está ativada; um destinatário (`EmailTo`) é então necessário. O endereço do remetente é obtido da `RJReport.EmailSender` Tenant.
Este runbook envia emails utilizando a API do Microsoft Graph. Para enviar emails através da Graph API, é necessário configurar um endereço de email existente na personalização do runbook.
Consulte a [documentação das definições de relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obter detalhes sobre todas as definições disponíveis.
#### Branding do email
O email do relatório respeita as definições opcionais de `RJReport.Branding.*` do Tenant:
* **Imagem do cabeçalho e do rodapé** – URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada
* **Ligação no rodapé** – destino da imagem do rodapé
* **Cor de destaque e do texto** – valores hexadecimais de 6 dígitos, por exemplo `#0052cc`
Quando estas definições não estão configuradas, são utilizadas as imagens e cores predefinidas do RealmJoin. Uma imagem que não possa ser transferida ou validada, ou um valor de cor inválido, nunca impede o email do relatório – é utilizada em vez disso a predefinição correspondente.
Instruções de configuração e requisitos da imagem: [Branding do email](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).
### Localização
Organização → Geral → Adicionar utilizadores principais dos dispositivos ao grupo (Agendado)
**Nome completo do Runbook**
rjgit-org\_general\_add-primary-users-of-devices-to-group\_scheduled
### Detalhes
| Propriedade | Valor |
| ------------------- | ---------------------------------------------------------------------------------------- |
| Versão | 1.2.0 |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
|
| Agendável | sim |
### Permissões
#### Permissões da aplicação
* **Tipo**: Microsoft Graph
* DeviceManagementManagedDevices.Read.All
* *Lê os dispositivos geridos do Intune filtrados por SO para recolher o utilizador principal de cada dispositivo*
* Group.Read.All
* *Valida os grupos de destino/inclusão/exclusão e lê as respetivas listas de membros*
* GroupMember.ReadWrite.All
* *Adiciona e remove utilizadores no grupo de destino através de chamadas em lote /groups/{id}/members/$ref*
* User.Read.All
* *Lê o ID do membro e o UPN para identificar membros utilizadores e registar remoções*
### Parâmetros
#### TargetGroupId
Grupo que recebe os utilizadores principais. A sua associação é gerida apenas por este runbook.
| Propriedade | Valor |
| -------------------------- | -------------------- |
| Obrigatório | verdadeiro |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Grupo de destino |
#### Windows
Inclui os utilizadores principais de dispositivos Windows.
| Propriedade | Valor |
| -------------------------- | ----------------------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir dispositivos Windows? |
#### MacOS
Inclui os utilizadores principais de dispositivos macOS.
| Propriedade | Valor |
| -------------------------- | --------------------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir dispositivos macOS? |
#### iOS
Inclui os utilizadores principais de dispositivos iOS e iPadOS.
| Propriedade | Valor |
| -------------------------- | ------------------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir dispositivos iOS? |
#### Android
Inclui os utilizadores principais de dispositivos Android.
| Propriedade | Valor |
| -------------------------- | ----------------------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir dispositivos Android? |
#### AdvancedFilter
Filtro OData para os dispositivos em vez dos seletores de plataforma; por exemplo, startsWith(deviceName,'FWP-') e operatingSystem eq 'Windows'.
| Propriedade | Valor |
| -------------------------- | -------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Filtro personalizado |
#### RemoveUsersWhenNoDeviceMatch
Remove utilizadores do grupo de destino quando já não são o utilizador principal de um dispositivo correspondente. Desative para apenas adicionar.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | Remover utilizadores sem um dispositivo correspondente? |
#### IncludeGroupId
Apenas membros deste grupo podem ser adicionados ao grupo de destino.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Incluir usuários do grupo |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ExcludeGroupId
Os membros deste grupo nunca são adicionados e são removidos, se estiverem presentes.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Excluir usuários do grupo |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ReportOnly
Pré-visualiza as alterações sem as aplicar. A pré-visualização é enviada por e-mail, com os primeiros 10 utilizadores por lista no corpo e as listas completas anexadas.
| Propriedade | Valor |
| -------------------------- | ----------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | Apenas relatório? |
#### EmailFrom
Endereço do remetente do email do relatório. Obtido da definição do Tenant RJReport.EmailSender.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingHeaderImageUrl
Imagem de cabeçalho do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.HeaderImageUrl; é utilizado o cabeçalho predefinido do RealmJoin quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingFooterImageUrl
Imagem de rodapé do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.FooterImageUrl; é utilizado o rodapé predefinido do RealmJoin quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingFooterLink
Ligação por trás da imagem de rodapé do email do relatório. Obtida da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é utilizado quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingAccentColor
Cor de destaque do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.AccentColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingTextColor
Cor do texto do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.TextColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### EmailTo
Endereço para onde vai a pré-visualização. Usado apenas no modo apenas de relatório.
| Propriedade | Valor |
| -------------------------- | ----------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Enviar relatório de pré-visualização para |
#### ReportFileFormat
Anexe as listas completas como CSV, como um livro de trabalho do Excel ou ambos. Usado apenas no modo apenas de relatório.
| Propriedade | Valor |
| -------------------------- | ---------------------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | CSV e XLSX |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Formato do ficheiro do relatório de pré-visualização |
**Opções do portal**
| Opção do portal | Valor |
| --------------- | ----------- |
| CSV e XLSX | CSV e XLSX |
| Apenas CSV | Apenas CSV |
| Apenas XLSX | Apenas XLSX |
[Voltar à visão geral da referência do Runbook](/pt/automatizacao/runbooks/runbook-references.md)
---
# 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/automatizacao/runbooks/runbook-references/org/general/add-primary-users-of-devices-to-group_scheduled.md?ask=&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.