M365Con 2027 – conferenza online gratuita · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Errori di SPMT e Migration Manager: checklist su endpoint, spazio su disco e scansione

By ·

SPMT segnala spazio su disco insufficiente oppure l'agente di Migration Manager indica Connected ma non riesce a eseguire la scansione? Controlla in quest'ordine gli endpoint richiesti, la cartella di lavoro locale, lo storage di destinazione e le impostazioni dell'agente.

Automatically translated with AI from the original post. Read the English original

Una migrazione da file share o da SharePoint locale può funzionare bene per settimane. Poi una libreria segnala un errore di spazio su disco, un firewall blocca un endpoint oppure l'agente di Migration Manager resta su «Connected» e rifiuta di eseguire la scansione. Quattro thread della community Microsoft, tra la fine del 2025 e la fine del 2026, descrivono questi casi. Solo uno di essi ha una risposta contrassegnata come soluzione, quindi questo articolo li combina con le pagine attuali di Learn. Si tratta di una guida alla risoluzione dei problemi, non di una procedura ufficiale Microsoft.

Punti chiave

  • Consenti l'elenco completo degli endpoint di Microsoft Learn, incluso api.office.com per SPMT e gli endpoint di scansione per Migration Manager. Un thread consiglia di farlo usando il nome host e non l'indirizzo IP.
  • Un firewall che rifiuta una voce contenente https:// potrebbe aver bisogno solo del nome host in un oggetto FQDN, come riportato in un thread che lo ha indicato come soluzione.
  • Gli errori di spazio su disco di SPMT documentati da Learn riguardano la cartella di lavoro locale: controlla quindi per prima cosa lo spazio libero sul computer di migrazione, poi lo storage del sito di destinazione.
  • «Cannot scan» con un agente connesso non aveva una correzione confermata nei thread. Un utente aveva un caso di supporto che Microsoft ha trattato come problema noto.
  • Tieni pronti il report dell'errore, il codice di errore esatto e l'ora (UTC), perché la maggior parte dei thread si è conclusa con «apri un caso di supporto».

Come si presentano i sintomi

  • Endpoint: il firewall di un computer SPMT rifiuta https://api.office.com come voce non valida. Chi ha aperto il thread aveva letto che l'API era stata dismessa, ma la pagina dei prerequisiti di SPMT la elenca ancora (agosto 2026).
  • Spazio su disco: una migrazione da SharePoint 2019 a SharePoint Online non riesce per due librerie, con i messaggi «There isn't enough disk space in the target site collection» e «Not all the items in the package have been migrated». Chi ha scritto afferma che la destinazione ha spazio più che sufficiente (agosto 2026).
  • Cannot scan: un agente di Migration Manager mostra Connected ma «Cannot scan». Le migrazioni funzionavano fino a metà settembre. Reinstallare l'agente non ha risolto nulla e l'utente ha visto richieste SSL non riuscite verso gli endpoint di migrazione Microsoft (ottobre 2026).
  • Accesso con certificato: dopo aver reinstallato l'agente con autenticazione basata su certificato, Add Source Path nella scheda di scansione è disattivato e il log dell'agente ripete token_not_found (novembre 2025).

Passo 1: controlla gli endpoint

Learn elenca gli endpoint per entrambi gli strumenti come URL HTTPS. Per Migration Manager, la documentazione indica che l'agente invia richieste a questi endpoint e riceve risposte, che gli endpoint non possono mai chiamare Migration Manager e che l'agente non apre una porta per le connessioni remote.

Per SPMT, la pagina dei prerequisiti di Learn elenca, tra gli altri:

  • Autenticazione: login.microsoftonline.com, login.windows.net, aadcdn.msftauth.net, aadcdn.msauth.net, secure.aadcdn.microsoftonline-p.com
  • API di spostamento e convalida dei contenuti: api.office.com e graph.windows.net
  • Code e archiviazione di Azure per la migrazione: .queue.core.windows.net e .blob.core.windows.net
  • Destinazione: *.sharepoint.com
  • Graph per le informazioni su tenant e siti: graph.microsoft.com

Per Migration Manager, la pagina dei prerequisiti di Learn aggiunge gli endpoint relativi alla scansione, ad esempio api.mmp.svc.cloud.microsoft, odyssey.mmp.svc.cloud.microsoft, odyssey.prod.migrations.microsoft.com e diversi host SignalR. api.prod.migrations.microsoft.com è indicato in quella pagina come requisito per l'interfaccia web di Migration Manager. Copia sempre l'elenco aggiornato dalla pagina, perché cambia nel tempo. L'introduzione della pagina cita anche production.odyssey.ops.mover.io per le connessioni SignalR, ma questo host non compare nella sua tabella: per trovarlo leggi il testo che circonda la tabella.

La risposta contrassegnata come soluzione nel thread su api.office.com offre questo consiglio:

  1. Non considerare il rifiuto da parte del firewall come prova che l'endpoint non sia necessario.
  2. Consenti il nome host sulla porta TCP 443 dal computer di migrazione e usa regole basate su DNS, non indirizzi IP. Questo è il consiglio del thread. Learn non indica alcuna porta.
  3. Se il campo del firewall rifiuta la voce, inserisci solo il nome host in un oggetto FQDN. Il prefisso https:// potrebbe essere ciò che il campo non accetta. Questa parte è un consiglio del thread, non di Learn.
  4. Verifica la risoluzione dei nomi e una connessione TLS in uscita dal computer di migrazione, quindi esegui di nuovo la scansione.

Un test rapido dal computer di migrazione:

``powershell Test-NetConnection api.office.com -Port 443 Test-NetConnection odyssey.prod.migrations.microsoft.com -Port 443 ``

Un carattere jolly come *.blob.core.windows.net non può essere testato così com'è. Testa invece un nome host reale del tuo tenant. Una risposta nel thread "Cannot scan" suggerisce anche di escludere proxy, firewall, ispezione SSL o modifiche ai certificati tra l'agente e questi host. Non ho trovato menzioni di ispezione SSL nelle due pagine dei prerequisiti, quindi tratta questo punto come un suggerimento della community.

Passaggio 2: verifica lo spazio libero sul computer di migrazione

Per SPMT, la pagina di risoluzione dei problemi di Learn documenta questi errori:

  • "Scan File Failure: Not enough disk space to pack the file": lo spazio su disco per la cartella di lavoro della migrazione è insufficiente per le dimensioni del file di origine. Aumenta lo spazio della cartella di lavoro e riprova.
  • Errore 0x02040012: lo spazio di archiviazione temporaneo sul computer locale è insufficiente, perché SPMT inserisce nella cache il pacchetto nella cartella di lavoro. Amplia lo spazio di archiviazione temporaneo e riprova.

Learn consiglia 150 GB di spazio di archiviazione locale libero per il computer che esegue SPMT, sia nel profilo hardware consigliato sia in quello minimo. Controlla l'unità di sistema e l'unità che contiene la cartella di lavoro. La cartella di lavoro %appdata%\Microsoft\MigrationToolStorage è citata nella pagina di risoluzione dei problemi, e diversi errori indicati lì richiedono che i suoi file e le sue cartelle restino chiusi durante una migrazione.

Nel thread su SharePoint 2019, una risposta di un membro della community con il titolo di MVP sosteneva che il messaggio punta molto probabilmente all'archiviazione temporanea locale, non ai limiti di SharePoint Online. La pagina di Learn elenca gli errori locali sopra riportati e non riporta la formulazione esatta "target site collection". Quindi il controllo locale è il primo passo meglio supportato.

Passaggio 3: verifica lo spazio di archiviazione del sito di destinazione e del tenant

Un'altra risposta nello stesso thread indicava che il secondo messaggio, "Not all the items in the package have been migrated", è probabilmente un effetto collaterale del primo errore. Suggeriva di controllare il limite di archiviazione del sito di destinazione (nell'interfaccia di amministrazione di SharePoint, in Siti attivi), lo spazio di archiviazione totale del tenant e il contenuto delle versioni precedenti e del Cestino. Quella risposta e l'altra non sono state contrassegnate come soluzione, e chi ha pubblicato la domanda non ha riportato alcun risultato.

Se la destinazione è piena, tieni presente quanto dice Learn sull'archiviazione: i report sull'utilizzo possono essere in ritardo fino a 48 ore e, in modalità di archiviazione manuale, ogni sito ha un proprio limite.

Per la parte "non tutti gli elementi sono stati migrati", la pagina di risoluzione dei problemi di Learn riporta l'errore 0x01710009 due volte: una prima con il testo "Errors or time-out for Server Processing the file: Not all the items in the package are migrated", e una seconda come errore dovuto a errori di fine processo, in cui alcuni elementi del pacchetto non sono riusciti, con il consiglio di riavviare la migrazione. Per le dipendenze mancanti sugli elementi di elenco (errore 0x01410010), controlla FailureSummaryReport.csv e assicurati che le dipendenze siano incluse nell'ambito della migrazione. Il thread suggerisce anche di riprovare una libreria non riuscita in batch più piccoli, e poi di eseguire una migrazione incrementale per recuperare gli elementi mancanti. Si tratta di un suggerimento della community, non di un passaggio ufficiale di Learn.

Passaggio 4: verifica l'agente di Migration Manager

La pagina di risoluzione dei problemi di Migration Manager di Learn descrive alcuni casi di agente diversi da "Cannot scan" ma che gli somigliano:

  • Agente disconnesso: le cause possibili includono lo stato della rete del computer dell'agente, una modifica della password o un'altra modifica critica dell'account amministratore del tenant (in tal caso tutti gli agenti devono essere reinstallati), un aggiornamento automatico non riuscito e la scadenza del token.
  • La scansione resta in stato Accodata: possono essere pianificati solo gli agenti nel gruppo di agenti Default. Se nessun agente si trova in quel gruppo, sposta l'agente nel gruppo Default.
  • Impossibile inviare un processo (0x01610002): la pagina consiglia di aggiungere eccezioni antivirus per microsoft.sharepoint.migration.clientservice.exe e microsoft.sharepoint.migration.mthost.exe.

Nel thread "Cannot scan", una risposta elencava i passaggi di configurazione dell'agente forniti da Microsoft e chiedeva se fossero interessate tutte le condivisioni o solo alcune. Una risposta generata automaticamente nello stesso thread suggeriva di modificare un file di configurazione dell'agente. Risposte di questo tipo non costituiscono una prova, e nelle pagine di Learn non ho trovato nulla di simile: non applicare quella modifica senza una conferma da parte di Microsoft. Chi ha aperto il thread ha scritto che un ingegnere del supporto gli aveva detto che si tratta di un problema noto su cui si sta lavorando. Nel thread, però, il personale Microsoft non ha confermato la cosa. Se i sintomi corrispondono, apri subito una richiesta di supporto.

Passaggio 5: accesso dell'agente tramite certificato

Il thread sul certificato non riporta una soluzione confermata. Un moderatore del personale Microsoft ha indicato come causa di token_not_found un file di configurazione del certificato mancante o incompleto, e ha chiesto di verificare le autorizzazioni dell'app. Chi ha aperto il thread ha risposto che il file era stato controllato e l'agente reinstallato più volte. Il moderatore ha poi suggerito verifiche sugli endpoint e di concedere all'app l'autorizzazione Lettura sul sito di amministrazione; chi ha aperto il thread ha riferito che i test sugli endpoint sono riusciti e che il problema persiste. L'ultimo commento del moderatore suggerisce di rivolgersi a Microsoft Service Hub se il problema rimane. Nessuna risposta conferma una soluzione. Nelle pagine di Learn che ho letto non ho trovato conferma del formato del file né delle autorizzazioni, quindi usa la pagina ufficiale di configurazione di Migration Manager per l'autenticazione tramite certificato e non affidarti al thread.

Passaggio 6: raccogli le prove

Learn indica questi percorsi di log per Migration Manager: %AppData%\Microsoft\SPMigration\Logs per le attività non riuscite, e la cartella Migration\MigrationTool[tenant_site] all'interno di %AppData%\Microsoft\SPMigration\Logs per il report di un'attività completata (oppure all'interno della cartella di lavoro personalizzata). Ordina le sottocartelle per data di modifica e apri quella più vicina all'avvio dell'attività. La pagina di SPMT non elenca le proprie cartelle di log, quindi apri il report dell'attività non riuscita direttamente nello strumento (come suggerisce una risposta nel thread). Annota il primo elemento non riuscito, il codice di errore, l'ID di correlazione e l'ora in UTC, e aggiungi l'URL del sito di destinazione.

Limiti e punti aperti

  • Solo la domanda sugli endpoint ha una soluzione indicata, e anche in quel caso chi ha aperto il thread non ha scritto alcuna conferma.
  • I thread su spazio su disco, "Cannot scan" e certificato sono irrisolti. Considera i passaggi relativi a questi casi come una checklist per restringere il problema.
  • La pagina dei prerequisiti di Migration Manager riporta una data di aggiornamento visibile di luglio 2025. Confrontala con quanto richiede oggi il portale.

Correlati

Fonti

Segui il podcastSpotify

Entities in this article

SharePoint SharePoint migration Tenant-to-tenant migration

Related articles

RSS