Panoramica dello Strumento di valutazione della migrazione di SharePoint

  • Articolo

Lo strumento di valutazione della migrazione di SharePoint è un semplice strumento eseguibile da riga di comando. Analizza il contenuto della farm di SharePoint per identificare l'impatto della migrazione del server a SharePoint con Microsoft 365.

Lo strumento è progettato per l'esecuzione senza influire sull'ambiente, quindi si potrebbe notare che lo strumento richiede da uno a due giorni per completare un'analisi dell'ambiente. Durante questo periodo, lo strumento segnala lo stato nella finestra della console. Al termine dell'analisi, i file di output si trovano nella directory Logs. Qui è possibile trovare il riepilogo e informazioni dettagliate sugli scenari che potrebbero essere interessati dalla migrazione.

Nota

Per scaricare lo strumento di valutazione della migrazione di SharePoint, vedere Scaricare lo strumento di valutazione della migrazione di SharePoint.

Nota

Per migliorare la qualità dei prodotti e dei servizi Microsoft, lo strumento segnala a Microsoft informazioni statistiche anonime. Facoltativamente, è possibile identificare l'organizzazione quando richiesto alla fine dell'analisi. Se lo strumento non è in grado di connettersi a Internet per segnalare queste informazioni, lo strumento funziona comunque come previsto.

Prerequisiti

Lo strumento è progettato per essere eseguito da una farm di SharePoint 2010, 2013 o 2016 e presenta i prerequisiti seguenti:

  • Per eseguire lo strumento, tutti i file devono essere estratti da qualsiasi pacchetto compresso prima dell'esecuzione.

  • Lo strumento deve essere eseguito come account del servizio farm. Un account amministratore della farm è accettabile purché all'account sia stato concesso l'accesso in lettura a tutte le applicazioni Web. L'account richiede anche autorizzazioni esplicite per il controllo completo sia pergli amministratoridelle operazioni> cheper le autorizzazionidi condivisione> nell'applicazione del servizio profili utente. Esistono una serie di controlli per assicurarsi che l'account disponga di autorizzazioni sufficienti prima di analizzare l'ambiente.

  • Lo strumento supporta solo le versioni in inglese di SharePoint.

File di configurazione

È possibile modificare due file di configurazione per SMAT:

  • SiteSkipList.csv viene installato nella stessa directory di SMAT.exe. L'aggiunta di siti a questo csv indica a SMAT di non includere questi siti nell'output del report. Per esempi su come aggiungere siti all'elenco ignorati, vedere SiteSkipList.csv.

  • ScanDef.json viene installato nella stessa directory di SMAT. È possibile usare ScanDef.json per abilitare o disabilitare le singole analisi per SMAT. Questo file contiene configurazioni per la valutazione sia in SharePoint 2010 che in 2013.

Per disabilitare un'analisi, individuare la voce nel file ScanDef.json e impostare Abilitatosu false. Questo è utile se è presente un'analisi che non interessa all'azienda. La disabilitazione dell'analisi riduce il tempo di esecuzione complessivo di SMAT.

Di seguito viene disabilitata l'analisi avvisi.

{ "Name": "Alerts", "Type": "AlertsScanner", "SupportedVersions": [ "2010", "2013", "2016" ], "ReportCategoryType": "SPSite", "Enabled": false }

SupportedVersion informa SMAT a quali versioni di SharePoint si applica un'analisi specifica. Ad esempio, SharePoint 2010 non aveva componenti aggiuntivi di SharePoint, quindi lo scanner app non elenca 2010 come versione supportata.

{ "Name": "Apps", "Type": "AppsScanner", "SupportedVersions": [ "2013", "2016" ], "ReportCategoryType": "SPSite", "Enabled": true }

Alcune analisi hanno opzioni di configurazione aggiuntive. Questi sono configurabili nel file ScanDef.json. Non tutte le analisi hanno proprietà configurabili. Tuttavia, se un'analisi ha una proprietà, nel file ScanDef.json è configurata una proprietà predefinita che può essere modificata. Ad esempio, l'analisi SiteTemplateLanguage include un filtro per escludere i siti in lingua inglese [impostazioni locali 1033]. Se il team ha problemi con la migrazione dei siti in inglese, è possibile modificare il filtro per includere tali siti:

{ "Name": "SiteTemplateLanguage", "Type": "SiteTemplateLanguageScanner", "SupportedVersions": [ "2010", "2013", "2016" ], "Property": { "ExcludedLanguages": "" }, "ReportCategoryType": "SPSite", "Enabled": true }

Se si rimuove o si danneggia il file ScanDef.json, verrà usata una configurazione predefinita incorporata nel file eseguibile SMAT.exe. Questo è indicato nel file SMAT.log. Se si disabilita un'analisi o si modifica una proprietà e si nota che la modifica non viene prelevata quando si esegue SMAT.exe, cercare i dettagli nel file SMAT.log.

Esecuzione

Eseguire smat.exe dal percorso dei file estratti. Per visualizzare tutti i parametri disponibili, eseguire: smat.exe /help.

SMAT.exe è un programma di avvio che determina le intenzioni in base ai parametri passati e quindi carica l'applicazione appropriata per eseguire il lavoro richiesto. Sotto le quinte, sono presenti tre file eseguibili responsabili dell'esecuzione del lavoro:

  • SMAT2010.exe : esegue la valutazione in ambienti SharePoint 2010.

  • SMAT2013.exe : esegue la valutazione in ambienti SharePoint 2013.

  • SMIT.exe : esegue il mapping delle identità per gli ambienti SharePoint 2010 e 2013.

Nota

SMIT smette di funzionare dopo il 30 giugno 2023 a causa della deprecazione del servizio Graph di Azure AD. Per altre informazioni sull'annuncio più recente, vedere Importante: Ritiro di Graph di Azure AD e Deprecazione del modulo PowerShell. Quando si esegue SMAT.exe per eseguire una valutazione da PowerShell.exe, si verificano le azioni seguenti. La finestra di PowerShell in esecuzione SMAT.exe avvia l'app per eseguire il lavoro. Dopo il caricamento dell'app funzionante, il programma del caricatore SMAT.exe termina e restituisce il controllo all'operatore. Lo strumento che esegue il lavoro viene eseguito nella propria finestra fino al completamento.

File di registro

Nella directory di output potrebbero essere visualizzati fino a tre file di log:

  • SMAT.log : questo file contiene tutta la registrazione dall'esecuzione dello strumento. Contiene tre livelli di registrazione: Informazioni, Avviso ed Errori. Le informazioni consentono di tenere traccia dello stato di avanzamento e di risolvere i problemi. In genere, gli avvisi sono condizioni di errore previste. Gli errori sono condizioni impreviste in cui gli strumenti non sono stati in grado di determinare se saranno un ostacolo all'avanzamento. Questi devono essere esaminati.

  • SMAT_Errors.log : contiene solo gli eventi Error. Se questo file non è presente al termine degli strumenti, indica che non sono stati rilevati errori.

  • SMATTelemetry.log : contiene la registrazione per gli strumenti di caricamento dei dati di telemetria. Eventuali problemi in questa sezione non influiscono sulla generazione dei report.

Automazione della valutazione

Se è necessario pianificare il processo di valutazione, è possibile eseguire il file di .exe specifico. Ad esempio, se si vuole configurare un'attività pianificata in una farm di SharePoint 2010 per la valutazione, è consigliabile puntare l'attività pianificata a SMAT2010.exe. Se si vuole scrivere uno script di PowerShell che ha eseguito la valutazione in SharePoint 2013, è consigliabile impostare lo script su SMAT2013.exe.

Qualsiasi scenario di scripting deve usare l'opzione -q per eseguire il file .exe in modalità non interattiva. Questa modalità non fornisce alcun output alla console ed evita qualsiasi elemento che richieda l'input all'operatore.

Altre informazioni

Per scaricare lo strumento di migrazione di SharePoint e per altre informazioni su come risolvere i problemi identificati nei report di valutazione, vedere