> 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-teams-channels_scheduled.md).
# Informar canales de Teams programados
Enumerar los canales privados y compartidos de todos los equipos con sus propietarios
{% 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
Recorre todos los equipos del inquilino y enumera sus canales privados y compartidos con el equipo al que pertenecen, sus propietarios y, si se desea, sus miembros. Los canales privados no son visibles en la vista de grupos del portal de RealmJoin, por lo que este informe muestra quién los posee y quién puede acceder a ellos. Los canales sin propietario se enumeran por separado. El informe puede enviarse por correo electrónico o proporcionarse como un enlace de descarga.
### Cómo funciona
El runbook enumera todos los grupos de Microsoft 365 aprovisionados como equipo, opcionalmente filtrados por *Prefijo del nombre del equipo*. Para cada equipo lee los canales de los tipos seleccionados y, para cada canal, la lista de miembros.
* **Canales privados** pertenecen a un equipo; solo sus miembros los ven, y no aparecen en la vista de grupos del portal de RealmJoin ni en la membresía del equipo. Este informe es la forma de verlos de un vistazo.
* **Canales compartidos** están alojados por un equipo y pueden compartirse con otros equipos y con personas de otros inquilinos. El informe enumera los canales compartidos que aloja un equipo; los canales compartidos en un equipo desde otro lugar no se repiten bajo ese equipo.
Cada fila muestra el equipo y su visibilidad, el canal, su tipo, si está archivado, la fecha de creación, el número de propietarios, miembros y miembros externos, y los propietarios por nombre y correo electrónico. Con *¿Listar también a los miembros?* si se establece en sí, los miembros también se enumeran por nombre; déjelo desactivado en inquilinos grandes para mantener el informe breve.
Los canales sin propietario se enumeran en su propia tabla y hoja de cálculo. Un canal privado o compartido sigue funcionando sin propietario, pero nadie puede administrar su membresía desde dentro de Teams, por lo que esos canales son los primeros candidatos para limpieza.
#### Miembros externos
A un miembro cuyo inquilino difiere del inquilino de origen se le marca *(externo)* y se cuenta en la columna *ExternalCount* . Las cuentas de invitado del inquilino de origen no se marcan, ya que son miembros del directorio del inquilino.
#### Equipos y canales que no se pueden leer
Un equipo cuyos canales no se pueden leer, por ejemplo porque se eliminó mientras se ejecutaba el informe o porque el equipo está archivado y es inaccesible, se enumera en la tabla *Equipos no legibles* con el motivo y no detiene la ejecución. Un canal cuya lista de miembros no se puede leer mantiene su fila con el motivo en la columna *Nota* y no se cuenta como un canal sin propietario.
#### Tiempo de ejecución
Los canales y los miembros se leen mediante solicitudes por lotes de Graph, veinte a la vez. Un inquilino con varios miles de equipos aún tarda un rato; el registro del trabajo muestra el progreso. Use *Prefijo del nombre del equipo* para informar sobre un subconjunto.
### Entrega del informe
Los resultados siempre aparecen como tablas con nombre en la pestaña Output Data de la ejecución en el portal de RealmJoin. Los archivos del informe solo se generan cuando la **Entrega del informe** opción incluye un correo electrónico y/o un enlace de descarga; *Solo datos de salida* no crea archivos de informe. La entrega por correo electrónico y la generación del enlace de descarga son independientes y pueden combinarse.
Para el enlace de descarga, los archivos del informe se cargan en la Storage Account de Azure configurada en la `RJReport.StorageAccount.*` configuración del Tenant, y se devuelven enlaces de descarga SAS con tiempo limitado. La carga al almacenamiento se autentica con la identidad administrada de la cuenta de Automation; esa identidad necesita el **Reader and Data Access** rol RBAC en la Storage Account de destino (esto es una asignación de RBAC de Azure, no un permiso de aplicación de Graph).
### Configuración relacionada con el envío de correo electrónico
Enviar un informe por correo electrónico es opcional y solo ocurre cuando *Enviar también el informe por correo electrónico* o *Enviar también el informe por correo electrónico y enlace de descarga* se selecciona como entrega del informe; entonces se requiere un destinatario. 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 estos ajustes no están configurados, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen que no puede descargarse o validarse, 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).
### Notas y limitaciones
* El informe es de solo lectura. Los propietarios y miembros de los canales privados y compartidos se cambian en el centro de administración de Teams o en Teams mismo; los runbooks **Sincronizar miembros de canal o grupo (Programado)** y **Sincronizar propietarios de Shared Channel (Programado)** cubren los casos automatizados para los canales compartidos.
* Los canales estándar no se enumeran; su membresía es igual a la membresía del equipo, que muestra el portal de RealmJoin.
* La lista de miembros de un canal compartido contiene a sus miembros directos. Las personas que acceden a un canal compartido a través de otro equipo con el que se comparte el canal no se enumeran.
### Ubicación
Organización → Colaboración → Informe de canales de Teams (programado)
**Nombre completo del runbook**
rjgit-org\_collab\_report-teams-channels\_scheduled
### Detalles
| Propiedad | Valor |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| Versión | 1.0.1 |
| Módulos requeridos | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
Az.Accounts (>= 5.5.2)
|
| Programable | sí |
### Permisos
#### Permisos de aplicación
* **Tipo**: Microsoft Graph
* Channel.ReadBasic.All
* *Enumera los canales privados y compartidos de cada equipo mediante /teams/{id}/channels*
* ChannelMember.Read.All
* *Lee los miembros de cada canal listado para distinguir entre propietarios, miembros y miembros externos*
* Group.Read.All
* *Enumera los grupos de Microsoft 365 aprovisionados como equipos con su nombre y visibilidad*
* Mail.Send *(opcional — característica: informe por correo electrónico)*
* *Envía el correo electrónico del informe mediante Send-RjRbReportEmail cuando se selecciona la entrega por correo electrónico*
* Organization.Read.All *(opcional — característica: informe por correo electrónico)*
* *Lee el nombre para mostrar del Tenant para el asunto del correo, el cuerpo del correo y los nombres de archivo del informe*
#### Notas sobre permisos
Azure Storage Account: rol 'Reader and Data Access' para la identidad administrada de la Automation Account en la Storage Account de destino - la carga recupera las claves de la cuenta mediante listKeys (solo necesario para las opciones de enlace de descarga)
### Parámetros
#### IncludePrivateChannels
Enumera los canales privados alojados por cada equipo.
| Propiedad | Valor |
| ------------------------------ | -------------------------- |
| Requerido | falso |
| Valor predeterminado | Verdadero |
| Tipo | Booleano |
| Nombre para mostrar del portal | ¿Incluir canales privados? |
**Opciones del portal**
| Opción del portal | Valor |
| ----------------- | --------- |
| Sí | verdadero |
| No | falso |
#### IncludeSharedChannels
Enumera los canales compartidos alojados por cada equipo. Los miembros de otros inquilinos se marcan como externos.
| Propiedad | Valor |
| ------------------------------ | ----------------------------- |
| Requerido | falso |
| Valor predeterminado | Verdadero |
| Tipo | Booleano |
| Nombre para mostrar del portal | ¿Incluir canales compartidos? |
**Opciones del portal**
| Opción del portal | Valor |
| ----------------- | --------- |
| Sí | verdadero |
| No | falso |
#### IncludeMembers
También enumera los miembros de cada canal por nombre. Desactivado enumera solo a los propietarios, lo que mantiene el informe breve en inquilinos grandes.
| Propiedad | Valor |
| ------------------------------ | ------------------------------- |
| Requerido | falso |
| Valor predeterminado | Falso |
| Tipo | Booleano |
| Nombre para mostrar del portal | ¿Listar también a los miembros? |
**Opciones del portal**
| Opción del portal | Valor |
| --------------------------- | --------- |
| Sí, propietarios y miembros | verdadero |
| No, solo propietarios | falso |
#### TeamNamePrefix
Solo los equipos cuyo nombre comienza con este texto. Déjelo vacío para todos los equipos.
| Propiedad | Valor |
| ------------------------------ | ----------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar del portal | Prefijo del nombre del equipo |
#### EmailFrom
Dirección del remitente del correo electrónico del informe. Se toma de la configuración del 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) |
#### SendEmailReport
Enviar el informe a la dirección de correo electrónico del destinatario.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | Falso |
| Tipo | Booleano |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### EmailTo
Envía el informe a estas direcciones. Separe varias con comas; cada destinatario recibe un correo electrónico independiente.
| Propiedad | Valor |
| ------------------------------ | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar del portal | Dirección(es) de correo electrónico del destinatario |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### ReportFileFormat
Entrega el informe como CSV, como un libro de Excel o ambos.
| Propiedad | Valor |
| ------------------------------ | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | CSV y XLSX |
| Tipo | Cadena |
| Nombre para mostrar del portal | Formato del archivo del informe |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
**Opciones del portal**
| Opción del portal | Valor |
| ----------------- | ---------- |
| CSV y XLSX | CSV y XLSX |
| Solo CSV | Solo CSV |
| Solo XLSX | Solo XLSX |
#### CreateDownloadLink
También carga el informe y devuelve un enlace de descarga que expira después de unos días.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | Falso |
| Tipo | Booleano |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### ContainerName
Contenedor de almacenamiento al que se cargan los archivos del informe. Se configura por runbook.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | report-teams-channels |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### ResourceGroupName
Grupo de recursos de la Storage Account para las cargas del informe. Obtenido de la configuración del Tenant RJReport.StorageAccount.ResourceGroup.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### StorageAccountName
Storage Account para las cargas del informe. Obtenido de la configuración del Tenant RJReport.StorageAccount.StorageAccountName.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### LinkExpiryDays
Número de días que un enlace de descarga permanece válido. Obtenido de la configuración del Tenant RJReport.StorageAccount.LinkExpiryDays.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | 6 |
| Tipo | Int32 |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
[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-teams-channels_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.