SharePoint项目迁移：保留文件版本时避免覆盖当前版本的问题

我之前帮客户处理过几乎一模一样的场景，你现在的问题核心在于：直接向已创建的目标文件添加旧版本时，SharePoint默认会把上传的内容设为当前版本，而非追加到历史版本列表里。下面是经过验证的可行方案，分步骤给你拆解：

核心思路 #

别先把源文件的最新内容写入目标站点再补历史版本，而是按版本从旧到新的顺序操作：先以源文件的最早版本创建目标文件的初始版本，再依次把中间的历史版本追加进去，最后将源的最新版本设为目标文件的当前版本。这样既完整保留所有历史记录，又不会覆盖最新内容。

具体实现步骤（以PnP PowerShell为例） #

1. 拉取源文件的完整版本列表 #

先连接源站点，获取目标文件的所有版本，并按版本号从小到大排序（确保最早的版本在前）：

# 连接源SharePoint站点
Connect-PnPOnline -Url "https://your-source-site.sharepoint.com" -Interactive

# 获取源文件及所有版本信息
$sourceFile = Get-PnPFile -Url "/sites/source/Shared Documents/your-target-file.docx" -Includes Versions
$sourceVersions = $sourceFile.Versions | Sort-Object -Property VersionLabel

2. 用源的最早版本创建目标文件的初始版本 #

这一步会生成目标文件的第一个版本，对应源文件的最早历史版本：

# 连接目标SharePoint站点
Connect-PnPOnline -Url "https://your-target-site.sharepoint.com" -Interactive

# 获取源最早版本的文件内容
$oldestVersion = $sourceVersions[0]
$versionContent = Get-PnPFileVersionContent -FileUrl $sourceFile.ServerRelativeUrl -VersionLabel $oldestVersion.VersionLabel

# 在目标站点创建初始版本文件
Add-PnPFile -Content $versionContent -Path "/sites/target/Shared Documents/your-target-file.docx" -FileName "your-target-file.docx"

3. 依次追加中间的历史版本 #

遍历源文件的剩余版本（从第二个到倒数第二个），把它们作为历史版本添加到目标文件中：

$targetFile = Get-PnPFile -Url "/sites/target/Shared Documents/your-target-file.docx" -Includes Versions

# 跳过已创建的初始版本，遍历到倒数第二个版本（留最后一个作为当前版本）
for ($i = 1; $i -lt $sourceVersions.Count - 1; $i++) {
    $currentVersion = $sourceVersions[$i]
    $versionContent = Get-PnPFileVersionContent -FileUrl $sourceFile.ServerRelativeUrl -VersionLabel $currentVersion.VersionLabel
    
    # 将版本追加为历史记录
    Add-PnPFileVersion -FileUrl $targetFile.ServerRelativeUrl -Content $versionContent -CheckInComment $currentVersion.CheckInComment
}

4. 把源的最新版本设为目标文件的当前版本 #

最后覆盖目标文件的内容为源的最新版本，确保当前版本是最新状态，同时保留所有历史版本：

$latestVersion = $sourceVersions[-1]
$latestContent = Get-PnPFileVersionContent -FileUrl $sourceFile.ServerRelativeUrl -VersionLabel $latestVersion.VersionLabel

# 更新当前版本并签入
Set-PnPFileContent -FileUrl $targetFile.ServerRelativeUrl -Content $latestContent -CheckInComment $latestVersion.CheckInComment -CheckInType MajorCheckIn

关键注意事项 #

• 版本顺序不能乱：必须严格从旧到新添加历史版本，SharePoint的版本链是按时间顺序维护的，乱序会导致版本记录混乱。
• 权限要求：操作账号需要在源和目标站点都拥有编辑权限，并且能访问文件的所有历史版本。
• 大文件处理：如果文件体积较大，建议用分块上传的方式处理版本内容，避免超时或上传失败。

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