Copy-SPOPersonalSitePage

此 cmdlet 命令允许你利用现有复制作重新定位现有 SharePoint 页面。 我们还会将与 SharePoint 页面关联的任何资产复制到新目标。 我们提供两种重定位页面的方法:

  • 复制:此方法在新位置创建副本时保持原始页面不变。
  • 移动:此方法在新位置创建一个新副本,并从源中删除原始页面。

语法

Default (默认值)

Copy-SPOPersonalSitePage
    -SourceSite <SpoSitePipeBind>
    -DestinationSite <SpoSitePipeBind>
    -PageName <String>
    [-DeleteSourcePage]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Copy-SPOPersonalSitePage cmdlet 允许 SharePoint 管理员将一个或多个 SharePoint 页面从所选源复制到所选目标 SharePoint 网站。 -DeleteSourcePage如果 参数设置为 $true,则会在复制作后删除源页 () ,从而有效地将页面 () 。

注意

此 cmdlet 可能并非在所有租户中都可用,因为该功能可能正在进行中。 如果租户中尚未启用该功能,则尝试运行此 cmdlet 将导致错误。

可以将现有页面 () 移向和移出何处?

目标
OneDrive for Business 中的 SharePoint 页面库 OneDrive for Business 中的 SharePoint 页面库
OneDrive for Business 中的 SharePoint 页面库 SharePoint 网站
SharePoint 网站 SharePoint 网站

如何实现查询复制作的状态?

执行此 cmdlet 后,将收到以下信息:

属性 说明
ErrorMessage 如果发生任何错误,我们将显示相应的错误消息。
JobState 作业的当前状态。
NewPageUrl 如果复制作已完成,则为新页面的 URL。
SourcePageName 要复制的源页的名称。
StatusMessage 描述当前状态的消息。
WorkItemId 用于跟踪复制作业状态的工作项 ID。 如果复制作已完成,则为 00000000-0000-0000-0000-000000000000
  • 如果复制成功,将提供新页面的 URL。
  • 如果复制仍在进行中,将收到工作项 ID。 可以使用 Get-SPOPersonalSitePageCopyProgress 命令检查 URL 的状态。

下表说明了复制作业的状态:

状态 解释
已排队 复制作已排队等待执行。
CreateAssetsFolderStart 我们已开始创建一个文件夹来放置此页上使用的所有关联资产。
CreateAssetsFolderEnd 我们已完成创建文件夹以放置此页上使用的所有关联资产。
CopyAssetsStart 我们已开始复制此页上使用的关联资产。
CopyAssetsEnd 已完成复制此页上使用的关联资产。
CreatePageStart 我们已开始创建新页面。
CreatePageEnd 我们已完成创建新页面。
Succeeded 复制作成功。
删除 复制作已删除。
已失败 复制作失败。
JobNotFound 找不到复制作。

示例

示例 1

Copy-SPOPersonalSitePage -SourceSite 'https://contoso-my.sharepoint.com/personal/testuser_onmicrosoft_com' -DestinationSite 'https://contoso.sharepoint.com/sites/testsite' -PageName 'TestPage.aspx' -Confirm

示例 1 演示了 SharePoint 管理员如何通过确认将名为 TestPage.aspx 的 SharePoint 页面从 testuserOneDrive for Business 中的 SharePoint 页面库复制到 testsite SharePoint 网站。 不会删除源页。

示例 2

Copy-SPOPersonalSitePage -SourceSite 'https://contoso-my.sharepoint.com/personal/testuser_onmicrosoft_com' -DestinationSite 'https://contoso.sharepoint.com/sites/testsite' -PageName 'TestPage.aspx' -DeleteSourcePage

示例 2 演示了 SharePoint 管理员如何将名为 TestPage.aspx 的 SharePoint 页面从 testuserOneDrive for Business 中的 SharePoint 页面库移动到 testsite SharePoint 网站。 复制作后,源页将被删除。

示例 3

Copy-SPOPersonalSitePage -SourceSite 'https://contoso.sharepoint.com/sites/sourcesite' -DestinationSite 'https://contoso.sharepoint.com/sites/testsite' -PageName 'TestPage.aspx' -DeleteSourcePage -Confirm

示例 3 演示了 SharePoint 管理员如何通过确认将名为 TestPage.aspx 的 SharePoint 页面从 SharePoint 网站名称 sourcesite 复制到 testsite SharePoint 网站。 复制作后,源页将被删除。

示例 4

Copy-SPOPersonalSitePage -SourceSite 'https://contoso-my.sharepoint.com/personal/testuser1_onmicrosoft_com' -DestinationSite 'https://contoso-my.sharepoint.com/personal/testuser2_onmicrosoft_com' -PageName 'TestPage.aspx' -DeleteSourcePage -Confirm

示例 4 演示了 SharePoint 管理员如何在确认的情况下,将名为 TestPage.aspx 的 SharePoint 页面从 testuser1OneDrive for Business testuser2中的 SharePoint 页面库移动到 OneDrive for Business 中的 SharePoint 页面库。 复制作后,源页将被删除。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

参数属性

类型:System.Management.Automation.SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DeleteSourcePage

适用:SharePoint Online

指示复制后是否删除源 SharePoint 页面 () 。 如果指定,作将移动 SharePoint 页面 () ,而不是复制。

参数属性

类型:System.Management.Automation.SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DestinationSite

适用:SharePoint Online

指定要将 SharePoint 页面复制到的目标 SharePoint 网站的 URL。

参数属性

类型:Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PageName

适用:SharePoint Online

指定要复制的 SharePoint 页面的名称。 不使用开关时, -AllPages 此参数是必需的。 请注意, -PageName 引用以后缀.aspx结尾的 SharePoint 页面的名称,例如page.aspx。

参数属性

类型:System.String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SourceSite

适用:SharePoint Online

指定要复制的 SharePoint 页面的源 SharePoint 网站的 URL。

参数属性

类型:Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示在 cmdlet 运行时发生的情况。 此 cmdlet 未运行。

参数属性

类型:System.Management.Automation.SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

输出

System.Object

备注

问:移动后,SharePoint 页面是否会保留其版本历史记录?

答:目前,只会传输最新发布的版本。

问:我共享的 SharePoint 页面的收件人是否可以在移动后继续访问它们?

答:移动页面后,将删除所有权限。