PowerShell est très pratique pour explorer les calendriers Exchange, que ce soit pour consulter les événements planifiés ou supprimer un rendez-vous. La gestion des calendriers dans Exchange ou Microsoft 365 peut parfois sembler complexe, surtout si l’on souhaite éviter d’utiliser l’interface graphique. L’utilisation de scripts PowerShell permet un gain de temps considérable, mais la méthode peut s’avérer déroutante car il existe plusieurs approches selon les besoins. Par exemple, obtenir la liste de tous les événements du calendrier d’un utilisateur est une chose, mais supprimer une réunion ou vider des calendriers entiers peut être une tout autre affaire, parfois avec les mêmes outils, parfois non. Attention : certaines commandes peuvent fonctionner sur une configuration et échouer sur une autre, notamment en raison de problèmes d’autorisations ou de modules. Ce guide devrait vous aider à comprendre comment lister et supprimer des événements de calendrier dans la plupart des configurations, que vous utilisiez Exchange Online ou un serveur local. Conclusion ? Vous pourrez consulter toutes vos réunions à venir ou vider votre calendrier sans avoir à vous connecter à chaque compte manuellement. C’est un peu bricolé, certes, mais c’est bien plus rapide que de passer des heures à chercher. Consultez les commandes ci-dessous et choisissez celle qui vous convient.
Comment lister et supprimer des événements de calendrier dans Exchange via PowerShell
Afficher les événements du calendrier utilisateur dans Microsoft 365 avec PowerShell
Ceci est particulièrement utile pour consulter rapidement le calendrier d’un utilisateur, notamment pour les audits ou pour anticiper les événements à venir. Le fonctionnement repose sur l’API Microsoft Graph, qui vous donne accès aux éléments du calendrier si vous disposez des autorisations nécessaires. Généralement, vous devez enregistrer une application dans Azure AD ( Portail Azure > Inscriptions d’applications > Nouvelle inscription ), puis lui accorder Calendars. Readles Calendars. ReadBasic. Allautorisations nécessaires pour que votre script puisse accéder aux données du calendrier. Si le module n’est pas installé, exécutez :
Install-Module Microsoft. Graph -Scope AllUsersUne fois ces informations configurées, utilisez l’ID de votre application Azure, l’empreinte numérique de votre certificat et votre ID de locataire pour vous authentifier. Voici un exemple de connexion simple :
$certThumbprint = "9CF05589A4B29BECEE6456F08A76EBC3DC2BC581" $AzureAppID = "111111-2222-3333-4444-12345678" $tenant = "woshub.onmicrosoft.com" Connect-MgGraph -AppId $AzureAppID -CertificateThumbprint $certThumbprint -TenantId $tenant Sur certaines configurations, cette opération peut échouer la première fois. Dans ce cas, essayez de vous reconnecter ou vérifiez vos autorisations, car Windows a tendance à compliquer les choses inutilement. Une fois connecté, vous pouvez récupérer les événements du calendrier utilisateur comme ceci :
$StartDate = (Get-Date -Day 1) $EndDate = (Get-Date -Day 1).AddMonths(1) Get-MgUserCalendarView -UserId "[email protected]" -CalendarId "Calendar" -StartDateTime $StartDate -EndDateTime $EndDate | Select-Object -Property @{Name='EventStart';Expression={ $_. Start. DateTime }}, @{Name='EventEnd';Expression={ $_. End. DateTime }}, Subject, BodyPreview Vous y trouverez la liste des réunions avec leurs horaires de début et de fin, leurs sujets et des extraits de leur contenu. Pratique pour un audit ou simplement pour consulter le planning sans avoir à vous connecter au portail.
Méthode 1 : Supprimer les événements à venir dans le calendrier Exchange
Si vous souhaitez supprimer des événements à venir (par exemple, si un employé est en vacances et que vous devez vider son calendrier), vous pouvez utiliser la cmdlet Remove-CalendarEvents. Cette commande indique à PowerShell : « Supprime toutes les réunions planifiées dans les 15 prochains jours par cet utilisateur », ou spécifiez une plage de dates. Voici un exemple :
Remove-CalendarEvents -Identity [email protected] -CancelOrganizedMeetings -QueryWindowInDays 15 C’est pratique pour un nettoyage rapide lorsque le départ d’une personne est imminent ou que vous devez faire un coup de propre rapide. Vous pouvez également cibler des périodes spécifiques :
Remove-CalendarEvents -Identity [email protected] -CancelOrganizedMeetings -QueryStartDate 2023-04-10 -QueryWindowInDays 60 Dans certaines configurations, l’ajout d’éléments -PreviewOnly -Verbosepermet de visualiser ce qui sera supprimé en premier, afin d’éviter toute suppression accidentelle. Attention cependant : cette cmdlet ne récupère que les événements à venir et ne filtre pas par sujet ni par organisateur ; il s’agit d’un outil de purge rapide, principalement destiné au nettoyage après des licenciements ou des réinitialisations ponctuelles.
Si vous devez supprimer des événements passés ou travailler avec des données plus anciennes sur un serveur Exchange local (par exemple, 2016, 2013, etc.), vous pouvez utiliser les commandes Search-Mailbox ou New-ComplianceSearch, notamment si vous traitez des sujets ou du contenu spécifiques dans les éléments du calendrier. Par exemple :
Search-Mailbox -Identity [email protected] -SearchQuery "Subject:'Discuss: AD Schema Update' AND Kind:meetings AND Received:01/12/2023..15/01/2024" -TargetMailbox report_mbx -TargetFolder SearchMailboxResult -LogOnly -LogLevel Full Cela permet d’extraire les réunions correspondant à l’objet et à la période. Pour supprimer, remplacez -LogOnlypar -DeleteContent. Le principe est le même dans Exchange Online, mais principalement via ComplianceSearch. Voici un exemple rapide :
New-ComplianceSearch -Name DeleteOldMeetings -ContentMatchQuery "kind:meetings AND subject:weekly_it_meeting" Start-ComplianceSearch -identity DeleteOldMeetings Get-ComplianceSearch -identity DeleteOldMeetings | fl Une fois votre recherche terminée (le statut indique « Terminé »), vous pouvez exécuter :
New-ComplianceSearchAction -SearchName DeleteOldMeetings -Purge Cette approche demande un peu plus de recherches, mais elle est très efficace si vous devez dénicher des événements spécifiques ou supprimer en masse d’anciens calendriers.
Conclure
Gérer les événements de calendrier avec PowerShell peut sembler un peu intimidant au premier abord, surtout avec la multitude d’outils et de commandes disponibles. Mais une fois la prise en main effectuée, c’est un gain de temps précieux. Que vous souhaitiez simplement consulter ou supprimer des événements, il existe une méthode adaptée à presque tous les cas de figure. Pensez à bien vérifier vos commandes et leur portée avant d’effectuer des suppressions en masse : rien de pire que de tout effacer par erreur ! Sur une configuration, l’opération a été instantanée ; sur une autre, un redémarrage ou une actualisation rapide a été nécessaire. Quoi qu’il en soit, cela permet généralement de gagner un temps considérable par rapport à une utilisation manuelle, en particulier dans les grandes organisations. Bonne chance pour la gestion de vos calendriers !
Résumé
- Utilisez des modules PowerShell comme Microsoft. Graph pour lire les données du calendrier.
- Enregistrez les applications dans Azure et accordez les autorisations appropriées avant de vous connecter.
- Utilisez Remove-CalendarEvents pour supprimer rapidement les réunions à venir.
- Pour les événements plus anciens ou spécifiques, effectuez une recherche et supprimez-les à l’aide de Search-Mailbox ou ComplianceSearch.
- Toujours tester les commandes avec l’option -PreviewOnly avant de supprimer de gros volumes de données.