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

# Relatório de dispositivos com pouco espaço em disco agendado

Relatar dispositivos que 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

Lista dispositivos 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 dispositivo recebe a classificação Aviso ou Crítico, dependendo de quão abaixo do limite está. A lista pode ser restringida por plataforma, fabricante e modelo. O relatório pode ser enviado por e-mail ou disponibilizado como um link de download.

### Casos de uso comuns

* Monitorização recorrente do espaço em disco em toda a frota de dispositivos geridos
* Encontrar dispositivos com probabilidade de falhar atualizações de funcionalidades ou implementações de aplicações devido a espaço livre insuficiente
* Preparar comunicação direcionada aos utilizadores ou campanhas de limpeza, por exemplo com **Notificar Utilizadores Sobre Pouco Espaço em Disco**
* Verificar uma geração específica de hardware através dos filtros de fabricante e modelo

### 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 relatório descreve o estado do último inventário bem-sucedido e não o estado atual do dispositivo. Use a **Última sincronização** coluna do relatório para avaliar quão atualizada está uma linha individual.

Dispositivos que comunicam um tamanho total de disco de zero bytes não têm inventário de armazenamento utilizável. Isto é comum em perfis de trabalho do Android Enterprise e também acontece em dispositivos que ainda não concluíram um inventário. Esses dispositivos são excluídos da avaliação em vez de serem reportados como "0 GB livres", e o seu número é mostrado na saída da consola e no resumo por e-mail.

Este relatório lista deliberadamente os dispositivos independentemente da antiguidade do respetivo inventário, para que um dispositivo que deixou de fazer check-in continue a aparecer. A sua contraparte voltada para o utilizador **Notificar Utilizadores Sobre Pouco Espaço em Disco** faz o oposto: ignora os dispositivos cujo último sincronismo Intune seja mais antigo do que a sua `MaxInventoryAgeDays` definição, para que ninguém seja solicitado a libertar espaço com base em números desatualizados. 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 - mas este relatório pode listar mais dispositivos do que o runbook de notificação grava. A diferença são exatamente os dispositivos com inventário desatualizado, e o runbook de notificação reporta o seu número na sua própria saída.

Windows e macOS estão incluídos por predefinição, iOS/iPadOS e Android não. O limite predefinido de 20 GB foi dimensionado para discos de computadores de secretária e reportaria um grande número de dispositivos móveis perfeitamente saudáveis. Quando ativa as plataformas móveis, o limite baseado em percentagem (`ThresholdType` = *Espaço livre abaixo de uma percentagem do tamanho do disco*) geralmente fornece resultados mais significativos.

### Limite e severidade

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

Cada dispositivo reportado é classificado: os dispositivos abaixo de metade do limite configurado são marcados como **Crítico**, todos os outros dispositivos reportados como **Aviso**. No separador Dados de Saída, cada classificação tem a sua própria tabela (*Dispositivos críticos*, *Dispositivos com aviso*, os piores dispositivos primeiro); na pasta de trabalho do Excel, as classificações são destacadas a vermelho e amarelo.

### Entrega do relatório

Cada execução escreve uma **Resumo** a tabela e as tabelas de dispositivos por classificação no separador Dados de Saída do portal RealmJoin, onde cada tabela também pode ser exportada para Excel. Os ficheiros de relatório (CSV e/ou pasta de trabalho do Excel) só são gerados quando a **Entrega do relatório** a opção inclui um e-mail ou uma ligação de transferência. A entrega por e-mail e a geração da ligação de transferência são independentes e podem ser combinadas.

Para a ligação de transferência, os ficheiros do relatório são carregados para a Storage Account do Azure configurada nas `RJReport.StorageAccount.*` definições de Tenant, e são devolvidos links de download SAS com prazo limitado. O carregamento para o armazenamento autentica-se com a identidade gerida da conta de Automação; essa identidade precisa da **Leitor e acesso aos dados** função RBAC na Storage Account de destino (esta é uma atribuição Azure RBAC, não uma permissão de aplicação Graph). Uma falha no carregamento é comunicada como aviso e não interrompe a entrega por e-mail.

Os agendamentos criados antes da **Entrega do relatório** opção existir continuam a enviar o respetivo email: um destinatário guardado por si só ainda ativa o email para eles. Quando esse agendamento é aberto para edição, a opção mostra *Apenas dados de saída*; selecione novamente a entrega antes de guardar, caso contrário o agendamento deixa de enviar o relatório.

Quando nenhum dispositivo está abaixo do limite, não é criado qualquer ficheiro de relatório; uma entrega por e-mail selecionada continua a enviar uma breve confirmação sem anexos.

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

O envio de um relatório por e-mail é opcional e só acontece quando a **Entrega do relatório** opção inclui um e-mail; é então necessário um destinatário. O endereço do remetente é obtido de `RJReport.EmailSender` Tenant.

Este runbook envia emails utilizando a API do Microsoft Graph. Para enviar emails através da Graph API, é necessário configurar um endereço de email existente na personalização do runbook.

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

#### Branding do email

O email do relatório respeita as definições opcionais de `RJReport.Branding.*` do Tenant:

* **Imagem do cabeçalho e do rodapé** - URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada
* **Ligação no rodapé** - destino da imagem de 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 de RealmJoin. Uma imagem que não possa ser transferida ou validada, ou um valor de cor inválido, nunca impede o email do relatório - em vez disso, é usada a predefinição correspondente.

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

### Localização

Organização → Dispositivos → Reportar Dispositivos com Pouco Espaço em Disco (Agendado)

**Nome completo do Runbook**

rjgit-org\_devices\_report-devices-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)<br>Az.Accounts (>= 5.5.2)</p> |
| Agendável           | sim                                                                                                                |

### Permissões

#### Permissões da aplicação

* **Tipo**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *Lê dispositivos geridos pelo Intune, incluindo freeStorageSpaceInBytes e totalStorageSpaceInBytes, para encontrar dispositivos abaixo do limite de pouco espaço em disco*
  * Mail.Send *(opcional — funcionalidade: Relatório por email)*
    * *Envia o email do relatório através de Send-RjRbReportEmail quando a entrega por email é selecionada*
  * Organization.Read.All *(opcional — funcionalidade: Relatório por email)*
    * *Lê /organization para o nome do Tenant usado nos nomes dos ficheiros de relatório, no assunto do e-mail e no rodapé do e-mail; sem isso, o runbook recorre a 'Unknown Tenant'*

#### Notas de permissão

Azure Storage Account: função 'Leitor e acesso aos dados' para a identidade gerida da conta de Automação na Storage Account de destino - o carregamento obtém as chaves da conta através de listKeys (necessário apenas para as opções de ligação de transferência)

### 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 este número de gigabytes são reportados.

| 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 percentagem do tamanho do disco são reportados.

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

#### Windows

Inclui dispositivos Windows.

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

#### MacOS

Inclui dispositivos macOS.

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

#### iOS

Inclui dispositivos iOS e iPadOS.

| Propriedade                | Valor                            |
| -------------------------- | -------------------------------- |
| Obrigatório                | falso                            |
| Valor predefinido          | Falso                            |
| Tipo                       | Booleano                         |
| Nome de exibição do portal | Incluir dispositivos iOS/iPadOS? |

#### Android

Inclui dispositivos Android.

| Propriedade                | Valor                         |
| -------------------------- | ----------------------------- |
| Obrigatório                | falso                         |
| Valor predefinido          | Falso                         |
| Tipo                       | Booleano                      |
| Nome de exibição do portal | Incluir dispositivos Android? |

#### Filtro de fabricante

Apenas estes fabricantes, separados por vírgulas; Dell também corresponde a Dell Inc. Deixe vazio para todos.

| Propriedade                | Valor                |
| -------------------------- | -------------------- |
| Obrigatório                | falso                |
| Valor predefinido          |                      |
| Tipo                       | Cadeia de caracteres |
| Nome de exibição do portal | Filtro de fabricante |

#### Filtro de modelo

Apenas estes modelos, separados por vírgulas; Surface também corresponde a Surface Laptop 3. Deixe vazio para todos.

| Propriedade                | Valor                |
| -------------------------- | -------------------- |
| Obrigatório                | falso                |
| Valor predefinido          |                      |
| Tipo                       | Cadeia de caracteres |
| Nome de exibição do portal | Filtro de modelo     |

#### EmailFrom

Endereço do remetente do email do relatório. Obtido 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) |

#### ReportFileFormat

Entregar o relatório como CSV, como uma pasta de trabalho do Excel ou ambos.

| Propriedade                | Valor                                                  |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório                | falso                                                  |
| Valor predefinido          | CSV e XLSX                                             |
| Tipo                       | Cadeia de caracteres                                   |
| Nome de exibição do portal | Formato do ficheiro do relatório                       |
| Oculto no portal           | sim (predefinido através da personalização do runbook) |

**Opções do portal**

| Opção do portal | Valor       |
| --------------- | ----------- |
| CSV e XLSX      | CSV e XLSX  |
| Apenas CSV      | Apenas CSV  |
| Apenas XLSX     | Apenas XLSX |

#### CreateDownloadLink

Também carregue o relatório e devolva uma ligação de download que expira após alguns dias.

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

#### ContainerName

Contentor de armazenamento para o qual os ficheiros do relatório são carregados. Definir por runbook.

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | falso                                                  |
| Valor predefinido | report-devices-low-diskspace                           |
| Tipo              | Cadeia de caracteres                                   |
| Oculto no portal  | sim (predefinido através da personalização do runbook) |

#### ResourceGroupName

Grupo de recursos da conta de armazenamento para carregamentos do relatório. Obtido a partir da definição de tenant RJReport.StorageAccount.ResourceGroup.

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | falso                                                  |
| Valor predefinido |                                                        |
| Tipo              | Cadeia de caracteres                                   |
| Oculto no portal  | sim (predefinido através da personalização do runbook) |

#### StorageAccountName

Conta de armazenamento para carregamentos do relatório. Obtida a partir da definição de tenant RJReport.StorageAccount.StorageAccountName.

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | falso                                                  |
| Valor predefinido |                                                        |
| Tipo              | Cadeia de caracteres                                   |
| Oculto no portal  | sim (predefinido através da personalização do runbook) |

#### LinkExpiryDays

Número de dias que uma ligação de download permanece válida. Obtido a partir da definição de tenant RJReport.StorageAccount.LinkExpiryDays.

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | falso                                                  |
| Valor predefinido | 6                                                      |
| Tipo              | Int32                                                  |
| Oculto no portal  | sim (predefinido através da personalização do runbook) |

#### SendEmailReport

Envia o relatório para o endereço de email do destinatário.

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

#### EmailTo

Enviar o relatório para estes endereços. Separe vários com vírgulas; cada destinatário recebe um email separado.

| Propriedade                | Valor                                                  |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório                | falso                                                  |
| Valor predefinido          |                                                        |
| Tipo                       | Cadeia de caracteres                                   |
| Nome de exibição do portal | Endereço(s) de email do(s) destinatário(s)             |
| 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/report-devices-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.
