Exportar informe de grupo de Microsoft 365 a CSV mediante PowerShell
Como administrador, monitorear los grupos y su membresía es una de las tareas rutinarias. La mayoría de los administradores prefieren PowerShell al centro de administración de Microsoft para una mejor personalización. Entonces, veamos cómo obtener un informe grupal de Microsoft 365 usando PowerShell en este blog.
PowerShell tiene varios cmdlets como Get-MSolGroup, Get-AzureADGroup, Get- UnifiedGroup, Get-DistributionGroup, Get-MgGroup para obtener información del grupo. ¿Estás confundido al elegir el correcto? ¡No temáis! Estamos aquí para ayudarte. Hemos creado un script Todo-en-Uno PowerShell para exportar grupos y sus detalles de membresía a un archivo CSV.
Con una secuencia de comandos única, puede generar varios informes grupales con la ayuda de opciones de filtrado avanzadas. A continuación se muestran algunos informes de ejemplo,
- Informe de todos los grupos
- Informe de membresía de todos los grupos
- Obtener informe de grupo para un grupo individual o una lista de grupos (mediante importación CSV)
- Obtenga membresía de grupo para un solo grupo o una lista de grupos (mediante importación CVS)
- Informe del grupo de seguridad de Microsoft 365
- Informe de membresía del grupo de seguridad de Microsoft 365
- Informe del grupo de distribución
- Informe de membresía del grupo de distribución
- Informe del grupo de seguridad habilitado para correo
- Informe de pertenencia al grupo de seguridad habilitado para correo
- Informe de grupo vacío (Grupo sin informe de miembros)
- Informe del tamaño del grupo (informe del grupo basado en el informe del recuento de miembros)
Descargar script:M365GroupReport
Aspectos destacados adicionales del guión:
- El script utiliza Microsoft Graph PowerShell.
- El script también se puede ejecutar con autenticación basada en certificados (CBA) .
- Exporta el resultado del informe a CSV.
- Puede obtener recuento de miembros según el tipo de miembro como usuario, grupo, contacto, etc.
- El script es compatible con el programador.
- Sobre todo, el script exporta el resultado a 2 archivos CSV con un buen formato. Uno con información del grupo y otro con información detallada sobre la membresía del grupo.
Secuencia de comandos de PowerShell para informes de grupo de Microsoft 365: pasos de ejecución:
Método 1: Ejecute el script con una cuenta de administrador
Para ver todos los grupos y la información de sus miembros, ejecute el script de la siguiente manera:
./M365GroupReport.ps1Después de la ejecución del script, ambos archivos de salida estarán disponibles en el directorio de ejecución.
Método 2: Ejecutar el script de PowerShell con certificado
Para ejecutar el script con autenticación basada en certificado, utilice el siguiente formato
.\M365GroupReport.ps1 -TenantId <TenantId> -ClientId <ClientId> -CertificateThumbprint <Certthumbprint>También puede utilizar el formato anterior para ejecutar el script de PowerShell como tarea programada en el Programador de tareas de Windows.
Nota: Para usar CBA, debe registrar la aplicación en Azure AD. Para obtener más detalles sobre cómo registrar aplicaciones y certificados de Azure, puede consultar el blog sobre cómo conectar MS Graph PowerShell con certificados. Puede seguir los pasos manuales o automatizar el proceso (a través de un script listo para ejecutar) según sus necesidades.
Informe de grupo de Microsoft 365:
El informe de grupo de Microsoft 365 tiene las siguientes columnas: nombre del grupo, dirección de correo electrónico, tipo de grupo, recuento de miembros del grupo y recuento de miembros por tipo.
El informe del grupo es similar a la siguiente captura de pantalla:
Informe de membresía de grupo de Microsoft 365:
El informe de pertenencia al grupo de Microsoft 365 tiene las siguientes columnas: Nombre del grupo, Dirección de correo electrónico del grupo, Nombre del miembro, Correo electrónico del miembro y Tipo de miembro. El tipo de miembro del grupo es útil para identificar el tipo de miembro, como usuario, grupo y contacto.
El informe de los miembros del grupo es similar a la siguiente captura de pantalla:
Más casos de uso del script de informes grupales de Microsoft 365:
Como se dijo anteriormente, el script admite parámetros de filtrado avanzados para obtener el informe según sus necesidades.
Exportar todos los grupos y membresías de Microsoft 365 a CSV:
Para exportar todos los grupos de Microsoft 365, ejecute el script de la siguiente manera:
./M365GroupReport.ps1El informe exportado contiene todos los tipos de grupos, como lista de distribución, grupos de seguridad, grupo de seguridad habilitado para correo y grupos unificados.
Al consultar este informe, el administrador puede agregar o eliminar usuarios del grupo.
Conseguir miembros para un único/lista de grupos:
Puedes usar -< i>GroupIDsFile parámetro para obtener el informe de grupos específicos de la lista de entrada llamada "GroupId.txt" y exporta todas las membresías a CSV.
Para obtener un informe de grupo y un informe de membresía de grupos específicos, pase un archivo de entrada con un GUID de grupos.
./M365GroupReport.ps1 -GroupIDsFile C:/GroupId.txtEl GroupIDsFile debe seguir el siguiente formato: Identidad de grupo separada por una nueva línea sin encabezado.
Informe sobre el tamaño del grupo:
El informe le ayuda a obtener los grupos que tienen más de un número "N" de miembros. Para obtener este informe, puede ejecutar el script con -MinGroupMembersCount param.
./M365GroupReport.ps1 -MinGroupMembersCount 50El script anterior exporta todos los grupos que tienen más de 50 miembros.
Nota: Si desea determinar la membresía del grupo (es decir, el recuento de miembros) en función de ciertas condiciones, puede utilizar el informe de membresía del grupo dinámico.
Informe del grupo de seguridad de Microsoft 365:
Los grupos de seguridad se utilizan para conceder acceso a los recursos de Microsoft 365. Para exportar el informe del grupo de seguridad, puede ejecutar el script con -Security param.
./M365GroupReport.ps1 -SecurityAl referir el informe de membresía del grupo, puede ver los usuarios que tienen derechos y acceso a sitios de SharePoint y CRM Online.
Informe de lista de distribución:
Las listas de distribución se utilizan para enviar notificaciones a un grupo de personas. Para exportar el grupo de distribución y su membresía, puede usar -DistributionList param mientras se ejecuta el script.
./M365GroupReport.ps1 -DistributionListEl script anterior enumera todos los grupos de distribución y la información de sus miembros.
Nota: El informe enumera los grupos de Microsoft 365 (buzones de correo de grupo) como una lista de distribución.
También puede consultar nuestro script dedicado en el informe de membresía del grupo de distribución para obtener un informe más detallado.
Informe de grupos de seguridad habilitados para correo:
Este tipo de grupo funciona como seguridad habitual junto con la capacidad de enviar correo a sus miembros. Para obtener una lista de todos los grupos de seguridad habilitados para correo, ejecute el script con -MailEnabledSecurity param.
./M365GroupReport.ps1 -MailEnabledSecurityLa secuencia de comandos exporta la información y la membresía de los grupos de seguridad habilitados para correo al archivo CSV.
Obtener informe de grupos vacíos:
Para obtener un informe de grupo vacío (es decir, grupos sin miembros), ejecute el script con -<.Está vacío param.
./M365GroupReport.ps1 -IsEmptyAl consultar este informe, puede eliminar grupos no utilizados o inactivos en su inquilino.
Programar el informe de grupo para que se ejecute periódicamente:
Como se dijo anteriormente, este script es compatible con el programador. Puede pasar la credencial como parámetro. Por lo tanto, no solicitará el nombre de usuario ni la contraseña durante la ejecución.
./M365GroupReport.ps1 -UserName admin@contoso.com -Password XXXPuede utilizar el Programador de tareas de Windows para tareas programadas de PowerShell.
Obtenga un informe grupal más granular:
Para exportar un informe de grupo más granular, puede utilizar varios filtros (es decir, parámetros y modificadores). He dado algunos ejemplos a continuación.
- Para obtener grupos de distribución vacíos,
./M365GroupReport.ps1 -IsEmpty -DistributionList- Para ver grupos de seguridad vacíos,
./M365GroupReport.ps1 -IsEmpty -Security- Para enumerar grupos de seguridad vacíos habilitados para correo,
./M365GroupReport.ps1 -IsEmpty -MailenabledSecurity- Para conseguir grandes grupos de distribución,
./M365GroupReport.ps1 -DistributionList -MinGroupMembersCount 500- Para obtener grupos de seguridad según el recuento de miembros,
./M365GroupReport.ps1 -Security -MinGroupMembersCount 50Los grupos de Microsoft 365 son útiles cuando quieres dar acceso o enviar información a varias personas. Al añadir personas al grupo, se les otorga automáticamente el permiso que necesitan. Además de los grupos, también puedes utilizar la membresía del buzón de correo compartido cuando varias personas quieran acceder al mismo buzón.
Obtenga informes grupales más detallados:
Para obtener informes de grupo más detallados basados en
Tipos de grupo
- grupo de seguridad
- Grupo de distribución
- Grupo de seguridad habilitado para correo
- grupo Microsoft 365
- Grupo de distribución dinámica
Membresía de grupo
- Miembros directos
Fuente de creación del grupo
- Grupos creados a través de Teams
puede echar un vistazo a la herramienta de auditoría e informes de Microsoft 365 AdminDroid.
AdminDroid proporciona más de 1500 informes prediseñados y 20 paneles de control inteligentes y visualmente atractivos para conocer su entorno de Office 365 de un vistazo. Esta herramienta proporciona informes sobre informes, auditorías, análisis, estadísticas de uso, seguridad y cumplimiento de Office 365, etc.
Además, AdminDroid proporciona más de más de 100 informes y paneles completamente gratis. Incluye informes sobre usuarios, licencias, grupos, miembros de grupos, dispositivos, actividades de inicio de sesión, cambios de contraseña, cambios de licencia y más. La edición gratuita no tiene restricciones en las funcionalidades de informes, como personalización, programación y exportación. Descargue la herramienta gratuita de informes Office 365 de AdminDroid y vea cómo le ayuda.
Espero que este blog le ayude a gestionar la membresía de grupos en su organización.