Invoke-SPOSiteSwap

  • 參考
模組:
Microsoft.Online.SharePoint.PowerShell
適用於:
SharePoint Online

封存原始網站同時，叫用工作以將網站位置與另一個網站交換。

Syntax

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

Description

將來源網站與目標網站交換，並同時封存原始目標網站。

請注意，目標網站必須是：

啟動交換之後，會將目標網站移至封存位置，並將來源網站移至目標位置。 根據預設，會在來源位置建立網站重新導向，並將流量重新導向至目標位置。

如果目標是位於 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