# Agregar usuarios principales de dispositivos al grupo programado

### Descripción

Esta guía 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 coincidente se eliminan del grupo. Un grupo de inclusión opcional restringe qué usuarios son elegibles, y un grupo de exclusión opcional impide que se agreguen usuarios específicos o mantiene su eliminación.

### 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

### 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 en el que se sincronizarán los usuarios principales. Los miembros de este grupo serán administrados exclusivamente por esta guía.

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

#### Windows

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

| Propiedad            | Valor   |
| -------------------- | ------- |
| Requerido            | false   |
| Valor predeterminado | False   |
| Tipo                 | Boolean |

#### MacOS

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

| Propiedad            | Valor   |
| -------------------- | ------- |
| Requerido            | false   |
| Valor predeterminado | False   |
| Tipo                 | Boolean |

#### iOS

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

| Propiedad            | Valor   |
| -------------------- | ------- |
| Requerido            | false   |
| Valor predeterminado | False   |
| Tipo                 | Boolean |

#### Android

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

| Propiedad            | Valor   |
| -------------------- | ------- |
| Requerido            | false   |
| Valor predeterminado | False   |
| Tipo                 | Boolean |

#### AdvancedFilter

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

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| 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. Deshabilitar para el modo solo agregar: los miembros existentes nunca se eliminan.

| Propiedad            | Valor   |
| -------------------- | ------- |
| Requerido            | false   |
| Valor predeterminado | True    |
| Tipo                 | Boolean |

#### IncludeGroupId

Opcional. Solo los usuarios que sean miembros de este grupo pueden agregarse al grupo de destino. Deje vacío para considerar a todos los usuarios principales.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| 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            | false  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

[Volver a la vista general de referencia del runbook](/es/automatizacion/runbooks/runbook-references.md)


---

# 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/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.