> 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/es/automatizacion/runbooks/runbook-references/org/collab/report-sharepoint-tenant-storage_scheduled.md).
# Generar informe programado de almacenamiento del tenant de SharePoint
Supervisar el almacenamiento de SharePoint y alertar cuando se superen los límites
{% hint style="info" %}
Este es un runbook programado. Está diseñado para ejecutarse según una programación recurrente en lugar de activarse para un único objeto. Véase [Programación](/es/automatizacion/runbooks/scheduling.md) para obtener detalles sobre cómo configurar las programaciones del runbook.
{% endhint %}
### Descripción
Comprueba el almacenamiento del Tenant de SharePoint Online en cada ejecución: la cuota, cuánto se usa y las colecciones de sitios que más utilizan. El inventario completo se escribe en la salida de la ejecución. Solo se envía un correo de alerta cuando el almacenamiento libre cae por debajo del límite de poco almacenamiento o cuando el almacenamiento con licencia pero no utilizado supera el límite recuperable.
### Casos de uso comunes
* Comprobación diaria programada del estado del almacenamiento del Tenant de SharePoint Online que alerta solo cuando se supera un umbral.
* Detectar un Tenant que se acerca a su cuota de almacenamiento antes de que se impida a los usuarios guardar archivos.
* Detectar una gran cantidad de almacenamiento con licencia no utilizado, potencialmente recuperable.
### Programación y salida
Se recomienda una programación diaria. El resumen del almacenamiento, el resultado de ambas comprobaciones de umbral y las principales colecciones de sitios se escriben en la **Datos de salida** pestaña del trabajo en cada ejecución, independientemente de si se supera un umbral, para que el historial del trabajo siga siendo útil en los días sin alerta. No se crean archivos de informe.
### Interacciones de parámetros
* `AlertLowStorageLimitInGB` alerta cuando el almacenamiento libre del Tenant cae por debajo del valor configurado.
* `AlertUnusedStorageLimitInGB` alerta cuando el almacenamiento libre del Tenant supera el valor configurado, un indicador de almacenamiento con licencia recuperable. Establézcalo en `0` para desactivar esta comprobación.
* Ambas comprobaciones pueden activarse en la misma ejecución solo cuando `AlertLowStorageLimitInGB` está configurado por encima de `AlertUnusedStorageLimitInGB`; revise ambos valores conjuntamente al ajustar los umbrales.
* El correo electrónico de alerta solo se envía cuando se supera al menos un umbral. Una ejecución sin superación finaliza normalmente y no envía nada.
* La lista de principales colecciones de sitios cubre solo colecciones de sitios de SharePoint. Los sitios de OneDrive for Business quedan excluidos porque su almacenamiento no cuenta para la cuota de almacenamiento del Tenant que este runbook supervisa.
### Configuración relacionada con el envío de correo electrónico
El envío del correo electrónico de alerta solo ocurre cuando se supera un umbral de almacenamiento; se envía al destinatario (`AlertEmailTo`). La dirección del remitente se toma de la `RJReport.EmailSender` configuración del Tenant.
Este runbook envía correos electrónicos usando la API de Microsoft Graph. Para enviar correos electrónicos a través de la API de Graph, debe configurar una dirección de correo electrónico existente en la personalización del runbook.
Consulte la [documentación de configuración de informes de RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obtener detalles sobre todas las configuraciones disponibles.
#### Marca del correo electrónico
El correo electrónico del informe tiene en cuenta la opción opcional `RJReport.Branding.*` del Tenant:
* **Imagen de encabezado y pie de página** – URL HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada una
* **Enlace del pie de página** – destino de la imagen del pie de página
* **Color de acento y de texto** – valores hexadecimales de 6 dígitos, p. ej. `#0052cc`
Cuando estas configuraciones no están definidas, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen que no se puede descargar o validar, o un valor de color no válido, nunca impide el correo electrónico del informe; en su lugar se usa el valor predeterminado correspondiente.
Instrucciones de configuración y requisitos de imagen: [Marca del correo electrónico](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).
### Limitaciones
* Enumerar todas las colecciones de sitios puede llevar varios minutos en tenants con un gran número de sitios.
### Ubicación
Organización → Collab → Informe de almacenamiento del Tenant de SharePoint (Programado)
**Nombre completo del runbook**
rjgit-org\_collab\_report-sharepoint-tenant-storage\_scheduled
### Detalles
| Propiedad | Valor |
| ------------------ | --------------------------------------------------------------------------------------------------------------------- |
| Versión | 1.5.0 |
| Módulos requeridos | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
PnP.PowerShell (>= 3.4.1)
|
| Programable | sí |
### Permisos
#### Permisos de aplicación
* **Tipo**: Microsoft Graph
* Mail.Send
* *Envía el correo electrónico de alerta de umbral de almacenamiento mediante Send-RjRbReportEmail; el propósito completo de este runbook es la alerta, por lo que el envío es incondicional ante una superación, no un interruptor*
* Organization.Read.All
* *Lee /organization para resolver el nombre para mostrar del Tenant que se usa en el asunto y la marca del correo electrónico de alerta*
* Sites.Read.All
* *Lee el sitio raíz del Tenant (/sites/root) para obtener la URL del centro de administración de SharePoint que usa Connect-PnPOnline*
* **Tipo**: Office 365 SharePoint Online
* Sites.FullControl.All
* *Este runbook se conecta con Connect-PnPOnline -ManagedIdentity contra la URL del centro de administración de SharePoint y llama a los cmdlets de Tenant-admin Get-PnPGeoStorageQuota y Get-PnPTenantSite, que requieren control total de todo el Tenant; Sites.Read.All de solo lectura es insuficiente para el extremo de Tenant-admin*
#### Notas sobre permisos
SharePoint Online: conceda Sites.FullControl.All en el recurso 'Office 365 SharePoint Online' (appId 00000003-0000-0ff1-ce00-000000000000) a la identidad administrada de la Automation Account — esta concesión solo de aplicación no puede realizarse a través del flujo estándar de asignación de roles de aplicación de Entra usado para Microsoft Graph y debe asignarse manualmente por Tenant.
### Parámetros
#### AlertLowStorageLimitInGB
Envía una alerta cuando el almacenamiento libre del Tenant baje de este número de gigabytes.
| Propiedad | Valor |
| ------------------------------ | --------------------------------------------------------------- |
| Requerido | verdadero |
| Valor predeterminado | 200 |
| Tipo | Int32 |
| Nombre para mostrar del portal | Alertar cuando el almacenamiento libre caiga por debajo de (GB) |
#### AlertUnusedStorageLimitInGB
Envía una alerta cuando el almacenamiento con licencia que no usa ningún sitio supera este número de gigabytes. Ese almacenamiento podría recuperarse.
| Propiedad | Valor |
| ------------------------------ | --------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | 1024 |
| Tipo | Int32 |
| Nombre para mostrar del portal | Alertar cuando el almacenamiento no utilizado supere (GB) |
#### TopSiteCount
Cuántas de las colecciones de sitios más grandes se enumeran.
| Propiedad | Valor |
| ------------------------------ | ----------------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | 10 |
| Tipo | Int32 |
| Nombre para mostrar del portal | Número de principales colecciones de sitios que se van a informar |
#### EmailFrom
Dirección del remitente del correo electrónico de alerta. Tomada de la configuración de Tenant RJReport.EmailSender.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### BrandingHeaderImageUrl
Imagen de encabezado del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Se toma de la configuración del Tenant RJReport.Branding.HeaderImageUrl; se usa el encabezado predeterminado de RealmJoin cuando está vacío.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### BrandingFooterImageUrl
Imagen de pie de página del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Se toma de la configuración del Tenant RJReport.Branding.FooterImageUrl; se usa el pie de página predeterminado de RealmJoin cuando está vacío.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### BrandingFooterLink
Enlace asociado a la imagen de pie de página del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.Branding.FooterLink; realmjoin.com se usa cuando está vacío.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### BrandingAccentColor
Color de acento del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.AccentColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### BrandingTextColor
Color de texto del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.TextColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### AlertEmailTo
Dirección a la que se envía la alerta cuando se supera un límite.
| Propiedad | Valor |
| ------------------------------ | ------------------------------------------------------------- |
| Requerido | verdadero |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar del portal | Dirección de correo electrónico del destinatario de la alerta |
#### AlertEmailSubject
Línea de asunto del correo electrónico de alerta.
| Propiedad | Valor |
| ------------------------------ | --------------------------------------------------------- |
| Requerido | verdadero |
| Valor predeterminado | RealmJoin - Alerta de almacenamiento de SharePoint Online |
| Tipo | Cadena |
| Nombre para mostrar del portal | Asunto del correo electrónico de alerta |
[Volver a la vista general de referencia del runbook](/es/automatizacion/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/es/automatizacion/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.