Programar notificación a usuarios sobre dispositivos obsoletos

Notificar por correo electrónico a los usuarios principales sobre sus dispositivos obsoletos

Esta es una ejecución programada de runbook. Está diseñada para ejecutarse en un horario 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

Identifica dispositivos que no han estado activos durante un número especificado de días y envía notificaciones personalizadas por correo electrónico a los usuarios principales de esos dispositivos. El correo contiene información del dispositivo y pasos de acción para el usuario. Opcionalmente, filtra usuarios incluyendo o excluyendo grupos específicos. Los dispositivos sin usuario principal (y los dispositivos cuyo usuario principal coincida con un patrón de nombre configurable, por ejemplo, cuentas de Device Enrollment Manager) pueden, opcionalmente, enviarse al destinatario de correo de reemplazo, mientras que todas las demás notificaciones se envían directamente a los usuarios finales.

Configuración relacionada con el envío de correos electrónicos

El envío de un informe por correo electrónico es opcional y solo ocurre cuando se proporciona un destinatario (Correo electrónico del destinatario) 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 Graph API, necesitas 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 para más detalles.

Selección del idioma de la plantilla de correo

Este runbook admite tres opciones de plantilla de correo electrónico:

1. EN (inglés - predeterminado): Usa la plantilla de inglés integrada
2. DE (alemán): Usa la plantilla de alemán integrada
3. Personalizada: Usa una plantilla personalizada de Runbook Customizations

Uso de plantillas de correo personalizadas

Para usar una plantilla de correo personalizada (p. ej., en neerlandés, español o cualquier otro idioma), debes configurar el texto de la plantilla en Runbook Customizations. Si falta algún parámetro de plantilla personalizada, el runbook recurrirá automáticamente a la plantilla en inglés.

Ejemplo: plantilla personalizada

{
    "Runbooks": {
        "rjgit-org_devices_notify-users-about-stale-devices_scheduled": {
            "Parameters": {
                "CustomMailTemplateSubject": {
                    "Default": "Este es un asunto personalizado - Acción requerida: Dispositivos inactivos"
                },
                "CustomMailTemplateBeforeDeviceDetails": {
                    "Default": "**Esto está encima de los detalles del dispositivo.** \n\nEstimado usuario ..."
                },
                "CustomMailTemplateAfterDeviceDetails": {
                    "Default": "**Esto está debajo de los detalles del dispositivo.** \n\n## Lo que debes hacer..."
                }
            }
        }
    }
}

Notas importantes:

• Usa \n para saltos de línea en la configuración JSON
• Se admite formato Markdown (##, ###, **, -) en el texto de la plantilla
• Deben configurarse los tres parámetros de plantilla personalizada (Subject, BeforeDeviceDetails, AfterDeviceDetails)
• Si falta algún parámetro, el runbook vuelve automáticamente a la plantilla en inglés (EN)
• Al usar la plantilla personalizada, selecciona "Personalizada - Usa la plantilla de Runbook Customizations" en la lista desplegable Plantilla de correo

Enrutamiento de dispositivos sin usuario principal al destinatario de reemplazo

De forma predeterminada, los dispositivos inactivos sin usuario principal se omiten, y un valor configurado OverrideEmailRecipient redirige todos las notificaciones. Activar SendNoPrimaryUserDevicesToOverride cambia esto: los dispositivos sin usuario principal (y los dispositivos cuyo usuario principal coincide con OverrideUserNamePattern) se envían al OverrideEmailRecipient, mientras que todas las demás notificaciones se envían directamente a los usuarios finales.

SendNoPrimaryUserDevicesToOverride	OverrideEmailRecipient	Comportamiento
Desactivado	vacío	Los dispositivos sin usuario principal se omiten; los usuarios reciben el correo directamente.
Desactivado	establecido	Todas las notificaciones se redirigen al destinatario de reemplazo.
Activado	establecido	Los dispositivos sin usuario principal se agrupan en un correo combinado al destinatario de reemplazo. Los usuarios que coinciden con el patrón se redirigen al destinatario de reemplazo. Todos los demás usuarios reciben su notificación directamente.
Activado	vacío	Configuración no válida: el runbook se detiene con un error.

Patrón de nombre de usuario

OverrideUserNamePattern acepta uno o más patrones comodín (separados por comas) que se comparan con el UPN del usuario principal, p. ej. DEM-* para cuentas de Device Enrollment Manager o DEM-*,KIOSK-* para varios patrones. La coincidencia no distingue mayúsculas de minúsculas y usa la sintaxis de comodines de PowerShell (*, ?). El patrón solo se evalúa cuando SendNoPrimaryUserDevicesToOverride está habilitado.

Notas importantes:

• Habilitar SendNoPrimaryUserDevicesToOverride requiere OverrideEmailRecipient que se establezca
• Los dispositivos sin usuario principal omiten el filtrado del ámbito de usuario (no tienen ningún usuario con el que comparar grupos)
• Los usuarios que coinciden con el patrón siguen estando sujetos primero al filtrado del ámbito de usuario; los usuarios excluidos por el ámbito no generan ninguna notificación
• El correo combinado para dispositivos sin usuario principal usa una redacción administrativa (sin pasos de acción para el usuario final), independientemente de las plantillas personalizadas

Ubicación

Organización → Dispositivos → Notificar a los usuarios sobre dispositivos inactivos (programado)

Nombre completo del runbook

rjgit-org_devices_notify-users-about-stale-devices_scheduled

Detalles

Propiedad	Valor
Versión	1.4.0
Módulos requeridos	RealmJoin.RunbookHelper (>= 0.8.7) Microsoft.Graph.Authentication (>= 2.39.0)
Programable	sí

Notas

Este runbook envía automáticamente notificaciones personalizadas por correo electrónico a los usuarios que tienen dispositivos que no se han sincronizado durante un número especificado de días. El correo se envía directamente a la dirección de correo del usuario principal e incluye información detallada sobre cada dispositivo inactivo.

Requisitos previos:

• El parámetro EmailFrom debe configurarse en la personalización del runbook (configuración RJReport.EmailSender)
• Opcional: se puede configurar la información de contacto de Service Desk (ServiceDesk_DisplayName, ServiceDesk_EMail, ServiceDesk_Phone, ServiceDesk_PortalUrl)

Casos de uso comunes:

• Recordatorios automáticos a los usuarios sobre dispositivos inactivos para fomentar comprobaciones periódicas de los dispositivos
• Gestión proactiva del ciclo de vida de los dispositivos alertando a los usuarios antes de que los dispositivos se retiren
• Seguridad y cumplimiento al garantizar que los usuarios conozcan todos los dispositivos registrados a su nombre
• Uso del parámetro MaxDays para notificaciones escalonadas (p. ej., primer recordatorio a los 30 días, aviso final a los 60 días)
• Filtrado del ámbito de usuario para dirigirse a departamentos específicos o excluir cuentas de servicio
• Gestión centralizada de dispositivos sin usuario principal o pertenecientes a cuentas de Device Enrollment Manager (p. ej. DEM-*) mediante el destinatario de reemplazo

Opciones de piloto y pruebas:

• Usa el parámetro OverrideEmailRecipient para enviar todas las notificaciones a un buzón de prueba en lugar de a los usuarios finales
• Ideal para validar el contenido del correo y probar filtros antes de implementarlo en producción
• Envía notificaciones a sistemas de tickets o buzones compartidos para una gestión centralizada

Permisos

Permisos de aplicación

• Tipo: Microsoft Graph

  • DeviceManagementManagedDevices.Read.All
  • Directory.Read.All
  • Device.Read.All
  • Group.Read.All
  • Mail.Send

Parámetros

Días

Número de días sin actividad para considerarse inactivo (umbral mínimo).

Propiedad	Valor
Requerido	falso
Valor predeterminado	30
Tipo	Int32
Nombre para mostrar en el portal	Días mínimos sin actividad

MaxDays

Número máximo opcional de días sin actividad. Si se establece, solo se incluirán los dispositivos inactivos entre Days y MaxDays.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Int32
Nombre para mostrar en el portal	(Opcional) Días máximos sin actividad

Windows

Incluir dispositivos Windows en los resultados.

Propiedad	Valor
Requerido	falso
Valor predeterminado	Verdadero
Tipo	Booleano
Nombre para mostrar en el portal	Incluir dispositivos Windows

macOS

Incluir dispositivos macOS en los resultados.

Propiedad	Valor
Requerido	falso
Valor predeterminado	Verdadero
Tipo	Booleano
Nombre para mostrar en el portal	Incluir dispositivos macOS

iOS

Incluir dispositivos iOS en los resultados.

Propiedad	Valor
Requerido	falso
Valor predeterminado	Verdadero
Tipo	Booleano
Nombre para mostrar en el portal	Incluir dispositivos iOS

Android

Incluir dispositivos Android en los resultados.

Propiedad	Valor
Requerido	falso
Valor predeterminado	Verdadero
Tipo	Booleano
Nombre para mostrar en el portal	Incluir dispositivos Android

Correo electrónico del remitente

La dirección de correo electrónico del remitente. Esto debe configurarse en la personalización del runbook.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

ServiceDeskDisplayName

Nombre para mostrar de Service Desk para la información de contacto del usuario (opcional).

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

ServiceDeskEmail

Dirección de correo electrónico de Service Desk para la información de contacto del usuario (opcional).

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

ServiceDeskPhone

Número de teléfono de Service Desk para la información de contacto del usuario (opcional).

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

ServiceDeskPortalUrl

URL del portal de Service Desk para la información de contacto del usuario, mostrada como un enlace en el que se puede hacer clic (opcional).

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

ServiceDeskTicketUrl

Enlace directo a un ticket de Service Desk, mostrado como un enlace en el que se puede hacer clic (opcional). Vacío de forma predeterminada, por lo que no se agrega ningún enlace al ticket.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

UseUserScope

Habilita el filtrado del ámbito de usuario para incluir o excluir usuarios según su pertenencia a grupos.

Propiedad	Valor
Requerido	falso
Valor predeterminado	False
Tipo	Booleano
Nombre para mostrar en el portal	Usar filtrado por ámbito de usuario
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

IncludeUserGroup

Envía correos solo a usuarios que sean miembros de este grupo. Requiere que UseUserScope esté habilitado.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena
Nombre para mostrar en el portal	Usuarios a incluir (grupo)
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

ExcludeUserGroup

No envíes correos a usuarios que sean miembros de este grupo. Requiere que UseUserScope esté habilitado.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena
Nombre para mostrar en el portal	Usuarios a excluir (grupo)
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

OverrideEmailRecipient

Opcional: dirección(es) de correo electrónico a las que enviar todas las notificaciones en lugar de a los usuarios finales. Pueden separarse por comas para varios destinatarios. Perfecto para pruebas, pilotos o envíos a sistemas de tickets. Si se deja vacío, los correos se enviarán a los usuarios finales reales.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena
Nombre para mostrar en el portal	(Opcional) destinatario(s) de correo electrónico de reemplazo

SendNoPrimaryUserDevicesToOverride

Si se habilita, los dispositivos inactivos sin usuario principal (y los dispositivos cuyo usuario principal coincide con OverrideUserNamePattern) se envían a OverrideEmailRecipient, mientras que todas las demás notificaciones se envían directamente a los usuarios finales. Requiere que OverrideEmailRecipient esté establecido. Los dispositivos sin usuario principal omiten el filtrado del ámbito de usuario.

Propiedad	Valor
Requerido	falso
Valor predeterminado	False
Tipo	Booleano
Nombre para mostrar en el portal	Enviar dispositivos sin usuario principal al destinatario de reemplazo
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

OverrideUserNamePattern

Patrón(es) comodín opcional(es) que se comparan con el UPN del usuario principal (separados por comas, p. ej. 'DEM-,KIOSK-', sin distinguir mayúsculas de minúsculas). Las notificaciones de los usuarios que coinciden se redirigen a OverrideEmailRecipient. Solo se usa cuando SendNoPrimaryUserDevicesToOverride está habilitado.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena
Nombre para mostrar en el portal	(Opcional) patrón de nombre de usuario principal para el enrutamiento de reemplazo (p. ej., 'DEM-*')
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

MailTemplateLanguage

Selecciona qué plantilla de correo usar: EN (inglés, predeterminado), DE (alemán) o Custom (de Runbook Customizations).

Propiedad	Valor
Requerido	falso
Valor predeterminado	EN
Tipo	Cadena
Nombre para mostrar en el portal	Plantilla de correo
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

CustomMailTemplateSubject

Línea de asunto personalizada del correo (solo se usa cuando MailTemplateLanguage está configurado como 'Custom').

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena
Nombre para mostrar en el portal	Personalizada: asunto del correo
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

CustomMailTemplateBeforeDeviceDetails

Texto personalizado para mostrar antes de la lista de dispositivos (solo se usa cuando MailTemplateLanguage está configurado como 'Custom'). Admite formato Markdown.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena
Nombre para mostrar en el portal	Personalizada: texto antes de la lista de dispositivos
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

CustomMailTemplateAfterDeviceDetails

Texto personalizado para mostrar después de la lista de dispositivos (solo se usa cuando MailTemplateLanguage está configurado como 'Custom'). Admite formato Markdown.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena
Nombre para mostrar en el portal	Personalizada: texto después de la lista de dispositivos
Oculto en el portal	sí (preconfigurado mediante la personalización del runbook)

Volver a la vista general de referencia del runbook