Błędy SPMT i Migration Manager: lista kontrolna dotycząca punktów końcowych, miejsca na dysku i skanowania
By Mirko Peters ·
SPMT zgłasza brak miejsca na dysku albo agent Migration Manager pokazuje status Connected, ale nie może skanować? Sprawdź wymagane punkty końcowe, lokalny folder roboczy, magazyn docelowy i ustawienia agenta w tej kolejności.
Automatically translated with AI from the original post. Read the English original
Udostępnianie plików lub migracja z lokalnego SharePoint zwykle działa przez tygodnie. Potem biblioteka kończy się błędem dotyczącym miejsca na dysku, zapora odrzuca punkt końcowy, albo agent Migration Manager pozostaje w stanie „Connected” i odmawia skanowania. Cztery wątki społeczności Microsoft z okresu od końca 2025 do końca 2026 roku opisują te przypadki. Tylko jeden z nich ma odpowiedź oznaczoną jako rozwiązanie, dlatego ten artykuł łączy je z aktualnymi stronami Learn. To przewodnik po rozwiązywaniu problemów, a nie oficjalna procedura Microsoft.
Najważniejsze wnioski
- Zezwól na pełne listy punktów końcowych z Microsoft Learn, w tym api.office.com dla SPMT oraz punkty końcowe skanowania dla Migration Manager. Jeden z wątków zaleca robienie tego według nazwy hosta, a nie adresu IP.
- Zapora, która odrzuca wpis zawierający https://, może wymagać samej nazwy hosta w obiekcie FQDN, jak podano w wątku, w którym oznaczono to jako rozwiązanie.
- Błędy miejsca na dysku w SPMT, udokumentowane przez Learn, wskazują na lokalny folder roboczy, dlatego najpierw sprawdź wolne miejsce na komputerze wykonującym migrację, a następnie magazyn witryny docelowej.
- Komunikat „Cannot scan” przy połączonym agencie nie miał w wątkach potwierdzonej poprawki. Jeden z autorów miał zgłoszenie do pomocy technicznej, które Microsoft uznał za znany problem.
- Przygotuj raport o błędzie, dokładny kod błędu i czas (UTC), ponieważ większość wątków kończyła się zaleceniem „otwórz zgłoszenie do pomocy technicznej”.
Jak wyglądają objawy
- Punkt końcowy: Zapora komputera SPMT odrzuca
https://api.office.comjako nieprawidłowy wpis. Autor przeczytał, że interfejs API jest wycofany, a mimo to strona z wymaganiami wstępnymi SPMT nadal go wymienia (sierpień 2026). - Miejsce na dysku: Migracja z SharePoint 2019 do SharePoint Online kończy się błędem dla dwóch bibliotek, z komunikatami „There isn't enough disk space in the target site collection” oraz „Not all the items in the package have been migrated”. Autor twierdzi, że w miejscu docelowym jest dużo wolnego miejsca (sierpień 2026).
- Cannot scan: Agent Migration Manager pokazuje status Connected oraz „Cannot scan”. Migracje działały do połowy września. Ponowna instalacja agenta nie pomogła, a autor zauważył nieudane żądania SSL do punktów końcowych migracji Microsoft (październik 2026).
- Logowanie certyfikatem: Po ponownej instalacji agenta z uwierzytelnianiem opartym na certyfikatach przycisk Add Source Path na karcie skanowania jest wyszarzony, a dziennik agenta stale powtarza
token_not_found(listopad 2025).
Krok 1: Sprawdź punkty końcowe
Learn wymienia punkty końcowe obu narzędzi jako adresy URL HTTPS. W przypadku Migration Manager Learn podaje, że agent wysyła żądania do tych punktów końcowych i odbiera odpowiedzi, że punkty końcowe nigdy nie mogą wywoływać Migration Managera oraz że agent nie otwiera portu do zdalnych połączeń.
W przypadku SPMT na stronie wymagań wstępnych w Learn wymieniono m.in.:
- Uwierzytelnianie:
login.microsoftonline.com,login.windows.net,aadcdn.msftauth.net,aadcdn.msauth.net,secure.aadcdn.microsoftonline-p.com - Interfejsy API przenoszenia i weryfikacji zawartości:
api.office.comorazgraph.windows.net - Kolejki migracji i magazyn w Azure:
.queue.core.windows.netoraz.blob.core.windows.net - Miejsce docelowe:
*.sharepoint.com - Graph dla informacji o dzierżawie i witrynach:
graph.microsoft.com
W przypadku Migration Managera strona wymagań wstępnych w Learn dodaje punkty końcowe związane ze skanowaniem, na przykład api.mmp.svc.cloud.microsoft, odyssey.mmp.svc.cloud.microsoft, odyssey.prod.migrations.microsoft.com oraz kilka hostów SignalR. api.prod.migrations.microsoft.com jest tam wymieniony jako wymaganie dla interfejsu webowego Migration Managera. Zawsze kopiuj aktualną listę ze strony, ponieważ się zmienia. We wstępie strony wymieniono także production.odyssey.ops.mover.io dla połączeń SignalR, a tego hosta nie ma w jej tabeli, więc przeczytaj tekst wokół tabeli.
Odpowiedź oznaczona jako rozwiązanie w wątku dotyczącym api.office.com zawiera następującą radę:
- Nie traktuj odrzucenia przez zaporę jako dowodu, że punkt końcowy jest niepotrzebny.
- Zezwól na nazwę hosta przez TCP 443 z komputera migracyjnego i używaj reguł opartych na DNS, a nie na adresach IP. To jest rada z wątku. Learn nie podaje portu.
- Jeśli pole zapory odrzuca wpis, wprowadź samą nazwę hosta w obiekcie FQDN. Prefiks
https://może być tym, co pole odrzuca. Ta część to rada z wątku, a nie z Learn. - Sprawdź rozpoznawanie nazw oraz wychodzące połączenie TLS z komputera migracyjnego, a następnie uruchom skanowanie ponownie.
Szybki test z komputera migracyjnego:
``powershell Test-NetConnection api.office.com -Port 443 Test-NetConnection odyssey.prod.migrations.microsoft.com -Port 443 ``
Symbolu wieloznacznego, takiego jak *.blob.core.windows.net, nie da się przetestować w takiej postaci. Zamiast tego przetestuj rzeczywistą nazwę hosta z Twojej dzierżawy. Odpowiedź w wątku „Cannot scan” sugeruje też wykluczenie serwera proxy, zapory, inspekcji SSL lub zmian certyfikatów między agentem a tymi hostami. Na obu stronach wymagań wstępnych nie znalazłem wzmianki o inspekcji SSL, więc traktuj ten punkt jako sugestię społeczności.
Krok 2: Sprawdź wolne miejsce na komputerze migracyjnym
W przypadku SPMT strona rozwiązywania problemów w Learn dokumentuje następujące błędy:
- „Scan File Failure: Not enough disk space to pack the file”: miejsce na dysku dla folderu roboczego migracji jest zbyt małe w stosunku do rozmiaru pliku źródłowego. Powiększ folder roboczy i spróbuj ponownie.
- Błąd 0x02040012: tymczasowa pamięć masowa na komputerze lokalnym jest zbyt mała, ponieważ SPMT buforuje pakiet w folderze roboczym. Zwiększ tymczasową pamięć masową i ponów próbę.
Learn zaleca 150 GB wolnego miejsca lokalnego dla komputera uruchamiającego SPMT, zarówno w zalecanym, jak i w minimalnym profilu sprzętowym. Sprawdź dysk systemowy oraz dysk, na którym znajduje się folder roboczy. Folder roboczy %appdata%\Microsoft\MigrationToolStorage jest wspomniany na stronie rozwiązywania problemów, a kilka opisanych tam błędów mówi, że jego pliki i foldery muszą pozostać zamknięte podczas migracji.
W wątku o SharePoint 2019 odpowiedź członka społeczności z tytułem MVP stwierdziła, że komunikat najprawdopodobniej wskazuje na lokalną pamięć tymczasową, a nie na limity SharePoint Online. Strona Learn wymienia wyżej opisane lokalne błędy i nie zawiera dokładnego brzmienia „target site collection”. Lokalne sprawdzenie jest zatem najlepiej uzasadnionym pierwszym krokiem.
Krok 3: Sprawdź witrynę docelową i magazyn dzierżawy
Inna odpowiedź w tym samym wątku stwierdziła, że drugi komunikat, „Not all the items in the package have been migrated”, jest prawdopodobnie efektem ubocznym pierwszego błędu. Zasugerowano sprawdzenie limitu magazynu witryny docelowej (w centrum administracyjnym SharePoint, w sekcji Aktywne witryny), łącznego magazynu dzierżawy oraz starych wersji i zawartości kosza. Ani ta odpowiedź, ani druga nie zostały oznaczone jako rozwiązanie, a autor wątku nie podał wyniku.
Jeśli miejsce docelowe jest pełne, pamiętaj o tym, co Learn pisze o magazynie: raporty wykorzystania mogą opóźniać się nawet o 48 godzin, a w trybie magazynowania Manual każda witryna ma własny limit.
Co do części „not all items migrated”: strona Learn z rozwiązywaniem problemów wymienia błąd 0x01710009 dwukrotnie. Raz z tekstem „Errors or time-out for Server Processing the file: Not all the items in the package are migrated”, a raz jako błąd wynikający z niepowodzeń zakończenia zadania, gdy w pakiecie nie powiodły się niektóre elementy, wraz ze wskazówką, aby uruchomić migrację ponownie. W przypadku brakujących zależności elementów listy (błąd 0x01410010) sprawdź plik FailureSummaryReport.csv i upewnij się, że zależności mieszczą się w zakresie migracji. Wątek sugeruje też ponowienie jednej nieudanej biblioteki w mniejszych partiach, a następnie uruchomienie migracji przyrostowej, aby wychwycić brakujące elementy. To sugestia społeczności, a nie krok z dokumentacji Learn.
Krok 4: sprawdź agenta Migration Manager
Strona Learn dotycząca rozwiązywania problemów z Migration Manager opisuje kilka przypadków agenta, które nie są błędem „Cannot scan”, ale mogą wyglądać podobnie:
- Agent rozłączony: możliwe przyczyny to stan sieci na komputerze agenta, zmiana hasła lub podobna krytyczna zmiana na koncie administratora dzierżawy (wówczas wszystkich agentów trzeba zainstalować ponownie), nieudana automatyczna aktualizacja oraz wygaśnięcie tokenu.
- Skanowanie pozostaje w stanie Queued: do harmonogramu mogą trafiać wyłącznie agenci z grupy agentów Default. Jeśli żaden agent nie należy do tej grupy, zmień grupę agenta na Default.
- Niepowodzenie przesłania zadania (0x01610002): strona zaleca wyjątki dla programu antywirusowego w odniesieniu do plików
microsoft.sharepoint.migration.clientservice.exeimicrosoft.sharepoint.migration.mthost.exe.
W wątku „Cannot scan” jedna odpowiedź wymieniała kroki konfiguracji agenta według dokumentacji Microsoft i pytała, czy dotyczy to wszystkich udziałów, czy tylko niektórych. Automatycznie wygenerowana odpowiedź w tym samym wątku sugerowała edycję pliku konfiguracyjnego agenta. Takie odpowiedzi nie są dowodem i nie znalazłem niczego podobnego na stronach Learn, dlatego nie stosuj tej zmiany bez oświadczenia firmy Microsoft. Autor pytania napisał, że pracownik pomocy technicznej poinformował go o znanym problemie, nad którym trwają prace. Pracownicy Microsoft nie potwierdzili tego w wątku. Jeśli Twoje objawy są podobne, zgłoś sprawę do pomocy technicznej jak najwcześniej.
Krok 5: logowanie agenta certyfikatem
Wątek o certyfikatach nie zawiera potwierdzonego rozwiązania. Moderator z ramienia Microsoft wskazał brakujący lub niekompletny plik konfiguracji certyfikatu jako przyczynę błędu token_not_found i poprosił o sprawdzenie uprawnień aplikacji. Autor pytania odpowiedział, że plik został sprawdzony, a agent był wielokrotnie instalowany ponownie. Moderator zasugerował następnie testy punktów końcowych oraz przyznanie aplikacji uprawnienia Read do witryny administracyjnej. Autor zgłosił, że testy punktów końcowych zakończyły się powodzeniem, a problem pozostał. Ostatni komentarz moderatora sugerował, aby w razie dalszych problemów skorzystać z Microsoft Service Hub. Żadna odpowiedź nie potwierdza poprawki. Nie udało mi się potwierdzić formatu pliku ani uprawnień na przeczytanych stronach Learn, dlatego skorzystaj z oficjalnej strony konfiguracji Migration Manager dotyczącej uwierzytelniania certyfikatem i nie opieraj się na tym wątku.
Krok 6: zbierz dowody
Learn podaje następujące lokalizacje dzienników Migration Manager: %AppData%\Microsoft\SPMigration\Logs dla zadań zakończonych niepowodzeniem oraz folder Migration\MigrationTool[tenant_site] w katalogu %AppData%\Microsoft\SPMigration\Logs dla raportu zadania zakończonego (lub w Twoim niestandardowym folderze roboczym). Posortuj podfoldery według czasu modyfikacji i otwórz ten, który jest najbliżej momentu rozpoczęcia zadania. Strona SPMT nie wymienia własnych folderów dziennika, dlatego otwórz raport nieudanego zadania bezpośrednio w narzędziu (jak sugeruje jedna z odpowiedzi). Zanotuj pierwszy nieudany element, kod błędu, identyfikator korelacji oraz czas w UTC, a także adres URL witryny docelowej.
Ograniczenia i otwarte kwestie
- Tylko pytanie o punkty końcowe ma oznaczone rozwiązanie, a nawet tam autor nie napisał potwierdzenia.
- Wątki dotyczące miejsca na dysku, „Cannot scan” i certyfikatów pozostają nierozwiązane. Traktuj opisane dla nich kroki jako listę kontrolną pomagającą zawęzić problem.
- Strona wymagań wstępnych Migration Manager pokazuje widoczną datę aktualizacji: lipiec 2025. Porównaj ją z tym, czego portal wymaga obecnie.
Powiązane
Źródła
- Microsoft Learn: wymagania wstępne SPMT i wymagane punkty końcowe
- Microsoft Learn: Rozwiązywanie typowych problemów z SPMT
- Microsoft Learn: wymagania wstępne Migration Manager i punkty końcowe
- Microsoft Learn: Rozwiązywanie problemów z migracją plików w Migration Manager
- Microsoft Community Hub: problem z narzędziem SharePoint Migration Tool (sierpień 2026)
- Microsoft Community Hub: pomoc w błędzie SPMT (sierpień 2026)
- Microsoft Q&A: Microsoft 365 Migration - Cannot Scan (październik 2026)
- Microsoft Q&A: Migration Manager (Certificate Authentication) Add Source Path greyed out (listopad 2025)