New command: Unused Mailboxes

[murati]

Usage

m365 outlook mail unused

Description

It retrieves the list of mailboxes which have no activity starting the given period

Options

Option	Description
--period D7, D30, D90, D180
--since Starting date

Examples

Retrieve the list of inactive mailboxes in last 30 days

m365 outlook mail unused

Retrieve the list of active mailboxes starting the given date

m365 outlook mail unused --since 2024-01-01T00:00:000Z

Default properties

• DisplayName
• UserPrincipalName
• LastActivityDate
• IsArchived

Additional Info

No response

[waldekmastykarz]

Thanks for the suggestion @murati! A couple of ideas:

• what's the API that we could use to retrieve this information?
• it seems like a report command, so I suggest that we rename it to m365 outlook report mailbox unused

@pnp/cli-for-microsoft-365-maintainers any other feedback before we open it up?

[milanholemans]

I'm curious if there's an API for this. If there isn't, this should probably be converted to a sample script in my opinion.

[murati]

Per my research, it requires EXO V3. That was actually my question. Graph does not directly support EXO but when I read the source code, I saw some endpoints apart from graph usage. Therefore, I thought, you could reach EXO beyond my knowledge.

We are building a smart admin panel for M365 and the EXO requiring modules are the slowest ones. Please let me know, if I can contribute somehow and further.

[milanholemans]

Can you provide some documentation about the API you want to leverage?

[murati]

Can you provide some documentation about the API you want to leverage?

This is how I execute this command:

Get-EXOMailbox -InactiveMailboxOnly

And here is the link : https://learn.microsoft.com/en-us/powershell/module/exchange/get-exomailbox?view=exchange-ps

I wasn't able to find further API documentation about it.

[milanholemans]

Let's see if we can get it to work.