Помилки SPMT і Migration Manager: контрольний список щодо кінцевих точок, дискового простору й сканування
By Mirko Peters ·
SPMT повідомляє про брак дискового простору, або агент Migration Manager показує «Connected», але не може сканувати? Перевірте в такому порядку: необхідні кінцеві точки, локальну робочу папку, сховище цільового майданчика та налаштування агента.
Automatically translated with AI from the original post. Read the English original
Міграція з файлового ресурсу або локального SharePoint зазвичай працює добре протягом тижнів. Потім бібліотека видає повідомлення про брак дискового простору, брандмауер відхиляє кінцеву точку, або агент Migration Manager залишається в стані «Connected» і відмовляється сканувати. Чотири теми спільноти Microsoft, від кінця 2025 до кінця 2026 року, показують ці випадки. Лише в одній із них відповідь позначена як розв’язання, тож ця стаття поєднує їх з актуальними сторінками Learn. Це посібник з усунення несправностей, а не офіційна процедура Microsoft.
Головне
- Дозвольте повні списки кінцевих точок із Microsoft Learn, зокрема api.office.com для SPMT і кінцеві точки сканування для Migration Manager. В одній темі радять робити це за іменем хоста, а не за IP-адресою.
- Брандмауер, який відхиляє запис із https:// у ньому, може потребувати лише імені хоста в об’єкті FQDN, як повідомлялося в темі, де це позначили як розв’язання.
- Помилки дискового простору SPMT, описані на Learn, вказують на локальну робочу папку, тож спершу перевірте вільне місце на комп’ютері міграції, а потім сховище цільового майданчика.
- «Cannot scan» за підключеного агента в темах не мало підтвердженого виправлення. В одного автора питання була справа в підтримці, яку Microsoft визнала відомою проблемою.
- Тримайте напоготові звіт про збій, точний код помилки та час (UTC), бо більшість тем завершувалися порадою «відкрити справу в підтримці».
Як виглядають симптоми
- Кінцева точка: Брандмауер комп’ютера SPMT відхиляє
https://api.office.comяк недійсний запис. Автор допису читав, що API застарів, але сторінка вимог SPMT досі її вказує (серпень 2026). - Дисковий простір: Міграція з SharePoint 2019 до SharePoint Online для двох бібліотек завершується помилками «There isn't enough disk space in the target site collection» і «Not all the items in the package have been migrated». Автор стверджує, що в місці призначення достатньо простору (серпень 2026).
- Cannot scan: Агент Migration Manager показує «Connected», але «Cannot scan». Міграції працювали до середини вересня. Повторне встановлення агента не допомогло, а автор бачив невдалі SSL-запити до міграційних кінцевих точок Microsoft (жовтень 2026).
- Вхід за сертифікатом: Після повторного встановлення агента з автентифікацією за сертифікатом кнопка Add Source Path на вкладці сканування неактивна, а журнал агента постійно повторює
token_not_found(листопад 2025).
Крок 1: перевірте кінцеві точки
Learn перелічує кінцеві точки для обох інструментів як URL-адреси HTTPS. Для Migration Manager там зазначено, що агент надсилає запити на ці кінцеві точки та отримує відповіді, що кінцеві точки ніколи не можуть викликати Migration Manager і що агент не відкриває порт для віддалених підключень.
Для SPMT на сторінці вимог Learn серед інших перелічено такі:
- Автентифікація:
login.microsoftonline.com,login.windows.net,aadcdn.msftauth.net,aadcdn.msauth.net,secure.aadcdn.microsoftonline-p.com - API для переміщення вмісту та перевірки:
api.office.comіgraph.windows.net - Черги міграції та сховище Azure:
.queue.core.windows.netі.blob.core.windows.net - Призначення:
*.sharepoint.com - Graph для інформації про клієнт і сайти:
graph.microsoft.com
Для Migration Manager на сторінці вимог Learn додано кінцеві точки, пов'язані зі скануванням, наприклад api.mmp.svc.cloud.microsoft, odyssey.mmp.svc.cloud.microsoft, odyssey.prod.migrations.microsoft.com і кілька хостів SignalR. api.prod.migrations.microsoft.com там вказано як вимогу для веб-інтерфейсу Migration Manager. Завжди копіюйте актуальний список зі сторінки, оскільки він змінюється. У вступній частині сторінки також згадано production.odyssey.ops.mover.io для підключень SignalR, але цього хоста немає в її таблиці, тож читайте текст навколо таблиці.
Відповідь, позначена як рішення в обговоренні api.office.com, містить таку пораду:
- Не вважайте відмову брандмауера доказом того, що кінцева точка не потрібна.
- Дозвольте ім'я хоста через TCP 443 із комп'ютера для міграції та використовуйте правила на основі DNS, а не IP-адреси. Це порада з обговорення. Learn не вказує порт.
- Якщо поле брандмауера відхиляє запис, введіть лише ім'я хоста в об'єкті FQDN. Можливо, поле не приймає префікс
https://. Ця частина є порадою з обговорення, а не з Learn. - Перевірте розв'язання імен і вихідне з'єднання TLS з комп'ютера для міграції, а потім повторіть сканування.
Швидкий тест із комп'ютера для міграції:
``powershell Test-NetConnection api.office.com -Port 443 Test-NetConnection odyssey.prod.migrations.microsoft.com -Port 443 ``
Шаблон на кшталт *.blob.core.windows.net не можна перевірити в такому вигляді. Натомість перевірте реальне ім'я хоста з вашого клієнта. У обговоренні «Cannot scan» також пропонується виключити проксі-сервер, брандмауер, перевірку SSL або зміни сертифікатів між агентом і цими хостами. На двох сторінках вимог я не бачив згадки про перевірку SSL, тож сприймайте цей пункт як пропозицію спільноти.
Крок 2: Перевірте вільне місце на комп'ютері для міграції
Для SPMT на сторінці усунення несправностей Learn описано такі помилки:
- «Scan File Failure: Not enough disk space to pack the file»: дискового простору для робочої папки міграції замало для розміру вихідного файлу. Збільште робочу папку та повторіть спробу.
- Помилка 0x02040012: тимчасового сховища на локальному комп'ютері замало, оскільки SPMT кешує пакет у робочій папці. Розширте тимчасове сховище та повторіть спробу.
Learn рекомендує 150 ГБ вільного локального сховища для комп'ютера, на якому працює SPMT, як у рекомендованому, так і в мінімальному профілі апаратного забезпечення. Перевірте системний диск і диск вашої робочої папки. Робоча папка %appdata%\Microsoft\MigrationToolStorage згадується на сторінці усунення несправностей, а кілька помилок там вказують, що її файли та папки під час міграції мають бути закриті.
У обговоренні SharePoint 2019 відповідь від учасника спільноти з титулом MVP казала, що повідомлення, імовірно, вказує на локальне тимчасове сховище, а не на обмеження SharePoint Online. На сторінці Learn перелічено локальні помилки вище, а точного формулювання «target site collection» там немає. Тож локальна перевірка є найбільш обґрунтованим першим кроком.
Крок 3: Перевірте цільовий сайт і сховище клієнта
Інша відповідь у тому самому обговоренні зазначала, що друге повідомлення, «Not all the items in the package have been migrated», імовірно, є побічним наслідком першої помилки. Там пропонувалося перевірити ліміт сховища цільового сайту (у центрі адміністрування SharePoint у розділі Active sites), загальне сховище клієнта, а також старі версії та вміст кошика. Ця відповідь і попередня не були позначені як рішення, а автор питання не повідомив про результат.
Якщо цільове сховище заповнене, зважте на те, що пишуть у Learn про сховище: звіти про використання можуть відставати до 48 годин, а в режимі ручного сховища кожен сайт має власний ліміт.
Щодо повідомлення «not all items migrated» сторінка з усуненням несправностей у Learn двічі згадує помилку 0x01710009: один раз із текстом «Errors or time-out for Server Processing the file: Not all the items in the package are migrated», а вдруге як збій через помилки завершення завдання, коли частина елементів пакета не була перенесена, з порадою перезапустити міграцію. Для відсутніх залежностей елементів списку (помилка 0x01410010) перевірте FailureSummaryReport.csv і переконайтеся, що залежності входять в обсяг міграції. У треді також пропонують повторити невдалу бібліотеку меншими пакетами, а потім виконати інкрементальну міграцію, щоб знайти відсутні елементи. Це пропозиція спільноти, а не крок із Learn.
Крок 4: перевірте агент Migration Manager
Сторінка Learn з усунення несправностей Migration Manager описує кілька випадків з агентом, які не є помилкою «Cannot scan», але схожі на неї:
- Агент відключений: можливі причини: стан мережі на комп’ютері з агентом, зміна пароля або інша подібна критична зміна облікового запису адміністратора клієнта (тоді всі агенти потрібно перевстановити), невдале автоматичне оновлення та закінчення терміну дії токена.
- Сканування залишається в статусі Queued: планувати можна лише завдання для агентів у групі агентів Default. Якщо жоден агент не належить до цієї групи, змініть групу агента на Default.
- Помилка подання завдання (0x01610002): сторінка рекомендує додати винятки антивірусу для
microsoft.sharepoint.migration.clientservice.exeіmicrosoft.sharepoint.migration.mthost.exe.
У треді «Cannot scan» одна відповідь перелічувала кроки налаштування агента від Microsoft і питала, чи вражені всі спільні папки або лише деякі. Автоматично згенерована відповідь у тому самому треді радила змінити файл конфігурації агента. Такі відповіді не є доказом, і я не знайшов нічого подібного на сторінках Learn, тому не застосовуйте цю зміну без роз’яснення від Microsoft. Автор написав, що служба підтримки повідомила йому про відому проблему, над якою працюють. Співробітники Microsoft у треді це не підтвердили. Якщо ваші симптоми збігаються, звертайтеся до підтримки раніше.
Крок 5: вхід агента за сертифікатом
У треді про сертифікат немає підтвердженого виправлення. Модератор від Microsoft вказав на відсутній або неповний файл конфігурації сертифіката як причину token_not_found і попросив перевірити дозволи застосунку. Автор відповів, що файл перевіряв і агент перевстановлював багато разів. Потім модератор запропонував перевірки кінцевих точок і надання застосунку дозволу Read для адміністративного сайту, а автор повідомив, що тести кінцевих точок пройдені, але проблема залишилася. В останньому коментарі модератор порадив звернутися до Microsoft Service Hub, якщо проблема не зникне. Жодна відповідь не підтверджує виправлення. Я не зміг підтвердити формат файлу чи дозволів на сторінках Learn, які переглянув, тож скористайтеся офіційною сторінкою налаштування Migration Manager для автентифікації за сертифікатом і не покладайтеся на тред.
Крок 6: зберіть докази
Learn вказує такі розташування журналів Migration Manager: %AppData%\Microsoft\SPMigration\Logs для невдалих завдань і папка Migration\MigrationTool[tenant_site] всередині %AppData%\Microsoft\SPMigration\Logs для звіту про завершене завдання (або всередині вашої власної робочої папки). Відсортуйте підпапки за часом зміни та відкрийте ту, що найближча до початку завдання. На сторінці SPMT її власні папки журналів не перелічено, тому відкрийте звіт про невдале завдання в інструменті (як радить одна відповідь). Запишіть першу невдалу позицію, код помилки, ідентифікатор кореляції та час в UTC, а також додайте URL цільового сайту.
Обмеження та відкриті питання
- Лише питання з кінцевими точками має позначене рішення, але й там автор не написав жодного підтвердження.
- Треди про брак місця на диску, «Cannot scan» і сертифікат не вирішені. Ставтеся до кроків для них як до контрольного списку для звуження проблеми.
- На сторінці з передумовами Migration Manager видима дата оновлення — липень 2025 року. Порівняйте її з тим, що сьогодні вимагає портал.
Пов’язане
Джерела
- Microsoft Learn: вимоги до SPMT та необхідні кінцеві точки
- Microsoft Learn: усунення поширених проблем SPMT
- Microsoft Learn: вимоги до Migration Manager та кінцеві точки
- Microsoft Learn: усунення несправностей міграції файлів у Migration Manager
- Microsoft Community Hub: проблема з SharePoint Migration Tool (серпень 2026)
- Microsoft Community Hub: допомога щодо помилки SPMT (серпень 2026)
- Microsoft Q&A: Microsoft 365 Migration – Cannot Scan (жовтень 2026)
- Microsoft Q&A: Migration Manager (Certificate Authentication) Add Source Path greyed out (листопад 2025)