Skip to content

New command: Get a list of purview retention labels #4144

@martinlingstuyl

Description

@martinlingstuyl

Usage

m365 purview retentionlabel list [options]

Description

Get a list of retention labels

Options

None but global options

Examples

Get a list of retention labels

m365 purview retentionlabel list

Additional Info

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

More information

Text output properties

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

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.

Try it out

You can try the endpoint by executing the following:

m365 request --url "https://graph.microsoft.com/beta/security/labels/retentionLabels"

Metadata

Metadata

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions