При переходе с SharePoint on-premises или SharePoint Online на Portal важно не только развернуть новую платформу, но и перенести накопленный контент. Для этого в каждый релизный дистрибутив Portal (Docker, Kubernetes, Native Linux и Windows) входит CLI portal-sp-migrate и примеры конфигурации в каталоге sharepoint-migrate-config/.
Что умеет portal-sp-migrate
- Два источника: SharePoint Online через Microsoft Graph и SharePoint On-Premises через CSOM
- Структура и контент: узлы, схемы списков, элементы, папки, файлы библиотек
- Сложные поля: lookup и person — отдельная фаза после основного импорта
- Права доступа: маппинг групп и пользователей на принципалы Portal (опционально)
- Возобновление: SQLite-состояние, чекпоинты и команды
resume/status
Фазы миграции
Инструмент работает поэтапно: nodes → schemas → items → folders → files → lookups → permissions (по желанию) → verify. Можно запустить полный цикл или одну фазу через --phase.
Типичный сценарий:
discover— инвентаризация источникаplan— план переноса и оценка объёмаrun— выполнение миграцииstatus— контроль прогресса; при сбое —resume
Где найти в дистрибутиве
После распаковки bundle бинарник лежит рядом с portal-cli (имя: portal-sp-migrate на Linux/macOS, portal-sp-migrate.exe на Windows). Примеры YAML-конфигурации — в sharepoint-migrate-config/migration.example.yaml и migration.onprem.example.yaml.
Быстрый старт
./portal-sp-migrate discover --config sharepoint-migrate-config/migration.example.yaml
./portal-sp-migrate plan --config sharepoint-migrate-config/migration.example.yaml
./portal-sp-migrate run --config sharepoint-migrate-config/migration.example.yamlКонфигурация задаёт подключение к SharePoint, целевой Portal (URL, учётные данные API), область миграции и маппинг полей. Для On-Prem и Graph — разные шаблоны конфигов.
Документация
Полное руководство, таблица соответствия полей SharePoint → Portal и рекомендации по правам:
Связанные материалы
Альтернатива SharePoint on-premises, план ухода с SharePoint 2019 до EoL, заявка на дистрибутив Portal.