> 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/automacao/runbooks/runbook-references/org/devices/notify-users-about-low-diskspace_scheduled.md).
# Notificar utilizadores sobre pouco espaço em disco agendado
Notificar os utilizadores principais sobre pouco espaço em disco nos respetivos dispositivos por email
{% hint style="info" %}
Este é um runbook agendado. Ele foi projetado para ser executado em um agendamento recorrente, em vez de ser disparado para um único objeto. Veja [Agendamento](/pt/automacao/runbooks/scheduling.md) para detalhes sobre como configurar agendamentos de runbook.
{% endhint %}
### Descrição
Identifica dispositivos Windows e macOS gerenciados pelo Intune cujo espaço livre em disco está abaixo de um limite configurável, seja uma quantidade fixa de espaço livre em gigabytes ou uma porcentagem do tamanho total do disco, e envia um e-mail personalizado por usuário principal. O e-mail lista todos os dispositivos afetados do usuário com seu espaço livre e total em disco, classifica cada dispositivo como Crítico ou Aviso e contém etapas práticas específicas para a plataforma para liberar espaço. A avaliação pode ser limitada a dispositivos críticos, a dispositivos com inventário recente do Intune, aos membros de um grupo de dispositivos do Entra e a usuários incluídos ou excluídos por um grupo. Um modo de simulação lista os usuários e dispositivos afetados sem enviar nada, e um destinatário de substituição global redireciona todas as notificações para uma caixa de correio de teste ou compartilhada.
### 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 sincronismo com o Intune seja mais antigo que `MaxInventoryAgeDays` (padrão de 14 dias) são ignorados e contados separadamente. Dispositivos sem uma data de último sincronismo também são tratados como desatualizados. Defina o parâmetro como `0` para desativar essa verificação.
O runbook complementar **Reportar dispositivos com pouco espaço em disco** deliberadamente não aplica esse filtro, portanto ele também lista dispositivos com inventário desatualizado e pode mostrar mais dispositivos do que são 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 é exatamente dos dispositivos ignorados por causa de um inventário desatualizado, que este runbook relata como um número separado em sua saída.
Dispositivos que informam 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 sua quantidade é exibida 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 a orientação de limpeza no e-mail é específica para sistemas operacionais de desktop.
Este runbook é a contraparte voltada ao 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 geral administrativa, incluindo dispositivos sem usuário principal, e este runbook para pedir aos usuários afetados que liberem espaço por conta própria.
### Limite e gravidade
`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 é classificado: dispositivos abaixo da metade do limite configurado são marcados como **Crítico**, todos os outros dispositivos abaixo do limite como **Aviso**. A classificação é exibida por dispositivo no e-mail e, com os modelos internos 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 modelo `Personalizado` tem um único assunto e uma única introdução, ambos retirados literalmente da personalização do runbook, portanto uma notificação Crítica e uma de Aviso são idênticas nele — formule o texto personalizado para que funcione para ambos.
`NotifyOnSeverity` controla quais dispositivos disparam uma notificação. Por padrão, todo dispositivo abaixo do limite o faz (*Aviso e Crítico*). Com *Somente Crítico*, os usuários são contatados apenas quando um dispositivo está abaixo da metade do limite. Isso permite uma abordagem em duas etapas: relatar todos os dispositivos abaixo do limite aos administradores por meio do runbook de relatório e notificar apenas os usuários cujos dispositivos são críticos.
### Comportamento da notificação
O runbook envia **um e-mail 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 e-mail 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 relata em `userId`, de modo que contas convidadas e usuários cujo UPN atual difere do endereço registrado no momento do registro sejam resolvidos corretamente; dispositivos sem um `userId` recorrem a uma pesquisa por nome principal de usuário. O e-mail é então enviado para o atributo `mail` do usuário, com o nome principal de usuário como fallback quando nenhum atributo mail está definido. Contas desabilitadas e usuários que não podem ser resolvidos são ignorados e listados na saída do console. Dispositivos sem usuário principal não podem ser notificados; eles são listados na saída do console para acompanhamento centralizado (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 e-mail. Use-o para validar limites e filtros de escopo antes da primeira execução em produção.
`OverrideEmailRecipient` redireciona **TODAS** as notificações para o endereço fornecido (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 e-mail redirecionado menciona o usuário afetado no assunto e no corpo. Use isso para testar o conteúdo do e-mail ou para direcionar tudo para uma caixa de correio compartilhada.
### Opções de escopo
* **Escopo do usuário:** Com `UseUserScope` ativado, `IncludeUserGroup` limita as notificações a usuários que sejam 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 vez no início da execução.
* **Escopo do dispositivo:** `IncludeDeviceGroup` limita a avaliação a dispositivos que sejam membros transitivos do grupo de dispositivos do Entra informado. Os dispositivos são correspondidos por meio de seu ID de dispositivo do Entra.
Quando um escopo de usuário e um escopo de dispositivo são configurados, um dispositivo precisa corresponder a ambos. Uma falha na pesquisa de grupo interrompe o runbook com um erro, em vez de notificar silenciosamente todos os usuários.
### Configuração de envio de e-mail
Os e-mails de notificação são enviados aos usuários afetados; o endereço do remetente é obtido da `RJReport.EmailSender` configuração do Tenant e é obrigatório.
Este runbook envia e-mails usando a API do Microsoft Graph. Para enviar e-mails via API Graph, você precisa configurar um endereço de e-mail existente na personalização do runbook.
Consulte a [documentação de configurações de relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para detalhes sobre todas as configurações disponíveis.
#### Identidade visual do e-mail
O e-mail de notificação respeita as configurações opcionais `RJReport.Branding.*` do Tenant:
* **Imagem de cabeçalho e 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 de texto** – valores hexadecimais de 6 dígitos, por exemplo `#0052cc`
Quando essas configurações não estão definidas, são usadas as imagens e cores padrão do RealmJoin. Uma imagem que não possa ser baixada ou validada, ou um valor de cor inválido, nunca impede o e-mail — o padrão correspondente é usado em seu lugar.
Instruções de configuração e requisitos de imagem: [Identidade visual do e-mail](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).
#### Informações de contato do Service Desk
As configurações opcionais `RJReport.ServiceDesk_DisplayName`, `RJReport.ServiceDesk_EMail`, `RJReport.ServiceDesk_Phone` e `RJReport.ServiceDesk_PortalUrl` do Tenant adicionam um bloco de contato ao final de cada e-mail. `ServiceDeskTicketUrl` também pode vincular a um ticket.
### Seleção do idioma do modelo de e-mail
Este runbook oferece suporte a três opções de modelo de e-mail:
1. **EN (Inglês - Padrão)**: Usa o modelo interno em inglês
2. **DE (Alemão)**: Usa o modelo interno em alemão
3. **Personalizado**: Usa um modelo personalizado das Personalizações do Runbook
#### Usando modelos de e-mail personalizados
Para usar um modelo de e-mail 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 de 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 internas, a seção "Por que isso é importante" e a seção "Perguntas" não são **não** renderizadas com o modelo personalizado, portanto o texto após a lista de dispositivos deve conter sua própria orientação 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\nPrezado usuário, os seguintes dispositivos estão ficando sem espaço em disco:"
},
"CustomMailTemplateAfterDeviceDetails": {
"Default": "**Isto fica abaixo dos detalhes do dispositivo.** \n\n## O que você pode fazer agora\n\n1. Esvazie a Lixeira\n2. ..."
}
}
}
}
}
```
**Observações importantes:**
* Use `\n` para quebras de linha na configuração JSON
* A formatação Markdown (##, ###, \*\*, -) é compatível com o texto do modelo
* Todos os três parâmetros de modelo personalizado (Assunto, BeforeDeviceDetails, AfterDeviceDetails) devem ser configurados
* Se qualquer parâmetro estiver ausente, o runbook fará fallback automaticamente para o modelo em inglês (EN)
* Ao usar o modelo personalizado, selecione "Custom - Use Template from Runbook Customizations" no menu suspenso Mail Template
* 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 | RealmJoin.RunbookHelper (>= 0.8.9)
Microsoft.Graph.Authentication (>= 2.39.0)
|
| Agendável | sim |
### Notas
Este runbook é a contraparte voltada ao usuário do runbook "Reportar dispositivos com pouco espaço em disco". Ambos usam as mesmas configurações de limite e a mesma classificação Crítico/Aviso, portanto o relatório oferece aos administradores a visão geral enquanto este runbook pede aos usuários afetados que liberem espaço por conta própria.
Resolução de destinatário: o usuário principal de um dispositivo é resolvido por meio do ID de objeto do Entra que o Intune relata em managedDevice.userId, de modo que contas convidadas e usuários cujo UPN atual difere do endereço registrado no momento do registro sejam resolvidos corretamente. Dispositivos para os quais o Intune não relata userId recorrem a uma pesquisa por nome principal de usuário. A notificação é enviada para o atributo mail do usuário, com o UPN como fallback.
Pré-requisitos:
* O parâmetro EmailFrom deve ser configurado na personalização do runbook (configuração RJReport.EmailSender)
* Opcional: as informações de contato do Service Desk podem ser configuradas (ServiceDesk\_DisplayName, ServiceDesk\_EMail, ServiceDesk\_Phone, ServiceDesk\_PortalUrl, ServiceDesk\_TicketUrl)
Fonte de dados e atualidade: os valores de espaço livre e total em disco são obtidos do inventário de hardware do Intune de cada dispositivo, que é atualizado com o check-in regular do dispositivo. Eles descrevem o estado do último inventário bem-sucedido e não necessariamente o estado atual do dispositivo. Para evitar notificar usuários com base em números desatualizados, dispositivos cujo último sincronismo com o Intune seja mais antigo que MaxInventoryAgeDays são ignorados (0 desativa essa verificação). O runbook "Reportar dispositivos com pouco espaço em disco" deliberadamente não aplica esse filtro, portanto ele também lista dispositivos com inventário desatualizado — assim, pode mostrar mais dispositivos do que são notificados aqui. O número ignorado por causa de um inventário desatualizado é informado na saída deste runbook, o que explica a diferença. Dispositivos que informam um tamanho total de disco de zero bytes não têm inventário de armazenamento utilizável e são excluídos da avaliação, mas sua quantidade é informada. Somente dispositivos Windows e macOS são avaliados, porque o inventário de armazenamento de dispositivos móveis é menos confiável e a orientação de limpeza é diferente.
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: relatar todos os dispositivos abaixo do limite aos administradores, notificar apenas os críticos (NotifyOnSeverity)
* Implantações em fases por departamento ou grupo piloto por meio das opções de escopo de usuário e grupo de dispositivos
* Exclusão de contas de serviço ou compartilhadas por meio do grupo de exclusão
Opções de piloto e teste:
* Use SimulationMode para listar os usuários e dispositivos afetados sem enviar nenhum e-mail
* Use OverrideEmailRecipient para enviar todas as notificações para uma caixa de correio de teste em vez dos usuários finais
* Perfeito para validar o conteúdo do e-mail e testar limites e filtros antes de implantar em produção
### Permissões
#### Permissões da aplicação
* **Tipo**: Microsoft Graph
* DeviceManagementManagedDevices.Read.All
* *Lê dispositivos gerenciados pelo 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 e-mail, nome de exibição 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 usuário principal ou para o destinatário de substituição*
* Organization.Read.All *(opcional — recurso: nome do Tenant no rodapé do e-mail)*
* *Lê /organization para o nome do Tenant exibido no rodapé do e-mail; sem isso o runbook recorre a 'Tenant desconhecido'*
* Directory.Read.All *(opcional — recurso: filtragem por escopo de 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 dispositivos opcional*
### Parâmetros
#### ThresholdType
Determina como o pouco espaço em disco é detectado, seja por uma quantidade fixa de espaço livre em gigabytes ou pela porcentagem de espaço livre em relação ao tamanho do disco.
| Propriedade | Valor |
| -------------------------- | -------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | Espaço livre em GB |
| Tipo | String |
| 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 abaixo de uma porcentagem do tamanho do disco (%) | |
#### FreeSpaceThresholdGB
Dispositivos com menos espaço livre em disco do que este valor em gigabytes são considerados. Usado somente quando o tipo de limite está definido como espaço livre em gigabytes.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------ |
| Obrigatório | falso |
| Valor padrão | 20 |
| Tipo | Int32 |
| Nome de exibição no portal | Limite de pouco espaço em disco (GB livre) |
#### FreeSpacePercentThreshold
Dispositivos com uma porcentagem de espaço livre em disco menor do que este valor são considerados. Usado somente quando o tipo de limite está definido como espaço livre em porcentagem.
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | 10 |
| Tipo | Int32 |
| Nome de exibição no portal | Limite de pouco espaço em disco (% livre) |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### NotifyOnSeverity
Seleciona quais dispositivos disparam uma notificação: todo dispositivo abaixo do limite (Aviso e Crítico) ou apenas dispositivos abaixo da metade do limite (Somente Crítico).
| Propriedade | Valor |
| -------------------------- | -------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | Aviso e Crítico |
| Tipo | String |
| Nome de exibição no portal | Quais dispositivos devem disparar uma notificação? |
**Opções do portal**
| Opção do portal | Valor |
| --------------------------------------------------------- | ----- |
| Aviso e Crítico - todo dispositivo abaixo do limite | |
| Somente Crítico - dispositivos abaixo da metade do limite | |
#### Windows
Inclua dispositivos Windows na avaliação.
| Propriedade | Valor |
| -------------------------- | ---------------------------- |
| Obrigatório | falso |
| Valor padrão | verdadeiro |
| Tipo | Boolean |
| Nome de exibição no portal | Incluir dispositivos Windows |
#### macOS
Inclua dispositivos macOS na avaliação.
| Propriedade | Valor |
| -------------------------- | -------------------------- |
| Obrigatório | falso |
| Valor padrão | verdadeiro |
| Tipo | Boolean |
| Nome de exibição no portal | Incluir dispositivos macOS |
#### MaxInventoryAgeDays
Dispositivos cujo último sincronismo com o Intune seja mais antigo que esse número de dias são ignorados, porque o inventário de armazenamento deles é considerado desatualizado. Dispositivos sem uma data de último sincronismo também são ignorados. Defina como 0 para desativar a verificação.
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------------------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | 14 |
| Tipo | Int32 |
| Nome de exibição no portal | Ignorar dispositivos cujo último sincronismo com o Intune seja mais antigo que (dias, 0 = sem limite) |
#### EmailFrom
O endereço de e-mail do remetente. Isso precisa ser configurado na personalização do runbook.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### BrandingHeaderImageUrl
URL pública HTTPS opcional de uma imagem de cabeçalho personalizada (PNG/JPEG/GIF, máx. 200 KB) para o e-mail de notificação. Proveniente da configuração do Tenant RJReport.Branding.HeaderImageUrl. Quando vazio, é usada a imagem de cabeçalho padrão do RealmJoin.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### BrandingFooterImageUrl
URL pública HTTPS opcional de uma imagem de rodapé personalizada (PNG/JPEG/GIF, máx. 200 KB) para o e-mail de notificação. Proveniente da configuração do Tenant RJReport.Branding.FooterImageUrl. Quando vazio, é usada a imagem de rodapé padrão do RealmJoin.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### BrandingFooterLink
URL opcional para a qual a imagem do rodapé aponta. Proveniente da configuração do Tenant RJReport.Branding.FooterLink. Quando vazio, é usado o link padrão ().
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### BrandingAccentColor
Substituição opcional da cor de destaque (hex de 6 dígitos, por exemplo '#0052cc') para o modelo de e-mail de notificação. Proveniente da configuração do Tenant RJReport.Branding.AccentColor. Quando vazio ou inválido, é usada a cor de destaque padrão do RealmJoin.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### BrandingTextColor
Substituição opcional da cor do texto (hex de 6 dígitos) para o modelo de e-mail de notificação. Proveniente da configuração do Tenant RJReport.Branding.TextColor. Quando vazio ou inválido, é usada a cor de texto padrão do RealmJoin.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### ServiceDeskDisplayName
Nome de exibição do Service Desk para informações de contato do usuário (opcional).
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### ServiceDeskEmail
Endereço de e-mail do Service Desk para informações de contato do usuário (opcional).
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### ServiceDeskPhone
Número de telefone do Service Desk para informações de contato do usuário (opcional).
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### ServiceDeskPortalUrl
URL do portal do Service Desk para informações de contato do usuário, renderizada como um link clicável (opcional).
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### ServiceDeskTicketUrl
Link direto para um ticket do Service Desk, renderizado como um link clicável (opcional). Vazio por padrão, portanto nenhum link de ticket é adicionado.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### UseUserScope
Ative a filtragem por escopo de usuário para incluir ou excluir usuários com base na associação a grupos.
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | Falso |
| Tipo | Boolean |
| Nome de exibição no portal | Usar filtragem de escopo de usuário |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### IncludeUserGroup
Notifique apenas usuários que sejam membros transitivos desse grupo. Requer que UseUserScope esteja ativado.
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Usuários a incluir (Grupo) |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### ExcludeUserGroup
Não notifique usuários que sejam membros transitivos desse grupo. Requer que UseUserScope esteja ativado.
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Usuários a excluir (Grupo) |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### IncludeDeviceGroup
Grupo de dispositivos do Entra opcional. Quando definido, apenas dispositivos que sejam membros transitivos desse grupo são avaliados. Pode ser combinado com o escopo de usuário.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------ |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Limitar a dispositivos em grupo (opcional) |
#### OverrideEmailRecipient
Opcional: substituição global - quando definido, TODAS as notificações são enviadas para este endereço em vez dos usuários finais. Pode ser separado por vírgulas para vários destinatários. Perfeito para testes e pilotos, ou para direcionar tudo para uma caixa de correio compartilhada. Se deixado em branco, cada usuário recebe e-mail diretamente.
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Redirecionar \* TODOS \* os e-mails para o(s) destinatário(s) de substituição |
#### SimulationMode
Quando ativado, o runbook lista os usuários e dispositivos afetados na saída, mas não envia nenhum e-mail.
| Propriedade | Valor |
| -------------------------- | ------------------- |
| Obrigatório | falso |
| Valor padrão | Falso |
| Tipo | Boolean |
| Nome de exibição no 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
Selecione qual modelo de e-mail usar: EN (Inglês, padrão), DE (Alemão) ou Custom (das Personalizações do Runbook).
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | EN |
| Tipo | String |
| Nome de exibição no portal | Modelo de e-mail |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### CustomMailTemplateSubject
Linha de assunto de e-mail personalizada (usada apenas quando MailTemplateLanguage está definido como 'Custom'). É usada tanto para notificações de Aviso quanto para notificações Críticas, porque o modelo personalizado não tem equivalente para a linha de assunto urgente dos modelos internos.
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Personalizado: Assunto do e-mail |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### CustomMailTemplateBeforeDeviceDetails
Texto personalizado a ser exibido antes da lista de dispositivos (usado apenas quando MailTemplateLanguage está definido como 'Custom'). Suporta formatação Markdown.
| Propriedade | Valor |
| -------------------------- | --------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Personalizado: Texto antes da lista de dispositivos |
| Oculto no portal | sim (predefinido por personalização do runbook) |
#### CustomMailTemplateAfterDeviceDetails
Texto personalizado a ser exibido após a lista de dispositivos (usado apenas quando MailTemplateLanguage está definido como 'Custom'). Suporta formatação Markdown. Substitui as etapas de limpeza internas, portanto deve conter sua própria orientação.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Personalizado: Texto após a lista de dispositivos |
| Oculto no portal | sim (predefinido por personalização do runbook) |
[Voltar para a visão geral de referência do Runbook](/pt/automacao/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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.realmjoin.com/pt/automacao/runbooks/runbook-references/org/devices/notify-users-about-low-diskspace_scheduled.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.