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

Notificar utilizadores sobre dispositivos inativos agendado

Notificar os utilizadores principais sobre os seus dispositivos inativos por email

Descrição

Identifica dispositivos que não estiveram ativos durante um número específico de dias e envia notificações por e-mail personalizadas aos utilizadores principais desses dispositivos. O e-mail contém informações do dispositivo e passos de ação para o utilizador. Opcionalmente, filtre os utilizadores incluindo ou excluindo grupos específicos.

Configuração relativa ao envio de e-mails

O envio de um relatório por e-mail é opcional e só acontece quando é fornecido um destinatário (EmailTo) é fornecido. O endereço do remetente é obtido da RJReport.EmailSender definição do Tenant.

Este runbook envia e-mails usando a API do Microsoft Graph. Para enviar e-mails através da API Graph, é necessário configurar um endereço de e-mail existente na personalização do runbook.

Consulte a documentação das Configurações de Relatório do RealmJoin para mais detalhes.

Seleção do idioma do modelo de e-mail

Este runbook suporta três opções de modelo de e-mail:

  1. EN (Inglês - Predefinição): Usa o modelo em inglês incorporado

  2. DE (Alemão): Usa o modelo em alemão incorporado

  3. Personalizados: Usa um modelo personalizado de Personalizações do Runbook

Utilizar modelos de e-mail personalizados

Para usar um modelo de e-mail personalizado (por exemplo, em neerlandês, espanhol ou qualquer outro idioma), precisa de configurar o texto do modelo nas Personalizações do Runbook. Se algum parâmetro de modelo personalizado estiver em falta, o runbook recuará automaticamente para o modelo em inglês.

Exemplo: Modelo Personalizado

{
    "Runbooks": {
        "rjgit-org_devices_notify-users-about-stale-devices_scheduled": {
            "Parameters": {
                "CustomMailTemplateSubject": {
                    "Default": "Este é um assunto personalizado - Ação necessária: Dispositivos inativos"
                },
                "CustomMailTemplateBeforeDeviceDetails": {
                    "Default": "**Isto está acima dos Detalhes do Dispositivo.** \n\nCaro utilizador ..."
                },
                "CustomMailTemplateAfterDeviceDetails": {
                    "Default": "**Isto está abaixo dos Detalhes do Dispositivo.** \n\n## O que deve fazer..."
                }
            }
        }
    }
}

Notas importantes:

  • Use \n para quebras de linha na configuração JSON

  • A formatação Markdown (##, ###, **, -) é suportada no texto do modelo

  • Todos os três parâmetros de modelo personalizado (Subject, BeforeDeviceDetails, AfterDeviceDetails) devem ser configurados

  • Se algum parâmetro estiver em falta, o runbook recua automaticamente para o modelo em inglês (EN)

  • Ao utilizar o modelo personalizado, selecione "Personalizado - Usar modelo das Personalizações do Runbook" no menu suspenso de Modelo de e-mail

Localização

Organização → Dispositivos → Notificar utilizadores sobre dispositivos inativos (Agendado)

Nome completo do runbook

rjgit-org_devices_notify-users-about-stale-devices_scheduled

Permissões

Permissões de aplicação

  • Tipo: Microsoft Graph

    • DeviceManagementManagedDevices.Read.All

    • Directory.Read.All

    • Device.Read.All

    • Group.Read.All

    • Mail.Send

Parâmetros

Dias

Número de dias sem atividade para ser considerado inativo (limiar mínimo).

Propriedade
Valor

Obrigatório

false

Valor padrão

30

Tipo

Int32

MaxDays

Número máximo opcional de dias sem atividade. Se definido, apenas dispositivos inativos entre Days e MaxDays serão incluídos.

Propriedade
Valor

Obrigatório

false

Valor padrão

Tipo

Int32

Windows

Incluir dispositivos Windows nos resultados.

Propriedade
Valor

Obrigatório

false

Valor padrão

Verdadeiro

Tipo

Booleano

MacOS

Incluir dispositivos macOS nos resultados.

Propriedade
Valor

Obrigatório

false

Valor padrão

Verdadeiro

Tipo

Booleano

iOS

Incluir dispositivos iOS nos resultados.

Propriedade
Valor

Obrigatório

false

Valor padrão

Verdadeiro

Tipo

Booleano

Android

Incluir dispositivos Android nos resultados.

Propriedade
Valor

Obrigatório

false

Valor padrão

Verdadeiro

Tipo

Booleano

EmailFrom

O endereço de e-mail do remetente. Isto precisa de ser configurado na personalização do runbook.

Propriedade
Valor

Obrigatório

false

Valor padrão

Tipo

Cadeia de caracteres

ServiceDeskDisplayName

Nome de apresentação do Service Desk para informações de contacto do utilizador (opcional).

Propriedade
Valor

Obrigatório

false

Valor padrão

Tipo

Cadeia de caracteres

ServiceDeskEmail

Endereço de e-mail do Service Desk para informações de contacto do utilizador (opcional).

Propriedade
Valor

Obrigatório

false

Valor padrão

Tipo

Cadeia de caracteres

ServiceDeskPhone

Número de telefone do Service Desk para informações de contacto do utilizador (opcional).

Propriedade
Valor

Obrigatório

false

Valor padrão

Tipo

Cadeia de caracteres

UseUserScope

Ative a filtragem de âmbito de utilizadores para incluir ou excluir utilizadores com base na pertença a grupos.

Propriedade
Valor

Obrigatório

false

Valor padrão

Falso

Tipo

Booleano

IncludeUserGroup

Enviar e-mails apenas para utilizadores que sejam membros deste grupo. Requer que UseUserScope esteja ativado.

Propriedade
Valor

Obrigatório

false

Valor padrão

Tipo

Cadeia de caracteres

ExcludeUserGroup

Não enviar e-mails a utilizadores que sejam membros deste grupo. Requer que UseUserScope esteja ativado.

Propriedade
Valor

Obrigatório

false

Valor padrão

Tipo

Cadeia de caracteres

OverrideEmailRecipient

Opcional: endereço(s) de e-mail para os quais enviar todas as notificações em vez dos utilizadores finais. Pode ser separado por vírgulas para vários destinatários. Perfeito para testes, pilotos ou para enviar para sistemas de tickets. Se for deixado em branco, os e-mails serão enviados aos utilizadores finais reais.

Propriedade
Valor

Obrigatório

false

Valor padrão

Tipo

Cadeia de caracteres

MailTemplateLanguage

Selecione qual modelo de e-mail usar: EN (Inglês, predefinição), DE (Alemão) ou Custom (das Personalizações do Runbook).

Propriedade
Valor

Obrigatório

false

Valor padrão

EN

Tipo

Cadeia de caracteres

CustomMailTemplateSubject

Linha de assunto de e-mail personalizada (usada apenas quando MailTemplateLanguage está definido como 'Custom').

Propriedade
Valor

Obrigatório

false

Valor padrão

Tipo

Cadeia de caracteres

CustomMailTemplateBeforeDeviceDetails

Texto personalizado a mostrar antes da lista de dispositivos (usado apenas quando MailTemplateLanguage está definido como 'Custom'). Suporta formatação Markdown.

Propriedade
Valor

Obrigatório

false

Valor padrão

Tipo

Cadeia de caracteres

CustomMailTemplateAfterDeviceDetails

Texto personalizado a mostrar depois da lista de dispositivos (usado apenas quando MailTemplateLanguage está definido como 'Custom'). Suporta formatação Markdown.

Propriedade
Valor

Obrigatório

false

Valor padrão

Tipo

Cadeia de caracteres

Voltar à visão geral da referência do runbook

Última atualização

Isto foi útil?