如何通过PowerShell检索Teams频道关联的Office Connector URL？

Get-TeamChannel 命令确实只能返回频道基础信息，没办法直接获取Office Connector的关联状态或URL。要拿到这些数据，得借助Microsoft Graph相关工具，下面是两种可行的方式：

方法1：使用Microsoft Graph PowerShell模块 #

1. 先安装并连接到Graph：

   # 安装模块（首次使用）
   Install-Module Microsoft.Graph.Teams -Force -AllowClobber
   # 连接并请求所需权限
   Connect-MgGraph -Scopes "Team.ReadBasic.All","Channel.ReadBasic.All","ChannelSettings.Read.All"
   

2. 获取指定团队下所有频道的Connector信息：
   先拿到团队的所有频道，再遍历每个频道查询关联的Connector：

   $teamId = "<你的团队GROUP_ID>"
   # 获取团队下所有频道
   $channels = Get-MgTeamChannel -TeamId $teamId
   # 遍历每个频道，查询关联的Connector
   foreach ($channel in $channels) {
       $connectors = Get-MgTeamChannelConnector -TeamId $teamId -ChannelId $channel.Id
       if ($connectors) {
           Write-Host "频道: $($channel.DisplayName) (ID: $($channel.Id))"
           foreach ($conn in $connectors) {
               # 筛选Office Connector（通常类型为"Incoming Webhook"）
               if ($conn.ConnectorTypeDisplayName -eq "Incoming Webhook") {
                   Write-Host "  Office Connector URL: $($conn.Configuration.webhookUrl)"
               }
           }
       } else {
           Write-Host "频道: $($channel.DisplayName) 未关联任何Connector"
       }
   }
   

方法2：直接调用Microsoft Graph API #

如果你习惯用API工具（比如Postman），可以调用以下端点：

GET https://graph.microsoft.com/v1.0/teams/{team-id}/channels/{channel-id}/connectors

返回的JSON数据中，configuration字段里的webhookUrl就是Office Connector的URL，同时可以通过connectorTypeDisplayName字段确认是否是"Incoming Webhook"类型的Connector。

注意：不管用哪种方式，都需要具备对应的权限（比如ChannelSettings.Read.All），否则会返回权限不足的错误。

内容的提问来源于stack exchange，提问作者Ranxerox