> 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/report-devices-low-diskspace_scheduled.md). # Relatório agendado de dispositivos com pouco espaço em disco Relatório agendado de dispositivos geridos com pouco espaço livre em disco. {% hint style="info" %} Este é um runbook agendado. Ele foi projetado para ser executado em um agendamento recorrente, em vez de ser acionado para um único objeto. Consulte [Agendamento](/pt/automacao/runbooks/scheduling.md) para detalhes sobre como configurar agendamentos de runbook. {% endhint %} ### Descrição Identifica e lista dispositivos 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. O resultado pode ser refinado por plataforma e por filtros de fabricante e modelo, e cada dispositivo reportado recebe classificação Crítico ou Aviso, dependendo de quão abaixo do limite ele está. Envia automaticamente um relatório por e-mail com anexos CSV e/ou Excel (xlsx). Os arquivos do relatório também podem ser carregados para um Azure Storage Account, retornando links de download com tempo limitado. O parâmetro ReportFileFormat controla quais formatos de arquivo são gerados e entregues (somente CSV, CSV & XLSX, ou somente XLSX). Quando o anexo CSV excede o limite de tamanho do e-mail e "CSV & XLSX" está selecionado, o e-mail recorre apenas à pasta de trabalho do Excel. ### Atualidade e limitações dos dados Os valores de espaço livre e espaço 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 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 informam um tamanho total de disco de zero bytes não têm inventário de armazenamento utilizável. Isso é 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 sua quantidade é mostrada na saída do console e no resumo do e-mail. Este relatório lista deliberadamente os dispositivos independentemente de quão antigo seja o inventário, para que um dispositivo que parou de fazer check-in ainda apareça. Sua contraparte voltada ao usuário **Notificar Usuários Sobre Pouco Espaço em Disco** faz o oposto: ele ignora dispositivos cujo último sync do Intune seja mais antigo do que sua `MaxInventoryAgeDays` configuração, para que ninguém seja solicitado a liberar espaço com base em números desatualizados. 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 — mas este relatório pode listar mais dispositivos do que o runbook de notificação escreve. A diferença são exatamente os dispositivos com um inventário desatualizado, e o runbook de notificação informa a quantidade deles em sua própria saída. Windows e macOS estão incluídos por padrão, iOS/iPadOS e Android não. O limite padrão de 20 GB é dimensionado para discos de desktop e relataria um grande número de dispositivos móveis perfeitamente saudáveis. Quando você habilita as plataformas móveis, o limite baseado em porcentagem (`ThresholdType` = *Espaço livre abaixo de uma porcentagem do tamanho do disco*) normalmente produz resultados mais significativos. ### Limite e severidade `ThresholdType` seleciona se um dispositivo é reportado 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`). Apenas o campo correspondente ao tipo selecionado é mostrado no portal. Todo dispositivo reportado recebe uma classificação: dispositivos abaixo de metade do limite configurado são marcados como **Crítico**, e todos os outros dispositivos reportados como **Aviso**. Na pasta de trabalho do Excel, essas classificações são destacadas em vermelho e amarelo. ### Entrega do relatório Os arquivos do relatório só são gerados quando um método de entrega é usado, ou seja, quando um destinatário (`EmailTo`) é fornecido e/ou `CreateDownloadLink` está habilitado. Sem nenhum dos dois, o resultado é lido diretamente na saída do portal RealmJoin. A entrega por e-mail e a geração de link de download são independentes e podem ser combinadas. Para o link de download, os arquivos do relatório são carregados para a conta de armazenamento Azure configurada nas `RJReport.StorageAccount.*` configurações do Tenant, e links de download SAS com tempo limitado são retornados. O upload para o armazenamento se autentica com a identidade gerenciada da conta de Automação; essa identidade precisa da função Storage Account Contributor **Storage Account Contributor** RBAC na conta de armazenamento de destino (isso é uma atribuição Azure RBAC, não uma permissão de aplicativo do Graph). ### Configuração relativa ao envio de e-mails O envio de um relatório por e-mail é opcional e só acontece quando um destinatário (`EmailTo`) é fornecido. O endereço do remetente é obtido da configuração do `RJReport.EmailSender` Tenant. Este runbook envia e-mails usando a API do Microsoft Graph. Para enviar e-mails via API do Graph, você precisa configurar um endereço de e-mail existente na personalização do runbook. Veja a [documentação das configurações do relatório 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 do relatório respeita as configurações opcionais `RJReport.Branding.*` do Tenant: * **Imagem do cabeçalho e do rodapé** – URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada * **Link do rodapé** – destino da imagem do rodapé * **Cor de destaque e 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 do relatório – o padrão correspondente é usado em seu lugar. Instruções de configuração e requisitos da imagem: [Identidade visual do e-mail](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.0.0 | | Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.9)\nMicrosoft.Graph.Authentication (>= 2.39.0)\nAz.Accounts (>= 5.5.2) | | Agendável | sim | ### Notas Este runbook complementa a base de relatórios e fornece uma visão geral recorrente dos dispositivos que estão prestes a ficar sem espaço em disco, para que os usuários afetados possam ser contatados antes que a falta de espaço livre comece a bloquear atualizações, instalações de aplicativos ou sincronização de perfis. Pré-requisitos: * O parâmetro EmailFrom deve estar configurado na personalização do runbook (configuração RJReport.EmailSender) Origem dos dados e atualidade: Os valores de espaço livre e espaço 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. Portanto, eles descrevem o estado do último inventário bem-sucedido e não necessariamente o estado atual, então a coluna Last Sync do relatório deve ser usada para avaliar quão atualizada está uma linha. Dispositivos que informam um tamanho total de disco de zero bytes não têm inventário de armazenamento utilizável (isso é comum em perfis de trabalho do Android Enterprise) e são excluídos da avaliação, mas sua quantidade é reportada. Este relatório lista deliberadamente os dispositivos independentemente de quão antigo seja o inventário, para que um dispositivo que parou de fazer check-in ainda apareça. Sua contraparte voltada ao usuário "Notify Users About Low Diskspace" faz o oposto e ignora dispositivos cujo último sync do Intune seja mais antigo do que a configuração MaxInventoryAgeDays, para que nenhum usuário seja solicitado a liberar espaço com base em números desatualizados. Ambos os runbooks aplicam o mesmo limite e a mesma classificação Crítico/Aviso, mas o relatório pode, portanto, listar mais dispositivos do que o runbook de notificação escreve — a diferença são os dispositivos com um inventário desatualizado, e o runbook de notificação informa a quantidade deles em sua própria saída. Padrões de plataforma: Windows e macOS estão incluídos por padrão, iOS/iPadOS e Android não, porque o limite padrão em gigabytes é dimensionado para discos de desktop e relataria um grande número de dispositivos móveis perfeitamente saudáveis. Quando as plataformas móveis estão habilitadas, o limite baseado em porcentagem normalmente produz resultados mais significativos. Casos de uso comuns: * Monitoramento recorrente do espaço em disco em toda a frota de dispositivos gerenciados * Localizar dispositivos que provavelmente falharão em atualizações de recursos ou implantações de aplicativos devido a espaço livre insuficiente * Preparar comunicações direcionadas com usuários ou campanhas de limpeza * Verificar uma geração específica de hardware por meio dos filtros de fabricante e modelo ### Permissões #### Permissões de aplicativo * **Tipo**: Microsoft Graph * DeviceManagementManagedDevices.Read.All * *Lê dispositivos gerenciados pelo Intune, incluindo freeStorageSpaceInBytes e totalStorageSpaceInBytes, para encontrar dispositivos abaixo do limite de pouco espaço em disco* * Organization.Read.All *(opcional — recurso: relatório por e-mail / link de download)* * *Lê /organization para o nome do Tenant usado nos nomes dos arquivos do relatório, no assunto do e-mail e no rodapé do e-mail; sem isso o runbook recorre a 'Unknown Tenant'* * Mail.Send *(opcional — recurso: relatório por e-mail)* * *Envia o e-mail do relatório via Send-RjRbReportEmail quando EmailTo está configurado* #### Notas sobre permissões Azure Storage Account: função 'Storage Account Contributor' para a identidade gerenciada da Automation Account na conta de armazenamento de destino — o upload recupera as chaves da conta via listKeys (necessário apenas quando CreateDownloadLink é usado) ### 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 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 abaixo de uma porcentagem do tamanho do disco (%) | | #### FreeSpaceThresholdGB Dispositivos com menos espaço livre em disco do que esse valor em gigabytes são reportados. Usado apenas quando o tipo de limite é 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 livres) | #### FreeSpacePercentThreshold Dispositivos com uma porcentagem de espaço livre em disco menor do que esse valor são reportados. Usado apenas quando o tipo de limite é 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 (% livres) | | Oculto no portal | sim (predefinido via personalização do runbook) | #### Windows Inclui dispositivos Windows nos resultados. | Propriedade | Valor | | -------------------------- | ---------------------------- | | Obrigatório | falso | | Valor padrão | Verdadeiro | | Tipo | Booleano | | Nome de exibição no portal | Incluir dispositivos Windows | #### macOS Inclui dispositivos macOS nos resultados. | Propriedade | Valor | | -------------------------- | -------------------------- | | Obrigatório | falso | | Valor padrão | Verdadeiro | | Tipo | Booleano | | Nome de exibição no portal | Incluir dispositivos macOS | #### iOS Inclui dispositivos iOS e iPadOS nos resultados. | Propriedade | Valor | | -------------------------- | ------------------------------- | | Obrigatório | falso | | Valor padrão | Falso | | Tipo | Booleano | | Nome de exibição no portal | Incluir dispositivos iOS/iPadOS | #### Android Inclui dispositivos Android nos resultados. | Propriedade | Valor | | -------------------------- | ---------------------------- | | Obrigatório | falso | | Valor padrão | Falso | | Tipo | Booleano | | Nome de exibição no portal | Incluir dispositivos Android | #### ManufacturerFilter Lista opcional de nomes de fabricantes separada por vírgulas. Um dispositivo é incluído quando seu fabricante contém uma das entradas. Deixe em branco para incluir todos os fabricantes. | Propriedade | Valor | | -------------------------- | ------------------------------------------------------------------------------------------------------- | | Obrigatório | falso | | Valor padrão | | | Tipo | String | | Nome de exibição no portal | Filtro de fabricante (separado por vírgulas, correspondência por substring, deixe em branco para todos) | #### ModelFilter Lista opcional de nomes de modelos separada por vírgulas. Um dispositivo é incluído quando seu modelo contém uma das entradas. Deixe em branco para incluir todos os modelos. | Propriedade | Valor | | -------------------------- | --------------------------------------------------------------------------------------------------- | | Obrigatório | falso | | Valor padrão | | | Tipo | String | | Nome de exibição no portal | Filtro de modelo (separado por vírgulas, correspondência por substring, deixe em branco para todos) | #### 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 via 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 do relatório. Proveniente da configuração do Tenant RJReport.Branding.HeaderImageUrl. Quando vazio, a imagem padrão de cabeçalho do RealmJoin é usada. | Propriedade | Valor | | ---------------- | ----------------------------------------------- | | Obrigatório | falso | | Valor padrão | | | Tipo | String | | Oculto no portal | sim (predefinido via 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 do relatório. Proveniente da configuração do Tenant RJReport.Branding.FooterImageUrl. Quando vazio, a imagem padrão de rodapé do RealmJoin é usada. | Propriedade | Valor | | ---------------- | ----------------------------------------------- | | Obrigatório | falso | | Valor padrão | | | Tipo | String | | Oculto no portal | sim (predefinido via 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, o link padrão () é usado. | Propriedade | Valor | | ---------------- | ----------------------------------------------- | | Obrigatório | falso | | Valor padrão | | | Tipo | String | | Oculto no portal | sim (predefinido via 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 do relatório. 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 via personalização do runbook) | #### BrandingTextColor Substituição opcional da cor do texto (hex de 6 dígitos) para o modelo de e-mail do relatório. 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 via personalização do runbook) | #### ReportFileFormat Controla quais formatos de arquivo do relatório são gerados e entregues: "somente CSV", "CSV & XLSX" (padrão) ou "somente XLSX". | Propriedade | Valor | | -------------------------- | ------------------------------- | | Obrigatório | falso | | Valor padrão | CSV & XLSX | | Tipo | String | | Nome de exibição no portal | Formato do arquivo do relatório | **Opções do portal** | Opção do portal | Valor | | --------------- | ----- | | CSV & XLSX | | | somente CSV | | | somente XLSX | | #### CreateDownloadLink Se ativado, os arquivos do relatório são carregados para um Azure Storage Account e links de download com tempo limitado são retornados. Desativado por padrão. | Propriedade | Valor | | -------------------------- | ----------------------------------------------------------------------------- | | Obrigatório | falso | | Valor padrão | Falso | | Tipo | Booleano | | Nome de exibição no portal | Criar um link de download do arquivo (enviar relatório para o armazenamento)? | **Opções do portal** | Opção do portal | Valor | | ------------------------------------------------------- | ---------- | | Sim - carregar relatório e retornar um link de download | verdadeiro | | Não - não criar um link de download | falso | #### ContainerName Nome do contêiner de armazenamento usado para o upload. Configurado por runbook (não é uma configuração global do RJReport). | Propriedade | Valor | | ---------------- | ----------------------------------------------- | | Obrigatório | falso | | Valor padrão | report-devices-low-diskspace | | Tipo | String | | Oculto no portal | sim (predefinido via personalização do runbook) | #### ResourceGroupName Grupo de recursos que contém a conta de armazenamento. Proveniente das configurações do Tenant RJReport. | Propriedade | Valor | | ---------------- | ----------------------------------------------- | | Obrigatório | falso | | Valor padrão | | | Tipo | String | | Oculto no portal | sim (predefinido via personalização do runbook) | #### StorageAccountName Nome da conta de armazenamento usada para o upload. Proveniente das configurações do Tenant RJReport. | Propriedade | Valor | | ---------------- | ----------------------------------------------- | | Obrigatório | falso | | Valor padrão | | | Tipo | String | | Oculto no portal | sim (predefinido via personalização do runbook) | #### LinkExpiryDays Número de dias até que o link de download gerado expire. Proveniente das configurações do Tenant RJReport. | Propriedade | Valor | | ---------------- | ----------------------------------------------- | | Obrigatório | falso | | Valor padrão | 6 | | Tipo | Int32 | | Oculto no portal | sim (predefinido via personalização do runbook) | #### EmailTo Se especificado, um e-mail com o relatório será enviado para os endereços fornecidos. Pode ser um único endereço ou vários endereços separados por vírgula (string). A função envia e-mails individuais para cada destinatário por motivos de privacidade. | Propriedade | Valor | | -------------------------- | ------------------------------------- | | Obrigatório | falso | | Valor padrão | | | Tipo | String | | Nome de exibição no portal | Endereço(s) de e-mail do destinatário | [Voltar à visão geral da referência de 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/report-devices-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.