---
title: "Set-VBRMailNotificationConfiguration"
description: "Modifies global email notification settings. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet modifies global email notification settings. To modify settings, specify new values for the necessary parameters."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrmailnotificationconfiguration.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Veeam Backup & Replication Settings > Specifying Email Notification Settings > Set-VBRMailNotificationConfiguration"
dateModified: "2026-08-19"
---

# Set-VBRMailNotificationConfiguration

## Short Description
Modifies global email notification settings.

**Product Edition**: Standard, Enterprise, Enterprise Plus, Veeam Universal License

## Syntax
```
Set-VBRMailNotificationConfiguration [-SmtpServer <String>] [-Sender <String>] [-Recipient <String>]
 [-Subject <String>] [-DailyReportsTime <DateTime>] [-Port <Int32>] [-Timeout <Int32>] [-EnableSSL]
 [-EnableAuth] [-Credentials <CCredentials>] [-NotifyOnSuccess] [-NotifyOnWarning] [-NotifyOnFailure]
 [-NotifyOnLastRetryOnly] [-Force] [-AIGenerated <Boolean>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies global email notification settings.

::: note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged.

:::

## 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">AIGenerated</span></p>
        </td>
        <td>
          <p>Specifies whether Veeam Backup & Replication will use AI-generated text in email notification messages.</p>
        </td>
        <td style="width:10%;">
          <p><code>Boolean</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Credentials</span></p>
        </td>
        <td>
          <p>Specifies the user credentials that Veeam Backup & Replication will use connect to the SMTP server.</p>
        </td>
        <td style="width:10%;">
          <p><code>CCredentials</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">DailyReportsTime</span></p>
        </td>
        <td>
          <p>Specifies the time when Veeam Backup & Replication will send daily reports.</p><p>Default: <code>1/1/2019 10:00:00 PM</code></p>
        </td>
        <td style="width:10%;">
          <p><code>DateTime</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">EnableAuth</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will use user credentials to connect to the SMTP server.</p><p>Default: <code>Disabled</code></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">EnableSSL</span></p>
        </td>
        <td>
          <p>Enables SSL. If you provide this parameter, Veeam Backup & Replication will send email notifications over secure connection.</p><p>Default: <code>Disabled</code></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will modify global email notification settings without showing warnings in the PowerShell console.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">NotifyOnFailure</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will send email notifications if a job does not complete successfully.</p><p>Default: <code>True</code>.</p><p><strong>Note</strong>: To disable this option, set the parameter value to <code>$false</code>. That is, <em>parameter_name</em><code>:$false</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">NotifyOnLastRetryOnly</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will send  email notifications about the final job status.</p><p>Default: <code>True</code>.</p><p><strong>Note</strong>: To disable this option, set the parameter value to <code>$false</code>. That is, <em>parameter_name</em><code>:$false</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">NotifyOnSuccess</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will send email notifications if a job runs successfully.</p><p>Default: <code>True</code>.</p><p><strong>Note</strong>: To disable this option, set the parameter value to <code>$false</code>. That is, <em>parameter_name</em><code>:$false</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">NotifyOnWarning</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will send email notifications if a job completes with a warning.</p><p>Default: <code>True</code>.</p><p><strong>Note</strong>: To disable this option, set the parameter value to <code>$false</code>. That is, <em>parameter_name</em><code>:$false</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Port</span></p>
        </td>
        <td>
          <p>Specifies the port number. The SMTP server will send messages over this port.</p><p>Default: <code>25</code></p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Recipient</span></p>
        </td>
        <td>
          <p>Specifies the recipient addresses.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Sender</span></p>
        </td>
        <td>
          <p>Specifies an email address. The cmdlet will send email notifications from this address.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SmtpServer</span></p>
        </td>
        <td>
          <p>Specifies a full DNS name or an IP address of the SMTP server. The cmdlet will use this server to send email notifications.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Subject</span></p>
        </td>
        <td>
          <p>Specifies the subject of the email notifications.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Timeout</span></p>
        </td>
        <td>
          <p>Specifies the connection timeout for the SMTP server.</p><p>Default: <code>100000</code></p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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 [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
The cmdlet returns the [`VBRMailNotificationConfiguration`](vbrmailnotificationconfiguration.md) object that contains global email notification settings.

## Examples

::: example
### Modifying Global Email Notification Settings

This command modifies the global notification settings. Veeam Backup & Replication will send notification settings with the following options:

- The IP address of the SMTP server that Veeam Backup & Replication will use to send messages is `172.17.53.12`.
- The messages are sent from the `backup@tech.com` email address.
- The messages are sent to the `administrator@tech.com` email address.
- The subject of the messages is `%BackupJobs%`.
- Veeam Backup & Replication will send messages if the backup job fails.

```
Set-VBRMailNotificationConfiguration -SmtpServer 172.17.53.12 -Sender backup@tech.com -Recipient administrator@tech.com -Subject %BackupJobs% -NotifyOnFailure
```

:::

## Related Commands

[`Get-Date`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-date?view=powershell-7.1)