Set-VESPMailSettings

Short Description

Modifies Veeam Explorer for Microsoft SharePoint email settings. Veeam Explorer for Microsoft SharePoint uses these settings to send Microsoft SharePoint items as attachments in email messages and deliver export reports.

Applies to

Veeam Backup & Replication, Veeam Backup for Microsoft 365

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

Syntax

This cmdlet provides parameter sets that allow you to:

  • Modify email settings to use a custom SMTP server with basic authentication.

Set-VESPMailSettings [-EnableSendingEmails] [-Server <String>] [-Port <Int32>] [-UseAuthentication] [-UseSSL] [-Credentials <PSCredential>] -From <String> [<CommonParameters>]

  • Modify email settings to use a Google account for authentication.

Set-VESPMailSettings [-EnableSendingEmails] [-GoogleGmail] [-ClientId <String>] [-ClientSecret <SecureString>] [<CommonParameters>]

  • Modify email settings to use a Microsoft 365 account for authentication.

Set-VESPMailSettings [-EnableSendingEmails] [-ClientId <String>] [-Microsoft365] [-MailApiUrl <String>] [-TenantId <String>] [<CommonParameters>]

Detailed Description

This cmdlet modifies email settings for Veeam Explorer for Microsoft SharePoint. To modify settings, you need to enter the necessary parameters with new values. The parameters that you omit will remain unchanged.

Note

Email settings are global, they will be applied to all operations configured in Veeam Explorer for Microsoft SharePoint.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

EnableSendingEmails

Defines that Veeam Explorer for Microsoft SharePoint will send email messages.

Default: False

SwitchParameter

False

Named

False

Server

Specifies the full DNS name or IP address of the SMTP server for sending email messages.

String

False

Named

False

Port

Specifies a port number for connecting to SMTP server.

Int32

False

Named

False

UseAuthentication

Defines that the SMTP server requires authentication. Otherwise, the connection will be established to the SMTP server which does not enforce authentication.

Default: False

SwitchParameter

False

Named

False

UseSSL

Defines that Veeam Explorer for Microsoft SharePoint will enable a secure connection for sending emails.

If you do not provide this parameter, email messages will be sent through the connection that does not require SSL authentication.

Default: False

SwitchParameter

False

Named

False

Credentials

Specifies credentials that you want to use for authentication to the SMTP server.

Accepts the PSCredential object. To get this object, run the Get-Credential cmdlet.

False

Named

False

From

Specifies an email address of the email sender.

String

False

Named

False

GoogleGmail

Defines that Veeam Explorer for Microsoft SharePoint will send email messages on behalf of a Google account.

Default: False

SwitchParameter

True

Named

False

ClientId

Specifies the client ID obtained while registering an application in the Google Cloud console or Microsoft Identity platform.

String

False

Named

False

ClientSecret

Specifies a password.

Note: This parameter is required only for authentication with a Google account using a custom application.

SecureString

False

Named

False

Microsoft365

Defines that Veeam Explorer for Microsoft SharePoint will send email messages on behalf of a Microsoft 365 account.

Default: False

SwitchParameter

True

Named

False

MailApiUrl

Specifies the Microsoft Graph endpoint for sending mail.

Default: https://graph.microsoft.com/v1.0

String

False

Named

False

TenantId

Specifies a tenant ID in Microsoft Entra ID (formerly Microsoft Azure Active Directory).

String

False

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

The cmdlet returns the VESPMailSettings object that contains mail settings configured for Veeam Explorer for Microsoft SharePoint..

Examples

Set-VESPMailSettingsExample 1. Modifying Email Settings for SMTP Server with Basic Authentication

Set-VESPMailSettingsExample 2. Modifying Email Settings for Authentication with Microsoft 365 Account Using Veeam Application

Set-VESPMailSettingsExample 3. Modifying Email Settings for Authentication with Google Account Using Veeam Application

Set-VESPMailSettingsExample 4. Modifying Email Settings for Authentication with Microsoft 365 Account Using Custom Application

Set-VESPMailSettingsExample 5. Modifying Email Settings for Authentication with Google Account Using Custom Application

Related Commands

Read-Host

Page updated 4/4/2025

Page content applies to build 12.3.1.1139