> 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/es/automatizacion/runbooks/runbook-references/org/general/add-primary-users-of-devices-to-group_scheduled.md).

# Agregar los usuarios principales de los dispositivos al grupo programado

Mantener un grupo sincronizado con los usuarios principales de los dispositivos de Intune

{% hint style="info" %}
Este es un runbook programado. Está diseñado para ejecutarse con una programación recurrente en lugar de activarse para un único objeto. Consulte [Programación](https://docs.realmjoin.com/es/automatizacion/runbooks/scheduling.md) para obtener detalles sobre cómo configurar las programaciones del runbook.
{% endhint %}

### Descripción

Recopila los usuarios principales de todos los dispositivos de Intune de las plataformas elegidas y mantiene sincronizado con ellos un grupo de Entra ID. Los usuarios sin un dispositivo coincidente se eliminan, a menos que la eliminación esté desactivada. Un grupo de inclusión limita qué usuarios son elegibles, un grupo de exclusión bloquea usuarios. Un modo solo de informe previsualiza los cambios por correo electrónico sin aplicar nada.

### Casos de uso comunes

* Mantener un grupo de distribución o de destino de Conditional Access alineado con «quién tiene actualmente un dispositivo administrado», filtrado por plataforma, por un filtro OData avanzado o por un ámbito de grupo de inclusión/exclusión.
* Validar un filtro o ámbito nuevo o modificado antes de que se permita escribir en un grupo de producción.

Se recomienda una programación diaria.

### Modo solo de informe para pilotos y pruebas

Activar `ReportOnly` para calcular la misma diferencia de alta/baja que produciría una ejecución real, sin aplicar ningún cambio al grupo. En su lugar, se envía a `EmailTo`: cada lista (se añadirían, se eliminarían) muestra como máximo 10 usuarios en el cuerpo del correo, con un indicador de «... y N más» cuando una lista es más larga, y las listas completas se adjuntan como archivo(s) de informe en el formato elegido por `ReportFileFormat`. Ejecútelo una vez en este modo después de cambiar la selección de plataforma, `AdvancedFilter` o los grupos de inclusión/exclusión, revise la vista previa y luego desactive `ReportOnly` para permitir que se aplique la sincronización.

### Interacciones de parámetros

* `AdvancedFilter`, cuando se establece, reemplaza por completo la selección de plataforma Windows/macOS/iOS/Android en lugar de combinarse con ella.
* `RemoveUsersWhenNoDeviceMatch` controla tanto la ejecución real como la `ReportOnly` vista previa: cuando está desactivado, no se elimina a ningún usuario en ninguno de los casos, por lo que la vista previa siempre refleja lo que haría una ejecución real.

### Configuración relativa al envío de correos electrónicos

El envío de un informe por correo electrónico es opcional y solo ocurre cuando la `ReportOnly` la opción está habilitada; un destinatario (`EmailTo`) entonces. La dirección del remitente se toma de la `RJReport.EmailSender` de Tenant.

Este runbook envía correos electrónicos mediante la API de Microsoft Graph. Para enviar correos mediante Graph API, debes configurar una dirección de correo electrónico existente en la personalización del runbook.

Consulta la [documentación de configuración de informes de RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para conocer todos los ajustes disponibles.

#### Marca del correo electrónico

El correo electrónico del informe respeta las `RJReport.Branding.*` configuraciones opcionales de Tenant:

* **Imagen de cabecera y pie de página** – URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada una
* **Enlace del pie de página** – destino de la imagen del pie de página
* **Color de acento y de texto** – valores hexadecimales de 6 dígitos, p. ej. `#0052cc`

Cuando estas configuraciones no están definidas, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen que no se puede descargar o validar, o un valor de color no válido, nunca impide el correo electrónico del informe; en su lugar se usa el valor predeterminado correspondiente.

Instrucciones de configuración y requisitos de imagen: [Marca del correo electrónico](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Ubicación

Organización → General → Agregar usuarios principales de dispositivos al grupo (programado)

**Nombre completo del runbook**

rjgit-org\_general\_add-primary-users-of-devices-to-group\_scheduled

### Detalles

| Propiedad          | Valor                                                                                    |
| ------------------ | ---------------------------------------------------------------------------------------- |
| Versión            | 1.2.0                                                                                    |
| Módulos requeridos | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| Programable        | sí                                                                                       |

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *Lee los dispositivos administrados de Intune filtrados por sistema operativo para recopilar el usuario principal de cada dispositivo*
  * Group.Read.All
    * *Valida los grupos de destino/inclusión/exclusión y lee sus listas de miembros*
  * GroupMember.ReadWrite.All
    * *Agrega y elimina usuarios en el grupo de destino mediante llamadas por lotes a /groups/{id}/members/$ref*
  * User.Read.All
    * *Lee el id de miembro y el UPN para identificar a los miembros de usuario y registrar las eliminaciones*

### Parámetros

#### TargetGroupId

Grupo que recibe a los usuarios principales. Su pertenencia es administrada solo por este runbook.

| Propiedad                        | Valor            |
| -------------------------------- | ---------------- |
| Obligatorio                      | true             |
| Valor predeterminado             |                  |
| Tipo                             | Cadena           |
| Nombre para mostrar en el portal | Grupo de destino |

#### Windows

Incluye a los usuarios principales de dispositivos Windows.

| Propiedad                        | Valor                          |
| -------------------------------- | ------------------------------ |
| Obligatorio                      | falso                          |
| Valor predeterminado             | Falso                          |
| Tipo                             | Booleano                       |
| Nombre para mostrar en el portal | ¿Incluir dispositivos Windows? |

#### macOS

Incluye a los usuarios principales de dispositivos macOS.

| Propiedad                        | Valor                        |
| -------------------------------- | ---------------------------- |
| Obligatorio                      | falso                        |
| Valor predeterminado             | Falso                        |
| Tipo                             | Booleano                     |
| Nombre para mostrar en el portal | ¿Incluir dispositivos macOS? |

#### iOS

Incluye a los usuarios principales de dispositivos iOS y iPadOS.

| Propiedad                        | Valor                      |
| -------------------------------- | -------------------------- |
| Obligatorio                      | falso                      |
| Valor predeterminado             | Falso                      |
| Tipo                             | Booleano                   |
| Nombre para mostrar en el portal | ¿Incluir dispositivos iOS? |

#### Android

Incluye a los usuarios principales de dispositivos Android.

| Propiedad                        | Valor                          |
| -------------------------------- | ------------------------------ |
| Obligatorio                      | falso                          |
| Valor predeterminado             | Falso                          |
| Tipo                             | Booleano                       |
| Nombre para mostrar en el portal | ¿Incluir dispositivos Android? |

#### AdvancedFilter

Filtro OData para los dispositivos en lugar de los conmutadores de plataforma, por ejemplo startsWith(deviceName,'FWP-') y operatingSystem eq 'Windows'.

| Propiedad                        | Valor                |
| -------------------------------- | -------------------- |
| Obligatorio                      | falso                |
| Valor predeterminado             |                      |
| Tipo                             | Cadena               |
| Nombre para mostrar en el portal | Filtro personalizado |

#### RemoveUsersWhenNoDeviceMatch

Elimina usuarios del grupo de destino cuando ya no son el usuario principal de un dispositivo coincidente. Desactívelo para añadir solo.

| Propiedad                        | Valor                                              |
| -------------------------------- | -------------------------------------------------- |
| Obligatorio                      | falso                                              |
| Valor predeterminado             | Verdadero                                          |
| Tipo                             | Booleano                                           |
| Nombre para mostrar en el portal | ¿Eliminar usuarios sin un dispositivo coincidente? |

#### IncludeGroupId

Solo los miembros de este grupo pueden agregarse al grupo de destino.

| Propiedad                        | Valor                                                       |
| -------------------------------- | ----------------------------------------------------------- |
| Obligatorio                      | falso                                                       |
| Valor predeterminado             |                                                             |
| Tipo                             | Cadena                                                      |
| Nombre para mostrar en el portal | Incluir usuarios del grupo                                  |
| Oculto en el portal              | sí (preestablecido mediante la personalización del runbook) |

#### ExcludeGroupId

Los miembros de este grupo nunca se agregan y se eliminan si están presentes.

| Propiedad                        | Valor                                                       |
| -------------------------------- | ----------------------------------------------------------- |
| Obligatorio                      | falso                                                       |
| Valor predeterminado             |                                                             |
| Tipo                             | Cadena                                                      |
| Nombre para mostrar en el portal | Excluir usuarios del grupo                                  |
| Oculto en el portal              | sí (preestablecido mediante la personalización del runbook) |

#### ReportOnly

Previsualiza los cambios sin aplicarlos. La vista previa se envía por correo electrónico, con los primeros 10 usuarios por lista en el cuerpo y las listas completas adjuntas.

| Propiedad                        | Valor          |
| -------------------------------- | -------------- |
| Obligatorio                      | falso          |
| Valor predeterminado             | Falso          |
| Tipo                             | Booleano       |
| Nombre para mostrar en el portal | ¿Solo informe? |

#### EmailFrom

Dirección del remitente del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.EmailSender.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### BrandingHeaderImageUrl

Imagen de cabecera del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Se toma de la configuración del Tenant RJReport.Branding.HeaderImageUrl; se usa la cabecera predeterminada de RealmJoin cuando está vacía.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### BrandingFooterImageUrl

Imagen del pie de página del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Se toma de la configuración del Tenant RJReport.Branding.FooterImageUrl; se usa el pie de página predeterminado de RealmJoin cuando está vacía.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### BrandingFooterLink

Enlace detrás de la imagen del pie de página del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.Branding.FooterLink; se usa realmjoin.com cuando está vacía.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### BrandingAccentColor

Color de acento del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.AccentColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### BrandingTextColor

Color del texto del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.TextColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### EmailTo

Dirección a la que se envía la vista previa. Solo se usa en modo solo de informe.

| Propiedad                        | Valor                            |
| -------------------------------- | -------------------------------- |
| Obligatorio                      | falso                            |
| Valor predeterminado             |                                  |
| Tipo                             | Cadena                           |
| Nombre para mostrar en el portal | Enviar informe de vista previa a |

#### ReportFileFormat

Adjunte las listas completas como CSV, como un libro de Excel o ambos. Solo se usa en modo solo de informe.

| Propiedad                        | Valor                                           |
| -------------------------------- | ----------------------------------------------- |
| Obligatorio                      | falso                                           |
| Valor predeterminado             | CSV y XLSX                                      |
| Tipo                             | Cadena                                          |
| Nombre para mostrar en el portal | Formato del archivo del informe de vista previa |

**Opciones del portal**

| Opción del portal | Valor      |
| ----------------- | ---------- |
| CSV y XLSX        | CSV y XLSX |
| Solo CSV          | Solo CSV   |
| Solo XLSX         | Solo XLSX  |

[Volver al resumen de referencia de Runbook](https://docs.realmjoin.com/es/automatizacion/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/es/automatizacion/runbooks/runbook-references/org/general/add-primary-users-of-devices-to-group_scheduled.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.
