Blog Post

Exchange Team Blog
5 MIN READ

How to determine which Resource Mailboxes are being actively used

The_Exchange_Team's avatar
The_Exchange_Team
Platinum Contributor
May 21, 2026

Today we wanted to take a few minutes to discuss a topic that has come up several times. Consider the scenario where your organization has created Resource mailboxes, and you want to know which ones are actually being used. Seems like a fair request.

This would include Room and Equipment mailboxes as well as Workspaces. Unfortunately, there are no native reports (at the time of this writing) that include details on Resource mailbox utilization. We are going to provide a few options you can use to find this information out, and you can choose which one works for you.

Option 1: Use Get-CalendarViewDiagnostics

Get the ID of a meeting - Exchange | Microsoft Learn

This will check the calendar of the specified mailbox and will provide the output of all meetings on the calendar during the specified time window.

The following example will provide a list of meetings on the calendar going back 6 months in the past and 6 months in the future:

Get-CalendarViewDiagnostics resource@contoso.com -WindowStartUtc (Get-Date).AddMonths(-6) -WindowEndUtc (Get-Date).AddMonths(6)

This returns data quickly and only targets the calendar. The possible downside of this approach is that the meeting subject is not a property that is exposed. But if you are only looking to see which rooms have meetings scheduled, or get an overall count, this should work great for you.

The upside to this approach is that Exchange Online PowerShell has rich filtering capabilities, so for example you could easily target your command to all Room mailboxes or all Equipment mailboxes.

Example:

$roommailboxes = Get-Mailbox -ResultSize Unlimited -RecipientTypeDetails RoomMailbox
$roommailboxes | ForEach { Write-Host “Processing Mailbox $($_.Displayname)” ; Get-CalendarViewDiagnostics $_ -WindowStartUtc (Get-Date).AddMonths(-6) -WindowEndUtc (Get-Date).AddMonths(6) }

Option 2: Use Graph to get the details of calendar events.

List calendarView - Microsoft Graph v1.0 | Microsoft Learn

On the bottom of the article, see example requests. To use this with PowerShell, you need the Microsoft.Graph.Calendar module and you need an Entra ID App registration which has the appropriate Graph permissions added.

You can either use Delegated permissions or Application permissions.

  • Delegated permissions mean Graph API is being accessed using a user account and will prompt for sign-in information.
  • Application permissions would be used for non-interactive applications/scripts where a sign-in prompt cannot be used.

Example using Application permissions:

  1. Create Entra ID App registration
  2. Add Graph Application Calendars.Read API permission. This allows the application to read calendar data from all mailboxes.
  3. Create either a client secret or upload a certificate to be used for authentication. If you use a certificate, note that it can be a self-signed certificate.
  4. Launch PowerShell and import the Graph module
    Import-Module Microsoft.Graph
  5. Connect to Graph using PowerShell with a certificate
    Connect-MgGraph -ClientId <app id=""> -TenantId <your tenant="" id=""> -CertificateThumbprint <cert thumbprint=""></cert></your></app>

    or

    Connect to Graph using a client secret

    Connect-MgGraph -ClientSecretCredential -TenantId <your tenant="" id=""></your>
  6. Display a list of calendar items for a given time period and specify a few properties to show, such as the Organizer, Subject and Start/End time. We will use the same example as with Get-CalendarViewDiagnostics, going back 6 months in the past and 6 months in the future.
    Get-MgUserCalendarView -UserId resource@contoso.com -StartDateTime (Get-Date).AddMonths(-6) -EndDateTime (Get-Date).AddMonths(6) | select @{n='Organizer';e={$_.Organizer.EmailAddress.Name}}, subject, @{n='StartTime';e={$_.Start.DateTime}},@{n='EndTime';e={$_.End.DateTime}}

Graph does have filtering capabilities, though for me it isn’t quite as easy as filtering in Exchange Online PowerShell. If you can connect to both Exchange Online PowerShell and Graph PowerShell in the same session, you could combine the two and run your command against the list of mailboxes in your variable.

Example:

Get the list of mailboxes from Exchange Online PowerShell:

$roommailboxes = Get-Mailbox -ResultSize Unlimited -RecipientTypeDetails RoomMailbox

Then use Graph PowerShell to get the Calendar events:

$roommailboxes | foreach {Write-Host "Processing Mailbox $($_.DisplayName)"; Get-MgUserCalendarView -UserId $_.PrimarySmtpAddress -StartDateTime (Get-Date).AddMonths(-6) -EndDateTime (Get-Date).AddMonths(6) | select @{n='Organizer';e={$_.Organizer.EmailAddress.Name}}, subject, @{n='StartTime';e={$_.Start.DateTime}},@{n='EndTime';e={$_.End.DateTime}}}

Note that there are additional properties available in addition to what was provided in the example above. You would need to determine which ones you want to show. Some of them (like Organizer and Start/End) are Type properties, so you must build an expression to handle them like we did above. Graph is also exposed to many other languages as well (HTTP, C#, Java, etc.)

Using the Graph solution, it is also possible to restrict access to only certain mailboxes (such as only Resource mailboxes).

Role Based Access Control for Applications in Exchange Online | Microsoft Learn

This would allow you to control which mailboxes the Entra ID app could pull calendar details from.

It involves configuring a management scope that defines the list of mailboxes (via a recipient filter). Once that is done, the Graph permissions in Entra ID needs to be removed, and they can then be granted in Exchange Online via RBAC (New-ManagementRoleAssignment).

Option 3: Use Get-MailboxFolderStatistics

For a very simplistic approach to checking resource mailbox usage, Get-MailboxFolderStatistics might provide what you need. Using the IncludeOldestAndNewestItems along with the FolderScope allows you to target the Calendar folder.

Example:

Get-MailboxFolderStatistics resource@contoso.com -IncludeOldestAndNewestItems -FolderScope Calendar

Similar to Get-CalendarViewDiagnostics, you have the ability to run in bulk against multiple recipients.

Example:

$roommailboxes | Foreach { Get-MailboxFolderStatistics $_ -IncludeOldestAndNewestItems -FolderScope Calendar}

Do not use Get-CalendarDiagnosticObjects for this purpose!

One last method that we’ve seen customers try use is using Calendar Diagnostic Logs with the Get-CalendarDiagnosticObjects cmdlet. Please DON’T use this method.

Get Calendar diagnostic logs for Exchange Online mailboxes - Exchange | Microsoft Learn

While it technically will work to pull meeting details, it really was not designed for bulk gathering of calendar events. Instead, it was designed to help troubleshoot problems with individual meetings. Calendar Diagnostic Log data includes not only data from the Calendar, but also all other folders where calendar-related information can be stored, including the Inbox, Sent Items, Deleted Items and Recoverable Items folders such as Calendar Logging. Querying even for a single meeting can sometimes produce in excess of 1000 logs. As such, running this in bulk for lots of meetings against a mailbox may fail, might timeout or produce errors. If you are using this method and reach out to Support because you have issues (which is very likely), we will direct you to one of the other options.

In summary, although there are no native reports available to check on which Resource Mailboxes are being used, there are several options available. If you are already connected to Exchange Online PowerShell, using Get-CalendarViewDiagnostics may be the simplest option for you. If you need more properties than what is exposed with Get-CalendarViewDiagnostics or want to be able to use a custom application that uses a different language, we recommend the Graph approach.

Ben Winzenz

Updated Jun 26, 2026
Version 5.0

3 Comments

  • Tonaco69's avatar
    Tonaco69
    Tin Contributor

    Hi, I can't find the Get-CalendarViewDiagnostics cmdlet, I have Exchange SE on-perm

    • bwinzenz's avatar
      bwinzenz
      Icon for Microsoft rankMicrosoft

      Tonaco69​ Unfortunately that is a cloud-only cmdlet. :(
      I tried to reply earlier but it didn't seem to show up here. Hopefully it will show up this time.

      This article was mainly focused on Exchange Online. Exchange on-prem unfortunately does not have equivalent commands as far as I am aware, but I will check with some colleagues.

  • This article describes a script that uses the Microsoft Graph PowerShell SDK to report the usage of room mailboxes: 

    https://practical365.com/room-mailbox-statistics-new/