How To Configure Veeam Backup for Microsoft 365 to Use Microsoft Graph Export API for Teams

KB ID: 4340
Product: Veeam Backup for Microsoft 365 | 6.0
Published: 2022-07-15
Last Modified: 2022-08-17
Get weekly article updates
By subscribing, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.

Cheers for trusting us with the spot in your mailbox!

Now you’re less likely to miss what’s been brewing in our knowledge base with this weekly digest

error icon

Oops! Something went wrong.

Please try again later.

Purpose

This article documents the procedure for enabling Veeam Backup for Microsoft 365 to use the Teams Export APIs to backup Teams Chats.

In Veeam Backup for Microsoft 365 6a, by default, EWS APIs are used for Team chats backup, however Microsoft plans to deprecate Exchange Web Services (EWS) backup for the TeamsMessagesData folder in the future. After EWS API access to TeamsMessagesData folder is deprecated, the only way for Veeam Backup for Microsoft 365 to backup Teams Chats will be using the Teams Graph Export APIs.

Solution

Irreversible Change
This change from using EWS to Graph API to protect Teams messages is irreversible on both the repository and proxy levels. Once a new backup has been created with Teams Graph Export APIs, Veeam Backup for Microsoft 365 can no longer use that repository for backing up Teams chats using EWS API.

Follow these steps to activate the new Team chats backup method via Teams Export APIs:

Preparation

Make sure your Microsoft 365 organization has access to the Teams Export APIs.
KB4322: How to request access to Microsoft Graph Teams Export APIs

Enable Teams Graph API Backup on Veeam Backup for Microsoft 365 Server

On the Veeam Backup for Microsoft 365 server, in an Administrative PowerShell window, run the following PowerShell command:
Alternatively, right-click the Veeam Backup for Microsoft 365 PowerShell shortcut on the desktop and select Run as Administrator.

Set-VBOServer –EnableTeamsGraphAPIBackup:$true
SetVBOServer

Enable Teams Graph API Backup on Proxies

Note: Enabling Teams Graph API Backup for a proxy is irreversible. Once a proxy has been configured to use the Microsoft Graph Export API for Teams, it cannot be reverted to use EWS.

On the Veeam Backup for Microsoft 365 server, in an Administrative PowerShell window*, perform the following steps to enable usage of the Graph Export API for Teams on each of the Proxies that will use the new API to backup Teams Chats.
*Alternatively, right-click the Veeam Backup for Microsoft 365 PowerShell shortcut on the desktop and select Run as Administrator.

  1. Run the following PowerShell Command to retrieve a list of all available Proxies and their Proxy IDs.
    You will need the proxy IDs for the next step.
Get-VBOProxy | ft Hostname, Id, IsTeamsGraphAPIBackupEnabled
  1. For each backup proxy that you want to process Team chats via the new Teams Export APIs, run the following PowerShell cmdlet:​
    Replacing proxy_id with the GUID of the proxy.
Set-VBOProxy -proxy (Get-VBOproxy –id proxyID) -EnableTeamsGraphAPIBackup:$true
Example

Show in the example below:

  • The list of proxies is retrieved.
  • A specific proxy is set to use Teams Graph API.
  • The list of proxies is retrieved again to confirm that the option is enabled.

Enable Teams Chat Backup in GUI

  1. Reopen the Veeam Backup for Microsoft 365 console.
  2. Right-click on the Organization and select 'Edit organization'.

    Note that there is now a checkbox specifically for Microsoft Teams. That checkbox needs to be selected to back up Teams data. If access to the API has not been granted and this checkbox is enabled, the Teams backup will fail.
Enable Teams chats backup
  1. Edit the Backup Job will be backing up Teams Chats and enable Chats in Processing Options:
Enable Chats Processing
Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.

Spelling error in text

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please try again later.

KB Feedback/Suggestion

This form is only for KB Feedback/Suggestions, if you need help with the software open a support case

By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.
This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
Verify your email to continue your product download
We've sent a verification code to:
  • Incorrect verification code. Please try again.
An email with a verification code was just sent to
Didn't receive the code? Click to resend in sec
Didn't receive the code? Click to resend
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please try again later.