Forum Discussion

Copper Contributor

Nov 16, 2022

Solved

Changing "retention type" on an existing retention label in MS Purview

I have a need to make a change to document retention in SharePoint. I need to deprecate use of an existing retention label with retention type "EventAgeInDays" and have users begin labeling content b...

microsoft purview

records management

EricaToelle
Nov 28, 2022
Hi K-dub,

Thanks for the question! Here is a link to the documentation about modifying existing labels: Create retention labels for exceptions - Microsoft Purview (compliance) | Microsoft Learn

"Most settings can't be changed after the label is created and saved, which include:

The retention label name and the retention settings except the retention period. However, you can't change the retention period when the retention period is based on when items were labeled."

So, you can change the retention period for a label, but nothing else. If you'd like to change the other settings, the best process is to create a new label and use PowerShell to replace it 1:1 with the old label.

Please let us know if you have other questions.

Thanks!

Erica

EricaToelle

Microsoft

Nov 28, 2022

Hi K-dub,

Thanks for the question! Here is a link to the documentation about modifying existing labels: Create retention labels for exceptions - Microsoft Purview (compliance) | Microsoft Learn

"Most settings can't be changed after the label is created and saved, which include:

The retention label name and the retention settings except the retention period. However, you can't change the retention period when the retention period is based on when items were labeled."

So, you can change the retention period for a label, but nothing else. If you'd like to change the other settings, the best process is to create a new label and use PowerShell to replace it 1:1 with the old label.

Please let us know if you have other questions.

Thanks!

Erica

Nick Brattoli
MVP
Jan 18, 2023
Hey EricaToelle! I hope everything's well with you! This is relevant to my interests. I'm going to have to show a client how to do do this soon (create the new labels and use PowerShell to replace them 1:1). Do you have any advice on what thread to start pulling to figure out how to do that?
- Kuljeet Singh
  Copper Contributor
  Jan 31, 2023
  Nick Brattoli Consider using the Set-PnPListItem cmdlet with the '-ClearLabel' and/or the '-Label' params to clear or assign a new retention label on an existing list item.
  
  Refer this example: https://pnp.github.io/powershell/cmdlets/Set-PnPListItem.html#example-4
  
  Hope that helps! Cheers!
  - EricaToelle
    Microsoft
    Nov 14, 2023
    This method is not recommended or supported by the Records Management product team.