New Command: Get a list of Purview retention events

[martinlingstuyl]

Usage

m365 purview retentionevent list [options]

Description

Get a list of retention events

Options

None but global options

Examples

Get a list of retention events

m365 purview retentionevent list

Additional Info

The following Graph endpoint can be used:
https://graph.microsoft.com/beta/security/triggers/retentionEvents

More information

Text output properties

Properties visible in text output mode should be: id, displayName, eventTriggerDateTime

Beta notice

The Graph endpoint that's used is in beta, so we should add a beta notice to the docs.

Azure AD

The command will need the Scope RecordsManagement.Read.All.

More information

This section should be included in the documentation

This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.

Read more on event-based retention here

[Adam-it]

needs peer review ✅
nothing to add 👍
awesome work @martinlingstuyl on the retention labels 🤩

[nicodecleyre]

Can I work on this one?

[milanholemans]

Sure, all yours!