咨询：基于Office/PDF元数据修正SharePoint文件日期的无变更方案

核心思路 #

用SharePoint Online的PnP PowerShell模块直接修改文件列表项的Created和Modified元数据字段，通过-SystemUpdate参数实现静默更新——不生成新版本、不触发修改通知、不改变修改人信息，完全规避被识别为文件变更的问题。

前置准备 #

• 安装PnP PowerShell模块：Install-Module -Name PnP.PowerShell -Force -AllowClobber
• 拥有目标SharePoint站点的站点所有者权限
• 本地NAS文件夹路径（包含需修正的所有子文件夹）
• 目标SharePoint文档库的站点URL（例：https://yourtenant.sharepoint.com/sites/yoursite/Shared%20Documents）

批量处理脚本（支持子文件夹递归） #

# 配置参数
$localFolderPath = "D:\NAS\OldSPData" # 你的NAS文件夹路径
$siteUrl = "https://yourtenant.sharepoint.com/sites/yourtargetsite" # 目标SP站点URL
$docLibName = "Shared Documents" # 目标文档库名称

# 连接SharePoint Online
Connect-PnPOnline -Url $siteUrl -Interactive

# 获取文档库根文件夹对象
$docLib = Get-PnPList -Identity $docLibName
$rootFolder = Get-PnPFolder -List $docLib

# 递归处理文件夹与文件
function Update-SPFileTime {
    param(
        [Parameter(Mandatory=$true)]
        [string]$LocalPath,
        [Parameter(Mandatory=$true)]
        [Microsoft.SharePoint.Client.Folder]$SPFolder
    )

    # 处理当前文件夹下的所有文件
    $localFiles = Get-ChildItem -Path $LocalPath -File
    foreach ($file in $localFiles) {
        $spFile = Get-PnPFile -Url "$($SPFolder.ServerRelativeUrl)/$($file.Name)" -ErrorAction SilentlyContinue
        if ($spFile) {
            $listItem = Get-PnPListItem -List $docLibName -Id $spFile.ListItemAllFields.Id
            
            # 从本地文件读取原始时间，保留原创建/修改人信息
            $updateProps = @{
                "Created" = $file.CreationTimeUtc
                "Modified" = $file.LastWriteTimeUtc
                "Created By" = $listItem["Created By"]
                "Modified By" = $listItem["Modified By"]
            }

            # 静默更新元数据，无变更痕迹
            Set-PnPListItem -List $docLibName -Identity $listItem.Id -Values $updateProps -SystemUpdate -ErrorAction Continue
            Write-Host "已修正: $($file.Name) | 原修改时间: $($file.LastWriteTime)"
        }
    }

    # 递归处理子文件夹
    $localSubFolders = Get-ChildItem -Path $LocalPath -Directory
    foreach ($subFolder in $localSubFolders) {
        $spSubFolder = Get-PnPFolder -Url "$($SPFolder.ServerRelativeUrl)/$($subFolder.Name)" -ErrorAction SilentlyContinue
        if ($spSubFolder) {
            Update-SPFileTime -LocalPath $subFolder.FullName -SPFolder $spSubFolder
            Write-Host "已处理子文件夹: $($subFolder.Name)"
        }
    }
}

# 启动批量更新
Update-SPFileTime -LocalPath $localFolderPath -SPFolder $rootFolder

# 断开连接
Disconnect-PnPOnline

关键细节说明 #

• -SystemUpdate参数：这是实现无变更记录的核心，仅更新元数据，不生成新版本、不触发工作流或通知，完全符合需求。
• 兼容性：对Office文档、PDF等所有文件类型通用，无需打开或修改文件内容。
• 单文件夹处理：若只需处理单个文件夹，删除脚本中的递归子文件夹逻辑即可。
• 时间准确性：强制使用UTC时间，避免时区转换导致的时间偏差。

注意事项 #

1. 先在测试文档库验证脚本效果，再操作生产数据
2. 若目标文档库开启强制版本控制，需临时关闭后执行脚本，否则-SystemUpdate可能失效
3. 若本地文件时间不是旧SharePoint的原始时间，可先从旧库导出元数据CSV（用Get-PnPListItem），再基于CSV修改脚本实现批量更新

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