> 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 al grupo los usuarios primarios de los dispositivos programado {% hint style="info" %} Este es un runbook programado. Está diseñado para ejecutarse según una programación recurrente en lugar de activarse para un único objeto. Consulte [Programación](/es/automatizacion/runbooks/scheduling.md) para obtener detalles sobre cómo configurar las programaciones del runbook. {% endhint %} ### Descripción Este runbook recopila los usuarios primarios 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 primario 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 Organization → General → Agregar usuarios primarios 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.1.0 | | Módulos requeridos |

RealmJoin.RunbookHelper (>= 0.8.9)
Microsoft.Graph.Authentication (>= 2.39.0)

| | Programable | sí | ### Permisos #### Permisos de aplicación * **Tipo**: Microsoft Graph * DeviceManagementManagedDevices.Read.All * *Lee los dispositivos administrados por Intune filtrados por SO para recopilar el usuario primario 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 El grupo de Entra ID en el que se sincronizarán los usuarios primarios. Los miembros de este grupo serán administrados exclusivamente por este runbook. | Propiedad | Valor | | -------------------------------- | ------------------------------------------------------- | | Requerido | true | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar en el portal | Grupo de destino (sincronizar usuarios primarios en él) | #### Windows Incluye los usuarios primarios de dispositivos Windows. (Filtro OData usado "operatingSystem eq 'Windows'") | Propiedad | Valor | | -------------------------------- | ---------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar en el portal | Incluir dispositivos Windows | #### MacOS Incluye los usuarios primarios de dispositivos macOS. (Filtro OData usado "operatingSystem eq 'macOS'") | Propiedad | Valor | | -------------------------------- | -------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar en el portal | Incluir dispositivos macOS | #### iOS Incluye los usuarios primarios de dispositivos iOS y iPadOS. (Filtro OData usado "operatingSystem eq 'iOS'") | Propiedad | Valor | | -------------------------------- | ------------------------ | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar en el portal | Incluir dispositivos iOS | #### Android Incluye los usuarios primarios de dispositivos Android. (Filtro OData usado "operatingSystem eq 'Android'") | Propiedad | Valor | | -------------------------------- | ---------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar en el portal | Incluir dispositivos Android | #### Filtro avanzado 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 | | Nombre para mostrar en el portal | Filtro personalizado (reemplaza la selección de SO) | #### Eliminar usuarios cuando no haya coincidencia de dispositivo Cuando está habilitado (predeterminado), los usuarios que ya no tienen un dispositivo primario 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 | True | | Tipo | Booleano | | Nombre para mostrar en el portal | Eliminar usuarios que ya no tienen un dispositivo coincidente | #### Id del grupo de inclusión Opcional. Solo los usuarios que sean miembros de este grupo son elegibles para agregarse al grupo de destino. Déjelo vacío para considerar a todos los usuarios primarios. | Propiedad | Valor | | -------------------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar en el portal | Incluir usuarios del grupo (opcional) | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### 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 | | Nombre para mostrar en el portal | Excluir usuarios del grupo (opcional) | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | [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, and the optional `goal` query parameter: ``` GET https://docs.realmjoin.com/es/automatizacion/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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.