Need to activate the Microsoft 365 sensitivity labels for Groups and Sites? This must be done with PowerShell. Find the current working script here.
The goal is that new sensitivity labels can be set with the scope for Groups and Sites in the Microsoft Purview compliance portal as here.
You can find the working PowerShell sample script in the atworkat/GovernanceToolkit365 repo.
The script works in PowerShell Core and checks whether the required EnableMIPLabels settings already exist or not with the Graph Beta Powershell command Get-MgBetaDirectorySetting. The settings are activated in both cases.
We hope this quick script helps to work with sensitivity labels in your Microsoft 365 tenant´s Groups and Sites.
SYNOPSIS
Sets a retention label on the specified list or library, or on specified items within a list or library. Use Reset-PnPRetentionLabel to remove the label again.
SYNTAX
Set on a list
Set-PnPRetentionLabel [-List] <ListPipeBind> -Label <String> [-SyncToItems <Boolean>] [-BlockDeletion <Boolean>]
[-BlockEdit <Boolean>] [-Connection <PnPConnection>]
Set on items in bulk
Set-PnPRetentionLabel [-List] <ListPipeBind> -Label <String> -ItemIds <List<Int32>> [-BatchSize <Int32>]
[-Connection <PnPConnection>] [-Verbose]
DESCRIPTION
Allows setting a retention label on a list or library and its items, or sets the retention label for specified items in a list or a library. Does not work for sensitivity labels.
When setting retention label to specified items, cmdlet allows passing of unlimited number of items – items will be split and processed in batches (CSOM method SetComplianceTagOnBulkItems has a hard count limit on number of processed items in one go). If needed, batch size may be adjusted with BatchSize parameter.
EXAMPLES
EXAMPLE 1
Set-PnPRetentionLabel -List "Demo List" -Label "Project Documentation"
This sets an O365 label on the specified list or library.
EXAMPLE 2
Set-PnPRetentionLabel -List "Demo List" -Label "Project Documentation" -SyncToItems $true
This sets an O365 label on the specified list or library and sets the label to all the items in the list and library as well.
EXAMPLE 3
Set-PnPRetentionLabel -List "Demo List" -ItemIds @(1,2,3) -Label "My demo label"
Sets “My demo label” retention label for items with ids 1, 2 and 3 on a list “Demo List”.
PARAMETERS
-BatchSize
Optional batch size when setting a label on specified items.
Type: Int32
Parameter Sets: (BulkItems)
Required: True
Position: Named
Default value: 25
Accept pipeline input: False
Accept wildcard characters: False
-BlockDeletion
Type: Boolean
Parameter Sets: (List)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-BlockEdit
Type: Boolean
Parameter Sets: (List)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Connection
Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
Type: PnPConnection
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ItemIds
List of item IDs to set label.
Type: List<Int32>
Parameter Sets: (BulkItems)
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Label
The name of the retention label.
Type: String
Parameter Sets: (All)
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-List
The ID or Url of the list.
Type: ListPipeBind
Parameter Sets: (All)
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-SyncToItems
Apply label to existing items in the library.
Type: Boolean
Parameter Sets: (List)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Verbose
When provided, additional debug statements will be shown while executing the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
## RELATED LINKS
[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)
[Microsoft Learn article on applying retention labels](https://learn.microsoft.com/en-us/sharepoint/dev/apis/csom-methods-for-applying-retention-labels)
