Sending Emails Using Microsoft Graph PowerShell
Recently Tobias Zimmergren posted a great article about sending emails using the Microsoft Graph with .NET. If you haven’t read it check it out now:
https://zimmergren.net/sending-e-mails-using-microsoft-graph-using-dotnet/
After reading it, I thought what might be interesting is doing the same thing but using the Microsoft Graph PowerShell commands instead.
So let’s get straight to it.
Step 1: Install and Import the PowerShell Module
Install-Module Microsoft.Graph
Import-Module Microsoft.Graph
Remember, you can choose to use either the production “v1.0” or “beta” endpoint.
Select-MgProfile -Name "beta"
Step 2: Connect to the Graph Using Required Permissions
Connect-MgGraph -Scopes `
"Mail.Send"
Step 3: Download the Demonstration Email Template
Download the Email Templates from GitHub: https://github.com/ColorlibHQ/email-templates
It would help if you made any adjustments as required. For example, I created variables “{{NAME}},” “{{COMPANY}}” to replace with actual values when sending the mail.
Step 4: Create the PowerShell to Send the Email
Within the Graph PowerShell, we can use the command “Send-MgUserMail.” This command invokes the “sendMail” action within the core Graph API.
$user = "admin@M365x.onmicrosoft.com"
$name = "Liam Cleary"
$company = "SharePlicity Education"
$subject = "SharePlicity Invitation"
$type = "html"
$template = Get-Content `
-path "C:\PowerShell\Template\email\11\index.html" `
-raw
$template = $template.Replace('{{NAME}}',$name)
$template = $template.Replace('{{COMPANY}}',$company)
$content = $template
$recipients = @()
$recipients += @{
emailAddress = @{
address = $user
}
}
$message = @{
subject = $subject;
toRecipients = $recipients;
body = @{
contentType = $type;
content = $content
}
}
Send-MgUserMail `
-UserId $user `
-Message $message
Of course, you can add further adjustments to the email format, the content, the recipients, etc.
It is always great to have different ways of achieving the same thing.
Liam Cleary
Liam began his career as a computer trainer. He quickly realized that programming, breaking and hacking were much more fun. Liam spent the next few years working within core infrastructure and security services. He is now the founder and owner of SharePlicity, a consulting company focusing on Microsoft 365 and Azure technology. His role within SharePlicity is to help organizations implement Microsoft 365 and Azure technology to enhance internal and external collaboration, document, and records management, automate business processes, and implement security controls and protection. He is a long-time Microsoft MVP and Microsoft Certified Trainer, focusing on architecture, security and crossing the boundary into software development. Over the past few years, his specialty has been security in Microsoft 365, Azure and its surrounding platforms. Liam also creates online training courses for Pluralsight, LinkedIn Learning and Cloud Academy, and he teaches multiple Microsoft certification courses for Opsgility and Microsoft. You can find him at user groups and conferences, teaching classes, offering advice, spending time in the community, teaching his kids how to code, raspberry PI programming, hacking the planet, building Lego robots, or coaching soccer. You may also find him running races in the dark, hiking, or mountain biking at breakneck speeds.