Cli-microsoft365: Record Management, Declare, undeclare, Apply Label, remove label

[joaojmendes]

I think is very usel if we have commands to work with records management ao Labels,
Like possibility to declare, undeclare records, and apply labels and remove label.

And associate list of what is defined.

Congratulation for the great job ! I am a MAcOS User and this tool is a must!

Cheers!

[waldekmastykarz]

Thank you and great to hear you find the CLI useful! 🎉

Regarding the extra commands you mentioned, do you have any pointers that we could use to get more info about the related functionality so that we can write specs for the commands and implement them?

[joaojmendes]

Welcome !

Cenario 1:

Remove the "declare record" to a specific Item/doc by command like exists in PnP Powershell -
Clear-PnPListItemAsRecord, and Test-PnPListItemIsRecord.

Cenario 2:

Possibility to add/remove a Label to a ListItem, add Label to Document Library and optionally apply this Label to all Docs that already exist in.

Labels are defined in Office 365 Security & Compliance Center and published to use on SharePoint and OnDrive.

Thank you very much!

[waldekmastykarz]

This is very helpful! Thank you for the additional information. We'll ping you when we have the specs ready to double check we have everything. 👍

[waldekmastykarz]

@joaojmendes Do you know if there is any API for working with labels or have you been using it through UI only so far?

[joaojmendes]

Hi Waldek,

I use the UI (Office 365 Security & Compliance) to create Labels, Policies and DLP Rules, In SharePoint I use the Document Library page settings to apply default label to content.

I think that at this time we don’t have any API available to manage Label, Policies and DLP, but there are PowerShell Cmdlets, https://docs.microsoft.com/en-us/powershell/module/exchange/policy-and-compliance-retention/get-retentionpolicy?view=exchange-ps.

In beta release of Microsoft Graph there are API to work with Policies… I don’t know if in the future will be available API’s to work this Label, Policies and DLP, and possibility to apply on content in SharePoint.
https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/policy_post

thank you very much.
João

From: Waldek Mastykarz [e-mail]
Reply-To: SharePoint/office365-cli [e-mail]
Date: Sunday, 22 April 2018 at 18:14
To: SharePoint/office365-cli [e-mail]
Cc: joaojmendes [e-mail], Mention [e-mail]
Subject: Re: [SharePoint/office365-cli] Record Management, Declare, undeclare, Apply Label, remove label (#384)

@joaojmendeshttps://github.com/joaojmendes Do you know if there is any API for working with labels or have you been using it through UI only so far?

—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHubhttps://github.com/SharePoint/office365-cli/issues/384#issuecomment-383397067, or mute the threadhttps://github.com/notifications/unsubscribe-auth/AL-D1TRl5KlLtlT0RHqYiM8dcm3OKoJCks5trLpdgaJpZM4S54gJ.

[waldekmastykarz]

Thanks for the info @joaojmendes, I'll see if I can dig up anything more.

[waldekmastykarz]

Hey @joaojmendes, are the following cmdlets covering the scenarios you mentioned?

• Clear-PnPListItemAsRecord
• Set-PnPListItemAsRecord
• Test-PnPListItemIsRecord
• Get-PnPLabel
• Set-PnPLabel

I think there might be a gap with regards to setting label on items, but I haven't worked with labels myself so can't tell for sure what's needed. Other than the links you shared previously, do you have links to some other resources like articles or blog posts that would give us some more information about what you're after?

[joaojmendes]

Hi @waldekmastykarz ,

The goal is apply Label to Items or declare/undeclre items as record

The cmdlets:

Clear-PnPListItemAsRecord
Set-PnPListItemAsRecord
Test-PnPListItemIsRecord

To work with labels (Office 365 Labels Data Governance)

the cmdlets:

Get-PnPLabel
Set-PnPLabel

work on list settings and when defined apply a label automatically to Items.

I think don't have a Cmdlets to apply a label to Items individual ...

I have worked with Document Management Systems and ECM and I have use InPlace Record I want to move to labels but there are some gaps of functionalities, for example the Label Defined as Record can't be applied automatically.

Is nice to have this cmdlets in office365-cli too :

Set-PnPListRecordDeclaration
Set-PnPInPlaceRecordsManagement

I hope I've helped.

thank you.

[waldekmastykarz]

Yes, you have. Thank you!

[waldekmastykarz]

Closing this issue in favor of #769, #770, #771, #772, #773, #774 and #775 so that we can track them separately.