Cli-microsoft365: New command: Get details about Microsoft Teams device usage by user

[sprider]

@waldekmastykarz @VelinGeorgiev

With Microsoft Graph, we can access Office 365 usage reports resources to get the information about how people using Office 365 services. For example, use the Microsoft Teams device usage reports to get information about Microsoft Teams device usage in an organization.

graph reports teamsdeviceusageuserdetail --period D7

graph reports teamsdeviceusageuserdetail --date 2019-05-01

API Reference - https://docs.microsoft.com/en-us/graph/api/reportroot-getteamsdeviceusageuserdetail?view=graph-rest-1.0&tabs=cs

Note: This command needs Reports.Read.All permission.

[waldekmastykarz]

Very nice suggestion! Would you like to pick it up yourself or let others chime in?

[sprider]

@waldekmastykarz

Sure, I will work on this.

Do we need to change anything to get the needed permission?

[waldekmastykarz]

Yes, I need to update the AAD app used by the CLI and we need to update this page in docs https://pnp.github.io/office365-cli/concepts/authorization-tokens/ with the additional permission. You can include it in your PR.

[sprider]

Thank you @waldekmastykarz.
Sure, I will update the documentation. Should I wait for your permission update or I can start from my side?

[waldekmastykarz]

I've granted the permission to the CLI AAD application. You're ready to go. Don't forget to reconsent the application in your AAD to use the new permission. You can do this by executing in the command line o365 --reconsent

[sprider]

Sure @waldekmastykarz. I will start this tomorrow or day after.

[waldekmastykarz]

Excellent! Thank you!

[sprider]

Submitted the PR for your review.

[waldekmastykarz]

Excellent! Thank you very much @sprider. We'll review it shortly.