Fouten in SPMT en Migration Manager: een checklist voor endpoints, schijfruimte en scans
By Mirko Peters ·
Meldt SPMT te weinig schijfruimte, of zegt de Migration Manager-agent Connected maar kan hij niet scannen? Controleer de vereiste endpoints, de lokale werkmap, de doelopslag en de agentinstellingen in deze volgorde.
Automatically translated with AI from the original post. Read the English original
Een migratie van een bestandsshare of van on-premises SharePoint verloopt weken goed. Dan faalt ineens een bibliotheek met een melding over schijfruimte, weigert een firewall een endpoint, of blijft de Migration Manager-agent op "Connected" staan en weigert hij te scannen. Vier communitythreads van eind 2025 tot eind 2026 laten deze gevallen zien. Slechts één daarvan heeft een antwoord dat als oplossing is aangemerkt. Daarom combineert dit artikel die threads met de huidige Learn-pagina's. Het is een gids voor probleemoplossing, geen officiële procedure van Microsoft.
Belangrijkste punten
- Sta de volledige endpointlijsten van Microsoft Learn toe, inclusief api.office.com voor SPMT en de scanendpoints voor Migration Manager. Een thread adviseert dit op basis van hostnamen te doen en niet via IP-adressen.
- Een firewall die een invoer met https:// erin afwijst, heeft mogelijk alleen de hostnaam nodig in een FQDN-object. Dat meldde een thread die dit als oplossing heeft aangemerkt.
- SPMT-fouten over schijfruimte die Learn beschrijft, wijzen naar de lokale werkmap. Controleer daarom eerst de vrije ruimte op de migratiecomputer en daarna de opslag van de doelsite.
- 'Cannot scan' bij een verbonden agent had in de threads geen bevestigde oplossing. Eén vragensteller had een supportcase die Microsoft als bekend probleem behandelde.
- Houd het foutrapport, de exacte foutcode en het tijdstip (UTC) bij de hand, want de meeste threads eindigden met 'open een supportcase'.
Hoe de symptomen eruitzien
- Endpoint: De firewall van een SPMT-computer wijst
https://api.office.comaf als ongeldige invoer. De vragensteller had gelezen dat de API is uitgefaseerd, maar de voorvereistenpagina van SPMT vermeldt hem nog steeds (augustus 2026). - Schijfruimte: Een migratie van SharePoint 2019 naar SharePoint Online faalt voor twee bibliotheken met "There isn't enough disk space in the target site collection" en "Not all the items in the package have been migrated". De vragensteller zegt dat de doellocatie voldoende ruimte heeft (augustus 2026).
- Cannot scan: Een Migration Manager-agent toont Connected maar "Cannot scan". Migraties werkten tot half september. Opnieuw installeren van de agent hielp niet, en de vragensteller zag mislukte SSL-aanvragen naar de Microsoft-migratieendpoints (oktober 2026).
- Aanmelden met certificaat: Na het opnieuw installeren van de agent met certificaatgebaseerde authenticatie is Add Source Path op het tabblad scan grijs en herhaalt het agentlogboek
token_not_found(november 2025).
Stap 1: Controleer de endpoints
Learn somt de endpoints voor beide tools op als HTTPS-URL's. Voor Migration Manager staat dat de agent verzoeken naar deze endpoints stuurt en antwoorden ontvangt, dat de endpoints nooit Migration Manager kunnen aanroepen, en dat de agent geen poort opent voor externe verbindingen.
Op de voorbereidingspagina van Learn voor SPMT staan onder andere:
- Verificatie:
login.microsoftonline.com,login.windows.net,aadcdn.msftauth.net,aadcdn.msauth.net,secure.aadcdn.microsoftonline-p.com - API's voor het verplaatsen van inhoud en validatie:
api.office.comengraph.windows.net - Azure-migratiewachtrijen en -opslag:
.queue.core.windows.neten.blob.core.windows.net - Bestemming:
*.sharepoint.com - Graph voor informatie over tenant en sites:
graph.microsoft.com
Voor Migration Manager voegt de voorbereidingspagina van Learn scan-gerelateerde endpoints toe, bijvoorbeeld api.mmp.svc.cloud.microsoft, odyssey.mmp.svc.cloud.microsoft, odyssey.prod.migrations.microsoft.com en verschillende SignalR-hosts. api.prod.migrations.microsoft.com staat daar vermeld als vereiste voor de webinterface van Migration Manager. Neem de actuele lijst altijd over van de pagina, want die verandert. De inleiding van de pagina noemt ook production.odyssey.ops.mover.io voor SignalR-verbindingen, en die host staat niet in de tabel. Lees dus ook de tekst rond de tabel.
Het antwoord dat in de thread over api.office.com als oplossing is aangemerkt, geeft dit advies:
- Behandel de weigering door de firewall niet als bewijs dat het endpoint niet nodig is.
- Sta de hostnaam toe op TCP 443 vanaf de migratiecomputer, en gebruik op DNS gebaseerde regels in plaats van IP-adressen. Dit is het advies uit de thread. Learn noemt geen poort.
- Als het firewallveld de invoer weigert, voer dan alleen de hostnaam in als FQDN-object. Mogelijk weigert het veld het voorvoegsel
https://. Dit deel is advies uit de thread, niet van Learn. - Test de naamresolutie en een uitgaande TLS-verbinding vanaf de migratiecomputer, en voer daarna de scan opnieuw uit.
Een snelle test vanaf de migratiecomputer:
``powershell Test-NetConnection api.office.com -Port 443 Test-NetConnection odyssey.prod.migrations.microsoft.com -Port 443 ``
Een wildcard zoals *.blob.core.windows.net kun je zo niet testen. Test in plaats daarvan een echte hostnaam uit je eigen tenant. Een antwoord in de thread "Cannot scan" vraagt ook om proxy, firewall, SSL-inspectie of certificaatwijzigingen tussen de agent en deze hosts uit te sluiten. Ik heb SSL-inspectie niet genoemd gezien op de twee voorbereidingspagina's, dus behandel dit punt als suggestie uit de community.
Stap 2: Controleer de vrije ruimte op de migratiecomputer
Voor SPMT documenteert de probleemoplossingspagina van Learn deze fouten:
- "Scan File Failure: Not enough disk space to pack the file": de schijfruimte voor de werkmap van de migratie is te klein voor de grootte van het bronbestand. Vergroot de werkmap en probeer het opnieuw.
- Fout 0x02040012: de tijdelijke opslag op de lokale computer is te laag, omdat SPMT het pakket in de werkmap opslaat. Vergroot de tijdelijke opslag en probeer het opnieuw.
Learn adviseert 150 GB vrije lokale opslag voor de computer waarop SPMT draait, zowel in het aanbevolen als in het minimale hardwareprofiel. Controleer de systeemschijf en de schijf van je werkmap. De werkmap %appdata%\Microsoft\MigrationToolStorage wordt genoemd op de probleemoplossingspagina, en meerdere fouten daar stellen dat de bestanden en mappen daarin tijdens een migratie gesloten moeten blijven.
In de SharePoint 2019-thread wees een antwoord van een communitylid met een MVP-titel erop dat de melding waarschijnlijk duidt op tijdelijke lokale opslag en niet op limieten van SharePoint Online. De Learn-pagina somt de hierboven genoemde lokale fouten op, en noemt de exacte formulering "target site collection" niet. De lokale controle is dus de best onderbouwde eerste stap.
Stap 3: Controleer de doelsite en de opslag van de tenant
Een ander antwoord in dezelfde thread stelde dat de tweede melding, "Not all the items in the package have been migrated", waarschijnlijk een neveneffect is van de eerste fout. Er werd voorgesteld de opslaglimiet van de doelsite te controleren (in het SharePoint-beheercentrum onder Actieve sites), de totale opslag van de tenant, en oude versies en inhoud van de prullenbak. Dat antwoord en het andere antwoord zijn niet als oplossing aangemerkt, en de plaatser heeft geen resultaat gemeld.
Als het doel vol is, houd dan rekening met wat Learn zegt over opslag: gebruiksrapporten kunnen tot 48 uur achterlopen, en in de modus Handmatige opslag heeft elke site zijn eigen limiet.
Voor het deel "not all items migrated" vermeldt de Learn-troubleshootingpagina foutcode 0x01710009 twee keer: één keer met de tekst "Errors or time-out for Server Processing the file: Not all the items in the package are migrated", en één keer als fout door taakeindfouten, waarbij sommige items in het pakket zijn mislukt, met het advies de migratie opnieuw te starten. Voor ontbrekende afhankelijkheden op lijstitems (foutcode 0x01410010) controleer je FailureSummaryReport.csv en zorg je dat de afhankelijkheden binnen het migratiebereik vallen. De thread stelt ook voor om één mislukte bibliotheek opnieuw te proberen in kleinere batches, en daarna een incrementele migratie uit te voeren om ontbrekende items op te vangen. Dat is een suggestie uit de community, geen stap van Learn.
Stap 4: Controleer de Migration Manager-agent
De Learn-troubleshootingpagina voor Migration Manager behandelt een paar agentsituaties die niet "Cannot scan" zijn, maar er wel op lijken:
- Agent verbroken: mogelijke oorzaken zijn de netwerkstatus op de agentcomputer, een wachtwoordwijziging of een andere vergelijkbare kritieke wijziging aan het tenantbeheerdersaccount (alle agents moeten dan opnieuw worden geïnstalleerd), een mislukte automatische upgrade en het verlopen van tokens.
- Scan blijft in de wachtrij staan: alleen agents in de agentgroep Default kunnen worden gepland. Als geen enkele agent in die groep zit, wijzig dan de groep van de agent naar Default.
- Taak indienen mislukt (0x01610002): de pagina raadt antivirusuitzonderingen aan voor
microsoft.sharepoint.migration.clientservice.exeenmicrosoft.sharepoint.migration.mthost.exe.
In de thread "Cannot scan" verwees één reactie naar de installatiestappen van de agent van Microsoft en vroeg of alle shares of slechts enkele worden getroffen. Een automatisch gegenereerd antwoord in dezelfde thread stelde voor een configuratiebestand van de agent aan te passen. Zulke antwoorden zijn geen bewijs, en ik heb in de Learn-pagina's niets dergelijks gevonden. Pas die wijziging dus niet toe zonder een verklaring van Microsoft. De vraagsteller schreef dat een supportmedewerker had verteld dat het een bekend probleem is waar aan wordt gewerkt. Microsoft-medewerkers hebben dit in de thread niet bevestigd. Als je symptomen overeenkomen, neem dan vroeg contact op met support.
Stap 5: Certificaataanmelding voor de agent
De certificaatthread heeft geen bevestigde oplossing. Een moderator van Microsoft wees op een ontbrekend of onvolledig certificaatconfiguratiebestand als oorzaak van token_not_found, en vroeg om de app-machtigingen te controleren. De vraagsteller antwoordde dat het bestand was gecontroleerd en dat de agent al vele keren opnieuw was geïnstalleerd. De moderator stelde daarna endpointcontroles voor en het verlenen van Read-rechten voor de app op de beheersite. De vraagsteller meldde dat de endpointtests waren geslaagd en dat het probleem bleef bestaan. De laatste opmerking van de moderator raadde Microsoft Service Hub aan als het probleem blijft bestaan. Geen enkele reactie bevestigt een oplossing. Ik kon het bestandsformaat of de machtigingen niet bevestigen op de Learn-pagina's die ik heb gelezen. Gebruik daarom de officiële installatiepagina van Migration Manager voor certificaatverificatie en vertrouw niet op de thread.
Stap 6: Verzamel bewijsmateriaal
Learn noemt deze logboeklocaties voor Migration Manager: %AppData%\Microsoft\SPMigration\Logs voor mislukte taken, en de map Migration\MigrationTool[tenant_site] onder %AppData%\Microsoft\SPMigration\Logs voor het taakrapport van een voltooide taak (of onder je eigen werkmap). Sorteer de submappen op wijzigingsdatum en open de map die het dichtst bij de starttijd van de taak ligt. De SPMT-pagina somt de eigen logmappen niet op, dus open het rapport van de mislukte taak in de tool (zoals een reactie voorstelt). Noteer het eerste mislukte item, de foutcode, de correlatie-ID en het tijdstip in UTC, en voeg de URL van de doelsite toe.
Beperkingen en open punten
- Alleen de endpointvraag heeft een gemarkeerde oplossing, en ook daar heeft de vraagsteller geen bevestiging geschreven.
- De threads over schijfruimte, "Cannot scan" en certificaten zijn onopgelost. Behandel de stappen daarvoor als een checklist om het probleem te beperken.
- De prerequisitespagina van Migration Manager toont een zichtbare updatedatum van juli 2025. Vergelijk die met wat het portaal vandaag vraagt.
Gerelateerd
Bronnen
- Microsoft Learn: SPMT-vereisten en vereiste eindpunten
- Microsoft Learn: Veelvoorkomende SPMT-problemen oplossen
- Microsoft Learn: Migration Manager-vereisten en eindpunten
- Microsoft Learn: Problemen met bestandsmigraties in Migration Manager oplossen
- Microsoft Community Hub: probleem met SharePoint Migration Tool (augustus 2026)
- Microsoft Community Hub: hulp bij SPMT-fout (augustus 2026)
- Microsoft Q&A: Microsoft 365-migratie – kan niet scannen (oktober 2026)
- Microsoft Q&A: Migration Manager (certificaatverificatie) – Add Source Path grijs weergegeven (november 2025)