changes to Get-IMAPMessage to return a filtered object

[sannae]

Hello! First-time contributor here, please be understanding...😄

I found myself using the Get-IMAPMessage cmdlet, but it looked a bit hard to use to find a specific message - which I thought it was its main purpose, given the name.

At the moment Get-IMAPMessage set the $Client.Folder property containing all the messages in the Inbox.
This PR is a proposal to return a list of PSCustomObjects made of the main properties of each message: From, To, Subject, Body, etc.

This way

• You may save the messages into a variable ($allMessages = Get-IMAPMessage -Client $Client)
• You may filter them by sender or recipient or anything else (Get-IMAPMessage -Client $Client -From Jones)

Individual or collection of messages may then be piped to any additional cmdlet (e.g. Remove-IMAPMessage as requested by #37) to be further manipulated.

Thank you

[PrzemyslawKlys]

Thanks for this but few things to address:

• Where-Object will be very slow on large mailboxes
• I'm pretty sure IMAP has filtering builtin which we should try to adopt
• What if someone wants all messages?
• What about all other properties of a message that you stripped?