使用PowerShell导入单个.aspx页面到SharePoint却导入全部文件的问题

问题原因 #

Import-SPWeb cmdlet 的 -Path 参数并非用来直接指定单个.aspx文件路径，它要求传入的是SharePoint导出的Web包文件（.cmp格式）。当你直接传入单个.aspx文件时，该命令会误将文件所在的整个Pages文档库作为导入源，导致库内所有页面都被导入，这和你日志中看到的[List] [Páginas] Progress: Importing以及多个ListItem导入的记录完全吻合。

解决方案 #

方案1：使用导出+导入的标准流程 #

先将目标页面单独导出为.cmp包，再进行导入：

# 导出单个页面到cmp包
Export-SPWeb -Identity "http://11.11.1.100:10000/" -ItemUrl "/Paginas/page1.aspx" -Path "C:\Users\user\Desktop\page1.cmp"

# 导入该cmp包
Import-SPWeb -Identity "http://11.11.1.100:10000/" -Path "C:\Users\user\Desktop\page1.cmp" -Force

• -ItemUrl 指定要导出的单个页面的服务器相对URL（需匹配目标站点的页面库路径）

方案2：直接上传页面到文档库（适用于本地aspx文件） #

如果你的page1.aspx是本地创建的文件，而非从SharePoint导出的页面，应该用文件上传的方式，而非Import-SPWeb。推荐使用PnP PowerShell：

# 连接到SharePoint站点
Connect-PnPOnline -Url "http://11.11.1.100:10000/" -UseWebLogin

# 上传本地aspx文件到页面库
Add-PnPFile -Path "C:\Users\user\Desktop\Pages\page1.aspx" -Folder "Paginas"

• Folder 参数指定目标页面库的名称（此处对应日志中的Páginas库）

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