> 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. Veja [Agendamento](/pt/automatizacao/runbooks/scheduling.md) para obter detalhes sobre como configurar os agendamentos do runbook.
{% endhint %}

### Descrição

Localiza dispositivos Windows e macOS no Intune cujo espaço livre em disco esteja abaixo de um limite, seja um número fixo de gigabytes ou uma porcentagem do disco. Cada usuário principal recebe um email listando seus dispositivos afetados com passos práticos para liberar espaço. Os dispositivos são classificados como Aviso ou Crítico. A execução pode ser limitada a dispositivos críticos, a dispositivos com inventário recente, a um grupo de dispositivos e a determinados usuários. Um modo de simulação lista apenas quem seria notificado, e um destinatário de substituição redireciona todos os emails para uma caixa de correio de teste.

### Casos de uso comuns

* Lembretes recorrentes para usuários cujos dispositivos estão prestes a ficar sem espaço em disco, antes que atualizações e instalações de aplicativos comecem a falhar
* Campanhas em duas etapas: reporte todos os dispositivos abaixo do limite aos administradores com **Reportar dispositivos com pouco espaço em disco**, e notifique apenas os usuários com dispositivos críticos via `NotifyOnSeverity`
* Implantações em fases por departamento ou grupo piloto por meio das opções de escopo de grupo de usuários e de dispositivos
* Excluindo contas de serviço ou compartilhadas por meio 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 gerenciado. Esse inventário é atualizado com o check-in regular do dispositivo, portanto o runbook vê o estado do último inventário bem-sucedido em vez do estado atual do dispositivo. Para evitar notificar usuários com base em números desatualizados, dispositivos cujo último sync do Intune seja mais antigo que `MaxInventoryAgeDays` (padrão 14 dias) são ignorados e contabilizados separadamente. Dispositivos sem uma data de última sincronização também são tratados como desatualizados. Defina o parâmetro como `0` para desativar esta verificação.

O runbook complementar **Reportar dispositivos com pouco espaço em disco** não aplica deliberadamente esse filtro, portanto 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, então um dispositivo recebe a mesma classificação em ambos; a diferença na contagem de dispositivos corresponde exatamente aos dispositivos ignorados por um inventário desatualizado, que este runbook relata como um número separado na sua saída.

Dispositivos que informam um tamanho total de disco de zero bytes não possuem inventário de armazenamento utilizável, por exemplo, dispositivos que ainda não concluíram um inventário. Tais dispositivos são excluídos da avaliação em vez de serem tratados como "0 GB livres", e seu número é exibido na saída do console.

Somente dispositivos Windows e macOS são avaliados. O inventário de armazenamento de dispositivos móveis é menos confiável, o limite padrão em gigabytes é dimensionado para discos de desktop e as orientações de limpeza no email são específicas para sistemas operacionais de desktop.

Este runbook é o equivalente voltado para o usuário de **Reportar dispositivos com pouco espaço em disco**. Ambos usam as mesmas configurações de limite e a mesma classificação Crítico/Aviso. Use o relatório para a visão administrativa, incluindo dispositivos sem um usuário principal, e este runbook para pedir que os usuários afetados liberem espaço por conta própria.

### Limite e severidade

`ThresholdType` seleciona se um dispositivo é considerado com base em uma 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`). Somente o campo correspondente ao tipo selecionado é exibido no portal.

Todo dispositivo abaixo do limite recebe uma classificação: dispositivos abaixo de metade do limite configurado são marcados como **Crítico**, e todos os outros dispositivos abaixo do limite como **Aviso**. A classificação é mostrada por dispositivo no email e, com os modelos integrados em inglês e alemão, a linha de assunto e a introdução mudam para uma redação urgente assim que um dos dispositivos do usuário é Crítico. O `Personalizado` modelo tem um único assunto e uma única introdução, ambos retirados literalmente da personalização do runbook, de modo que uma notificação Crítico e uma notificação Aviso tenham a mesma aparência lá - formule o texto personalizado para que funcione para ambos.

`NotifyOnSeverity` controla quais dispositivos acionam uma notificação. Por padrão, todo dispositivo abaixo do limite o faz (*Aviso e Crítico*). Com *Apenas Crítico*, os usuários são contatados somente quando um dispositivo está abaixo de metade do limite. Isso permite uma abordagem em duas etapas: reporte todos os dispositivos abaixo do limite aos administradores por meio do runbook de relatório e notifique apenas os usuários cujos dispositivos são críticos.

### Comportamento da notificação

O runbook envia **um email por usuário principal** que lista todos os dispositivos afetados desse usuário com sistema operacional, modelo, espaço livre e total em disco, classificação e a data do último inventário. O email contém etapas práticas de limpeza para as plataformas dos dispositivos listados: a seção Windows é incluída para dispositivos Windows, a seção macOS para dispositivos macOS e ambas quando o usuário tem dispositivos afetados dos dois tipos.

Os destinatários são resolvidos via Microsoft Graph: o usuário principal de um dispositivo é localizado pelo ID de objeto do Entra que o Intune informa em `userId`, portanto contas de convidado e usuários cujo UPN atual difere do endereço registrado no momento do cadastro são resolvidos corretamente; dispositivos sem um `userId` fazem fallback para uma pesquisa pelo nome principal do usuário. O email é então enviado para o atributo `mail` , com o nome principal do usuário como fallback quando nenhum atributo mail estiver definido. Contas desativadas e usuários que não podem ser resolvidos são ignorados e listados na saída do console. Dispositivos sem um usuário principal não podem ser notificados; eles são listados na saída do console para acompanhamento central (o runbook de relatório também os cobre).

`SimulationMode` lista os usuários afetados, seus dispositivos e os destinatários pretendidos na saída do console sem enviar nenhum email. Use-o para validar limites e filtros de escopo antes da primeira execução produtiva.

`OverrideEmailRecipient` redireciona **TODAS** as notificações para o endereço informado (separado por vírgulas para vários destinatários) em vez dos usuários finais. Um aviso é registrado em cada execução enquanto a substituição estiver ativa, e cada email redirecionado indica o usuário afetado no assunto e no corpo. Use isso para testar o conteúdo do email ou para encaminhar tudo para uma caixa de correio compartilhada.

Tenha em mente que a caixa de correio de substituição então recebe um email por usuário afetado, todos enviados em poucos segundos e com linhas de assunto urgentes. Os filtros de email podem classificar essa enxurrada de emails semelhantes como envio em massa ou spam e movê-la para a pasta de lixo eletrônico ou 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 email e o relata como enviado; o que o lado receptor faz depois disso não é visível na saída do job. Se os emails 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 mensagem para o endereço do remetente. Uma caixa de correio no mesmo Tenant é o alvo de teste mais confiável.

### Opções de escopo

* **Escopo de usuário:** Com `UseUserScope` ativado, `IncludeUserGroup` limita as notificações aos usuários que são membros desse grupo, e `ExcludeUserGroup` suprime notificações para membros desse grupo. Ambos usam a associação transitiva, portanto grupos aninhados são resolvidos, e ambos são lidos uma única vez no início da execução.
* **Escopo de dispositivo:** `IncludeDeviceGroup` limita a avaliação a dispositivos que são membros transitivos do grupo de dispositivos Entra informado. Os dispositivos são correspondidos pelo respectivo ID de dispositivo do Entra.

Quando um escopo de usuário e um escopo de dispositivo estão configurados, um dispositivo precisa corresponder a ambos. Uma consulta de grupo com falha interrompe o runbook com um erro em vez de notificar silenciosamente todos os usuários.

### Configuração relativa ao envio de emails

Os emails de notificação são enviados aos usuários afetados; o endereço do remetente é obtido da `RJReport.EmailSender` definição do Tenant e é obrigatória.

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 de notificação respeita a opcional `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 essas 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 baixada ou validada, ou um valor de cor inválido, nunca impede o email – o padrão correspondente é usado em seu lugar.

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` definições do Tenant adicionam um bloco de contato ao final de cada email. `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.

O modelo personalizado consiste em um assunto, um texto antes da lista de dispositivos e um texto após a lista de dispositivos. As etapas de limpeza integradas, a seção "Por que isso é importante" e a seção "Perguntas" são **não** renderizadas com o modelo personalizado, portanto o texto após a lista de dispositivos deve conter 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 está acima dos detalhes do dispositivo.** \n\nCaro usuário, os seguintes dispositivos estão ficando sem espaço em disco:"
                },
                "CustomMailTemplateAfterDeviceDetails": {
                    "Default": "**Isto está abaixo dos detalhes do dispositivo.** \n\n## O que você pode fazer agora\n\n1. Esvazie a Lixeira\n2. ..."
                }
            }
        }
    }
}
```

**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
* Os rótulos da lista de dispositivos são renderizados em inglês para o modelo personalizado

### Localização

Organização → Dispositivos → Notificar usuários 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.0.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 da aplicação

* **Tipo**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *Lê dispositivos gerenciados do Intune incluindo freeStorageSpaceInBytes, totalStorageSpaceInBytes, lastSyncDateTime e o usuário principal (userId e userPrincipalName) para encontrar dispositivos abaixo do limite de pouco espaço em disco*
  * User.Read.All
    * *Resolve cada usuário principal afetado (endereço de email, nome de exibição e accountEnabled) antes de enviar a notificação*
  * Mail.Send
    * *Envia o email de notificação de pouco espaço em disco para cada usuário principal ou para o destinatário de substituição*
  * Organization.Read.All *(opcional — recurso: nome do Tenant no rodapé do email)*
    * *Lê /organization para o nome do Tenant exibido no rodapé do email; sem isso o runbook faz fallback para 'Unknown Tenant'*
  * Directory.Read.All *(opcional — recurso: filtragem de escopo por grupo)*
    * *Lê os membros transitivos de usuário dos grupos de usuário de inclusão/exclusão e os membros transitivos de dispositivo (ID de dispositivo do Entra) do grupo de dispositivo opcional*

### Parâmetros

#### ThresholdType

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

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

**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 porcentagem do tamanho do disco (%) | Espaço livre em percentual |

#### FreeSpaceThresholdGB

Dispositivos com menos espaço livre do que esta quantidade de gigabytes são afetados.

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

#### FreeSpacePercentThreshold

Dispositivos com menos espaço livre do que esta porcentagem do disco são afetados.

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

#### NotifyOnSeverity

Todo dispositivo abaixo do limite (Aviso e Crítico), ou apenas dispositivos abaixo de metade dele (Apenas Crítico).

| Propriedade                | Valor                                             |
| -------------------------- | ------------------------------------------------- |
| Obrigatório                | falso                                             |
| Valor predefinido          | Aviso e Crítico                                   |
| Tipo                       | Cadeia de caracteres                              |
| Nome de exibição do portal | Quais dispositivos devem acionar uma notificação? |

**Opções do portal**

| Opção do portal                                          | Valor           |
| -------------------------------------------------------- | --------------- |
| Aviso e Crítico - todo dispositivo 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 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? |

#### MaxInventoryAgeDays

Dispositivos cuja última sincronização do Intune seja mais antiga do que essa quantidade de dias são ignorados, pois seus dados de disco estão desatualizados. 0 desabilita a verificação.

| Propriedade                | Valor                                            |
| -------------------------- | ------------------------------------------------ |
| Obrigatório                | falso                                            |
| Valor predefinido          | 14                                               |
| Tipo                       | Int32                                            |
| Nome de exibição do portal | Ignorar dispositivos sem sincronização há (dias) |

#### 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 mostrado no email. Obtido da definição do Tenant RJReport.ServiceDesk\_TicketUrl; vazio significa sem 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 neste grupo, incluindo grupos aninhados, 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 neste grupo, incluindo grupos aninhados, 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) |

#### IncludeDeviceGroup

Somente dispositivos neste grupo Entra ID, incluindo grupos aninhados, são verificados. Pode ser combinado com o filtro de usuários.

| Propriedade                | Valor                           |
| -------------------------- | ------------------------------- |
| Obrigatório                | falso                           |
| Valor predefinido          |                                 |
| Tipo                       | Cadeia de caracteres            |
| Nome de exibição do portal | Limitar a dispositivos no grupo |

#### OverrideEmailRecipient

Envia todos os emails para estes endereços em vez dos usuários, para testes e pilotos. A caixa de correio recebe um email por usuário afetado em poucos segundos, o que os filtros de email podem tratar como spam; prefira uma caixa de correio no seu próprio Tenant.

| Propriedade                | Valor                             |
| -------------------------- | --------------------------------- |
| Obrigatório                | falso                             |
| Valor predefinido          |                                   |
| Tipo                       | Cadeia de caracteres              |
| Nome de exibição do portal | Redirecionar todos os emails para |

#### SimulationMode

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

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

**Opções do portal**

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

#### 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, tanto para Aviso quanto para Crítico.

| 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; ele substitui as etapas de limpeza integradas. 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-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.
