> 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. Veja [Agendamento](/pt/automatizacao/runbooks/scheduling.md) para obter detalhes sobre como configurar os agendamentos do 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 email listando seus dispositivos obsoletos e o que fazer com eles. Os usuários podem ser incluídos ou excluídos por grupo. Os emails podem ser redirecionados: todos eles para um endereço de substituição para testes, ou os de contas que correspondem a um padrão de nome para um destinatário dedicado. Dispositivos obsoletos sem um usuário principal podem ser reunidos em um único email 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 `MaxDays` parâmetro, por exemplo, um primeiro lembrete após 30 dias e um aviso final após 60 dias
* Filtragem do escopo do usuário para direcionar departamentos específicos ou excluir contas de serviço
* Tratamento centralizado de dispositivos sem um 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 emails
Enviar um relatório por email é opcional e só acontece quando é fornecido um destinatário (`EmailTo`). O endereço do remetente é obtido da definição do `RJReport.EmailSender` Tenant.
Este runbook envia emails utilizando a API do Microsoft Graph. Para enviar emails através da Graph API, é necessário configurar um endereço de email existente na personalização do runbook.
Consulte 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 email
O email do relatório respeita as definições opcionais de `RJReport.Branding.*` do Tenant:
* **Imagem do cabeçalho e do rodapé** – URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada
* **Ligação no 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 utilizadas as imagens e cores predefinidas do RealmJoin. Uma imagem que não possa ser transferida ou validada, ou um valor de cor inválido, nunca impede o email do relatório – é utilizada em vez disso a predefinição correspondente.
Instruções de configuração e requisitos da imagem: [Branding do email](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).
#### Informações de contato do Service Desk
A 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 email de notificação. `ServiceDeskTicketUrl` também pode incluir um link para um ticket.
### Seleção de idioma do modelo de email
Este runbook oferece suporte a três opções de modelo de email:
1. **EN (Inglês - Padrão)**: Usa o modelo de email em inglês integrado
2. **DE (Alemão)**: Usa o modelo de email em alemão integrado
3. **Personalizado**: Usa um modelo personalizado das Personalizações do Runbook
#### Uso de modelos de email personalizados
Para usar um modelo de email personalizado (por exemplo, em holandês, espanhol ou qualquer outro idioma), você precisa configurar o texto do modelo nas Personalizações do Runbook. Se qualquer parâmetro do modelo personalizado estiver ausente, o runbook fará automaticamente fallback para o modelo em 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": "**Isso está acima dos Detalhes do Dispositivo.** \n\nCaro usuário ..."
},
"CustomMailTemplateAfterDeviceDetails": {
"Default": "**Isso está abaixo dos Detalhes do Dispositivo.** \n\n## O que você 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 do modelo personalizado (Subject, BeforeDeviceDetails, AfterDeviceDetails) devem ser configurados
* Se qualquer parâmetro estiver ausente, o runbook faz fallback automaticamente para o modelo em inglês (EN)
* Ao usar o modelo personalizado, selecione "Personalizado - Usar modelo das Personalizações do Runbook" no menu suspenso Modelo de email
### Encaminhamento de email
O runbook conhece três destinos de roteamento independentes, verificados nesta ordem de precedência:
1. **Substituição global (teste):** Um campo preenchido `OverrideEmailRecipient` redireciona **TODAS** redireciona emails — notificações de usuários, notificações roteadas por padrão e o email combinado para dispositivos sem um usuário principal — para esse endereço. Nenhum usuário final recebe um email. Use isso para testes, pilotos ou para redirecionar tudo para uma caixa de correio compartilhada ou sistema de tickets. Um aviso é registrado em cada execução enquanto a substituição estiver ativa.
2. **Usuários com correspondência de 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 do usuário. Todos os demais 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, os dispositivos obsoletos sem um usuário principal são reunidos em **um** email 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 emails 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 opção, `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 de 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 curinga 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 do escopo do usuário (eles não têm um usuário para corresponder aos grupos)
* Usuários com correspondência de padrão ainda estão sujeitos primeiro à filtragem do escopo do usuário; usuários excluídos pelo escopo não produzem nenhuma notificação
* O email combinado para dispositivos sem um 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 informam o usuário afetado no assunto e no corpo do email
### 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 | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
|
| Agendável | sim |
### Permissões
#### Permissões da aplicação
* **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 email e resolve IDs de usuário para a filtragem do escopo do 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 emails 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 predefinido | 30 |
| Tipo | Int32 |
| Nome de exibição do portal | Dias sem atividade |
#### MaxDays
Apenas dispositivos inativos por no máximo este número de dias são incluídos. Deixe em branco para não haver limite superior.
| Propriedade | Valor |
| -------------------------- | ---------------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Int32 |
| Nome de exibição do portal | Máximo de dias sem atividade |
#### Windows
Inclui dispositivos Windows.
| Propriedade | Valor |
| -------------------------- | ----------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir dispositivos Windows? |
#### MacOS
Inclui dispositivos macOS.
| Propriedade | Valor |
| -------------------------- | --------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir dispositivos macOS? |
#### iOS
Inclui dispositivos iOS e iPadOS.
| Propriedade | Valor |
| -------------------------- | ------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir dispositivos iOS? |
#### Android
Inclui dispositivos Android.
| Propriedade | Valor |
| -------------------------- | ----------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir dispositivos Android? |
#### EmailFrom
Endereço do remetente do e-mail de notificação. Obtido a partir da definição do Tenant RJReport.EmailSender.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingHeaderImageUrl
Imagem de cabeçalho do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.HeaderImageUrl; é utilizado o cabeçalho predefinido do RealmJoin quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingFooterImageUrl
Imagem de rodapé do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.FooterImageUrl; é utilizado o rodapé predefinido do RealmJoin quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingFooterLink
Ligação por trás da imagem de rodapé do email do relatório. Obtida da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é utilizado quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingAccentColor
Cor de destaque do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.AccentColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingTextColor
Cor do texto do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.TextColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ServiceDeskDisplayName
Nome do service desk mostrado no e-mail. Obtido a partir da definição do Tenant RJReport.ServiceDesk\_DisplayName.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ServiceDeskEmail
Endereço de e-mail do service desk mostrado no e-mail. Obtido a partir da definição do Tenant RJReport.ServiceDesk\_EMail.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ServiceDeskPhone
Número de telefone do service desk mostrado no e-mail. Obtido a partir da definição do Tenant RJReport.ServiceDesk\_Phone.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ServiceDeskPortalUrl
Ligação para o portal do service desk mostrada no e-mail. Obtida a partir da definição do Tenant RJReport.ServiceDesk\_PortalUrl.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ServiceDeskTicketUrl
Link para o ticket do service desk exibido no email. Deixe em branco para não usar link.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### UseUserScope
Indica se os usuários são filtrados por associação a grupo. Definido pela escolha "Filtrar usuários por grupo?".
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### IncludeUserGroup
Somente usuários deste grupo são notificados.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Incluir usuários do grupo |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ExcludeUserGroup
Usuários deste grupo não são notificados.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Excluir usuários do grupo |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### OverrideEmailRecipient
Envia todos os emails, incluindo os roteados por padrão e o email combinado, para estes endereços em vez dos destinatários normais. Para testes, pilotos ou um sistema de tickets.
| Propriedade | Valor |
| -------------------------- | --------------------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Redirecionar todos os emails para |
#### OverrideUserNamePattern
Padrões curinga para nomes de usuário, separados por vírgulas, por exemplo DEM-*,KIOSK-*. Os emails dos usuários correspondentes vão para "Destinatário para usuários com correspondência de padrão" em vez disso.
| Propriedade | Valor |
| -------------------------- | ----------------------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Padrão do nome do usuário principal |
#### UserNamePatternEmailRecipient
Endereços que recebem os emails dos usuários que correspondem ao padrão, separados por vírgulas. Obrigatório quando um padrão é definido e nenhuma substituição está ativa.
| Propriedade | Valor |
| -------------------------- | -------------------------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Destinatário para usuários com correspondência de padrão |
#### SendNoPrimaryUserDevicesToOverride
Reúne dispositivos obsoletos que não têm usuário principal em um email combinado para o "Destinatário para dispositivos sem usuário principal". Esses dispositivos ignoram o filtro de usuário.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### NoPrimaryUserEmailRecipient
Endereços para o email combinado, separados por vírgulas. Obrigatório quando o email combinado está habilitado e nenhuma substituição está definida.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Destinatário para dispositivos sem usuário principal |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### MailTemplateLanguage
Inglês, alemão ou o modelo personalizado da personalização do runbook; o inglês é usado onde o modelo personalizado está vazio.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | EN |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Modelo de email |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### CustomMailTemplateSubject
Assunto do email quando o modelo personalizado é usado.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Personalizado: assunto do email |
| Oculto no portal | sim (predefinido através 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 predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Personalizado: texto antes da lista de dispositivos |
| Oculto no portal | sim (predefinido através 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 predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Personalizado: texto após a lista de dispositivos |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
[Voltar à visão geral da referência do Runbook](/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=&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.