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 页面的收件人是否可以在移动后继续访问它们?
答:移动页面后,将删除所有权限。