> 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/devices/report-primary-user-mismatch_scheduled.md). # Informar discrepancia de usuario principal 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 Para dispositivos administrados con Windows, este informe programado compara el usuario principal registrado en Intune con el usuario principal registrado en la API de cliente de RealmJoin. Correlaciona los dos conjuntos de datos por dispositivo, marca cualquier dispositivo en el que el usuario principal difiera y envía por correo electrónico las diferencias con archivos adjuntos CSV y/o Excel (xlsx). Los archivos del informe también se pueden cargar en un Azure Storage Account, devolviendo enlaces de descarga con tiempo limitado. El parámetro ReportFileFormat controla qué formatos de archivo se generan y entregan (solo CSV, CSV y XLSX, o solo XLSX). Cuando el archivo adjunto CSV supera el límite de tamaño del correo y se selecciona "CSV & XLSX", el correo recurre únicamente al libro de Excel. ### Configuración relacionada con el envío de correos electrónicos Este runbook envía correos electrónicos usando la API de Microsoft Graph. Para enviar correos electrónicos mediante Graph API, debes configurar una dirección de correo electrónico existente en la personalización del runbook. Este proceso se describe en detalle en el [documentación de RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings). #### Branding del correo electrónico El correo electrónico del informe tiene en cuenta la configuración opcional `RJReport.Branding.*` de Tenant: una imagen de encabezado personalizada, una imagen de pie de página personalizada (URL HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada una), un enlace personalizado en el pie de página y colores personalizados 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 de branding que no se pueda descargar o validar, o un valor de color que no sea un color hexadecimal válido, nunca impide el envío del correo del informe; en su lugar, se usa el valor predeterminado correspondiente. Consulta la [documentación de RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para ver los detalles de configuración. ### Configuración de las credenciales de la API de RealmJoin Este runbook consulta la API de cliente de RealmJoin y requiere una credencial dedicada almacenada en la Azure Automation Account. **Configuración paso a paso:** 1. **Obtener credenciales de la API** — Si aún no tienes credenciales de la API de RealmJoin, solicítalas en 2. **Abrir la Automation Account** — En Azure Portal, navega hasta la Automation Account utilizada para los runbooks 3. **Ve a Recursos compartidos > Credenciales** — En el menú izquierdo, debajo de *Recursos compartidos*, haz clic en *Credenciales* 4. **Agregar una nueva credencial** — Haz clic en *Agregar una credencial* 5. **Asígnale exactamente el nombre `RJAPI`** — El runbook busca este nombre; cualquier variación hará que la búsqueda de la credencial falle 6. **Introduce el nombre de usuario y la contraseña de la API de RealmJoin** — Usa las credenciales del paso 1 7. **Guardar** — Haz clic en *Crear* y vuelve a ejecutar el runbook ### Ubicación Organización → Dispositivos → Informe de discrepancia de usuario principal (programado) **Nombre completo del runbook** rjgit-org\_devices\_report-primary-user-mismatch\_scheduled ### Detalles | Propiedad | Valor | | ------------------ | ----------------------------------------------------------------------------------------------------------------- | | Versión | 1.7.0 | | Módulos requeridos |

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

| | Programable | sí | ### Notas Requisitos previos: * Antes de programar, debe crearse manualmente una credencial compartida de Azure Automation Account llamada exactamente "RJAPI". Establece el nombre de usuario y la contraseña para que coincidan con una cuenta de API de cliente de RealmJoin (consulta ). * La identidad administrada de la Automation Account debe tener asignados los siguientes permisos de aplicación de Graph: DeviceManagementManagedDevices.Read.All, Mail.Send, Organization.Read.All. * La configuración RJReport.EmailSender debe configurarse con una dirección de remitente válida antes de la primera ejecución. * No se envía ningún correo electrónico cuando los dos conjuntos de datos están sincronizados; una ejecución vacía no es un error. ### Permisos #### Permisos de aplicación * **Tipo**: Microsoft Graph * DeviceManagementManagedDevices.Read.All * *Lee los dispositivos administrados de Intune para obtener el usuario principal de cada dispositivo Windows para la comparación* * Directory.Read.All * *Lee los miembros del grupo para resolver los filtros opcionales de ámbito de inclusión/exclusión de grupos de dispositivos* * Mail.Send *(opcional — función: informe por correo electrónico)* * *Entrega el informe de discrepancias mediante Send-RjReportEmail al destinatario EmailTo configurado* * Organization.Read.All * *Lee /organization para obtener el nombre del Tenant que se muestra en el informe* ### Parámetros #### SyncThresholdDays Número de días hacia atrás para el filtro de última sincronización de Intune. Solo se evalúan los dispositivos Windows que se hayan sincronizado dentro de estos días. | Propiedad | Valor | | -------------------------------- | -------------------------------------- | | Requerido | falso | | Valor predeterminado | 30 | | Tipo | Int32 | | Nombre para mostrar en el portal | Última sincronización de Intune (días) | #### DeviceNamePrefix Prefijo opcional del nombre del dispositivo para filtrar el informe a un subconjunto específico de dispositivos. Déjalo en blanco para incluir todos los dispositivos. | Propiedad | Valor | | -------------------------------- | --------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar en el portal | Prefijo del nombre del dispositivo (opcional) | #### IncludeMismatches Incluye en el informe los dispositivos cuyo usuario principal difiere entre Intune y RealmJoin. Habilitado de forma predeterminada. | Propiedad | Valor | | -------------------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | True | | Tipo | Booleano | | Nombre para mostrar en el portal | Incluir discrepancias | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### IncludeMissingInRealmJoin Incluye en el informe los dispositivos que existen en Intune pero no tienen un dispositivo coincidente en RealmJoin. Deshabilitado de forma predeterminada. | Propiedad | Valor | | -------------------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar en el portal | Incluir faltantes en RealmJoin | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### IncludeMissingInIntune Incluye en el informe los dispositivos que existen en RealmJoin pero no tienen un dispositivo coincidente en Intune. Deshabilitado de forma predeterminada. | Propiedad | Valor | | -------------------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar en el portal | Incluir faltantes en Intune | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### IncludePrimaryUserDeleted Incluye en el informe los dispositivos cuyo usuario principal de Intune ha sido eliminado de Entra ID. Intune altera el nombre principal de usuario de un usuario eliminado anteponiendo su id de objeto, lo que de otro modo aparecería como una discrepancia falsa. Habilitado de forma predeterminada. | Propiedad | Valor | | -------------------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar en el portal | Incluir usuarios principales eliminados | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### UseDeviceScope Habilita el filtrado por ámbito de dispositivos para incluir o excluir dispositivos según la pertenencia al grupo de dispositivos de Entra ID. | Propiedad | Valor | | -------------------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar en el portal | Usar filtrado por ámbito de dispositivos | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### IncludeDeviceGroup Incluye en el informe solo los dispositivos que sean miembros de este grupo de dispositivos de Entra ID. Requiere que el filtrado por ámbito de dispositivos esté habilitado. | Propiedad | Valor | | -------------------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar en el portal | Dispositivos a incluir (Grupo) | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### ExcludeDeviceGroup Excluye del informe los dispositivos que sean miembros de este grupo de dispositivos de Entra ID. Requiere que el filtrado por ámbito de dispositivos esté habilitado. | Propiedad | Valor | | -------------------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar en el portal | Dispositivos a excluir (Grupo) | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### EmailTo Si se especifica, se enviará un correo electrónico con el informe a las direcciones proporcionadas. Puede ser una sola dirección o varias direcciones separadas por comas. | Propiedad | Valor | | -------------------------------- | ---------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar en el portal | Enviar informe a | #### EmailFrom La dirección de correo del remitente. Se configura mediante la opción de personalización del runbook y está oculta en el portal. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### BrandingHeaderImageUrl | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### BrandingFooterImageUrl | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### BrandingFooterLink | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### BrandingAccentColor | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### BrandingTextColor | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### ReportFileFormat Controla qué formatos de archivo del informe se generan y entregan: "solo CSV", "CSV y XLSX" (predeterminado) o "solo XLSX". | Propiedad | Valor | | -------------------------------- | ------------------------------- | | Requerido | falso | | Valor predeterminado | CSV y XLSX | | Tipo | Cadena | | Nombre para mostrar en el portal | Formato del archivo del informe | **Opciones del portal** | Opción del portal | Valor | | ----------------- | ----- | | CSV y XLSX | | | solo CSV | | | solo XLSX | | #### CreateDownloadLink Si está habilitado, los archivos del informe se cargan en un Azure Storage Account y se devuelven enlaces de descarga con tiempo limitado. Deshabilitado de forma predeterminada. | Propiedad | Valor | | -------------------------------- | --------------------------------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar en el portal | ¿Crear un enlace de descarga de archivo (cargar el informe en el almacenamiento)? | **Opciones del portal** | Opción del portal | Valor | | ------------------------------------------------------- | ----- | | Sí - cargar el informe y devolver un enlace de descarga | true | | No - no crear un enlace de descarga | falso | #### ContainerName Nombre del contenedor de almacenamiento usado para la carga. Configurado por runbook (no es una configuración global de RJReport). | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | report-primary-user-mismatch | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### ResourceGroupName Grupo de recursos que contiene el Storage Account. Obtenido de la configuración del Tenant de RJReport. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### StorageAccountName Nombre del Storage Account usado para la carga. Obtenido de la configuración del Tenant de RJReport. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### LinkExpiryDays Número de días hasta que expire el enlace de descarga generado. Obtenido de la configuración del Tenant de RJReport. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | 6 | | Tipo | Int32 | | 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/devices/report-primary-user-mismatch_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.