Übersicht über das SharePoint-MigrationseignungstoolOverview of the SharePoint Migration Assessment Tool

Das Tool für die SharePoint-Migrations Bewertung ist eine einfache Befehlszeilendatei, die den Inhalt Ihrer SharePoint-Farm überprüft, um die Auswirkungen der Migration Ihres Servers zu SharePoint mit Microsoft 365 zu ermitteln.The SharePoint Migration Assessment Tool is a simple command line executable that scans the contents of your SharePoint farm to help identify the impact of migrating your server to SharePoint with Microsoft 365.

Da das Tool so konzipiert ist, dass es ohne Auswirkungen auf Ihre Umgebung ausgeführt wird, können Sie beobachten, dass das Tool ein bis zwei Tage benötigt, um einen Scan Ihrer Umgebung abzuschließen.As the tool is designed to run without impacting your environment, you may observe the tool requires one to two days to complete a scan of your environment. Während dieser Zeit meldet das Tool den Fortschritt im Konsolenfenster.During this time, the tool reports progress in the console window. Nach Abschluss der Überprüfung können Sie die Ausgabedateien im Verzeichnis Logs finden.After the scan is complete, you can find output files in the Logs directory. Hier finden Sie die Zusammenfassung und detailliertere Einblicke in die Szenarien, die von der Migration betroffen sein können.This is where you can find the summary and more detailed insights into the scenarios that could be impacted by migration.

Hinweis

Um das SharePoint-Migrationstool herunterzuladen, wechseln Sie zum herunterladen des Tools für die SharePoint-Migrations BewertungTo download the SharePoint Migration Tool, go to Download the SharePoint Migration Assessment Tool

Hinweis

Um die Qualität von Microsoft-Produkten und-Diensten zu verbessern, werden anonyme statistische Informationen von diesem Tool an Microsoft zurückgemeldet.To improve the quality of Microsoft products and services, the tool will report anonymous statistical information back to Microsoft. Optional können Sie Ihre Organisation identifizieren, wenn Sie am Ende der Überprüfung dazu aufgefordert werden.Optionally, you can identify your organization when prompted at the end of the scan. Wenn das Tool keine Verbindung mit dem Internet herstellen kann, um diese Informationen zu melden, funktioniert das Tool weiterhin wie erwartet.If the tool is not able to connect to the internet to report this information, the tool will still function as otherwise expected.

Modi in SharePoint Migration Assessment ToolModes in SharePoint Migration Assessment Tool

Das Tool bietet zwei Modi: Assessment und Identity Mapping.The tool offers two modes: Assessment and Identity Mapping.

BewertungAssessment

Dies ist der Standardmodus.This is the default mode. Wenn Sie SMAT.exe ausführen, wird die Bewertung ausgeführt.If you run SMAT.exe, the assessment will run. Der Bewertungsprozess führt Scans für die SharePoint-Farm und zugehörige Inhalte aus, die nach Problemen suchen, die bekanntermaßen Probleme für Kunden verursachen, die in SharePoint migrieren.The assessment process runs scans against the SharePoint farm and associated content looking for issues that have been known to cause issues for customers migrating into SharePoint. Weitere Informationen zu den verfügbaren Scans finden Sie unter SharePoint Migration Assessment Tool: Scan Reports RoadmapFor more info about the scans that are available, see SharePoint Migration Assessment Tool: Scan Reports Roadmap

IdentitätszuordnungIdentity Mapping

Mit der Identitätszuordnung können Sie einen Bericht über alle Benutzer-und Gruppenidentitäten generieren, die Zugriff auf Ihre SharePoint-Umgebung haben, und versuchen, diese Identitäten Azure AD Benutzer-und Gruppenidentitäten zuzuordnen.Identity Mapping lets you to generate a report of all the user and group identities that have access to your SharePoint environment and attempts to map those identities to Azure AD user and group identities.

Dieser Vorgang ist für die Migration sehr wichtig.This process is very important to migration. Wenn Identitäten vor der Migration nicht ordnungsgemäß eingerichtet wurden, kann dies dazu führen, dass Benutzer den Zugriff auf Inhalte sowie Informationen, die auf der Website falsch sind, verlieren.If identities are not properly set up prior to migration, it can result in users losing access to content as well as information being incorrect in the site. Beispielsweise wird in den Feldern erstellt von und geändert nicht die richtige Identitäts Post Migration angezeigt.For example, the Created By and Modified fields will not show the correct identity post migration.

Weitere Informationen zur Identitätszuordnung finden Sie unter SharePoint Migration Identity Mapping Tool.For more info about Identity Mapping, see SharePoint Migration Identity Mapping Tool.

VoraussetzungenPrerequisites

Das Tool ist so konzipiert, dass es in einer SharePoint 2010-oder 2013-Farm ausgeführt werden kann.The tool is built to be run from within a SharePoint 2010 or 2013 farm.

  • Zum Ausführen des Tools müssen alle Dateien vor der Ausführung aus einem komprimierten Paket extrahiert werden.To run the tool, all files must be extracted from any compressed package before execution.

  • Das Tool muss als Farm Dienstkonto ausgeführt werden.The tool must run as the Farm service account. Ein Farmadministratorkonto ist akzeptabel, solange dem Konto Lesezugriff auf alle Webanwendungen gewährt wurde.A farm administrator account is acceptable as long as the account has been given read access to all web applications. Das Konto benötigt außerdem explizite Vollzugriff-Berechtigungen für beide Vorgänge | Administratoren und Freigabe | Berechtigungen für die Benutzerprofildienst-Anwendung.The account also needs explicit Full Control permissions on both Operations | Administrators and Sharing | Permissions on the User Profile Service Application. Es gibt eine Reihe von Überprüfungen, um sicherzustellen, dass das Konto über ausreichende Berechtigungen verfügt, bevor die Umgebung überprüft wird.There are a series of checks to ensure the account has enough permissions prior to scanning the environment.

  • Das Tool unterstützt nur englische Versionen von SharePoint.The tool only supports English versions of SharePoint.

KonfigurationsdateienConfig files

Sie können zwei Konfigurationsdateien für SMAT ändern.You can modify two config files for SMAT.

SiteSkipList.csv wird im gleichen Verzeichnis wie SMAT.exe installiert.SiteSkipList.csv is installed in same directory as SMAT.exe. Durch das Hinzufügen von Websites zu dieser CSV-Datei wird SMAT mitgeteilt, dass diese Websites nicht in die Berichtsausgabe eingeschlossen werden sollen.Adding sites to this CSV will tell SMAT not to include these sites in the report output. Beispiele zum Hinzufügen von Websites zur Skip-Liste finden Sie unter SiteSkipList.csv.For examples about how to add sites to the skip list, see SiteSkipList.csv.

ScanDef.jsauf wird im gleichen Verzeichnis wie die SMAT installiert.ScanDef.json is installed in the same directory as the SMAT. Sie können ScanDef.json verwenden, um einzelne Scans für SMAT zu aktivieren oder zu deaktivieren.You can use ScanDef.json to enable or disable individual scans for SMAT. Diese Datei enthält Konfigurationen für die Bewertung sowohl auf SharePoint 2010 als auch auf 2013 sowie auf Identitätszuordnung.This file contains configurations for assessment on both SharePoint 2010 and 2013 as well as Identity Mapping.

Um einen Scan zu deaktivieren, suchen Sie den Eintrag im ScanDef.jsauf Datei, und legen Sie Enabled auf falsefest.To disable a scan, locate the entry in the ScanDef.json file, and set Enabled to false. Dies ist hilfreich, wenn es einen Scan gibt, der für Ihr Unternehmen nicht wichtig ist.This is useful if there is a scan that your business doesn't care about. Durch Deaktivieren der Überprüfung wird die gesamte Ausführungszeit von SMAT reduziert.Disabling the scan reduces the overall execution time of SMAT.

Im folgenden wird der Warnungs Scan deaktiviert.The following disables the Alerts scan.

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

Das SupportedVersion informiert SMAT, für welche Versionen von SharePoint eine bestimmte Überprüfung gilt.The SupportedVersion informs SMAT which versions of SharePoint a given scan applies to. Beispielsweise hat SharePoint 2010 nicht SharePoint-Add-Ins, sodass der apps-Scanner 2010 nicht als unterstützte Version auflistet.For example, SharePoint 2010 did not have SharePoint Add-ins, so the Apps scanner does not list 2010 as a supported version.

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

Einige Scans weisen zusätzliche Konfigurationsoptionen auf.Some scans have additional configuration options. Diese sind in der Datei ScanDef.jskonfigurierbar.These are configurable in the ScanDef.json file. Nicht alle Scans verfügen über konfigurierbare Eigenschaften.Not all scans have configurable properties. Wenn ein Scan jedoch über eine Eigenschaft verfügt, wird in der Datei ScanDef.js, die geändert werden kann, ein Standardwert konfiguriert.However, if a scan does have a property, there is a default configured in the ScanDef.json file that can be modified. Beispielsweise verfügt der SiteTemplateLanguage-Scan über einen Filter zum Ausschließen von englischen Websites [locale 1033].For example, the SiteTemplateLanguage scan has a filter to exclude English sites [locale 1033]. Wenn Ihr Team Bedenken hinsichtlich der Migration von englischen Websites hat, können Sie den Filter so ändern, dass er diese Websites einschließt:If your team has concerns about migrating English sites, you could modify the filter to include those sites:

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

Wenn Sie die ScanDef.jsfür die Datei entfernen oder beschädigen, wird stattdessen eine Standardkonfiguration verwendet, die in die ausführbare SMAT.exe eingebettet ist.If you remove or corrupt the ScanDef.json file, a default configuration that is embedded in the SMAT.exe executable will be used instead. Dies wird in der Datei SMAT. log notiert.This is noted in the SMAT.log file. Wenn Sie eine Änderung vornehmen, um einen Scan oder eine Eigenschaft zu deaktivieren, und beachten Sie, dass die Änderung beim Ausführen SMAT.exe nicht übernommen wird, suchen Sie in der Datei SMAT. log nach Details.If you make a change to disable a scan or a property and notice the change is not picked up when you run SMAT.exe, look in the SMAT.log file for details.

AusführungExecution

Führen Sie smat.exe vom Speicherort der extrahierten Dateien aus.Run smat.exe from the extracted files location. Wenn Sie alle verfügbaren Parameter anzeigen möchten, führen Sie Folgendes aus: smat.exe/Help.To see all the available parameters, run: smat.exe /help.

SMAT.exe ist ein Startprogramm, das Ihre Absichten anhand der übergebenen Parameter bestimmt, und lädt dann die entsprechende Anwendung, um die angeforderte Arbeit durchführen zu können.SMAT.exe is a launcher program that determines your intentions based on the parameters passed in, and then loads the appropriate application to do the work requested. Unter dem Cover gibt es drei ausführbare Dateien, die für die Arbeit zuständig sind:Under the covers, there are three executables that are responsible for doing the work:

  • SMAT2010.exe – führt eine Bewertung in SharePoint 2010 Umgebungen durch.SMAT2010.exe - Performs assessment on SharePoint 2010 environments.

  • SMAT2013.exe – führt eine Bewertung in SharePoint 2013 Umgebungen durch.SMAT2013.exe - Performs assessment on SharePoint 2013 environments.

  • SMIT.exe – führt Identitäts Zuordnungsaufgaben für SharePoint 2010-und 2013-Umgebungen aus.SMIT.exe - Performs identity mapping work for both SharePoint 2010 and 2013 environments.

Wenn Sie SMAT.exe ausführen, um eine Bewertung von PowerShell.exe durchzuführen, werden die folgenden Aktionen durchgeführt.When running SMAT.exe to perform assessment from PowerShell.exe, the following actions occur. Das PowerShell-Fenster, in dem SMAT.exe ausgeführt wird, startet die APP, um die Arbeit auszuführen.The PowerShell window running SMAT.exe launches the app to perform the work. Nachdem die funktionierende App geladen wurde, wird das SMAT.exe Ladeprogramm beendet und die Steuerung an den Operator zurückgegeben.After the working app is loaded, the SMAT.exe loader program terminates, and returns control to the operator. Das Tool, das die Arbeit ausführt, wird bis zum Abschluss in einem eigenen Fenster ausgeführt.The tool performing the work runs in its own window until it completes.

ProtokolldateienLog files

Möglicherweise werden bis zu drei Protokolldateien im Ausgabeverzeichnis angezeigt.You may see up to three log files in the output directory.

  • SMAT. log – diese Datei enthält die gesamte Protokollierung aus der Tool Ausführung.SMAT.log - This file contains all the logging from the tool execution. Dieser enthält drei Protokollierungsstufen.This will contain 3 levels of logging. Informationen, Warnungen und Fehler.Information, Warning, and Errors. Informationen helfen bei der Verfolgung des Fortschritts und der Problembehandlung.Information help track down progress and troubleshooting issues. Warnungen sind normalerweise erwartete Fehlerbedingungen.Warnings are typically expected error conditions. Fehler sind unerwartete Bedingungen, die unser Tool nicht ermitteln konnte, wenn es sich um einen Blocker für das fortfahren handeln würde.Errors are unexpected conditions that our tooling was unable to determine if they will be a blocker to moving forward. Diese müssen überprüft werden.These need to be reviewed.

  • SMAT_Errors. log – enthält nur die Fehlerereignisse.SMAT_Errors.log - This contains only the Error events. Wenn diese Datei nach Abschluss der Tooling-Funktion fehlt, wird angegeben, dass keine Fehler gefunden wurden.If this file is missing after the tooling completes, it indicates there were no errors found.

  • SMATTelemetry. log -dies enthält die Protokollierung für das Telemetrie-Upload-Tool.SMATTelemetry.log - This contains logging for the telemetry upload tooling. Alle Probleme in diesem Artikel wirken sich nicht auf das Generieren von Berichten aus.Any issues in here do not impact generating your reports.

Automatisieren der BewertungAutomating assessment

Wenn Sie den Bewertungsprozess planen müssen, können Sie dies tun, indem Sie die spezifische exe ausführen.If you have the need to schedule the assessment process, you can do so by running the specific EXE. Wenn Sie beispielsweise einen geplanten Task in einer SharePoint 2010 Farm zur Bewertung einrichten möchten, zeigen Sie den geplanten Vorgang auf SMAT2010.exe.For example, if you want to setup a scheduled task on a SharePoint 2010 farm for assessment, you would point the scheduled task to SMAT2010.exe. Wenn Sie ein PowerShell-Skript schreiben wollten, das die Bewertung auf SharePoint 2013 ausgeführt hat, richten Sie das Skript auf SMAT2013.exe.If you wanted to write a PowerShell script that ran assessment on SharePoint 2013, you would point the script to SMAT2013.exe.

Jedes Skript Szenario muss die Option "-q" verwenden, um die exe im stillen Modus auszuführen.Any scripting scenario must use the -q switch to run the EXE in quiet mode. In diesem Modus wird nichts in die Konsole ausgegeben, und es wird alles vermieden, was den Operator zur Eingabe auffordert.This mode does not output anything to the console and avoids anything that would prompt the operator for input.

Zu diesem Zeitpunkt unterstützt die ausführbare Datei für die Identitätszuordnung [SMIT.exe] keine Skripterstellung.At this time, the executable for Identity Mapping [SMIT.exe] does not support scripting. Dieser Prozess fordert die Anmeldeinformationen mindestens für Azure auf und kann zur Eingabe von Anmeldeinformationen aufgefordert werden, eine Verbindung mit Active Directory herzustellen.This process prompts for credentials to Azure at a minimum and may prompt for credentials to connect to Active Directory. Wenn Sie versuchen, ein Skript für diese ausführbare Datei zu erstellen, wird Sie nicht beendet, wenn das Programm Anmeldeinformationen anfordert.If you attempt to script against this executable, it hangs and never completes when the program prompts for credentials.

Weitere InformationenMore info

Wenn Sie das SharePoint-Migrations Tool herunterladen möchten, finden Sie weitere Informationen zur Behandlung von Problemen, die in den Bewertungsberichten identifiziert wurden.To download the SharePoint Migration Tool, and for more info about how to address issues identified in the assessment reports, see