Invoke-SPOSiteSwap
封存原始網站同時,叫用工作以將網站位置與另一個網站交換。
Syntax
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 的根網站,則執行交換之前,應執行下列準備動作:
- SharePoint 起始頁面 https://tenant-name.sharepoint.com/_layouts/15/sharepoint.aspx 定義的任何精選連結,將不會在執行交換後顯示。 如有需要,應先記錄精選連結,以便在交換之後手動重新建立。
- 外部共用和應用程式介面等功能取決於根網站中定義的原則和權限。 檢閱來源網站,以確保擁有根據現有根網站所需的原則和權限。 包括外部共用設定以及網站權限。
- 擁有超過 ~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。 此位置的網站必須存在,才可以執行交換。
來源網站將必須為以下擇一:
- 位於 https://tenant-name.sharepoint.com 的根網站或
- 位於 https://tenant-name.sharepoint.com/search. 的搜尋中心網站
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Online |