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

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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