如何使用 PowerShell 向团队频道发送消息

您可以使用 Webhook 或 Microsoft Graph API 调用从 PowerShell 向 Teams 频道发送消息。让我们看看如何使用 PowerShell 在 Microsoft Teams 频道中发送和阅读消息。您可以在各种监视或通知方案中使用这些 PS 脚本，在这些方案中您需要不通过电子邮件（Send-MailMessage cmdlet）而是直接向 Teams 通道发送通知。

使用 WebHook 向 Microsoft Teams 发送消息

您可以使用内置 WebHook 连接器将消息发送到 Microsoft Teams 频道。 Webhook 连接器是一个 URL 地址，您可以使用 HTTP POST 请求发送 JSON 对象。

1. 在 Teams 中创建频道。您可以使用 Microsoft Teams PowerShell 模块来完成此操作。例如：

   Get-team -DisplayName sysops| New-TeamChannel -DisplayName "AdminAlerts" -MembershipType Private

2. 然后打开Teams客户端（桌面版或网页版）并在频道的上下文菜单中选择连接器；

   

3. 添加Incoming Webhook类型的连接器；

   

4. 指定连接器名称；

5. 复制 Azure 为你创建的连接器的 URL。

要使用此 URL 向频道发送简单消息，请运行以下 PowerShell 命令：

$myTeamsWebHook = “https://a-d.webhook.office.com/webhookb2/123456-12312-@aaaaa-bbbb-cccc/IncomingWebhook/xxxxxxxxxxxxxxxxxxxxx/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxxxx/xxxxx-xxxx-xxxx-xxxx”
Invoke-RestMethod -Method post -ContentType 'Application/Json' -Body '{"text":"Test Teams!"}' -Uri $myTeamsWebHook

确保您的消息出现在 Teams 频道中。您创建的连接器将显示为消息的作者。

MS Teams 允许您每秒发送不超过 4 条消息。

您可以将其他数据添加到 Teams 通知、更改字体、颜色以及从 PowerShell 脚本添加额外信息。

例如，以下脚本监视具有 PDC FSMO 角色的域控制器上的用户锁定事件（事件 4740），并向团队通道发送通知。

$LockedUser = Search-ADAccount -UsersOnly -LockedOut | Get-ADUser -Properties lockoutTime, emailaddress | Select-Object emailaddress, @{n='lockoutTime';e={[DateTime]::FromFileTime($_.lockoutTime)}} | Sort-Object LockoutTime -Descending | Select-Object -first 1
$myTeamsWebHook  = "YOUR-WEBHOOK-URL"
$webhookMessage = [PSCustomObject][Ordered]@{
"@type"      = "FF0000"
"@context"   = "http://schema.org/extensions"
"summary"    = "Locked User: $($LockedUser.SamAccountName) "
"themeColor" = '700015'
"title"      = "User Lockout Event"
"text" = "`n
SamAccountName: $($LockedUser.SamAccountName)
Mail: $($LockedUser.EmailAddress)
Timestamp: $($LockedUser.LockoutTime.ToString()) "
}
$webhookJSON = convertto-json $webhookMessage -Depth 50
$webhookCall = @{
"URI"         = $myTeamsWebHook
"Method"      = 'POST'
"Body"        = $webhookJSON
"ContentType" = 'application/json'
}
Invoke-RestMethod @webhookCall

然后该事件将显示在 Teams 频道中，管理员可以对其做出反应。

您可以将脚本绑定到事件查看器中的EventID 4740（您可以将任务附加到事件）。或者，您可以在任务计划程序中创建作业并定期运行 PowerShell 脚本。

如何使用 Microsoft Graph API 发送或读取 Teams 消息？

使用 Microsoft Graph API，您可以在 Teams 频道中发送和读取消息。首先，您必须注册Azure应用程序，设置权限（

Group.Read.All

,

ChannelMessage.Send

,

Chat.ReadWrite

， 和

ChatMessage.Send

），并获取身份验证令牌（在如何使用 PowerShell 连接 Azure Microsoft Graph API 一文中了解更多信息）。

$ApplicationID = "4434ad23-b212-3212-3aad-54321de3bbc"
$TenatDomainName = "26216542-aaaa-bbbb-2212-65566aa6c32"
$AccessSecret="12-32Bh654321d3-seLa23l33p.hhj33MM21aaf"
$Body = @{
Grant_Type = "client_credentials"
Scope = "https://graph.microsoft.com/.default"
client_Id = $ApplicationID
Client_Secret = $AccessSecret
}
$ConnectGraph = Invoke-RestMethod -Uri https://login.microsoftonline.com/$TenatDomainName/oauth2/v2.0/token -Method POST -Body $Body
$token = $ConnectGraph.access_token
$URLchatmessage="https://graph.microsoft.com/v1.0/teams/$TeamID/channels/$ChannelID/messages"
$BodyJsonTeam = @"
{
"body": {
"content": "Hello World"
}
}
"@
Invoke-RestMethod -Method POST -Uri $URLchatmessage -Body $BodyJsonTeam -Headers -Headers @{Authorization = "Bearer $($token)"}

你可以得到

$TeamID

和

$ChannelID

使用

Get-Team

和

Get-TeamChannel

来自 MicrosoftTeams 模块。

以同样的方式，您可以使用 GET 方法从 Teams 聊天中读取消息。