For the complete documentation index, see llms.txt. This page is also available as Markdown.

Informar del agente RealmJoin programado

Informar de los dispositivos cuyo agente RealmJoin dejó de reportar

Este es un runbook programado. Está diseñado para ejecutarse con una programación recurrente en lugar de activarse para un único objeto. Consulte Programación para obtener detalles sobre cómo configurar las programaciones del runbook.

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 bastante después de que RealmJoin lo hiciera apunta a un agente de RealmJoin que falta, está bloqueado o está averiado. También pueden listarse 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 empareja por 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 dejan fuera a propósito; pertenecen al Informar de dispositivos obsoletos (programado) runbook.

  • RealmJoin: la lista de dispositivos de la API de cliente de RealmJoin. Para cada dispositivo, incluye los usuarios que el agente de RealmJoin ha informado como conectados, cada uno con una marca de tiempo de última vez visto marca de tiempo. RealmJoin escribe la misma marca de tiempo en el usuario y en el dispositivo con cada informe del agente, por lo que la más reciente de estos valores es el último contacto del agente con el 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

InSync

El agente informó hace poco; la brecha está por debajo del valor permitido.

AgentStale

Intune vio el dispositivo al menos Brecha permitida desde la última vez 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.

NeverSeen

RealmJoin conoce el dispositivo, pero el agente nunca ha informado de un usuario que haya iniciado sesión 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 llevan ningún nombre de dispositivo con el que coincidir.

AgentStale forma siempre parte del informe. Las demás categorías se activan con la Incluir ... opciones. La pestaña Output Data de la ejecución muestra un resumen y una tabla por categoría; los archivos del informe contienen las mismas filas.

Si coinciden los usuarios principales de un dispositivo y quién inicia sesión en él son preguntas distintas; el Informar de desajuste del usuario principal (programado) runbook las responde.

Por qué la brecha y no la antigüedad

Comparar la marca de tiempo de RealmJoin con hoy enumeraría todos los dispositivos que simplemente están apagados, por ejemplo durante las vacaciones. La brecha compara entre sí las dos fuentes: que Intune no haya visto un dispositivo tampoco es un problema del agente de RealmJoin. Solo un dispositivo que sigue comunicándose con Intune mientras RealmJoin no oye nada apunta al agente. El valor predeterminado de 14 días coincide con el punto en el que RealmJoin Portal 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 hay alguien con sesión iniciada. Cada informe actualiza la última vez visto 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 que haya iniciado sesión o un dispositivo que solo se enciende para actualizaciones, no produce una marca de tiempo nueva y puede aparecer como AgentStale aunque el agente esté bien. Excluya esos dispositivos con Exclude devices from group, o aumente la brecha permitida.

Los Última vez visto la columna en RealmJoin Portal 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 de 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 propias estadísticas de clientes de RealmJoin e imprime cuántos clientes cuenta RealmJoin como activos. El umbral detrás de ese recuento es una configuración de Tenant de RealmJoin (90 días de forma predeterminada), por lo que el número suele ser mayor que el número 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 cliente de RealmJoin y necesita una credencial dedicada almacenada en la Automation Account de Azure. La misma credencial sirve para cualquier runbook que use la API, por lo que esta es una configuración única por Automation Account.

  1. Obtener credenciales de la API - Si aún no tiene credenciales de la API de RealmJoin, solicítelas en support@realmjoin.com. El nombre de usuario tiene el formato t-<tenant id>, la contraseña es el secreto de la API. Un inicio de sesión en el portal no funciona aquí.

  2. Solicite la función de usuarios del dispositivo - La lista de dispositivos de la API de cliente es una característica que RealmJoin habilita por Tenant. Pida a soporte que la habilite junto con las credenciales; sin ella, la API responde con HTTP 403 y el runbook se detiene con ese mensaje.

  3. Abra la Automation Account - En Azure Portal, abra la Automation Account utilizada para los runbooks.

  4. Vaya a Recursos compartidos > Credenciales - En el menú izquierdo, debajo de Recursos compartidos, haga clic en Credenciales.

  5. Agregar una nueva credencial - Haga clic en Agregar una credencial.

  6. Póngale exactamente el nombre RJAPI - El runbook busca este nombre; cualquier otro nombre hace que falle la búsqueda de credenciales.

  7. Introduzca el nombre de usuario y el secreto de la API - Use los valores del paso 1.

  8. Guardar - Haga clic en Crear y ejecute de nuevo el runbook.

La API permite 30 solicitudes por minuto por Tenant y responde con HTTP 429 a partir de ese límite. El runbook necesita dos solicitudes por ejecución y repite una solicitud limitada por tasa después de 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 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. El envío 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 Azure Storage Account 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 (esta es una asignación de Azure RBAC, no un permiso de aplicación de Graph).

Configuración relativa al envío de correos electrónicos

El envío del informe por correo electrónico es opcional y solo ocurre cuando Enviar también el informe por correo electrónico o Enviar también 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 de Tenant.

Este runbook envía correos electrónicos mediante la API de Microsoft Graph. Para enviar correos mediante Graph API, debes configurar una dirección de correo electrónico existente en la personalización del runbook.

Consulta la documentación de configuración de informes de RealmJoin para conocer todos los ajustes disponibles.

Marca del correo electrónico

El correo electrónico del informe respeta las RJReport.Branding.* configuraciones opcionales de Tenant:

  • Imagen de cabecera 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 estas configuraciones no están definidas, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen que no se puede descargar o validar, 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.

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 periodos de inactividad.

Una personalización que fija ambos valores y entrega el informe por correo electrónico:

Consulta la Guía de personalización de runbooks para la sintaxis.

Notas y limitaciones

  • Solo se comparan los 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 mostrado en las tablas es el usuario registrado en Intune, no necesariamente el usuario que el agente vio por última vez; ambos se enumeran para las AgentStale filas.

Ubicación

Organización → Dispositivos → Informe de contacto del agente de RealmJoin (programado)

Nombre completo del runbook

rjgit-org_devices_report-realmjoin-agent-contact_scheduled

Detalles

Propiedad
Valor

Versión

1.1.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 la hora de la última 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 ámbito

    • 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 visible del Tenant para el asunto del correo electrónico, el cuerpo del correo electrónico y los nombres de archivo del informe

Notas sobre permisos

API de cliente de RealmJoin: una credencial de Automation Account llamada 'RJAPI' con el nombre de usuario de la API del Tenant (t-) y el secreto, emitidos por soporte de RealmJoin API de cliente de RealmJoin: la función de usuarios del dispositivo de la API debe estar habilitada para el Tenant por soporte de RealmJoin (de lo contrario, la lista de dispositivos responde con HTTP 403) Azure Storage Account: rol 'Reader and Data Access' para la identidad administrada de la Automation Account en la Storage Account 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 obsoletos en su lugar.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

30

Tipo

Int32

Nombre para mostrar en el portal

Última sincronización de Intune dentro de (días)

AgentContactThresholdDays

Un dispositivo cuenta como agente obsoleto cuando Intune lo vio al menos este número de días después de que RealmJoin lo hiciera por última vez. Las brechas cortas son normales, ya que el agente solo informa mientras un usuario tiene sesión iniciada.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

14

Tipo

Int32

Nombre para mostrar en el portal

Brecha permitida desde la última vez visto por RealmJoin (días)

DeviceNamePrefix

Solo dispositivos cuyo nombre comienza con este texto. Déjelo vacío para todos.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

Tipo

Cadena

Nombre para mostrar en el portal

Prefijo del nombre del dispositivo

IncludeAgentStale

Enumera los dispositivos que Intune vio bastante después de que RealmJoin lo hiciera por última vez, señal de un agente que ya no informa.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

Verdadero

Tipo

Booleano

Oculto en el portal

sí (preestablecido 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

Obligatorio

falso

Valor predeterminado

Verdadero

Tipo

Booleano

Nombre para mostrar en el portal

¿Incluir dispositivos que RealmJoin nunca ha visto?

Opciones del portal

Opción del portal
Valor

Sí

true

Sin

falso

IncludeMissingInRealmJoin

Enumera los dispositivos que existen en Intune pero no en RealmJoin.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

Falso

Tipo

Booleano

Nombre para mostrar en el portal

¿Incluir dispositivos faltantes en RealmJoin?

Opciones del portal

Opción del portal
Valor

Sí

true

Sin

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

Obligatorio

falso

Valor predeterminado

Falso

Tipo

Booleano

Nombre para mostrar en el portal

¿Incluir dispositivos faltantes en Intune?

Opciones del portal

Opción del portal
Valor

Sí

true

Sin

falso

IncludeDeviceGroup

Solo dispositivos de este grupo de Entra ID. Déjelo vacío para todos los dispositivos.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

Tipo

Cadena

Nombre para mostrar en el portal

Include devices from group

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

Obligatorio

falso

Valor predeterminado

Tipo

Cadena

Nombre para mostrar en el portal

Exclude devices from group

EmailFrom

Dirección del remitente del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.EmailSender.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

BrandingHeaderImageUrl

Imagen de cabecera 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 la cabecera predeterminada de RealmJoin cuando está vacía.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

BrandingFooterImageUrl

Imagen del 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ía.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

Enlace detrás de la imagen del pie de página del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.Branding.FooterLink; se usa realmjoin.com cuando está vacía.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido 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

Obligatorio

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

BrandingTextColor

Color del 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

Obligatorio

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

SendEmailReport

Envía el informe a la dirección de correo electrónico del destinatario.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

Falso

Tipo

Booleano

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

EmailTo

Envía el informe a estas direcciones. Separa varias con comas; cada destinatario recibe un correo electrónico independiente.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

Tipo

Cadena

Nombre para mostrar en el portal

Dirección(es) de correo electrónico del destinatario

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

ReportFileFormat

Entrega el informe como CSV, como un libro de Excel o ambos.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

CSV y XLSX

Tipo

Cadena

Nombre para mostrar en el portal

Formato del archivo del informe

Oculto en el portal

sí (preestablecido 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

También sube el informe y devuelve un enlace de descarga que expira después de unos días.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

Falso

Tipo

Booleano

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

ContainerName

Contenedor de almacenamiento al que se suben los archivos del informe. Se establece por runbook.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

report-realmjoin-agent-contact

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

ResourceGroupName

Grupo de recursos de la cuenta de almacenamiento para las cargas del informe. Se toma de la configuración del Tenant RJReport.StorageAccount.ResourceGroup.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

StorageAccountName

Cuenta de almacenamiento para las cargas del informe. Se toma de la configuración del Tenant RJReport.StorageAccount.StorageAccountName.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

SubscriptionId

ID de suscripción de la cuenta de almacenamiento para las cargas del informe. Se toma de la configuración del Tenant RJReport.StorageAccount.SubscriptionId; cuando está vacío, se usa la suscripción en la que inicia sesión la identidad administrada.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

LinkExpiryDays

Número de días que un enlace de descarga permanece válido. Se toma de la configuración del Tenant RJReport.StorageAccount.LinkExpiryDays.

Propiedad
Valor

Obligatorio

falso

Valor predeterminado

6

Tipo

Int32

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

Última actualización

¿Te fue útil?