如何用PnP PowerShell批量删除SharePoint大文件的版本历史

问题根源 #

常规脚本处理≥2GB的大文件时失败，核心原因是提前获取Versions属性会一次性拉取所有版本的元数据，大文件的版本数据量远超SharePoint请求限制，触发“Operation is not valid due to the current state of the object”错误。而直接加载文件对象再调用版本删除方法，绕开了预加载所有版本数据的操作，规避了这个问题。

批量处理脚本 #

# 首次运行需安装PnP PowerShell
# Install-Module -Name PnP.PowerShell -Force -AllowClobber

# 配置参数
$siteUrl = "https://yourtenant.sharepoint.com/sites/yoursite"
$libraryName = "目标文档库名称"

# 连接SharePoint站点
Connect-PnPOnline -Url $siteUrl -Interactive

# 获取目标文档库
$library = Get-PnPList -Identity $libraryName

# 遍历库内所有文件（含子文件夹）
$files = Get-PnPListItem -List $library -PageSize 500 -Recursive | Where-Object { $_["FileLeafRef"] -ne $null }

foreach ($fileItem in $files) {
    try {
        # 获取文件对象，不预加载Versions属性
        $file = Get-PnPFile -Url $fileItem["FileRef"] -AsFileObject
        
        # 跳过已签出或无历史版本的文件
        if ($file.CheckOutType -eq "None" -and $file.MajorVersion -gt 1) {
            Write-Host "正在处理: $($file.Name)" -ForegroundColor Cyan
            
            # 直接删除所有版本
            $file.Versions.DeleteAll()
            Invoke-PnPQuery
            
            Write-Host "$($file.Name) 版本历史删除完成" -ForegroundColor Green
        }
        else {
            Write-Host "$($file.Name) 无版本可删或已签出，跳过" -ForegroundColor Yellow
        }
    }
    catch {
        Write-Host "处理 $($fileItem["FileLeafRef"]) 失败: $($_.Exception.Message)" -ForegroundColor Red
    }
}

# 断开连接
Disconnect-PnPOnline

使用说明 #

1. 首次运行需执行注释中的命令安装PnP PowerShell模块。
2. 替换$siteUrl和$libraryName为你的实际站点地址和文档库名称。
3. 运行脚本后通过交互式窗口登录，需使用拥有文档库编辑权限的账号。
4. 若遇到超时问题，可在Connect-PnPOnline后添加-Timeout 300000（单位毫秒，对应5分钟）延长超时限制。

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