> 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-low-diskspace_scheduled.md).

# Notificar utilizadores sobre pouco espaço em disco agendado

Enviar e-mail aos utilizadores cujos dispositivos estão a ficar sem espaço em disco

{% 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 Windows e macOS no Intune cujo espaço livre em disco está abaixo de um limite, seja um número fixo de gigabytes ou uma percentagem do disco. Cada utilizador principal recebe um e-mail com a lista dos respetivos dispositivos afetados e passos práticos para libertar espaço. Os dispositivos são classificados como Warning ou Critical. A execução pode ser limitada a dispositivos críticos, a dispositivos com um inventário recente, a um grupo de dispositivos e a determinados utilizadores. Um modo de simulação lista apenas quem seria notificado, e um destinatário de substituição redireciona todos os e-mails para uma caixa de correio de teste.

### Casos de uso comuns

* Lembretes recorrentes para utilizadores cujos dispositivos estão prestes a ficar sem espaço em disco, antes de as atualizações e instalações de aplicações começarem a falhar
* Campanhas em duas etapas: comunicar todos os dispositivos abaixo do limite aos administradores com **Reportar dispositivos com pouco espaço em disco**, e notificar apenas os utilizadores com dispositivos críticos via `NotifyOnSeverity`
* Implementações faseadas por departamento ou grupo piloto através das opções de âmbito de utilizador e de grupo de dispositivos
* Excluindo contas de serviço ou partilhadas através do grupo de exclusão

### Atualidade dos dados e limitações

Os valores de espaço livre e total em disco são lidos do inventário de hardware do Intune de cada dispositivo gerido. Este inventário é atualizado com o check-in regular do dispositivo, pelo que o runbook vê o estado do último inventário bem-sucedido e não o estado atual do dispositivo. Para evitar notificar utilizadores com base em números desatualizados, dispositivos cujo último sincronismo do Intune seja anterior a `MaxInventoryAgeDays` (predefinição 14 dias) são ignorados e contabilizados separadamente. Dispositivos sem data do último sincronismo também são tratados como desatualizados. Defina o parâmetro para `0` para desativar esta verificação.

O runbook complementar **Reportar dispositivos com pouco espaço em disco** não aplica deliberadamente este filtro, pelo que também lista dispositivos com inventário desatualizado e pode mostrar mais dispositivos do que os notificados aqui. Ambos os runbooks aplicam o mesmo limite e a mesma classificação Crítico/Aviso, pelo que um dispositivo é classificado de forma idêntica em ambos; a diferença na contagem de dispositivos são exatamente os dispositivos ignorados por causa de um inventário desatualizado, que este runbook apresenta como um número separado na sua saída.

Dispositivos que reportam um tamanho total de disco de zero bytes não têm inventário de armazenamento utilizável, por exemplo, dispositivos que ainda não concluíram um inventário. Esses dispositivos são excluídos da avaliação em vez de serem tratados como "0 GB livres", e o respetivo número é mostrado na saída da consola.

Apenas dispositivos Windows e macOS são avaliados. O inventário de armazenamento de dispositivos móveis é menos fiável, o limite predefinido em gigabytes foi dimensionado para discos de computadores de secretária e as orientações de limpeza no e-mail são específicas para sistemas operativos de desktop.

Este runbook é o equivalente orientado para o utilizador de **Reportar dispositivos com pouco espaço em disco**. Ambos usam as mesmas definições de limite e a mesma classificação Crítico/Aviso. Use o relatório para a visão geral administrativa, incluindo dispositivos sem um utilizador principal, e este runbook para pedir aos utilizadores afetados que libertem espaço por si próprios.

### Limite e severidade

`ThresholdType` seleciona se um dispositivo é considerado com base numa quantidade fixa de espaço livre (`FreeSpaceThresholdGB`) ou com base na proporção de espaço livre em relação ao tamanho do disco (`FreeSpacePercentThreshold`). Só o campo correspondente ao tipo selecionado é mostrado no portal.

Todos os dispositivos abaixo do limite são classificados: os dispositivos abaixo de metade do limite configurado são marcados como **Crítico**, todos os outros dispositivos abaixo do limite como **Aviso**. A classificação é mostrada por dispositivo no e-mail e, com os modelos incorporados em inglês e alemão, a linha de assunto e a introdução passam para uma formulação urgente assim que um dos dispositivos do utilizador é Crítico. O `Custom` template tem um único assunto e uma única introdução, ambos retirados literalmente da personalização do runbook, pelo que uma notificação Crítico e uma Aviso têm aí uma leitura idêntica - formule o texto personalizado para funcionar para ambos.

`NotifyOnSeverity` controla quais dispositivos desencadeiam uma notificação. Por predefinição, todos os dispositivos abaixo do limite o fazem (*Aviso e Crítico*). Com *Apenas Crítico*, os utilizadores são contactados apenas quando um dispositivo está abaixo de metade do limite. Isto permite uma abordagem em duas etapas: comunicar todos os dispositivos abaixo do limite aos administradores através do runbook de relatório e notificar apenas os utilizadores cujos dispositivos são críticos.

### Comportamento da notificação

O runbook envia **um e-mail por utilizador principal** que lista todos os dispositivos afetados desse utilizador com sistema operativo, modelo, espaço livre e total em disco, classificação e a data do último inventário. O e-mail contém passos práticos de limpeza para as plataformas dos dispositivos listados: a secção Windows é incluída para dispositivos Windows, a secção macOS para dispositivos macOS, e ambas quando o utilizador tem dispositivos afetados de ambos os tipos.

Os destinatários são resolvidos através do Microsoft Graph: o utilizador principal de um dispositivo é procurado pelo ID de objeto Entra que o Intune reporta em `userId`, pelo que contas convidadas e utilizadores cujo UPN atual difere do endereço registado no registo são resolvidos corretamente; dispositivos sem um `userId` fazem recurso a uma pesquisa pelo nome principal do utilizador. Os dispositivos são agrupados pela conta que o Graph devolve, pelo que um utilizador cujos dispositivos reportam o ID de objeto em alguns e apenas o UPN noutros ainda recebe um único e-mail. O e-mail é então enviado para o atributo `mail` do utilizador, com o nome principal do utilizador como fallback quando nenhum atributo mail está definido. Contas desativadas e utilizadores que não possam ser resolvidos são ignorados; são listados na saída da consola e, com o motivo, na tabela de Dados de Saída "Notificações". Se não for possível resolver um único utilizador afetado e pelo menos uma pesquisa tiver falhado por outro motivo que não um utilizador eliminado, por exemplo porque a identidade gerida não tem `User.Read.All` ou o Graph aplica limitação de taxa às pesquisas, ninguém é notificado e o trabalho termina como falhado depois de escrever os seus Dados de Saída. Uma execução cujas pesquisas falhadas digam respeito apenas a utilizadores eliminados (não encontrados) conclui com um aviso, e uma execução de simulação conclui sempre. Dispositivos sem utilizador principal não podem ser notificados; aparecem na tabela de Dados de Saída "Dispositivos com pouco espaço em disco" com o motivo "Sem utilizador principal" para acompanhamento centralizado (o runbook de relatório também os cobre).

`SimulationMode` lista os utilizadores afetados, os respetivos dispositivos e os destinatários pretendidos na saída da consola e nas tabelas de Dados de Saída sem enviar qualquer e-mail. Use-o para validar limites e filtros de âmbito antes da primeira execução em produção.

`OverrideEmailRecipient` redireciona **ALL** todas as notificações para o endereço indicado (separado por vírgulas para vários destinatários) em vez dos utilizadores finais. É registado um aviso em cada execução enquanto a substituição estiver ativa, e cada e-mail redirecionado indica o utilizador afetado no assunto e no corpo. Utilize isto para testar o conteúdo do e-mail ou para encaminhar tudo para uma caixa de correio partilhada.

Tenha em conta que a caixa de correio de substituição recebe então um e-mail por utilizador afetado, todos enviados em poucos segundos e com linhas de assunto urgentes. Os filtros de correio podem classificar esse fluxo de e-mails semelhantes como envio em massa ou spam e movê-lo para a pasta de lixo eletrónico ou para a quarentena, em particular quando a caixa de correio de substituição pertence a outro Tenant. O runbook apenas vê que o Microsoft Graph aceitou cada e-mail e reporta-o como enviado; o que o lado recetor faz depois não é visível na saída do trabalho. Se os e-mails não chegarem, verifique a pasta de lixo eletrónico e a quarentena da caixa de correio de substituição e execute um rastreamento de mensagens para o endereço do remetente. Uma caixa de correio no mesmo Tenant é o destino de teste mais fiável.

### Opções de âmbito

* **Âmbito do utilizador:** Com `UseUserScope` ativado, `IncludeUserGroup` limita as notificações aos utilizadores que são membros desse grupo, e `ExcludeUserGroup` suprime as notificações para membros desse grupo. Ambos usam a pertença transitiva, pelo que os grupos aninhados são resolvidos, e ambos são lidos uma única vez no início da execução.
* **Âmbito do dispositivo:** `IncludeDeviceGroup` limita a avaliação aos dispositivos que são membros (transitivamente) do grupo de dispositivos Entra indicado. Os dispositivos são correspondidos através do respetivo ID de dispositivo Entra.

Quando um âmbito de utilizador e um âmbito de dispositivo estão configurados, um dispositivo tem de corresponder a ambos. Uma pesquisa de grupo falhada interrompe o runbook com um erro em vez de notificar silenciosamente todos os utilizadores.

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

Os e-mails de notificação são enviados para os utilizadores afetados; o endereço do remetente é obtido da `RJReport.EmailSender` definição do tenant e é obrigatório.

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 de notificação respeita o opcional `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 predefinidas do RealmJoin. Uma imagem que não possa ser descarregada ou validada, ou um valor de cor inválido, nunca impede o e-mail – em vez disso, é usada a predefiniçã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 definições do tenant adicionam um bloco de contacto ao fim de cada e-mail. `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.

O modelo personalizado consiste num assunto, num texto antes da lista de dispositivos e num texto após a lista de dispositivos. Os passos de limpeza incorporados, a secção "Porque é que isto é importante" e a secção "Perguntas" são **não** apresentados com o modelo personalizado, pelo que o texto após a lista de dispositivos deve conter as suas próprias orientações de limpeza.

**Exemplo: modelo personalizado**

```json
{
    "Runbooks": {
        "rjgit-org_devices_notify-users-about-low-diskspace_scheduled": {
            "Parameters": {
                "CustomMailTemplateSubject": {
                    "Default": "Este é um assunto personalizado - Ação necessária: pouco espaço em disco"
                },
                "CustomMailTemplateBeforeDeviceDetails": {
                    "Default": "**Isto fica acima dos Detalhes do Dispositivo.** \n\nCaro utilizador, os seguintes dispositivos estão a ficar sem espaço em disco:"
                },
                "CustomMailTemplateAfterDeviceDetails": {
                    "Default": "**Isto fica abaixo dos Detalhes do Dispositivo.** \n\n## O que pode fazer agora\n\n1. Esvaziar a Reciclagem\n2. ..."
                }
            }
        }
    }
}
```

**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 template from runbook customization" no campo "Mail template"
* As etiquetas da lista de dispositivos são apresentadas em inglês para o modelo personalizado

### Localização

Organização → Dispositivos → Notificar utilizadores sobre pouco espaço em disco (Agendado)

**Nome completo do runbook**

rjgit-org\_devices\_notify-users-about-low-diskspace\_scheduled

### Detalhes

| Propriedade         | Valor                                                                                    |
| ------------------- | ---------------------------------------------------------------------------------------- |
| Versão              | 1.1.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 geridos pelo Intune incluindo freeStorageSpaceInBytes, totalStorageSpaceInBytes, lastSyncDateTime e o utilizador principal (userId e userPrincipalName) para encontrar dispositivos abaixo do limite de pouco espaço em disco*
  * User.Read.All
    * *Resolve cada utilizador principal afetado (endereço de e-mail, nome apresentado e accountEnabled) antes de enviar a notificação*
  * Mail.Send
    * *Envia o e-mail de notificação de pouco espaço em disco para cada utilizador principal ou para o destinatário de substituição*
  * Organization.Read.All *(opcional — funcionalidade: nome do Tenant no rodapé do e-mail)*
    * *Lê /organization para o nome do tenant mostrado no rodapé do e-mail; sem isso, o runbook recua para 'Unknown Tenant'*
  * Directory.Read.All *(opcional — funcionalidade: filtragem por âmbito de grupo)*
    * *Lê os membros transitivos de utilizador dos grupos de utilizadores de inclusão/exclusão e os membros transitivos de dispositivos (ID de dispositivo Entra) do grupo de dispositivos opcional*

### Parâmetros

#### ThresholdType

Por uma quantidade fixa de gigabytes livres ou pela percentagem de espaço livre no disco.

| Propriedade                | Valor                                              |
| -------------------------- | -------------------------------------------------- |
| Obrigatório                | falso                                              |
| Valor padrão               | Espaço livre em GB                                 |
| Tipo                       | Texto                                              |
| Nome de exibição no portal | Como deve ser determinado o pouco espaço em disco? |

**Opções do portal**

| Opção do portal                                                | Valor                       |
| -------------------------------------------------------------- | --------------------------- |
| Espaço livre abaixo de um tamanho fixo (GB)                    | Espaço livre em GB          |
| Espaço livre abaixo de uma percentagem do tamanho do disco (%) | Espaço livre em percentagem |

#### FreeSpaceThresholdGB

Os dispositivos com menos espaço livre do que este número de gigabytes são afetados.

| Propriedade                | Valor                       |
| -------------------------- | --------------------------- |
| Obrigatório                | falso                       |
| Valor padrão               | 20                          |
| Tipo                       | Int32                       |
| Nome de exibição no portal | Limite de espaço livre (GB) |

#### FreeSpacePercentThreshold

Os dispositivos com menos espaço livre do que esta percentagem do disco são afetados.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               | 10                                                      |
| Tipo                       | Int32                                                   |
| Nome de exibição no portal | Limite de espaço livre (%)                              |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

#### NotifyOnSeverity

Todos os dispositivos abaixo do limite (Aviso e Crítico), ou apenas os dispositivos abaixo de metade do mesmo (Apenas Crítico).

| Propriedade                | Valor                                                 |
| -------------------------- | ----------------------------------------------------- |
| Obrigatório                | falso                                                 |
| Valor padrão               | Aviso e Crítico                                       |
| Tipo                       | Texto                                                 |
| Nome de exibição no portal | Quais dispositivos devem desencadear uma notificação? |

**Opções do portal**

| Opção do portal                                          | Valor           |
| -------------------------------------------------------- | --------------- |
| Aviso e Crítico - todos os dispositivos abaixo do limite | Aviso e Crítico |
| Apenas Crítico - dispositivos abaixo de metade do limite | Apenas Crítico  |

#### 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? |

#### MaxInventoryAgeDays

Os dispositivos cujo último sincronismo do Intune seja anterior a este número de dias são ignorados, porque os respetivos dados de disco estão desatualizados. 0 desativa a verificação.

| Propriedade                | Valor                                                 |
| -------------------------- | ----------------------------------------------------- |
| Obrigatório                | falso                                                 |
| Valor padrão               | 14                                                    |
| Tipo                       | Int32                                                 |
| Nome de exibição no portal | Ignorar dispositivos não sincronizados durante (dias) |

#### 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

Ligação para o ticket do service desk mostrado no e-mail. Obtida da definição do tenant RJReport.ServiceDesk\_TicketUrl; vazio significa sem ligação.

| 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

Só os utilizadores deste grupo, incluindo grupos aninhados, 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

Os utilizadores deste grupo, incluindo grupos aninhados, 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) |

#### IncludeDeviceGroup

Só os dispositivos deste grupo Entra ID, incluindo grupos aninhados, são verificados. Pode ser combinado com o filtro de utilizadores.

| Propriedade                | Valor                           |
| -------------------------- | ------------------------------- |
| Obrigatório                | falso                           |
| Valor padrão               |                                 |
| Tipo                       | Texto                           |
| Nome de exibição no portal | Limitar a dispositivos no grupo |

#### OverrideEmailRecipient

Envia todos os e-mails para estes endereços em vez dos utilizadores, para testes e pilotos. A caixa de correio recebe um e-mail por utilizador afetado em poucos segundos, o que os filtros de correio podem tratar como spam; prefira uma caixa de correio no seu próprio Tenant.

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

#### SimulationMode

A simulação apenas lista os utilizadores e dispositivos afetados; nada é enviado.

| Propriedade                | Valor               |
| -------------------------- | ------------------- |
| Obrigatório                | falso               |
| Valor padrão               | Falso               |
| Tipo                       | Booleano            |
| Nome de exibição no portal | Modo de notificação |

**Opções do portal**

| Opção do portal                                                     | Valor      |
| ------------------------------------------------------------------- | ---------- |
| Enviar notificações aos utilizadores                                | falso      |
| Simulação - listar apenas os utilizadores afetados, não enviar nada | verdadeiro |

#### 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 |

**Opções do portal**

| Opção do portal                                   | Valor  |
| ------------------------------------------------- | ------ |
| Inglês (predefinição)                             | EN     |
| Alemão                                            | DE     |
| Modelo personalizado da personalização do runbook | Custom |

#### CustomMailTemplateSubject

Assunto do e-mail quando o modelo personalizado é usado, tanto para Aviso como para Crítico.

| 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; substitui os passos de limpeza incorporados. 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-low-diskspace_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.
