使用Copy-PnPFile跨站点集复制文档库失败，报错值不能为空求助

根据你提供的报错信息（Null value for source item），核心问题是PowerShell无法定位到指定的源文档库，以下是针对性的解决步骤：

1. 验证源路径的正确性 #

• 检查源站点和文档库的拼写：确认/sites/AshTest/Docs中的站点名称AshTest、文档库名称Docs没有大小写错误或拼写失误（部分SharePoint环境对路径大小写敏感）。
• 手动验证源库存在：执行以下命令确认源文档库可被访问：

  # 连接到源站点
  Connect-PnPOnline -Url "https://tenant.sharepoint.com/sites/AshTest"
  # 获取文档库信息，验证是否存在
  Get-PnPList -Identity "Docs"
  

  如果命令返回库信息，说明源路径有效；否则需要修正路径。

2. 跨站点集复制需明确指定连接参数 #

跨不同站点集复制文件时，必须显式指定源站点和目标站点的连接对象，否则PowerShell会默认使用当前连接的站点，导致无法找到跨站点的源路径。示例命令如下：

# 分别建立源站点和目标站点的连接
$sourceConn = Connect-PnPOnline -Url "https://tenant.sharepoint.com/sites/AshTest" -ReturnConnection
$targetConn = Connect-PnPOnline -Url "https://tenant.sharepoint.com/sites/ADM-AshTest" -ReturnConnection

# 执行复制命令，指定源/目标连接
Copy-PnPFile -SourceUrl "/sites/AshTest/Docs" -TargetUrl "/sites/ADM-AshTest/TestDocs/Docs" -SourceConnection $sourceConn -TargetConnection $targetConn -Force

3. 确认目标路径的有效性 #

• 检查目标路径的父层级：确认/sites/ADM-AshTest/TestDocs是已存在的文档库，且Docs文件夹要么已存在，要么允许通过-Force参数自动创建（若目标父路径不存在，命令会失败）。
• 验证目标路径可访问：执行以下命令确认目标路径有效：

  Connect-PnPOnline -Url "https://tenant.sharepoint.com/sites/ADM-AshTest"
  Get-PnPFolder -Url "TestDocs/Docs"
  

4. 检查权限配置 #

确保执行命令的账号具备：

• 源文档库/sites/AshTest/Docs的读取权限
• 目标路径/sites/ADM-AshTest/TestDocs/Docs的写入权限
  若权限不足，联系管理员调整后重试。

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