> 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-realmjoin-agent-contact_scheduled.md). # Informar del agente RealmJoin programado Informar de los dispositivos cuyo agente RealmJoin dejó de reportar {% 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. Véase [Programación](/es/automatizacion/runbooks/scheduling.md) para obtener detalles sobre cómo configurar las programaciones del runbook. {% endhint %} ### Descripción Compara, para dispositivos Windows, cuándo RealmJoin vio por última vez el dispositivo con cuándo se sincronizó por última vez con Intune. Un dispositivo que Intune vio mucho después de la última vez que lo hizo RealmJoin apunta a un agente de RealmJoin que falta, está bloqueado o está averiado. También se pueden listar dispositivos que RealmJoin nunca ha visto y dispositivos conocidos solo por un lado. El informe puede enviarse por correo electrónico o proporcionarse como un enlace de descarga. ### Cómo funciona El runbook lee dos listas y las relaciona mediante el ID de dispositivo de Entra (con el ID de dispositivo de Intune como alternativa): * **Intune**: todos los dispositivos Windows que completaron una sincronización dentro de los últimos *Última sincronización de Intune dentro de (días)*. Los dispositivos que dejaron de sincronizarse con Intune se omiten a propósito; pertenecen al **Informar dispositivos obsoletos (Programado)** runbook. * **RealmJoin**: la lista de dispositivos de la API de clientes de RealmJoin. Para cada dispositivo incluye los usuarios que el agente de RealmJoin ha informado que han iniciado sesión, cada uno con una marca de tiempo de *visto por última vez* marca de tiempo. RealmJoin escribe la misma marca de tiempo para el usuario y para el dispositivo con cada informe del agente, por lo que el más reciente de esos valores es el último contacto del agente del dispositivo. Para cada dispositivo de Intune, el runbook calcula la **brecha**: cuántos días Intune siguió viendo el dispositivo después de que el agente de RealmJoin informara por última vez. Cada dispositivo recibe un estado: | Estado | Significado | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Sincronizado` | El agente informó hace poco; la brecha está por debajo del valor permitido. | | `Agente desactualizado` | Intune vio el dispositivo al menos *Brecha permitida con respecto al último visto por RealmJoin (días)* después de que el agente informara por última vez. El dispositivo se estaba usando mientras el agente no informaba: el agente falta, está bloqueado por un proxy o un firewall, no se está ejecutando o está averiado. | | `Nunca visto` | RealmJoin conoce el dispositivo, pero el agente nunca ha informado de un usuario con sesión iniciada en él; por ejemplo, un dispositivo que se inscribió y nunca se usó, o un quiosco. | | `MissingInRealmJoin` | El dispositivo existe en Intune pero no en RealmJoin: el agente nunca lo registró. | | `MissingInIntune` | El dispositivo existe en RealmJoin pero no se sincronizó con Intune dentro de la ventana de sincronización. No está disponible junto con un prefijo de nombre de dispositivo, porque los dispositivos de RealmJoin no incluyen ningún nombre de dispositivo con el que coincidir. | `Agente desactualizado` forma siempre parte del informe. Las demás categorías se activan con la *Incluir ...* opciones. La pestaña Datos de salida de la ejecución muestra un resumen y una tabla por categoría; los archivos del informe contienen las mismas filas. Si los usuarios principales de un dispositivo coinciden y quién inicia sesión en él son preguntas diferentes; el **Informar discrepancia de usuario principal (Programado)** runbook las responde. #### Por qué la brecha y no la antigüedad Comparar la marca de tiempo de RealmJoin con la fecha actual enumeraría todos los dispositivos que simplemente están apagados, por ejemplo durante las vacaciones. La brecha compara ambas fuentes entre sí: un dispositivo que Intune tampoco ha visto no es un problema del agente de RealmJoin. Solo un dispositivo que sigue comunicándose con Intune mientras RealmJoin no recibe nada apunta al agente. El valor predeterminado de 14 días coincide con el punto en que el Portal de RealmJoin marca un dispositivo como obsoleto. #### Qué significa la marca de tiempo de RealmJoin El agente de RealmJoin se ejecuta en el contexto del usuario que ha iniciado sesión e informa cada 15 minutos mientras alguien tiene la sesión iniciada. Cada informe actualiza la *visto por última vez* de ese usuario en ese dispositivo y del propio dispositivo. Un dispositivo sin un usuario con sesión iniciada, por ejemplo un dispositivo quiosco, un dispositivo compartido sin una cuenta iniciada o un dispositivo que solo se enciende para las actualizaciones, no produce una marca de tiempo nueva y puede aparecer como `Agente desactualizado` aunque el agente funcione bien. Excluya esos dispositivos con *Excluir dispositivos del grupo*, o aumente la brecha permitida. El *Última vez visto* La columna en el Portal de RealmJoin no es el mismo valor: el portal muestra el más reciente entre el contacto del agente, la sincronización con Intune y la actividad de inicio de sesión en Entra ID. Este informe usa deliberadamente solo el contacto del agente, porque eso es lo que indica si el agente funciona. #### Línea de plausibilidad El runbook también lee las estadísticas de cliente propias de RealmJoin e imprime cuántos clientes cuenta RealmJoin como activos. El umbral detrás de ese recuento es una configuración del Tenant de RealmJoin (90 días de forma predeterminada), por lo que el número suele ser mayor que el de dispositivos sincronizados aquí; una gran diferencia en la otra dirección significa que la ventana de sincronización o la brecha permitida están configuradas demasiado ajustadas para el Tenant. ### Configuración relativa a las credenciales de la API de RealmJoin El runbook consulta la API de clientes de RealmJoin y necesita una credencial dedicada almacenada en la cuenta de Azure Automation. La misma credencial sirve para todos los runbooks que utilizan la API, por lo que es una configuración única por cuenta de Automation. 1. **Obtener credenciales de API** - Si aún no tiene credenciales de la API de RealmJoin, solicítelas en . El nombre de usuario tiene el formato `t-`, la contraseña es el secreto de la API. Un inicio de sesión en el portal no funciona aquí. 2. **Solicitar la característica de usuarios de dispositivos** - La lista de dispositivos de la API de clientes es una característica que RealmJoin habilita por Tenant. Pida al soporte técnico que la habilite junto con las credenciales; sin ella, la API responde con HTTP 403 y el runbook se detiene con ese mensaje. 3. **Abrir la cuenta de Automation** - En Azure Portal, abra la cuenta de Automation utilizada para los runbooks. 4. **Vaya a Recursos compartidos > Credenciales** - En el menú izquierdo, en *Recursos compartidos*, haga clic en *Credenciales*. 5. **Agregar una nueva credencial** - Haga clic en *Agregar una credencial*. 6. **Asígnele exactamente el nombre `RJAPI`** - El runbook busca este nombre; cualquier otro nombre hace que falle la búsqueda de credenciales. 7. **Introducir el nombre de usuario y el secreto de la API** - Utilice los valores del paso 1. 8. **Guardar** - Haga clic en *Crear* y ejecute el runbook de nuevo. La API permite 30 solicitudes por minuto y por Tenant y responde con HTTP 429 más allá de ese límite. El runbook necesita dos solicitudes por ejecución y repite una solicitud limitada por tasa tras un breve retraso, hasta cinco veces, antes de rendirse. ### Entrega del informe Los resultados siempre aparecen como tablas con nombre en la pestaña Output Data de la ejecución en el portal de RealmJoin. Los archivos del informe solo se generan cuando la **Entrega del informe** opción incluye un correo electrónico y/o un enlace de descarga; *Solo datos de salida* no crea archivos de informe. La entrega por correo electrónico y la generación del enlace de descarga son independientes y pueden combinarse. Para el enlace de descarga, los archivos del informe se cargan en la Storage Account de Azure configurada en la `RJReport.StorageAccount.*` configuración del Tenant, y se devuelven enlaces de descarga SAS con tiempo limitado. La carga al almacenamiento se autentica con la identidad administrada de la cuenta de Automation; esa identidad necesita el **Reader and Data Access** rol RBAC en la Storage Account de destino (esto es una asignación de RBAC de Azure, no un permiso de aplicación de Graph). ### Configuración relacionada con el envío de correo electrónico Enviar un informe por correo electrónico es opcional y solo ocurre cuando *Enviar también el informe por correo electrónico* o *Enviar también el informe por correo electrónico y enlace de descarga* se selecciona como entrega del informe; entonces se requiere un destinatario. La dirección del remitente se toma de la `RJReport.EmailSender` configuración del Tenant. Este runbook envía correos electrónicos usando la API de Microsoft Graph. Para enviar correos electrónicos a través de la API de Graph, debe configurar una dirección de correo electrónico existente en la personalización del runbook. Consulte la [documentación de configuración de informes de RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obtener detalles sobre todas las configuraciones disponibles. #### Marca del correo electrónico El correo electrónico del informe tiene en cuenta la opción opcional `RJReport.Branding.*` del Tenant: * **Imagen de encabezado y pie de página** - URL 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 estos ajustes no están configurados, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen que no puede descargarse o validarse, 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). ### Programación Ejecute el informe semanalmente. Empiece con el valor predeterminado de 14 días para la brecha permitida y una ventana de sincronización de 30 días; reduzca la brecha una vez que la lista esté limpia, o auméntela cuando sigan apareciendo dispositivos con largos períodos de inactividad. Una personalización que fija ambos valores y entrega el informe por correo electrónico: ```json "rjgit-org_devices_report-realmjoin-agent-contact_scheduled": { "parameters": { "SyncThresholdDays": { "Default": 30 }, "AgentContactThresholdDays": { "Default": 14 }, "EmailTo": { "Default": "endpoint-team@contoso.com" } } } ``` Consulte la [Guía de personalización de runbooks](https://docs.realmjoin.com/automation/runbooks/runbook-customization) para la sintaxis. ### Notas y limitaciones * Solo se comparan dispositivos Windows, ya que el agente de RealmJoin se ejecuta en Windows. * La API de cliente de RealmJoin no expone ni la versión del agente ni la hora de sincronización con Intune por dispositivo; la comparación se basa en el contacto del agente descrito arriba. * El usuario principal de Intune que se muestra en las tablas es el usuario registrado en Intune, no necesariamente el último usuario que vio el agente; ambos se enumeran para las `Agente desactualizado` filas. ### Ubicación Organización → Dispositivos → Informe del contacto del agente de RealmJoin (programado) **Nombre completo del runbook** rjgit-org\_devices\_report-realmjoin-agent-contact\_scheduled ### Detalles | Propiedad | Valor | | ------------------ | ------------------------------------------------------------------------------------------------------------------ | | Versión | 1.0.0 | | Módulos requeridos |

RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
Az.Accounts (>= 5.5.2)

| | Programable | sí | ### Permisos #### Permisos de aplicación * **Tipo**: Microsoft Graph * DeviceManagementManagedDevices.Read.All * *Lee los dispositivos Windows en Intune con su usuario principal y su última hora de sincronización para la comparación* * GroupMember.Read.All * *Lee los miembros de dispositivo de los grupos opcionales de inclusión y exclusión que acotan el alcance* * Mail.Send *(opcional — característica: informe por correo electrónico)* * *Envía el correo electrónico del informe mediante Send-RjRbReportEmail cuando se selecciona la entrega por correo electrónico* * Organization.Read.All *(opcional — característica: informe por correo electrónico)* * *Lee el nombre para mostrar del Tenant para el asunto del correo, el cuerpo del correo y los nombres de archivo del informe* #### Notas sobre permisos API de clientes de RealmJoin: una credencial de cuenta de Automation denominada 'RJAPI' con el nombre de usuario de API del Tenant (t-) y el secreto, emitidos por el soporte técnico de RealmJoin. API de clientes de RealmJoin: la característica de usuarios de dispositivos de la API debe estar habilitada para el Tenant por el soporte técnico de RealmJoin (de lo contrario, la lista de dispositivos responde con HTTP 403). Storage Account de Azure: rol de 'Lector y acceso a datos' para la identidad administrada de la cuenta de Automation en la cuenta de almacenamiento de destino; la carga recupera las claves de la cuenta mediante listKeys (solo necesario para las opciones de enlace de descarga) ### Parámetros #### SyncThresholdDays Solo se comparan los dispositivos que se sincronizaron con Intune dentro de esta cantidad de días. Los dispositivos que dejaron de sincronizarse por completo pertenecen al informe de dispositivos inactivos. | Propiedad | Valor | | ------------------------------ | ------------------------------------------------ | | Requerido | falso | | Valor predeterminado | 30 | | Tipo | Int32 | | Nombre para mostrar del portal | Última sincronización de Intune dentro de (días) | #### AgentContactThresholdDays Un dispositivo cuenta como agente desactualizado cuando Intune lo vio al menos esta cantidad de días después de la última vez que lo hizo RealmJoin. Las breves brechas son normales, ya que el agente solo informa mientras un usuario tiene la sesión iniciada. | Propiedad | Valor | | ------------------------------ | ------------------------------------------------------------------ | | Requerido | falso | | Valor predeterminado | 14 | | Tipo | Int32 | | Nombre para mostrar del portal | Brecha permitida con respecto al último visto por RealmJoin (días) | #### DeviceNamePrefix Solo los dispositivos cuyo nombre comienza con este texto. Déjelo vacío para incluir todos. | Propiedad | Valor | | ------------------------------ | ---------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar del portal | Prefijo del nombre del dispositivo | #### IncludeAgentStale Enumera los dispositivos que Intune vio mucho después de la última vez que lo hizo RealmJoin, señal de un agente que ya no informa. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Verdadero | | Tipo | Booleano | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### IncludeNeverSeen Enumera los dispositivos que RealmJoin conoce pero en los que nunca ha visto un usuario con sesión iniciada; por ejemplo, dispositivos que se inscribieron pero aún no se han usado. | Propiedad | Valor | | ------------------------------ | --------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Verdadero | | Tipo | Booleano | | Nombre para mostrar del portal | ¿Incluir dispositivos que RealmJoin nunca ha visto? | **Opciones del portal** | Opción del portal | Valor | | ----------------- | --------- | | Sí | verdadero | | No | falso | #### IncludeMissingInRealmJoin Enumera los dispositivos que existen en Intune pero no en RealmJoin. | Propiedad | Valor | | ------------------------------ | ---------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar del portal | ¿Incluir dispositivos que faltan en RealmJoin? | **Opciones del portal** | Opción del portal | Valor | | ----------------- | --------- | | Sí | verdadero | | No | falso | #### IncludeMissingInIntune Enumera los dispositivos que existen en RealmJoin pero no se sincronizaron con Intune dentro de la ventana de sincronización. No está disponible junto con un prefijo de nombre de dispositivo. | Propiedad | Valor | | ------------------------------ | ------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar del portal | ¿Incluir dispositivos que faltan en Intune? | **Opciones del portal** | Opción del portal | Valor | | ----------------- | --------- | | Sí | verdadero | | No | falso | #### IncludeDeviceGroup Solo los dispositivos de este grupo de Entra ID. Déjelo vacío para todos los dispositivos. | Propiedad | Valor | | ------------------------------ | ------------------------------ | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar del portal | Incluir dispositivos del grupo | #### ExcludeDeviceGroup Omite los dispositivos de este grupo de Entra ID, por ejemplo quioscos o dispositivos compartidos que rara vez tienen un usuario con sesión iniciada. Déjelo vacío para no omitir ninguno. | Propiedad | Valor | | ------------------------------ | ------------------------------ | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar del portal | Excluir dispositivos del grupo | #### EmailFrom Dirección del remitente del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.EmailSender. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingHeaderImageUrl Imagen de encabezado 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 el encabezado predeterminado de RealmJoin cuando está vacío. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingFooterImageUrl Imagen de 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ío. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingFooterLink Enlace asociado a la imagen de pie de página del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.Branding.FooterLink; realmjoin.com se usa cuando está vacío. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado 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 | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingTextColor Color de 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 | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### SendEmailReport Enviar el informe a la dirección de correo electrónico del destinatario. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### EmailTo Envía el informe a estas direcciones. Separe varias con comas; cada destinatario recibe un correo electrónico independiente. | Propiedad | Valor | | ------------------------------ | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar del portal | Dirección(es) de correo electrónico del destinatario | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### ReportFileFormat Entrega el informe como CSV, como un libro de Excel o ambos. | Propiedad | Valor | | ------------------------------ | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | CSV y XLSX | | Tipo | Cadena | | Nombre para mostrar del portal | Formato del archivo del informe | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | **Opciones del portal** | Opción del portal | Valor | | ----------------- | ---------- | | CSV y XLSX | CSV y XLSX | | Solo CSV | Solo CSV | | Solo XLSX | Solo XLSX | #### CreateDownloadLink También carga el informe y devuelve un enlace de descarga que expira después de unos días. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### ContainerName Contenedor de almacenamiento al que se cargan los archivos del informe. Se configura por runbook. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | report-realmjoin-agent-contact | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### ResourceGroupName Grupo de recursos de la Storage Account para las cargas del informe. Obtenido de la configuración del Tenant RJReport.StorageAccount.ResourceGroup. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### StorageAccountName Storage Account para las cargas del informe. Obtenido de la configuración del Tenant RJReport.StorageAccount.StorageAccountName. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### LinkExpiryDays Número de días que un enlace de descarga permanece válido. Obtenido de la configuración del Tenant RJReport.StorageAccount.LinkExpiryDays. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | 6 | | Tipo | Int32 | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | [Volver a la vista general de 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 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/devices/report-realmjoin-agent-contact_scheduled.md?ask=&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.