#1 Global Leader in Data Resilience

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 | 7.0 | 7a | 8
Published: 2022-07-15
Last Modified: 2024-09-20
mailbox
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 backup Teams public channel posts using the Teams Export APIs.Veeam Backup for Microsoft 365 backs up Teams channel messages. For more information on the limitations of Teams chat backup, click here.

In Veeam Backup for Microsoft 365 7 and previous versions, by default, EWS APIs are used to back up the TeamsMessagesData folder; however, Microsoft has deprecated Exchange Web Services (EWS) backup for the TeamsMessagesData folder. With EWS API access to the TeamsMessagesData folder now deprecated, the only way for Veeam Backup for Microsoft 365 to back up Teams public channel posts is using the Teams Graph Export APIs.

Solution

Follow these steps to activate the new method to back up Teams data via Teams Export APIs:

Preparation

Veeam Backup for Microsoft 365 7/7a Addtional Steps

Before Veeam Backup for Microsoft 365 8, additional steps were required to configure the software to utilize Teams Graph APIs.

If Veeam Backup for Microsoft 365 version 7 or 7a is in use, review the Additional Preparation Steps section of this article.

Enable Teams Chat Backup in GUI

  1. Open the Veeam Backup for Microsoft 365 console.
  2. Right-click on the Organization and select 'Edit organization'.
  3. Enable the option labeled 'Teams chats' listed under the 'Microsoft Teams' option.
    Note: The 'Teams chats' checkbox must be selected to back up Teams public channel posts. Also note, 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 that will be backing up public channel posts and enable the 'Chats' option in Processing Options:
Enable Chats Processing

Prep Steps for Veeam Backup for Microsoft 365 v7(a)

The following steps are not required for Veeam Backup for Microsoft 365 version 8 or higher.

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 back up Teams public channel posts.
*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 data 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
  • If a remote proxy is added to a Workgroup, use the following command:
    Replacing proxy_id with the GUID of the proxy.
Set-VBOProxy -proxy (Get-VBOProxy -id proxyID) -EnableTeamsGraphAPIBackup:$true -Credential (Get-Credential)
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.
To submit feedback regarding this article, please click this link: 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 hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please, try again later.

You have selected too large block!

Please try select less.

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 hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.
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.