Invoke-SPOSiteSwap

调用作业,在存档原始网站时将网站的位置与另一网站进行交换。

语法

Invoke-SPOSiteSwap
         -SourceUrl <string>
         -TargetUrl <string>
         -ArchiveUrl <string>
         [-DisableRedirection]
         [-Force]
         [-NoWait]   
      [<CommonParameters>]

说明

在存档原始目标网站时将原网站的位置与目标网站进行交换。

请注意,目标站点必须是:

启动交换后,目标网站移动到存档位置,源网站移动到目标位置。 默认情况下,在源位置创建网站重定向,它会将流量重定向到目标位置。

如果目标是位于 https://tenant-name.sharepoint.com 的根网站,则应在进行交换之前执行以下准备活动:

  1. 执行交换后,将不显示在 SharePoint 起始页 (https://tenant-name.sharepoint.com/_layouts/15/sharepoint.aspx) 中定义的任何特色链接。 如果需要,应记录特色链接,以便可在交换后手动地重新创建它们。
  2. 外部共享和应用程序接口等功能依赖于根网站处定义的策略和权限。 请查看源网站,确保它根据现有根网站具有所需策略和权限。 这包括外部共享设置和网站权限。
  3. 许可证数超过 10,000 个的大型租户需要针对源站点运行 页面诊断工具 , (确保运行页面诊断工具的用户) 对源站点具有编辑权限。 执行交换前,需修正“需要注意(红色)”或“改进机会” (橙色)”的任何分析结果。

源网站和目标网站都无法连接到 Office 365 组。 它们不能是中心网站,也不能与中心关联。 如果网站是中心网站,请取消其中心网站的身份,交换根网站,然后将该网站注册为中心网站。 如果网站与中心相关联,请取消关联网站,交换根网站,然后重新关联该网站。

如果以前已激活发布功能,或当前已在源网站中激活该功能,则不能使用 Invoke-SPOSiteSwap。

示例

示例 1

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/CommunicationSite -TargetUrl https://contoso.sharepoint.com -ArchiveUrl https://contoso.sharepoint.com/sites/Archive

将位于 https://contoso.sharepoint.com 的现有网站存档至 https://contoso.sharepoint.com/sites/Archive,并将 https://contoso.sharepoint.com/sites/CommunicationSite 移至 https://contoso.sharepoint.com.。将在 https://contoso.sharepoint.com/sites/CommunicationSite 处创建网站重定向,它会将所有请求重定向到 https://contoso.sharepoint.com.

示例 2

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/SearchSite -TargetUrl https://contoso.sharepoint.com/search -ArchiveUrl https://contoso.sharepoint.com/sites/Archive

将位于 https://contoso.sharepoint.com/search 的现有搜索中心存档至 https://contoso.sharepoint.com/sites/Archive,并将 https://contoso.sharepoint.com/sites/SearchSite 移至 https://contoso.sharepoint.com/search.。将在 https://contoso.sharepoint.com/sites/SearchSite 处创建网站重定向,它会将所有请求重定向到 https://contoso.sharepoint.com/search.

示例 3

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/CommunicationSite -TargetUrl https://contoso.sharepoint.com -ArchiveUrl https://contoso.sharepoint.com/sites/Archive -DisableRedirection

将位于 https://contoso.sharepoint.com 的现有网站存档至 https://contoso.sharepoint.com/sites/Archive,并将 https://contoso.sharepoint.com/sites/CommunicationSite 移至 https://contoso.sharepoint.com.。不会在 https://contoso.sharepoint.com/sites/CommunicationSite. 处创建网站重定向

示例 4

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/SearchSite -TargetUrl https://contoso.sharepoint.com/search -ArchiveUrl https://contoso.sharepoint.com/sites/Archive -Force

将位于 https://contoso.sharepoint.com/search 的现有搜索中心存档至 https://contoso.sharepoint.com/sites/Archive,并将 https://contoso.sharepoint.com/sites/SearchSite 移至 https://contoso.sharepoint.com/search.。将在 https://contoso.sharepoint.com/sites/SearchSite 处创建网站重定向,它会将所有请求重定向到 https://contoso.sharepoint.com/search.。页面诊断工具识别的任何警告将被忽略并启动交换。 但是,由页面诊断工具识别的任何错误仍会阻止启动替换。

参数

-ArchiveUrl

要将目标网站存档到的 URL。 执行交换前,此位置处不得存在现有网站(包括回收站中已删除的网站)。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-DisableRedirection

禁止在源 URL 位置处创建网站重定向。

Type:Switch Parameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Force

覆盖并忽略由页面诊断工具所识别的任何警告,会阻止启动替换。

例如,如果收到警告“Invoke-SPOSiteSwap: Errors: 0;警告:1;详细信息:2 个项目不在 CDN 中,请启用 CDN。”可以使用此参数替代警告,但应查看和解决这些项,以获取长期稳定性和性能。

无论此参数如何,由页面诊断工具识别的任何错误始终会阻止启动替换。

Type:Switch Parameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-NoWait

保留此参数以供 Microsoft 内部使用。

Type:Switch Parameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-SourceUrl

源网站的 URL。 在执行交换之前,必须存在此位置处的网站。

如果目标是中 https://tenant-name.sharepoint.com 的根网站,则源网站必须是新式团队网站(STS # 3)或通信网站(SITEPAGEPUBLISHING # 0),并且无法在源网站上激活发布功能

如果目标是 https://tenant-name.sharepoint.com/search 处的搜索中心网站,则源网站必须是搜索中心网站 (SRCHCEN#0) 或基本搜索中心网站 (SRCHCENTERLITE#0)。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-TargetUrl

要将源网站交换为的目标网站的 URL。 在执行交换之前,必须存在此位置处的网站。

目标网站必须是:

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online