Powershell: Retention Cmdlets

Overview

The following reference CMDLets that are associated with Data Retention.

Cmdlet
Description
Applicable locations

A one-time operation to create storage, or view that storage for retention labels

Exchange mailboxes SharePoint sites (or SharePoint classic and communication sites) OneDrive accounts Microsoft 365 Group mailboxes & sites

View, create, delete, configure retention labels

Exchange mailboxes SharePoint sites (or SharePoint classic and communication sites) OneDrive accounts Microsoft 365 Group mailboxes & sites

View or configure the disposition review notification and reminder settings

Exchange mailboxes SharePoint sites (or SharePoint classic and communication sites) OneDrive accounts Microsoft 365 Group mailboxes & sites

View, create, delete, configure retention policies and retention label policies

Exchange email SharePoint sites (or SharePoint classic and communication sites) OneDrive accounts Microsoft 365 Group mailboxes & sites Skype for Business Exchange public folders Teams chat messages Teams channel messages

View, create, configure, delete settings (rules) for retention policies and retention labels

Exchange email SharePoint sites (or SharePoint classic and communication sites) OneDrive accounts Microsoft 365 Group mailboxes & sites Skype for Business Exchange public folders Teams chat messages Teams channel messages

Retention cmdlets specific to Teams private channels and Viva Engage

Use the following cmdlets when the locations are for Teams private channel messages, Viva Engage user messages, or Viva Engage community messages.

When the locations are for Teams chat messages, Teams channel messages, Exchange email, SharePoint sites (or SharePoint classic and communication sites), OneDrive accounts, Microsoft 365 Group mailboxes & sites, Skype for Business, or Exchange public folders, use the cmdlets listed in the previous section.

Expand table

Cmdlet
Description
Applicable locations

View, create, delete, configure retention policies

Teams private channel messages Viva Engage user messages Viva Engage community messages

View, create, configure, delete settings (rules) for retention policies

Teams private channel messages Viva Engage user messages Viva Engage community messages

Last updated