共用方式為


Invoke-SPOSiteSwap

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

語法

Default (預設值)

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

Description

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

請注意,目標網站必須是:

  • 根網站,例如 https://tenant-name.sharepoint.com;或
  • 搜尋中心網站,例如 https://tenant-name.sharepoint.com/search

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

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

適用:SharePoint Online

將封存的目標網站 URL。 在執行交換之前,此位置不應存在現有網站,包括資源回收筒中已刪除的網站。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:2
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DisableRedirection

適用:SharePoint Online

停用在來源 URL 位置建立網站重新導向。

參數屬性

類型:Switch Parameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Force

適用:SharePoint Online

覆寫或忽略由防止交換起始之頁面診斷工具識別的任何錯誤。

例如,如果您收到警告「Invoke-SPOSiteSwap: Errors: 0;警告:1;詳細數據:2 個專案不在CDN中,請啟用CDN。」您可以使用此參數來覆寫警告,但應檢閱和解決專案,以獲得長期穩定性和效能。

無論這個參數為何,由頁面診斷工具識別的任何錯誤,仍然隨時會防止交換起始。

參數屬性

類型:System.Management.Automation.SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-NoWait

適用:SharePoint Online

將保留此參數供 Microsoft 內部使用。

參數屬性

類型:System.Management.Automation.SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SourceUrl

適用:SharePoint Online

來源網站的 URL。 此位置的網站必須存在,才可以執行交換。

如果目標是位於 https://tenant-name.sharepoint.com 的根網站,來源網站必須是新式小組網站 (STS # 3) 或通訊網站 (SITEPAGEPUBLISHING # 0) 且 發佈功能永遠不可能在來源網站 啟動。

如果目標是位於 https://tenant-name.sharepoint.com/search 的搜尋中心,來源網站必須是搜尋中心網站 (SRCHCEN#0) 或基本搜尋中心網站 (SRCHCENTERLITE#0)。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-TargetUrl

適用:SharePoint Online

來源網站將交換之目標網站 URL。 此位置的網站必須存在,才可以執行交換。

來源網站將必須為以下擇一:

  • 位於 https://tenant-name.sharepoint.com 的根網站或
  • 位於 https://tenant-name.sharepoint.com/search 的搜尋中心網站

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

None

輸出

System.Object