> 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/collab/report-sharepoint-tenant-storage_scheduled.md).
# Relatório agendado do armazenamento do Tenant do SharePoint
Monitorizar o armazenamento do SharePoint e alertar quando os limites forem excedidos
{% 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
Verifica o armazenamento do tenant do SharePoint Online em cada execução: a cota, quanto está a ser usado e as coleções de sites que mais utilizam. O inventário completo é gravado na saída da execução. Um e-mail de alerta é enviado apenas quando o armazenamento livre desce abaixo do limite de armazenamento baixo ou quando o armazenamento licenciado, mas não utilizado, excede o limite recuperável.
### Casos de uso comuns
* Verificação diária agendada da integridade do armazenamento do tenant do SharePoint Online que alerta apenas quando um limite é ultrapassado.
* Detetar um tenant que se aproxima da sua quota de armazenamento antes de os utilizadores serem impedidos de guardar ficheiros.
* Detetar uma grande quantidade de armazenamento licenciado não utilizado e potencialmente recuperável.
### Agendamento e saída
É recomendada uma agenda diária. O resumo do armazenamento, o resultado de ორივ as verificações de limite e as principais coleções de sites são gravados no **Dados de saída** separador do trabalho em todas as execuções, independentemente de um limite ser ultrapassado, para que o histórico do trabalho continue útil em dias sem alerta. Não são criados ficheiros de relatório.
### Interações entre parâmetros
* `AlertLowStorageLimitInGB` alerta quando o armazenamento livre do tenant desce abaixo do valor configurado.
* `AlertUnusedStorageLimitInGB` alerta quando o armazenamento livre do tenant sobe acima do valor configurado, um indicador de armazenamento licenciado recuperável. Defina-o para `0` para desativar esta verificação.
* Ambas as verificações podem ser acionadas na mesma execução apenas quando `AlertLowStorageLimitInGB` está configurado acima de `AlertUnusedStorageLimitInGB`; reveja ambos os valores em conjunto ao ajustar os limites.
* O e-mail de alerta só é enviado quando pelo menos um limite é ultrapassado. Uma execução sem ultrapassagem conclui normalmente e não envia nada.
* A lista das principais coleções de sites abrange apenas coleções de sites do SharePoint. Os sites do OneDrive for Business são excluídos porque o respetivo armazenamento não conta para a quota de armazenamento do tenant monitorizada por este runbook.
### Configuração relativa ao envio de emails
O envio do e-mail de alerta só acontece quando um limite de armazenamento é ultrapassado; ele é enviado para o destinatário (`AlertEmailTo`). 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 do rodapé
* **Cor de destaque e do texto** – valores hexadecimais de 6 dígitos, por exemplo `#0052cc`
Quando estas definições não estão configuradas, são utilizadas as imagens e cores predefinidas do 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 – é utilizada em vez disso 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).
### Limitações
* Enumerar todas as coleções de sites pode demorar vários minutos em tenants com um grande número de sites.
### Localização
Organização → Colab → Report SharePoint Tenant Storage (Agendado)
**Nome completo do Runbook**
rjgit-org\_collab\_report-sharepoint-tenant-storage\_scheduled
### Detalhes
| Propriedade | Valor |
| ------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Versão | 1.5.0 |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
PnP.PowerShell (>= 3.4.1)
|
| Agendável | sim |
### Permissões
#### Permissões da aplicação
* **Tipo**: Microsoft Graph
* Mail.Send
* *Envia o e-mail de alerta do limite de armazenamento através de Send-RjRbReportEmail; todo o objetivo deste runbook é o alerta, por isso o envio é incondicional quando há uma violação, não um comutador*
* Organization.Read.All
* *Lê /organization para resolver o nome de exibição do tenant usado no assunto e na identidade visual do e-mail de alerta*
* Sites.Read.All
* *Lê o site raiz do tenant (/sites/root) para derivar o URL da central de administração do SharePoint usado por Connect-PnPOnline*
* **Tipo**: Office 365 SharePoint Online
* Sites.FullControl.All
* *Este runbook liga-se com Connect-PnPOnline -ManagedIdentity ao URL da central de administração do SharePoint e chama os cmdlets de administração do tenant Get-PnPGeoStorageQuota e Get-PnPTenantSite, que requerem controlo total em todo o tenant; Sites.Read.All, que é apenas de leitura, é insuficiente para o ponto final de administração do tenant*
#### Notas de permissão
SharePoint Online: conceda Sites.FullControl.All no recurso 'Office 365 SharePoint Online' (appId 00000003-0000-0ff1-ce00-000000000000) à identidade gerida da Conta de Automação — esta concessão apenas de aplicação não pode ser feita através do fluxo padrão de atribuição de funções de aplicação do Entra usado para Microsoft Graph e tem de ser atribuída manualmente por tenant.
### Parâmetros
#### AlertLowStorageLimitInGB
Envie um alerta quando o armazenamento livre do tenant descer abaixo deste número de gigabytes.
| Propriedade | Valor |
| -------------------------- | --------------------------------------------------------- |
| Obrigatório | verdadeiro |
| Valor predefinido | 200 |
| Tipo | Int32 |
| Nome de exibição do portal | Alertar quando o armazenamento livre ficar abaixo de (GB) |
#### AlertUnusedStorageLimitInGB
Envie um alerta quando o armazenamento licenciado que nenhum site usa exceder este número de gigabytes. Esse armazenamento pode ser recuperado.
| Propriedade | Valor |
| -------------------------- | ---------------------------------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | 1024 |
| Tipo | Int32 |
| Nome de exibição do portal | Alertar quando o armazenamento não utilizado subir acima de (GB) |
#### TopSiteCount
Quantas das maiores coleções de sites são listadas.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | 10 |
| Tipo | Int32 |
| Nome de exibição do portal | Número de coleções de sites principais a reportar |
#### EmailFrom
Endereço do remetente do e-mail de alerta. 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) |
#### AlertEmailTo
Endereço para o qual o alerta é enviado quando um limite é excedido.
| Propriedade | Valor |
| -------------------------- | -------------------------------------------- |
| Obrigatório | verdadeiro |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Endereço de e-mail do destinatário do alerta |
#### AlertEmailSubject
Linha de assunto do e-mail de alerta.
| Propriedade | Valor |
| -------------------------- | -------------------------------------------------------- |
| Obrigatório | verdadeiro |
| Valor predefinido | RealmJoin - Alerta de armazenamento do SharePoint Online |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Assunto do e-mail de alerta |
[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/collab/report-sharepoint-tenant-storage_scheduled.md?ask=&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.