Invoke-SPOSiteSwap

  • 参考
模块:
Microsoft.Online.SharePoint.PowerShell
适用于:
SharePoint Online

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

语法

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