Exporter le rapport de groupe Microsoft 365 au format CSV à l'aide de PowerShell

En tant qu'administrateur, surveiller les groupes et leurs membres est l'une des tâches de routine. La plupart des administrateurs préfèrent PowerShell au centre d'administration Microsoft pour une meilleure personnalisation. Voyons donc comment obtenir un rapport de groupe Microsoft 365 à l'aide de PowerShell dans ce blog.

PowerShell possède plusieurs applets de commande telles que Get-MSolGroup, Get-AzureADGroup, Get- UnifiedGroup, Get-DistributionGroup, Get-MgGroup pour obtenir des informations sur le groupe. Êtes-vous confus pour choisir le bon ? N'ayez crainte ! Nous sommes là pour vous aider. Nous avons créé un script PowerShell tout-en-un pour exporter les groupes et leurs détails d'adhésion dans un fichier CSV.

Avec le script unique, vous pouvez générer plusieurs rapports de groupe à l'aide d'options de filtrage avancées. Voici quelques exemples de rapports,

• Rapport sur tous les groupes
• Rapport sur l'adhésion à tous les groupes
• Obtenez un rapport de groupe pour un seul groupe/une liste de groupes (via l'importation CSV)
• Obtenez l'adhésion à un groupe pour un seul groupe/une liste de groupes (via l'importation CVS)
• Rapport du groupe de sécurité Microsoft 365
• Rapport d'appartenance au groupe de sécurité Microsoft 365
• Rapport sur le groupe de distribution
• Rapport sur l'appartenance au groupe de distribution
• Rapport du groupe de sécurité activé par messagerie
• Rapport d'appartenance au groupe de sécurité à extension messagerie
• Rapport de groupe vide (Groupe sans rapport de membre)
• Rapport sur la taille du groupe (rapport de groupe basé sur le rapport sur le nombre de membres)

Télécharger le script :M365GroupReport

Points forts supplémentaires du script :

• Le script utilise Microsoft Graph PowerShell.
• Le script peut également être exécuté avec l'authentification basée sur les certificats (CBA) .
• Exporte le résultat du rapport au format CSV.
• Vous pouvez obtenir le nombre de membres en fonction du type de membre tel que l'utilisateur, le groupe, le contact, etc.
• Le script est convivial pour les planificateurs.
• Surtout, le script exporte la sortie vers deux fichiers CSV bien formatés. L'un avec des informations sur le groupe et un autre avec des informations détaillées sur l'appartenance au groupe.

Script PowerShell du rapport du groupe Microsoft 365 - Étapes d'exécution :

Méthode 1 : Exécuter le script avec le compte administrateur

Pour afficher tous les groupes et les informations de leurs membres, exécutez le script comme suit :

./M365GroupReport.ps1

Après l'exécution du script, les deux fichiers de sortie seront disponibles dans le répertoire d'exécution.

Méthode 2 : Exécuter le script PowerShell avec certificat

Pour exécuter le script avec une authentification basée sur un certificat, utilisez le format ci-dessous

.\M365GroupReport.ps1 -TenantId <TenantId> -ClientId <ClientId> -CertificateThumbprint <Certthumbprint>

Vous pouvez également utiliser le format ci-dessus pour exécuter le script PowerShell en tant que tâche planifiée dans le Planificateur de tâches Windows.

Remarque : Pour utiliser CBA, vous devez enregistrer l'application dans Azure AD. Pour obtenir plus de détails sur l’enregistrement de l’application et des certificats Azure, vous pouvez consulter le blog Connect MS Graph PowerShell with certificate. Vous pouvez suivre les étapes manuelles ou automatiser le processus (via un script prêt à l'emploi) en fonction de vos besoins.

Rapport du groupe Microsoft 365 :

Le rapport de groupe Microsoft 365 comporte les colonnes suivantes : nom du groupe, adresse e-mail, type de groupe, nombre de membres du groupe et nombre de membres par type.

Le rapport de groupe ressemble à la capture d'écran ci-dessous :

Rapport sur l'adhésion au groupe Microsoft 365 :

Le rapport sur l'adhésion au groupe Microsoft 365 comporte les colonnes suivantes : Nom du groupe, Adresse e-mail du groupe, Nom du membre, Adresse e-mail du membre et Type de membre. Le type de membre du groupe est utile pour identifier le type d'un membre tel qu'un utilisateur, un groupe et un contact.

Le rapport sur les membres du groupe ressemble à la capture d'écran ci-dessous :

Autres cas d'utilisation du script de rapport de groupe Microsoft 365 :

Comme indiqué précédemment, le script prend en charge les paramètres de filtrage avancés pour obtenir le rapport selon vos besoins.

Exporter tous les groupes et adhésions Microsoft 365 au format CSV :

Pour exporter tous les groupes Microsoft 365, exécutez le script comme suit :

./M365GroupReport.ps1

Le rapport exporté contient tous les types de groupes tels que la liste de distribution, les groupes de sécurité, le groupe de sécurité à extension messagerie et les groupes unifiés.

En faisant référence à ce rapport, l'administrateur peut ajouter ou supprimer un utilisateur du groupe.

Obtenir des membres pour un seul/une liste de groupes :

Vous pouvez utiliser -< i>GroupIDsFile param pour obtenir le rapport pour un ou plusieurs groupes spécifiques à partir de la liste d'entrée appelée « GroupId.txt » et exporte toutes les adhésions au format CSV.

Pour obtenir un rapport de groupe et un rapport d'adhésion pour des groupes spécifiques, transmettez un fichier d'entrée avec un GUID des groupes.

./M365GroupReport.ps1 -GroupIDsFile C:/GroupId.txt

Le GroupIDsFile doit suivre le format ci-dessous : Identité du groupe séparée par une nouvelle ligne sans en-tête.

Rapport sur la taille du groupe :

Le rapport vous aide à obtenir les groupes qui comptent plus d’un nombre « N » de membres. Pour obtenir ce rapport, vous pouvez exécuter le script avec -MinGroupMembersCount param.

./M365GroupReport.ps1 -MinGroupMembersCount 50

Le script ci-dessus exporte tous les groupes comptant plus de 50 membres.

Remarque : Si vous souhaitez déterminer l'appartenance à un groupe (c'est-à-dire le nombre de membres) en fonction de certaines conditions, vous pouvez utiliser le rapport d'appartenance au groupe dynamique.

Rapport du groupe de sécurité Microsoft 365 :

Les groupes de sécurité sont utilisés pour accorder l'accès aux ressources Microsoft 365. Pour exporter le rapport du groupe de sécurité, vous pouvez exécuter le script avec le paramètre -Security.

./M365GroupReport.ps1 -Security

En faisant référence au rapport d'appartenance à un groupe, vous pouvez afficher les utilisateurs qui disposent de droits et d'un accès aux sites SharePoint et à CRM Online.

Rapport sur la liste de distribution :

Les listes de distribution sont utilisées pour envoyer des notifications à un groupe de personnes. Pour exporter un groupe de distribution et ses membres, vous pouvez utiliser -DistributionList param lors de l'exécution du script.

./M365GroupReport.ps1 -DistributionList

Le script ci-dessus répertorie tous les groupes de distribution et les informations sur leurs membres.

Remarque : le rapport répertorie les groupes Microsoft 365 (boîtes aux lettres de groupe) en tant que liste de distribution.

Vous pouvez également consulter notre script dédié sur le rapport sur l'adhésion au groupe de distribution pour un rapport plus détaillé.

Rapport sur les groupes de sécurité à extension messagerie :

Ce type de groupe fonctionne comme une sécurité régulière avec la possibilité d'envoyer du courrier à ses membres. Pour obtenir une liste de tous les groupes de sécurité à extension messagerie, exécutez le script avec -MailEnabledSecurity param.

./M365GroupReport.ps1 -MailEnabledSecurity

Le script exporte les informations et l'adhésion aux groupes de sécurité à extension messagerie vers le fichier CSV.

Obtenir le rapport sur les groupes vides :

Pour obtenir un rapport de groupe vide (c'est-à-dire des groupes sans membres), exécutez le script avec -<IsEmpty param.

./M365GroupReport.ps1 -IsEmpty

En vous référant à ce rapport, vous pouvez supprimer les groupes inutilisés/inactifs dans votre locataire.

Planifier l'exécution périodique du rapport de groupe :

Comme indiqué précédemment, ce script est convivial pour les planificateurs. Vous pouvez transmettre les informations d'identification en tant que paramètre. Ainsi, il ne demandera pas de nom d’utilisateur et de mot de passe lors de l’exécution.

./M365GroupReport.ps1 -UserName admin@contoso.com -Password XXX

Vous pouvez utiliser le Planificateur de tâches Windows pour les tâches planifiées PowerShell.

Obtenez un rapport de groupe plus détaillé :

Pour exporter un rapport de groupe plus précis, vous pouvez utiliser plusieurs filtres (c'est-à-dire des paramètres et des commutateurs). J'ai donné quelques exemples ci-dessous.

• Pour obtenir des groupes de distribution vides,

./M365GroupReport.ps1 -IsEmpty -DistributionList

• Pour afficher les groupes de sécurité vides,

./M365GroupReport.ps1 -IsEmpty -Security

• Pour répertorier les groupes de sécurité à extension messagerie vides,

./M365GroupReport.ps1 -IsEmpty -MailenabledSecurity

• Pour obtenir de grands groupes de distribution,

./M365GroupReport.ps1 -DistributionList -MinGroupMembersCount 500

• Pour obtenir des groupes de sécurité en fonction du nombre de membres :

./M365GroupReport.ps1 -Security -MinGroupMembersCount 50

Les groupes Microsoft 365 sont utiles lorsque vous souhaitez accorder/envoyer des informations à plusieurs personnes. L'ajout de personnes au groupe leur donne automatiquement l'autorisation dont elles ont besoin. Outre les groupes, vous pouvez également utiliser l'abonnement à une boîte aux lettres partagée lorsque plusieurs personnes souhaitent accéder à la même boîte aux lettres.

Obtenez des rapports de groupe plus détaillés :

Pour obtenir des rapports de groupe plus détaillés basés sur

• Types de groupes

  • Groupe de sécurité
  • Groupe de distribution
  • Groupe de sécurité à extension messagerie
  • Groupe Microsoft 365
  • Groupe de distribution dynamique

• Appartenance à un groupe

  • Membres directs
  • Membres de groupes imbriqués
  • Adhésion cachée
  • Membres externes

• Source de création de groupe

  • Groupes créés via Teams
  • Groupes créés via SharePoint Online
  • Groupes créés via Yammer
• Modifications des membres du groupe
• Utilisation des groupes
• Groupes inactifs basés sur la date de la dernière activité

vous pouvez consulter l'outil de reporting et d'audit AdminDroid Microsoft 365.

AdminDroid fournit 1 500 rapports prédéfinis et 20 tableaux de bord intelligents et visuellement attrayants pour connaître votre environnement Office 365 en un coup d'œil. Cet outil fournit des rapports sur les rapports, les audits, les analyses, les statistiques d'utilisation, la sécurité et la conformité d'Office 365, etc.

En outre, AdminDroid fournit plus de plus de 100 rapports et tableaux de bord entièrement gratuits. Il comprend des rapports sur les utilisateurs, les licences, les groupes, les membres du groupe, les appareils, les activités de connexion, les modifications de mot de passe, les modifications de licence, etc. L'édition gratuite n'a aucune restriction sur les fonctionnalités de reporting telles que la personnalisation, la planification et l'exportation. Téléchargez gratuitement l'outil de création de rapports Office 365 d'AdminDroid et voyez comment il vous aide.

J'espère que ce blog vous aidera à gérer l'adhésion aux groupes dans votre organisation.