Invoke-SPOSiteSwap
Вызывает задание для замены расположения сайта на другой сайт с архивацией первоначального сайта.
Синтаксис
Default (по умолчанию)
Invoke-SPOSiteSwap
[-SourceUrl] <String>
[[-TargetUrl] <String>]
[-ArchiveUrl] <String>
[-DisableRedirection]
[-Force]
[-NoWait]
[<CommonParameters>]
Описание
Заменяет расположение исходного сайта на целевой сайт с архивацией первоначального целевого сайта.
Целевым сайтом должен быть:
- корневой сайт, например
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
Применимо: SharePoint Online
URL-адрес, в котором архивируется целевой сайт. Перед выполнением замены в этом расположении не должно быть существующего сайта, а также удаленного сайта в корзине.
Свойства параметра
| Тип: | System.String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 2 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DisableRedirection
Применимо: SharePoint Online
Отключает создание переадресации на сайт в исходном URL-адресе.
Свойства параметра
| Тип: | Switch Parameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Применимо: SharePoint Online
Переопределяет и игнорирует все предупреждения, определенные Средством диагностики страниц, препятствующие запуску переключения.
Например, если появляется предупреждение "Invoke-SPOSiteSwap: Errors: 0; Предупреждения: 1; Сведения: 2 элемента не находятся в CDN, включите CDN". Предупреждения можно переопределить с помощью этого параметра, но элементы должны быть проверены и разрешены для обеспечения долгосрочной стабильности и производительности.
При этом все ошибки, определенные с помощью Средства диагностики страниц, все еще препятствуют запуску переключения вне зависимости от параметра.
Свойства параметра
| Тип: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-NoWait
Применимо: SharePoint Online
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметра
| Тип: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | 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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | 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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.