> 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 usuarios principales de dispositivos al grupo programado

### Descripción

Este runbook recopila los usuarios principales de todos los dispositivos administrados por Intune que coinciden con la(s) plataforma(s) seleccionada(s) y los sincroniza en un grupo de destino de Entra ID. Los usuarios que ya no estén asignados como usuario principal en ningún dispositivo que coincida se eliminan del grupo. Un grupo de inclusión opcional restringe qué usuarios son elegibles, y un grupo de exclusión opcional impide que usuarios específicos se agreguen o mantiene su eliminación.

### Ubicación

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

**Nombre completo del runbook**

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

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
  * Group.Read.All
  * GroupMember.ReadWrite.All
  * User.Read.All

### Parámetros

#### TargetGroupId

El grupo de Entra ID con el que se sincronizarán los usuarios principales. Los miembros de este grupo serán administrados exclusivamente por este runbook.

| Propiedad            | Valor     |
| -------------------- | --------- |
| Requerido            | verdadero |
| Valor predeterminado |           |
| Tipo                 | Cadena    |

#### Windows

Incluir usuarios principales de dispositivos Windows. (Filtro OData usado "operatingSystem eq 'Windows'")

| Propiedad            | Valor    |
| -------------------- | -------- |
| Requerido            | falso    |
| Valor predeterminado | Falso    |
| Tipo                 | Booleano |

#### MacOS

Incluir usuarios principales de dispositivos macOS. (Filtro OData usado "operatingSystem eq 'macOS'")

| Propiedad            | Valor    |
| -------------------- | -------- |
| Requerido            | falso    |
| Valor predeterminado | Falso    |
| Tipo                 | Booleano |

#### iOS

Incluir usuarios principales de dispositivos iOS e iPadOS. (Filtro OData usado "operatingSystem eq 'iOS'")

| Propiedad            | Valor    |
| -------------------- | -------- |
| Requerido            | falso    |
| Valor predeterminado | Falso    |
| Tipo                 | Booleano |

#### Android

Incluir usuarios principales de dispositivos Android. (Filtro OData usado "operatingSystem eq 'Android'")

| Propiedad            | Valor    |
| -------------------- | -------- |
| Requerido            | falso    |
| Valor predeterminado | Falso    |
| Tipo                 | Booleano |

#### AdvancedFilter

Opcional. Filtro OData personalizado que se aplicará al recuperar dispositivos. Reemplaza los filtros basados en la plataforma si se proporciona. Ejemplo: startsWith(deviceName,'FWP-') and operatingSystem eq 'Windows' .

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### RemoveUsersWhenNoDeviceMatch

Cuando está habilitado (predeterminado), los usuarios que ya no tienen un dispositivo principal que coincida con la(s) plataforma(s) seleccionada(s) se eliminan del grupo de destino. Deshabilítelo para el modo solo agregar: los miembros existentes nunca se eliminan.

| Propiedad            | Valor     |
| -------------------- | --------- |
| Requerido            | falso     |
| Valor predeterminado | Verdadero |
| Tipo                 | Booleano  |

#### IncludeGroupId

Opcional. Solo los usuarios que sean miembros de este grupo podrán agregarse al grupo de destino. Déjelo vacío para considerar a todos los usuarios principales.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### ExcludeGroupId

Opcional. Los usuarios que sean miembros de este grupo no se agregarán y se eliminarán del grupo de destino si ya están presentes.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

[Volver a la vista general de la referencia del runbook](/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 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/es/automatizacion/runbooks/runbook-references/org/general/add-primary-users-of-devices-to-group_scheduled.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.