任务计划程序执行PowerShell脚本遇传输连接读取失败及超时问题

问题情况 #

• 脚本在PowerShell终端或VS Code中运行完全正常，但通过任务计划程序（已配置管理员身份+最高权限）执行时失败
• 仅在包含10万条以上数据的SharePoint文档库中出现问题，这类查询耗时约5分钟，怀疑是任务计划程序未等待脚本执行完成就终止了进程

原脚本代码 #

Connect-PnPOnline -Url "https://my.sharepoint.com/sites/Documnets"
$Docs = Get-PnPList | Where-Object { $_.BaseTemplate -eq 101 -and $_.Hidden -eq $false }
ForEach ($List in $Docs) { 
 Write-Host "Working on List Name :- " $List.Title
    $Items = Get-PnPListItem -List $List.Title -PageSize 5000 | Sort-Object ID -Descending | Where-Object { ("1213356" -eq $_.FieldValues."AppNumber") } 
   
     Write-Host "Item found to update: $($Items.count)"
    If ($Items.Count -gt 0) {  
        WriteLog -level INFO -message "Record found"           
    }
}

可能的原因 #

1. 任务计划程序默认设置了超时限制，超过时间就强制终止任务
2. 非交互环境下Write-Host的输出缓冲问题导致脚本中断
3. 大数据量查询时，一次性通过管道处理所有项导致内存占用过高或执行超时
4. 任务计划使用的PowerShell环境未正确加载PnP模块

解决步骤 #

1. 调整任务计划程序的超时配置 #

• 打开任务计划程序，找到对应任务 → 右键选择属性 → 切换到设置选项卡
• 取消勾选"如果任务运行时间超过X小时X分钟，停止任务"（如果该选项已启用）
• 勾选"允许任务运行无限时间"（部分版本的任务计划程序有此选项，直接启用即可）

2. 优化脚本逻辑 #

核心修改点：

• 替换Write-Host为日志写入，避免非交互环境的输出问题
• 改用分页循环获取数据，减少内存占用，确保任务能持续执行
• 添加错误捕获，方便排查问题
• 将排序操作放在筛选之后，提升执行效率

修改后的脚本：

# 日志文件路径，自行修改
$logPath = "C:\SP_Scripts\QueryLog.log"

function WriteLog {
    param(
        [string]$level,
        [string]$message
    )
    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
    "$timestamp - [$level] $message" | Out-File -FilePath $logPath -Append -Encoding utf8
}

try {
    WriteLog -level INFO -message "脚本启动，开始连接SharePoint站点"
    Connect-PnPOnline -Url "https://my.sharepoint.com/sites/Documnets" -ErrorAction Stop
    WriteLog -level INFO -message "成功连接到目标站点"

    # 获取所有非隐藏的文档库
    $Docs = Get-PnPList | Where-Object { $_.BaseTemplate -eq 101 -and $_.Hidden -eq $false }
    WriteLog -level INFO -message "共发现$($Docs.Count)个需处理的文档库"

    foreach ($List in $Docs) { 
        WriteLog -level INFO -message "开始处理文档库：$($List.Title)"
        
        $matchingItems = @()
        $currentPage = 1
        # 分页循环获取数据，直到没有更多项
        do {
            WriteLog -level DEBUG -message "正在获取文档库$($List.Title)的第$currentPage页数据"
            $pageItems = Get-PnPListItem -List $List.Title -PageSize 5000 -Page $currentPage -ErrorAction Stop | 
                         Where-Object { $_.FieldValues."AppNumber" -eq "1213356" }
            $matchingItems += $pageItems
            $currentPage++
        } while ($pageItems.Count -eq 5000)

        # 对符合条件的项按ID降序排序
        $matchingItems = $matchingItems | Sort-Object ID -Descending

        WriteLog -level INFO -message "文档库$($List.Title)中找到$($matchingItems.Count)条符合条件的记录"
        if ($matchingItems.Count -gt 0) {  
            WriteLog -level INFO -message "文档库$($List.Title)存在需处理的记录"           
        }
    }

    WriteLog -level INFO -message "脚本执行完成"
}
catch {
    WriteLog -level ERROR -message "脚本执行出错：$($_.Exception.Message)"
    WriteLog -level ERROR -message "错误堆栈：$($_.ScriptStackTrace)"
    exit 1
}

3. 配置任务计划的正确执行参数 #

• 打开任务的操作选项卡，点击编辑：
  • 程序/脚本：填写powershell.exe
  • 添加参数：-ExecutionPolicy Bypass -File "你的脚本完整路径"（例如：-ExecutionPolicy Bypass -File "C:\SP_Scripts\YourQueryScript.ps1"）
• 切换到常规选项卡：
  • 勾选"不管用户是否登录都要运行"
  • 勾选"使用最高权限运行"
• 切换到设置选项卡：
  • 勾选"如果任务失败，每隔5分钟重试"，设置重试次数为3次（可选，根据需求调整）

4. 确保PnP模块在任务环境中可用 #

在脚本开头添加以下代码，验证并加载PnP模块：

# 检查并加载PnP模块
if (-not (Get-Module -ListAvailable -Name PnP.PowerShell)) {
    WriteLog -level ERROR -message "未找到PnP.PowerShell模块，请先安装"
    exit 1
}
Import-Module PnP.PowerShell -ErrorAction Stop

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