PowerShell foreach循环未遍历SharePoint数组全部元素求助

核心原因分析 #

你的脚本提前终止，大概率是以下几个问题：

• SharePoint API节流限制：Office 365对API调用频次有严格限制，短时间内大量调用Move-PnPFile和Set-PnPListItem会触发限流，导致脚本中断。
• 未捕获的异常：移动文件时遇到重名、权限不足、文件被锁定等情况，脚本没有异常捕获机制，直接终止。
• 资源占用过高：即使手动调用GC，处理22万条ListItem时，内存占用仍可能持续上升，导致PowerShell进程被系统终止。
• 条件逻辑冗余：原脚本三个独立if会让符合多个条件的文件被重复移动，浪费资源还可能引发错误。

修复与最佳实践 #

1. 加入节流处理与重试机制 #

PnP PowerShell内置节流重试，需显式启用，同时手动控制请求间隔避免触发限流：

• 用Set-PnPThrottlingConfiguration全局配置重试策略
• 每处理一定数量的项或一页数据后，添加短暂延迟

2. 异常捕获与日志记录 #

在操作块中加入try/catch捕获异常并记录，避免脚本整体终止，同时方便后续排查失败项。

3. 分页分批处理 #

一次性加载22万条ListItem会导致内存压力过大，改用分页遍历，处理完一页再加载下一页，降低资源占用。

4. 优化条件判断逻辑 #

改用if/elseif/else结构，确保每个文件只匹配一个条件，避免重复移动操作。

修改后的脚本示例 #

$source = "HR_STAFF"
$targetHR = "HR_STAFF/School Section - Human Resources"
$targetHRContract = "HR_STAFF/Human Resources - Contractual"
$targetContract = "HR_STAFF/Category - Contractual"
$SiteURL = "你的站点完整URL" # 请补充实际站点URL
$logPath = ".\file_move_log.txt"

# 初始化日志文件
"脚本启动时间: $(Get-Date)" | Out-File $logPath -Append

# 连接站点并配置节流重试
Connect-PnPOnline -Interactive -Url $SiteURL
Set-PnPThrottlingConfiguration -RetryCount 5 -RetryWait 10

$pageSize = 1000
$currentPage = 1
$totalProcessed = 0

# 分页循环获取列表项
do {
    $items = Get-PnPListItem -List $source -PageSize $pageSize -Page $currentPage
    if (-not $items) { break }

    foreach ($item in $items) {
        $totalProcessed++
        $fileName = $item.FieldValues.FileLeafRef
        $sourceFile = $item.FieldValues.FileRef
        $targetFile = $null

        # 优化条件判断，避免重复操作
        if ($item.FieldValues.SER_SchoolSection -eq "Human Resources" -and $item.FieldValues.SER_Category -eq "Contractual") {
            $targetFile = "$targetHRContract/$fileName"
        }
        elseif ($item.FieldValues.SER_SchoolSection -eq "Human Resources") {
            $targetFile = "$targetHR/$fileName"
        }
        elseif ($item.FieldValues.SER_Category -eq "Contractual") {
            $targetFile = "$targetContract/$fileName"
        }

        if ($targetFile) {
            try {
                # 执行文件移动
                Move-PnPFile -SourceUrl $sourceFile -TargetUrl $targetFile -Force -ErrorAction Stop
                # 更新列表项元数据
                Set-PnPListItem -Identity $item -Values @{
                    SER_IssueMonth = $item.FieldValues.SER_Modified
                    Modified = $item.FieldValues.SER_IssueDate
                    Created = $item.FieldValues.Created
                } -UpdateType SystemUpdate -ErrorAction Stop

                "[$(Get-Date)] 成功处理: $fileName" | Out-File $logPath -Append
            }
            catch {
                "[$(Get-Date)] 处理失败 $fileName : $($_.Exception.Message)" | Out-File $logPath -Append
            }
        }
        else {
            "[$(Get-Date)] 无匹配移动条件: $fileName" | Out-File $logPath -Append
        }

        # 每处理100项触发一次GC并添加短延迟
        if ($totalProcessed % 100 -eq 0) {
            [System.GC]::Collect()
            Start-Sleep -Milliseconds 500
        }
    }

    $currentPage++
    # 处理完一页后延长延迟，降低限流风险
    Start-Sleep -Seconds 2
} while ($true)

"脚本结束时间: $(Get-Date)，共处理 $totalProcessed 项" | Out-File $logPath -Append

额外建议 #

• 权限检查：确保执行脚本的账号对源文档库和所有目标文件夹有完全控制权限，避免权限不足导致批量失败。
• 小批量测试：先选取100-200条数据测试脚本逻辑，确认无误后再全量运行。
• 后台运行：处理22万项需要数小时甚至更久，建议用PowerShell后台作业或Windows任务计划运行，避免终端关闭中断进程。

内容的提问来源于stack exchange，提问作者C. P. Nicklas