Send-MSTTeamMessage

Teams: Publish a message in a Microsoft Teams channel via webhook

Script

#Requires -Version 5.1

[CmdletBinding()]
Param(
    [Parameter(Mandatory = $true)]
    [ValidatePattern('^https://outlook.office.com/webhook/')]
    [string]$WebhookURL,
    [Parameter(Mandatory = $true)]
    [string]$Message,
    [string]$Title,
    [ValidateSet('Orange', 'Green', 'Red')]
    [string]$MessageColor,
    [string]$ActivityTitle,
    [string]$ActivitySubtitle
)

Process {
    try {
        $body = [PSCustomObject]@{
            text       = $Message
            title      = $Title
            themeColor = if ($MessageColor -eq 'Orange') { '#FFA500' } elseif ($MessageColor -eq 'Green') { '#008000' } elseif ($MessageColor -eq 'Red') { '#FF0000' } else { '' }
        }

        $jsonBody = $body | ConvertTo-Json -Depth 3
        $null = Invoke-RestMethod -Uri $WebhookURL -Method Post -Body $jsonBody -ContentType 'application/json' -ErrorAction Stop

        [PSCustomObject]@{
            Timestamp = Get-Date -Format 'yyyy-MM-dd HH:mm:ss'
            Status    = 'Message sent to Microsoft Teams'
            Title     = $Title
        }
    }
    catch { throw }
}

Customize

WebhookURL string

The URL of the incoming webhook, must start with "https://outlook.office.com/webhook/"

Message string

The body of the message to publish on Teams

Title string

The title of the message to publish on Teams

MessageColor string

The color theme for the message (Orange, Green, Red)

ActivityTitle string

The Activity title of the message

ActivitySubtitle string

The Activity subtitle of the message