如何删除SharePoint Online中超1个月的文件版本历史？求可用工具

一、PowerShell脚本（免费自定义，最简技术方案） #

这是最灵活且无需额外付费的方法，适合有基础PowerShell能力的用户：

1. 先安装并导入SharePoint Online管理模块：

   Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Force
   Import-Module Microsoft.Online.SharePoint.PowerShell
   

2. 连接到你的租户管理站点：

   Connect-SPOService -Url https://yourtenant-admin.sharepoint.com
   

3. 运行自定义脚本清理旧版本：
   下面的脚本会遍历指定文档库，删除所有创建日期早于1个月的非当前版本：

   # 配置参数
   $siteUrl = "https://yourtenant.sharepoint.com/sites/目标站点"
   $libraryName = "目标文档库名称"
   $cutoffDate = (Get-Date).AddMonths(-1) # 保留最近1个月的版本
   
   # 初始化上下文
   $web = Get-SPOWeb -Identity $siteUrl
   $list = $web.Lists.GetByTitle($libraryName)
   $context = Get-SPOContext
   $context.Load($list)
   $context.ExecuteQuery()
   
   # 获取库中所有文件
   $items = $list.GetItems([Microsoft.SharePoint.Client.CamlQuery]::CreateAllItemsQuery())
   $context.Load($items)
   $context.ExecuteQuery()
   
   # 遍历处理每个文件的版本
   foreach($item in $items) {
       $versions = $item.Versions
       $context.Load($versions)
       $context.ExecuteQuery()
   
       foreach($version in $versions) {
           # 跳过当前版本，只删除早于 cutoff 的旧版本
           if($version.Created -lt $cutoffDate -and !$version.IsCurrentVersion) {
               Write-Host "正在删除文件 $($item.File.Name) 的版本 $($version.VersionLabel)"
               $version.DeleteObject()
           }
       }
       $context.ExecuteQuery()
   }
   

   提示：可以根据实际需求调整$cutoffDate的计算方式，比如用AddDays(-30)替代AddMonths(-1)；如果处理大量文件，建议加入分批逻辑避免超时。

二、支持日期筛选的第三方工具 #

如果不想写脚本，可以选择支持按日期筛选版本的付费工具：

• SharePoint Version History Cleaner类工具：部分商业化工具专门针对版本管理，支持按日期范围、版本数量等多维度筛选清理，操作界面更友好。
• Microsoft 365合规保留策略：如果你的租户有合规许可，可通过库级或站点级保留策略间接实现——设置版本保留期为1个月，系统会自动清理超出期限的版本（注意这是全局/范围性策略，需确认是否符合你的需求）。

你提到的工具仅支持按版本数量筛选，不符合日期需求，建议优先考察上述支持日期维度的工具。

注意事项 #

• 执行任何清理操作前，务必先在测试文档库验证效果，或备份重要版本历史。
• 如果文档库被设置了合规性保留/诉讼保留，需先调整策略，否则无法删除受保护的版本。
• 脚本运行时需要站点管理员或文档库的完全控制权限。

内容的提问来源于stack exchange，提问作者Høgsdal