Skip to content
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
---
ms.author: jtremper
title: Get started with the SharePoint Online Management Shell
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
---
ms.author: jtremper
title: Intro to SharePoint Online Management Shell
description: Intro to SharePoint Online Management Shell
---
Expand Down
16 changes: 8 additions & 8 deletions sharepoint/sharepoint-ps/sharepoint-online/Invoke-SPOSiteSwap.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,14 +35,14 @@ Swaps the location of a source site with a target site while archiving the origi

Please note, the target site must be either:

- The root site, for example <https://tenant-name.sharepoint.com>; or
- The search center site, for example <https://tenant-name.sharepoint.com/search>.
- The root site, for example <`https://tenant-name.sharepoint.com`>; or
Comment thread
prgundel marked this conversation as resolved.
Outdated
- The search center site, for example <`https://tenant-name.sharepoint.com/search`>.

When the swap is initiated, the target site is moved to the archive location and the source site is moved to the target location. By default, a site redirect is created at the source location that will redirect traffic to the target location.

If the target is the root site at <https://tenant-name.sharepoint.com>, then the following preparation activities should be performed prior to performing the swap:
If the target is the root site at <`https://tenant-name.sharepoint.com`>, then the following preparation activities should be performed prior to performing the swap:

1. Any Featured links defined in SharePoint Start Page at <https://tenant-name.sharepoint.com/_layouts/15/sharepoint.aspx> will not be displayed after performing the swap. If required, the Featured links should be documented so they can be manually recreated after the swap.
1. Any Featured links defined in SharePoint Start Page at <`https://tenant-name.sharepoint.com/_layouts/15/sharepoint.aspx`> will not be displayed after performing the swap. If required, the Featured links should be documented so they can be manually recreated after the swap.
2. Functionality such as external sharing and application interfaces are dependent on the policies and permissions defined at the root site. Review the source site to ensure that it has the required policies and permissions as per the existing root site. This includes external sharing settings as well as site permissions.
3. Larger tenants that have more than ~10,000 licenses will need to run the [Page Diagnostic Tool](/office365/enterprise/page-diagnostics-for-spo) against the source site (ensure that the user running the Page Diagnostic Tool has edit rights on the source site). Any analysis results that have the category Attention required (Red) or Improvement opportunities (Orange) will need to be remediated before performing the swap.

Expand Down Expand Up @@ -91,9 +91,9 @@ Archives the existing Search Center site at <https://contoso.sharepoint.com/sear

URL of the source site. The site at this location must exist before performing the swap.

If the target is the root site at <https://tenant-name.sharepoint.com> then the source site must be either a Modern Team Site (STS#3) or a Communication Site (SITEPAGEPUBLISHING#0) and **the publishing feature can never have been activated on the source site**.
If the target is the root site at <`https://tenant-name.sharepoint.com`> then the source site must be either a Modern Team Site (STS#3) or a Communication Site (SITEPAGEPUBLISHING#0) and **the publishing feature can never have been activated on the source site**.

If the target is the search center site at <https://tenant-name.sharepoint.com/search> then the source site must be either a Search Center Site (SRCHCEN#0) or a Basic Search Center Site (SRCHCENTERLITE#0).
If the target is the search center site at <`https://tenant-name.sharepoint.com/search`> then the source site must be either a Search Center Site (SRCHCEN#0) or a Basic Search Center Site (SRCHCENTERLITE#0).

```yaml
Type: String
Expand All @@ -114,8 +114,8 @@ URL of the target site that the source site will be swapped to. The site at this

The target site must be either:

- The root site at <https://tenant-name.sharepoint.com> or
- The search center site at <https://tenant-name.sharepoint.com/search.>
- The root site at <`https://tenant-name.sharepoint.com`> or
- The search center site at <`https://tenant-name.sharepoint.com/search`>

```yaml
Type: String
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -223,7 +223,7 @@ Accept wildcard characters: False

### -TargetWebUrl

The fully qualified web URL to use as the web address part of the base URL in the package metadata. If this is not provided, "<http://fileserver/sites/user"> will be used instead within the package metadata.
The fully qualified web URL to use as the web address part of the base URL in the package metadata. If this is not provided, "<`http://fileserver/sites/user`>" will be used instead within the package metadata.
Comment thread
prgundel marked this conversation as resolved.
Outdated

```yaml
Type: String
Expand Down