New command: m365 outlook message get

Usage

m365 outlook message get [options]

Description

Retrieves specified message

Options

Option	Description
-i, --id <id>	The Id of the message
--userId [userId]	The id of the userfrom which to get the message
--userPrincipalName [userPrincipalName]	The UPN of the user rom which to get the message

Additional Info

If there are other scenarios that require app-only permissions, we can definitely include them in the CLI, but they can only be used with a custom AAD app. We should clarify that in the command’s docs.

I think it would be a good idea to add a remark against the option description that passing the user ID or UPN of a shared mailbox user would be accepted.

Above to be added to the docs.

Open points:

Discussed

• As we’re using delegated permissions, does it make sense to add --userId parameter? If so, it’d require proper design as it’d potentially be used for different commands. However, it’d require app permissions.
• ADDED I just realized that userId might still be useful when we pull data from shared mailbox. I’ll add to the spec later
• DROPPED (reference) - I’m not sure what’s the use case for /me/mailFolders/messages endpoint, but I proposed it here anyway to be in line with the endpoint mechanisms. Is it for cases where two emails with the same id are in different folders?
• CHANGED (source) Should we use userId or mailboxId? Effectively, we not always provide a user. It’s either a user mailbox or shared mailbox or group mailbox. Seems like mailboxId would be more natural.

[robdy]

Thanks, Milan and Waldek. I’m happy for someone else to take over. I updated the spec with the current discussion

[robdy]

@waldekmastykarz yes, I do. I’ll do the checking and reply to you later.