> 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/pt/automatizacao/runbooks/runbook-references/org/devices/notify-users-about-stale-devices_scheduled.md).

# Notificar utilizadores sobre dispositivos obsoletos agendado

Enviar e-mail aos utilizadores sobre dispositivos que não usam há algum tempo

{% hint style="info" %}
Este é um runbook agendado. Ele foi projetado para ser executado em um agendamento recorrente, em vez de ser acionado para um único objeto. Consulte [Agendamento](https://docs.realmjoin.com/pt/automatizacao/runbooks/scheduling.md) para ver detalhes sobre como configurar agendamentos de runbook.
{% endhint %}

### Descrição

Encontra dispositivos do Intune que não estiveram ativos por um determinado número de dias. Cada usuário principal recebe um e-mail listando seus dispositivos obsoletos e o que fazer com eles. Os usuários podem ser incluídos ou excluídos por grupo. Os e-mails podem ser redirecionados: todos para um endereço de substituição para testes, ou os de contas que correspondam a um padrão de nome para um destinatário dedicado. Dispositivos obsoletos sem um usuário principal podem ser reunidos em um único e-mail combinado.

### Casos de uso comuns

* Lembretes automatizados aos usuários sobre dispositivos inativos para incentivar verificações regulares dos dispositivos
* Gerenciamento proativo do ciclo de vida dos dispositivos, alertando os usuários antes que os dispositivos sejam aposentados
* Segurança e conformidade, garantindo que os usuários estejam cientes de todos os dispositivos registrados em seu nome
* Notificações em etapas por meio do `DiasMáximos` parâmetro, por exemplo, um primeiro lembrete após 30 dias e uma notificação final após 60 dias
* Filtragem do escopo de usuários para direcionar departamentos específicos ou excluir contas de serviço
* Tratamento centralizado de dispositivos sem usuário principal ou pertencentes a contas do Device Enrollment Manager (por exemplo `DEM-*`) por meio de destinatários dedicados

### Configuração relativa ao envio de e-mail

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

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

Veja a [documentação das definições de relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obter detalhes sobre todas as definições disponíveis.

#### Branding do e-mail

O e-mail do relatório respeita as `RJReport.Branding.*` definições opcionais do Tenant:

* **Imagem do cabeçalho e do rodapé** – URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada
* **Link do rodapé** – destino da imagem do rodapé
* **Cor de destaque e do texto** – valores hexadecimais de 6 dígitos, por exemplo `#0052cc`

Quando estas definições não estão configuradas, são usadas as imagens e cores padrão do RealmJoin. Uma imagem que não pode ser transferida ou validada, ou um valor de cor inválido, nunca impede o e-mail do relatório – em vez disso, é usado o padrão correspondente.

Instruções de configuração e requisitos de imagem: [Branding do e-mail](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

#### Informações de contacto do Service Desk

O opcional `RJReport.ServiceDesk_DisplayName`, `RJReport.ServiceDesk_EMail`, `RJReport.ServiceDesk_Phone` e `RJReport.ServiceDesk_PortalUrl` As configurações do tenant adicionam um bloco de contato ao final de cada e-mail de notificação. `ServiceDeskTicketUrl` pode ainda ligar a um ticket.

### 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 inglês incorporado
2. **DE (Alemão)**: Usa o modelo alemão incorporado
3. **Custom**: Usa um modelo personalizado das 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), é necessário configurar o texto do modelo nas personalizações do runbook. Se faltar algum parâmetro do modelo personalizado, o runbook fará automaticamente fallback para o modelo inglês.

**Exemplo: modelo personalizado**

```json
{
    "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\nPrezado usuário ..."
                },
                "CustomMailTemplateAfterDeviceDetails": {
                    "Default": "**Isto está abaixo dos Detalhes do dispositivo.** \n\n## O que você deve fazer..."
                }
            }
        }
    }
}
```

**Notas importantes:**

* Utilize `\n` para quebras de linha na configuração JSON
* A formatação Markdown (##, ###, \*\*, -) é suportada no texto do modelo
* Todos os três parâmetros do modelo personalizado (Subject, BeforeDeviceDetails, AfterDeviceDetails) devem ser configurados
* Se algum parâmetro estiver em falta, o runbook faz automaticamente fallback para o modelo inglês (EN)
* Ao usar o modelo personalizado, selecione "Custom - Use Template from Runbook Customizations" na lista suspensa Mail Template

### Roteamento de e-mails

O runbook conhece três destinos de roteamento independentes, verificados nesta ordem de precedência:

1. **Substituição global (teste):** Um valor preenchido `OverrideEmailRecipient` redireciona **ALL** envia e-mails - notificações de usuários, notificações roteadas por padrão e o e-mail combinado para dispositivos sem usuário principal - para esse endereço. Nenhum usuário final recebe um e-mail. Use isso para testes, pilotos ou para encaminhar tudo para uma caixa de correio compartilhada ou sistema de chamados. Um aviso é registrado em cada execução enquanto a substituição estiver ativa.
2. **Usuários correspondentes ao padrão:** Quando `OverrideUserNamePattern` está definido, as notificações dos usuários cujo UPN corresponde ao padrão são enviadas para `UserNamePatternEmailRecipient` em vez de para o usuário. Todos os outros usuários recebem sua notificação diretamente. Uso típico: contas do Device Enrollment Manager ou de quiosque (`DEM-*`, `KIOSK-*`). cujas caixas de correio ninguém lê.
3. **Dispositivos sem usuário principal:** Quando `SendNoPrimaryUserDevicesToOverride` está habilitado, dispositivos obsoletos sem um usuário principal são reunidos em **uma** um e-mail combinado para `NoPrimaryUserEmailRecipient`. Caso contrário, esses dispositivos são ignorados. Essa configuração nunca altera como as notificações dos usuários são roteadas.

Configurações incompletas interrompem o runbook com um erro, em vez de enviar e-mails silenciosamente aos usuários finais:

* `SendNoPrimaryUserDevicesToOverride` habilitado sem `NoPrimaryUserEmailRecipient` (e sem uma substituição global) - erro.
* `OverrideUserNamePattern` definido sem `UserNamePatternEmailRecipient` (e sem uma substituição global) - erro.
* Um destinatário definido sem seu recurso (`NoPrimaryUserEmailRecipient` sem a alternância, `UserNamePatternEmailRecipient` sem um padrão) - aviso, o destinatário é ignorado.

Enquanto a substituição global estiver ativa, os destinatários dedicados não precisam ser definidos - tudo vai para o destinatário de substituição de qualquer forma.

#### Padrão do nome de usuário

`OverrideUserNamePattern` aceita um ou mais padrões curinga (separados por vírgula) correspondentes ao UPN do usuário principal, por exemplo `DEM-*` para contas do Device Enrollment Manager ou `DEM-*,KIOSK-*` para vários padrões. A correspondência não diferencia maiúsculas de minúsculas e usa a sintaxe de curingas do PowerShell (`*`, `?`). Quando o roteamento por padrão está ativo, o runbook registra um aviso informando qual padrão é redirecionado para qual destinatário.

**Notas importantes:**

* Todos os parâmetros de destinatário aceitam vários endereços separados por vírgulas
* Dispositivos sem usuário principal ignoram a filtragem de escopo de usuários (eles não têm um usuário para comparar com grupos)
* Usuários correspondentes ao padrão ainda estão sujeitos primeiro à filtragem de escopo de usuários; usuários excluídos pelo escopo não produzem nenhuma notificação
* O e-mail combinado para dispositivos sem usuário principal usa uma redação administrativa (sem etapas de ação para o usuário final), independentemente de modelos personalizados
* Notificações redirecionadas indicam o usuário afetado no assunto e no corpo do e-mail

### Localização

Organização → Dispositivos → Notificar usuários sobre dispositivos obsoletos (agendado)

**Nome completo do runbook**

rjgit-org\_devices\_notify-users-about-stale-devices\_scheduled

### Detalhes

| Propriedade         | Valor                                                                                    |
| ------------------- | ---------------------------------------------------------------------------------------- |
| Versão              | 1.7.0                                                                                    |
| Módulos necessários | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| Agendável           | sim                                                                                      |

### Permissões

#### Permissões de aplicativo

* **Tipo**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *Lê dispositivos gerenciados pelo Intune filtrados por lastSyncDateTime para encontrar dispositivos obsoletos e seus usuários principais*
  * Directory.Read.All
    * *Lê o nome do tenant para o rodapé do e-mail e resolve IDs de usuário para a filtragem de escopo de grupo*
  * Group.Read.All
    * *Lista os membros dos grupos de inclusão/exclusão para filtrar quais usuários principais recebem notificação*
  * Mail.Send
    * *Envia os e-mails de notificação de dispositivos obsoletos para cada usuário principal ou para o destinatário de substituição*

### Parâmetros

#### Dias

Dispositivos inativos por pelo menos este número de dias são considerados obsoletos.

| Propriedade                | Valor              |
| -------------------------- | ------------------ |
| Obrigatório                | falso              |
| Valor padrão               | 30                 |
| Tipo                       | Int32              |
| Nome de exibição no portal | Dias sem atividade |

#### DiasMáximos

Somente dispositivos inativos por no máximo este número de dias são incluídos. Deixe em branco para não definir limite superior.

| Propriedade                | Valor                        |
| -------------------------- | ---------------------------- |
| Obrigatório                | falso                        |
| Valor padrão               |                              |
| Tipo                       | Int32                        |
| Nome de exibição no portal | Máximo de dias sem atividade |

#### Windows

Inclui dispositivos Windows.

| Propriedade                | Valor                         |
| -------------------------- | ----------------------------- |
| Obrigatório                | falso                         |
| Valor padrão               | Verdadeiro                    |
| Tipo                       | Booleano                      |
| Nome de exibição no portal | Incluir dispositivos Windows? |

#### MacOS

Inclui dispositivos macOS.

| Propriedade                | Valor                       |
| -------------------------- | --------------------------- |
| Obrigatório                | falso                       |
| Valor padrão               | Verdadeiro                  |
| Tipo                       | Booleano                    |
| Nome de exibição no portal | Incluir dispositivos macOS? |

#### iOS

Inclui dispositivos iOS e iPadOS.

| Propriedade                | Valor                     |
| -------------------------- | ------------------------- |
| Obrigatório                | falso                     |
| Valor padrão               | Verdadeiro                |
| Tipo                       | Booleano                  |
| Nome de exibição no portal | Incluir dispositivos iOS? |

#### Android

Inclui dispositivos Android.

| Propriedade                | Valor                         |
| -------------------------- | ----------------------------- |
| Obrigatório                | falso                         |
| Valor padrão               | Verdadeiro                    |
| Tipo                       | Booleano                      |
| Nome de exibição no portal | Incluir dispositivos Android? |

#### EmailFrom

Endereço do remetente do email de notificação. Obtido da definição do Tenant RJReport.EmailSender.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingHeaderImageUrl

Imagem do cabeçalho do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida a partir da definição do Tenant RJReport.Branding.HeaderImageUrl; o cabeçalho padrão do RealmJoin é usado quando está vazio.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingFooterImageUrl

Imagem do rodapé do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida a partir da definição do Tenant RJReport.Branding.FooterImageUrl; o rodapé padrão do RealmJoin é usado quando está vazio.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingFooterLink

Link por trás da imagem do rodapé do e-mail do relatório. Obtido a partir da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é usado quando está vazio.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingAccentColor

Cor de destaque do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida a partir da definição do Tenant RJReport.Branding.AccentColor; o padrão do RealmJoin é usado quando está vazio ou inválido.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingTextColor

Cor do texto do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida a partir da definição do Tenant RJReport.Branding.TextColor; o padrão do RealmJoin é usado quando está vazio ou inválido.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ServiceDeskDisplayName

Nome do serviço de apoio mostrado no email. Obtido da definição do Tenant RJReport.ServiceDesk\_DisplayName.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ServiceDeskEmail

Endereço de email do serviço de apoio mostrado no email. Obtido da definição do Tenant RJReport.ServiceDesk\_EMail.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ServiceDeskPhone

Número de telefone do serviço de apoio mostrado no email. Obtido da definição do Tenant RJReport.ServiceDesk\_Phone.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ServiceDeskPortalUrl

Ligação para o portal do serviço de apoio mostrada no email. Obtida da definição do Tenant RJReport.ServiceDesk\_PortalUrl.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ServiceDeskTicketUrl

Link para o chamado do service desk mostrado no e-mail. Deixe em branco para não incluir link.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### UseUserScope

Se os utilizadores são filtrados por pertença a grupo. Definido pela opção "Filtrar utilizadores por grupo?".

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | Falso                                                   |
| Tipo             | Booleano                                                |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### IncludeUserGroup

Somente usuários neste grupo são notificados.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               |                                                         |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Incluir utilizadores do grupo                           |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

#### ExcludeUserGroup

Usuários neste grupo não são notificados.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               |                                                         |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Excluir utilizadores do grupo                           |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

#### OverrideEmailRecipient

Envia todos os e-mails, incluindo os roteados por padrão e o e-mail combinado, para esses endereços em vez dos destinatários normais. Para testes, pilotos ou um sistema de chamados.

| Propriedade                | Valor                              |
| -------------------------- | ---------------------------------- |
| Obrigatório                | falso                              |
| Valor padrão               |                                    |
| Tipo                       | Texto                              |
| Nome de exibição no portal | Redirecionar todos os e-mails para |

#### OverrideUserNamePattern

Padrões curinga para nomes de usuário, separados por vírgulas, por exemplo DEM-*,KIOSK-*. Os e-mails dos usuários correspondentes vão para "Recipient for pattern-matched users".

| Propriedade                | Valor                               |
| -------------------------- | ----------------------------------- |
| Obrigatório                | falso                               |
| Valor padrão               |                                     |
| Tipo                       | Texto                               |
| Nome de exibição no portal | Padrão do nome do usuário principal |

#### UserNamePatternEmailRecipient

Endereços que recebem os e-mails dos usuários que correspondem ao padrão, separados por vírgulas. Obrigatório quando um padrão está definido e nenhuma substituição está ativa.

| Propriedade                | Valor                                                |
| -------------------------- | ---------------------------------------------------- |
| Obrigatório                | falso                                                |
| Valor padrão               |                                                      |
| Tipo                       | Texto                                                |
| Nome de exibição no portal | Destinatário para usuários correspondentes ao padrão |

#### SendNoPrimaryUserDevicesToOverride

Reúne dispositivos obsoletos que não têm usuário principal em um único e-mail combinado para o "Recipient for devices without primary user". Esses dispositivos ignoram o filtro de usuários.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | Falso                                                   |
| Tipo             | Booleano                                                |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### NoPrimaryUserEmailRecipient

Endereços para o e-mail combinado, separados por vírgulas. Obrigatório quando o e-mail combinado está habilitado e nenhuma substituição está definida.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               |                                                         |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Destinatário para dispositivos sem usuário principal    |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

#### MailTemplateLanguage

Inglês, alemão ou o modelo personalizado da personalização do runbook; o inglês é usado quando o modelo personalizado está vazio.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               | EN                                                      |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Modelo de e-mail                                        |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

#### CustomMailTemplateSubject

Assunto do e-mail quando o modelo personalizado é usado.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               |                                                         |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Assunto do e-mail personalizado                         |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

#### CustomMailTemplateBeforeDeviceDetails

Texto acima da lista de dispositivos quando o modelo personalizado é usado. Markdown é permitido.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               |                                                         |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Texto personalizado antes da lista de dispositivos      |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

#### CustomMailTemplateAfterDeviceDetails

Texto abaixo da lista de dispositivos quando o modelo personalizado é usado. Markdown é permitido.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               |                                                         |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Texto personalizado após a lista de dispositivos        |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

[Voltar à visão geral da referência do runbook](https://docs.realmjoin.com/pt/automatizacao/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/pt/automatizacao/runbooks/runbook-references/org/devices/notify-users-about-stale-devices_scheduled.md?ask=<question>&goal=<user_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.
