---
title: "Get-VBOMailboxProtectionReport"
description: "This cmdlet generates a report on mailboxes that added to the Microsoft 365 and on-premises Microsoft Exchange organizations. This report contains statistical data on protected and unprotected user mailboxes."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/get-vbomailboxprotectionreport.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Reports > Get-VBOMailboxProtectionReport"
dateModified: "2026-08-21"
---

# Get-VBOMailboxProtectionReport

## Short Description
Generates reports on protected and unprotected mailboxes of the Microsoft 365 and on-premises Microsoft Exchange organizations.

## Syntax
```
Get-VBOMailboxProtectionReport [-Organization <VBOOrganization>] -Path <String> -Format <VBOReportFormat>
 [-Timezone <TimeZoneInfo>] [<CommonParameters>]
```

## Detailed Description
This cmdlet generates a report on mailboxes that added to the Microsoft 365 and on-premises Microsoft Exchange organizations. This report contains statistical data on protected and unprotected user mailboxes.

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Format</span></p>
        </td>
        <td>
          <p>Specifies in which format the cmdlet will save the report:</p><ul><li><em>PDF</em></li><li><em>CSV</em></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBOReportFormat</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Organization</span></p>
        </td>
        <td>
          <p>Specifies a Microsoft organization. The cmdlet will generate a report on mailboxes that are added to this organization.</p><p>Accepts the <a href="vboorganization.md"><code>VBOOrganization</code></a> object.</p><p>To get this object, run the <a href="get-vboorganization.md"><code>Get-VBOOrganization</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboorganization.md"><code>VBOOrganization</code></a></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Path</span></p>
        </td>
        <td>
          <p>Specifies a path to the folder. The cmdlet will save a report to this folder.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Timezone</span></p>
        </td>
        <td>
          <p>Specifies a timezone that you want to show in the report. The timezone is displayed at the bottom of the report page.</p><p><strong>Note</strong>: If you do not provide this parameter, the cmdlet will generate a report in the UTC timezone.</p><p>Accepts the <code>TimeZoneInfo</code> object.</p><p>To get this object, run the <a href="https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.management/get-timezone"><code>Get-TimeZone</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>TimeZoneInfo</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Examples

::: example
### Example 1: Generating Mailbox Report

This example shows how to generate a report for mailboxes of the `ABC` Microsoft organization. The report is generated with the following settings:

- The cmdlet will save the report to the folder that is located at the following path: `C:\tmp`.
- The cmdlet will generate the report in the CSV format.
- The cmdlet will generate the report in the UTC timezone.

```
$org = Get-VBOOrganization -Name "ABC"
Get-VBOMailboxProtectionReport -Path "C:\tmp" -Format CSV -Organization $org
```

Perform the following steps:

1. Run the [`Get-VBOOrganization`](get-vboorganization.md) cmdlet. Save the result to the `$org` variable.
2. Run the `Get-VBOMailboxProtectionReport` cmdlet. Specify the following settings:

   - Set the `$org` variable as the `Organization` parameter value.
   - Specify the `Path` parameter value.
   - Specify the `Format` parameter value.

:::

::: example
### Example 2: Generating Mailbox Report with Timezone

This example shows how to generate a report for mailboxes of Microsoft organizations. The report is generated with the following settings:

- The cmdlet will save the report to the folder that is located at the following path: `C:\share`.
- The cmdlet will generate the report in the CSV format. 
- The cmdlet will generate the report in the specified timezone.

```
$timezone = Get-TimeZone
Get-VBOMailboxProtectionReport -Path "C:\share" -Format CSV -TimeZone $timezone
```

Perform the following steps:

1. Run the [`Get-TimeZone`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.management/get-timezone) cmdlet. Save the result to the `$timezone` variable.
2. Run the `Get-VBOMailboxProtectionReport` cmdlet. Specify the following settings:

   - Provide the `Path` parameter.
   - Provide the `Format` parameter.
   - Set the `$timezone` variable as the `TimeZone` parameter value.

:::

## Related Commands

- [`Get-VBOOrganization`](get-vboorganization.md)
- [``Get-TimeZone``](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.management/get-timezone)