Before you begin
See this guide for all the Tutorials to create an Azure Automation Account, enable System assigned Managed Identity and create a PowerShell Runbook
Getting started with Azure Automation
You'll also need a Sendgrid Account and API key
Create PowerShell Runbook
Automation Account
Runbooks - Create a runbook
Name: sendgrid-test-runbook
Runbook type: PowerShell
Runtime version: 7.2
Review + Create
Edit the Runbook and enter the following PowerShell
# https://learn.microsoft.com/en-us/azure/automation/automation-send-email
Param(
[Parameter(Mandatory=$True)]
[String] $destEmailAddress,
[Parameter(Mandatory=$True)]
[String] $fromEmailAddress,
[Parameter(Mandatory=$True)]
[String] $subject,
[Parameter(Mandatory=$True)]
[String] $content
)
# Ensures you do not inherit an AzContext in your runbook
Disable-AzContextAutosave -Scope Process
# Connect to Azure with system-assigned managed identity
$AzureContext = (Connect-AzAccount -Identity).context
# set and store context
$AzureContext = Set-AzContext -SubscriptionName $AzureContext.Subscription -DefaultProfile $AzureContext
$VaultName = "test-829-kv"
$SENDGRID_API_KEY = Get-AzKeyVaultSecret -VaultName $VaultName -Name "SendGridAPIKey" -AsPlainText -DefaultProfile $AzureContext
$headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$headers.Add("Authorization", "Bearer " + $SENDGRID_API_KEY)
$headers.Add("Content-Type", "application/json")
$body = @{
personalizations = @(
@{
to = @(
@{
email = $destEmailAddress
}
)
}
)
from = @{
email = $fromEmailAddress
}
subject = $subject
content = @(
@{
type = "text/plain"
value = $content
}
)
}
$bodyJson = $body | ConvertTo-Json -Depth 4
$response = Invoke-RestMethod -Uri https://api.sendgrid.com/v3/mail/send -Method Post -Headers $headers -Body $bodyJson
Save and Test the Runbook
Enter the PowerShell parameters and click Start to run the test
The Runbook test completed successfully
Reference:
Send an email from an Automation runbook
https://learn.microsoft.com/en-us/azure/automation/automation-send-email