Cli-microsoft365: Add 'spo mail send' command

[Laul0]

Summary

Since some people use Office365-CLI with pipeline or for an automation script on Azure or whatever... can sent an email of notification can be really useful... Send a mail ? Yes ! BUT as SharePoint like Send-PnPMail.

Currently, I'm using it (Send-PnPMail) for site factory or critical error catched from my script i production to be more efficiency.

Add a support for spo mail send command in order to :

Because we can create an other cmdlet that allow to retrieve all mail addresses of requests access (mail requestaccess get)

• [x] Send a email to one or more users
• [x] Here the list of necessary parameters :
  
  
  
  • [x] --to List of recipients (ex: [email protected],[email protected])
  
  
  • [x] --subject Subject of the email
  
  
  • [x] --body Content of the email
  
  
  • [x] --from [From] specify who send notification
  
  
• [ ] Support at least the following additional parameters :
  
  
  
  • [x] -o, --output (no output)
  
  
  • [x] --verbose
  
  
  • [x] --debug
  
  

To Do

• [x] Add command from solution
• [x] Add documentation of usage (MkDocs)
• [x] Validate cmdlet usage
• [x] Validate Unit test

[VelinGeorgiev]

Should we utilize the MS Graph apis to do that? I am not sure how it is implemented with the pnp cmdlets.

[Laul0]

It works with REST API of SharePoint... I don't know with Graph.

[VelinGeorgiev]

@waldekmastykarz, what do you think?

[arjenbloemsma]

I think this will be a useful addition as users will probably want to send emails from their O365 CLI script. Sending emails this way will be easier for most users than sending a mail via, for instance, mailx (MacOS/Linux) or the SMTPClient object (Win).

The PowerShell version facilitates sending mails via SharePoint _and_ O365, so the Graph API should also be included.

[VelinGeorgiev]

Maybe we can have commands for both, where spo mail send is the SharePoint apis version.

[Laul0]

Totally agree with @VelinGeorgiev 😉

[arjenbloemsma]

That indeed sounds like a good plan!

[waldekmastykarz]

We already have graph user sendmail 😊 so I wonder what the added value of using the SharePoint version would be

[Laul0]

Keep using SPO cmdlet rather than change context to graph 😄 (not need to graph login). That can be useful when you're creating an SharePoint script essentially.

[waldekmastykarz]

Fair enough @Laul0. The current spec is ok. You want to pick it up yourself?

[Laul0]

hmmmmm why not ^^

[waldekmastykarz]

Hey @Laul0 are you still working on this? It seems like you have quite a few items on your name, all in progress. Shall we keep one and make other available for picking?

[Laul0]

Hi @waldekmastykarz, I almost finish the dev locally for this issue.
I have to finish the recovery.
After this one, I have 2 other issues. I hope submit a least 2 PR next week

[waldekmastykarz]

Awesome! Looking forward to it!