Übersicht über das SharePoint-Migrationseignungstool

  • Artikel

Das SharePoint-Migrationsbewertungstool ist ein einfaches ausführbares Befehlszeilentool. Es überprüft den Inhalt Ihrer SharePoint-Farm, um die Auswirkungen der Migration Ihres Servers zu SharePoint mit Microsoft 365 zu identifizieren.

Das Tool ist so konzipiert, dass es ausgeführt wird, ohne ihre Umgebung zu beeinträchtigen. Sie können also feststellen, dass das Tool ein bis zwei Tage benötigt, um eine Überprüfung Ihrer Umgebung abzuschließen. Während dieser Zeit meldet das Tool den Fortschritt im Konsolenfenster. Nach Abschluss der Überprüfung befinden sich die Ausgabedateien im Verzeichnis Protokolle. Hier finden Sie die Zusammenfassung und detailliertere Einblicke in die Szenarien, die von der Migration betroffen sein könnten.

Hinweis

Informationen zum Herunterladen des SharePoint-Migrationsbewertungstools finden Sie unter Herunterladen des SharePoint-Migrationsbewertungstools.

Hinweis

Um die Qualität von Microsoft-Produkten und -Diensten zu verbessern, meldet das Tool anonyme statistische Informationen an Microsoft zurück. Optional können Sie Ihre organization identifizieren, wenn Sie am Ende der Überprüfung dazu aufgefordert werden. Wenn das Tool keine Verbindung mit dem Internet herstellen kann, um diese Informationen zu melden, funktioniert das Tool weiterhin wie erwartet.

Voraussetzungen

Das Tool ist für die Ausführung in einer SharePoint 2010-, 2013- oder 2016-Farm erstellt und erfüllt die folgenden Voraussetzungen:

  • Zum Ausführen des Tools müssen alle Dateien vor der Ausführung aus einem komprimierten Paket extrahiert werden.

  • Das Tool muss als Farmdienstkonto ausgeführt werden. Ein Farmadministratorkonto ist zulässig, solange dem Konto Lesezugriff auf alle Webanwendungen gewährt wurde. Das Konto benötigt außerdem explizite Vollzugriffsberechtigungen fürBetriebsadministratoren> undFreigabeberechtigungen> für die Benutzerprofildienstanwendung. Es gibt eine Reihe von Überprüfungen, um sicherzustellen, dass das Konto über ausreichende Berechtigungen verfügt, bevor es die Umgebung überprüft.

  • Das Tool unterstützt nur englische Versionen von SharePoint.

Konfigurationsdateien

Sie können zwei Konfigurationsdateien für SMAT ändern:

  • SiteSkipList.csv wird im gleichen Verzeichnis wie SMAT.exe installiert. Das Hinzufügen von Websites zu dieser CSV-Datei weist SMAT an, diese Websites nicht in die Berichtsausgabe einzubeziehen. Beispiele zum Hinzufügen von Websites zur Überspringensliste finden Sie unter SiteSkipList.csv.

  • ScanDef.json wird im selben Verzeichnis wie die SMAT installiert. Sie können ScanDef.json verwenden, um einzelne Überprüfungen für SMAT zu aktivieren oder zu deaktivieren. Diese Datei enthält Konfigurationen für die Bewertung in SharePoint 2010 und 2013.

Um eine Überprüfung zu deaktivieren, suchen Sie den Eintrag in der ScanDef.json-Datei, und legen Sie Aktiviert auf false fest. Dies ist nützlich, wenn es eine Überprüfung gibt, die Ihrem Unternehmen egal ist. Wenn Sie die Überprüfung deaktivieren, wird die Gesamtausführungszeit von SMAT reduziert.

Im Folgenden wird die Überprüfung der Warnungen deaktiviert.

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

SupportedVersion informiert SMAT, für welche Versionen von SharePoint eine bestimmte Überprüfung gilt. SharePoint 2010 verfügte beispielsweise nicht über SharePoint-Add-Ins, sodass der App-Scanner 2010 nicht als unterstützte Version auflistet.

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

Einige Überprüfungen verfügen über zusätzliche Konfigurationsoptionen. Diese können in der ScanDef.json-Datei konfiguriert werden. Nicht alle Scans verfügen über konfigurierbare Eigenschaften. Wenn eine Überprüfung jedoch über eine -Eigenschaft verfügt, ist eine Standardeigenschaft in der ScanDef.json Datei konfiguriert, die geändert werden kann. Der SiteTemplateLanguage-Scan verfügt beispielsweise über einen Filter zum Ausschließen englischer Websites [gebietsschema 1033]. Wenn Ihr Team Bedenken hinsichtlich der Migration englischer Websites hat, können Sie den Filter ändern, um diese Websites einzuschließen:

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

Wenn Sie die ScanDef.json Datei entfernen oder beschädigen, wird stattdessen eine Standardkonfiguration verwendet, die in die SMAT.exe ausführbare Datei eingebettet ist. Dies wird in der SMAT.log-Datei notiert. Wenn Sie eine Überprüfung deaktivieren oder eine Eigenschaft ändern und feststellen, dass die Änderung beim Ausführen von SMAT.exe nicht vorgenommen wird, suchen Sie in der SMAT.log-Datei nach Details.

Ausführung

Führen Sie smat.exe am Speicherort der extrahierten Dateien aus. Führen Sie aus, um alle verfügbaren Parameter anzuzeigen: smat.exe /help.

SMAT.exe ist ein Startprogramm, das Ihre Absichten basierend auf den übergebenen Parametern bestimmt und dann die entsprechende Anwendung lädt, um die angeforderte Arbeit zu erledigen. Im Hintergrund gibt es drei ausführbare Dateien, die für die Arbeit verantwortlich sind:

  • SMAT2010.exe : Führt eine Bewertung in SharePoint 2010-Umgebungen durch.

  • SMAT2013.exe : Führt eine Bewertung für SharePoint 2013-Umgebungen durch.

  • SMIT.exe : Führt Die Identitätszuordnung für SharePoint 2010- und 2013-Umgebungen aus.

Hinweis

SMIT funktioniert nach dem 30. Juni 2023 aufgrund der Einstellung des Azure AD Graph-Diensts nicht mehr. Weitere Informationen zur neuesten Ankündigung finden Sie unter Wichtig: Einstellung von Azure AD Graph und Einstellung des PowerShell-Moduls. Wenn Sie SMAT.exe ausführen, um eine Bewertung aus PowerShell.exe durchzuführen, werden die folgenden Aktionen ausgeführt. Das PowerShell-Fenster, das SMAT.exe ausgeführt wird, startet die App, um die Arbeit auszuführen. Nachdem die funktionierende App geladen wurde, wird das SMAT.exe Ladeprogramm beendet und gibt die Steuerung an den Operator zurück. Das Tool, das die Arbeit ausführt, wird in einem eigenen Fenster ausgeführt, bis es abgeschlossen ist.

Protokolldateien

Im Ausgabeverzeichnis werden möglicherweise bis zu drei Protokolldateien angezeigt:

  • SMAT.log : Diese Datei enthält die gesamte Protokollierung der Toolausführung. Diese enthält drei Protokollierungsebenen: Informationen, Warnung und Fehler. Informationen helfen beim Nachverfolgen des Fortschritts und bei der Problembehandlung. In der Regel handelt es sich bei Warnungen um erwartete Fehlerbedingungen. Fehler sind unerwartete Bedingungen, bei denen unsere Tools nicht ermitteln konnten, ob sie ein Hindernis für das weitere Vorgehen sein werden. Diese müssen überprüft werden.

  • SMAT_Errors.log : Enthält nur die Fehlerereignisse. Wenn diese Datei nach Abschluss der Tools fehlt, gibt dies an, dass keine Fehler gefunden wurden.

  • SMATTelemetry.log : Enthält die Protokollierung für die Tools zum Hochladen von Telemetriedaten. Alle Probleme in hier wirken sich nicht auf das Generieren Ihrer Berichte aus.

Automatisieren der Bewertung

Wenn Sie den Bewertungsprozess planen müssen, können Sie dazu die spezifische .exe-Datei ausführen. Wenn Sie beispielsweise eine geplante Aufgabe in einer SharePoint 2010-Farm für die Bewertung einrichten möchten, verweisen Sie die geplante Aufgabe auf SMAT2010.exe. Wenn Sie ein PowerShell-Skript schreiben möchten, das die Bewertung auf SharePoint 2013 ausgeführt hat, verweisen Sie das Skript auf SMAT2013.exe.

Jedes Skriptszenario muss den -q Schalter verwenden, um die .exe Datei im ruhenden Modus auszuführen. Dieser Modus stellt keine Ausgabe für die Konsole bereit und vermeidet alles, was den Operator zur Eingabe auffordern würde.

Weitere Informationen

Weitere Informationen zum Beheben von Problemen, die in den Bewertungsberichten identifiziert wurden, finden Sie unter, um das SharePoint-Migrationstool herunterzuladen.