如何通过Microsoft Graph实现Microsoft 365 Planner任务变更自动反馈

Microsoft 365 Planner 任务变更监测方案（基于Microsoft Graph脚本实现） #

你需要的功能完全可以通过Microsoft Graph结合自定义脚本实现，不需要依赖Power Automate，以下是两个问题的具体解答：

问题1：变更监测的实现方式 #

目前Microsoft Graph没有提供专门的「单个任务全量变更事件」的独立监听对象，你可以根据监测范围选择两种实现方案：

• 若仅监测少量指定任务：每次调用GET /planner/tasks/{task-id}接口拉取任务全量字段，和上一次存储的快照逐字段对比，存在差异的部分即为变更内容。你可以自定义需要校验的字段范围，无需比对所有返回值，只校验你关注的变更项即可。
• 若监测指定Plan下的所有任务：可以使用GET /planner/plans/{plan-id}/tasks/delta增量查询接口，直接获取上一次查询之后的所有变更数据，不需要自行存储全量快照做比对，适合批量监测的场景。

提示：首次调用delta接口会返回全量任务数据，后续调用仅返回新增/修改/删除的条目，接口本身会维护同步状态，无需自行处理版本对比逻辑。

问题2：定时运行的实现方式 #

完全可以实现每小时运行一次直至目标任务关闭，根据你使用的系统环境选择对应的定时方案即可：

• Windows环境：把写好的脚本添加到「任务计划程序」，设置触发器为每小时重复运行。脚本内部每次执行前先判断目标任务的percentComplete字段是否为100（即已关闭），如果是就自动删除对应定时任务，或者直接退出执行。
• Linux/macOS环境：用crontab设置每小时运行一次的定时规则，同样在脚本内增加任务状态判断逻辑，符合关闭条件时自动移除crontab规则或者终止后续执行。

极简核心逻辑示例（PowerShell） #

使用前需要先在Azure AD注册应用，开通Tasks.Read.All或Tasks.ReadWrite.All应用权限，获取对应的客户端ID、密钥、租户ID：

# 基础配置项
$clientId = "你的Azure应用客户端ID"
$clientSecret = "你的Azure应用客户端密钥"
$tenantId = "你的租户ID"
$targetTaskId = "待监测的Planner任务ID"
$snapshotPath = "./last_task_snapshot.json"

# 获取Graph访问令牌
$tokenUri = "https://login.microsoftonline.com/$tenantId/oauth2/v2.0/token"
$tokenParams = @{
    client_id = $clientId
    scope = "https://graph.microsoft.com/.default"
    client_secret = $clientSecret
    grant_type = "client_credentials"
}
$tokenRes = Invoke-RestMethod -Method Post -Uri $tokenUri -Body $tokenParams
$headers = @{Authorization = "Bearer $($tokenRes.access_token)"}

# 拉取最新任务数据
$currentTask = Invoke-RestMethod -Method Get -Uri "https://graph.microsoft.com/v1.0/planner/tasks/$targetTaskId" -Headers $headers

# 任务已关闭则终止监测
if ($currentTask.percentComplete -eq 100) {
    Write-Host "目标任务已关闭，停止监测"
    # 此处可添加删除定时任务的逻辑
    exit 0
}

# 对比变更并触发通知
if (Test-Path $snapshotPath) {
    $lastSnapshot = Get-Content $snapshotPath | ConvertFrom-Json
    $changedFields = @()
    # 可自行扩展需要比对的字段
    if ($currentTask.title -ne $lastSnapshot.title) { $changedFields += "标题" }
    if ($currentTask.description -ne $lastSnapshot.description) { $changedFields += "描述" }
    if ($currentTask.percentComplete -ne $lastSnapshot.percentComplete) { $changedFields += "进度" }
    if ($currentTask.assignedTo -ne $lastSnapshot.assignedTo) { $changedFields += "指派人员" }
    
    if ($changedFields.Count -gt 0) {
        # 此处可添加你需要的反馈逻辑，比如发送邮件、企业微信/Teams通知等
        Write-Host "监测到任务变更：$($changedFields -join "、")"
    }
}

# 保存最新快照用于下次比对
$currentTask | ConvertTo-Json | Out-File $snapshotPath -Force

内容的提问来源于stack exchange，提问作者highfive-2017