SharePoint 移轉評估工具的概觀Overview of the SharePoint Migration Assessment Tool

SharePoint 遷移評估工具是簡單的命令列可執行工具。The SharePoint Migration Assessment Tool is a simple command line executable tool. 它會掃描您的 SharePoint 伺服器陣列內容,以協助識別將伺服器遷移至與 Microsoft 365 SharePoint 的影響。It scans the contents of your SharePoint farm to help identify the impact of migrating your server to SharePoint with Microsoft 365.

此工具的設計目的是在不影響您的環境的情況下執行,所以您可能會發現工具需要一到兩天的時間來完成環境掃描。The tool is designed to run without impacting your environment, so you might observe that the tool requires one to two days to complete a scan of your environment. 在這段時間內,工具會在主控台視窗中報告進度。During this time, the tool reports progress in the console window. 掃描完成後,輸出檔案會位於記錄檔目錄中。After the scan finishes, the output files are in the Logs directory. 在此,您可以在遷移可能影響的案例中,找到摘要及更深入的見解。This is where you can find the summary and more detailed insights into the scenarios that could be impacted by migration.

注意

若要下載 SharePoint 遷移工具,請參閱 下載 SharePoint 遷移評估工具To download the SharePoint Migration Tool, see Download the SharePoint Migration Assessment Tool.

注意

若要改善 Microsoft 產品和服務的品質,該工具會向 Microsoft 報告匿名的統計資訊。To improve the quality of Microsoft products and services, the tool reports anonymous statistical information back to Microsoft. 或者,您可以在掃描結束時出現提示時,識別您的組織。Optionally, you can identify your organization when prompted at the end of the scan. 若工具無法連線到網際網路來報告此資訊,則該工具仍會如預期的方式運作。If the tool can't connect to the internet to report this information, the tool still functions as otherwise expected.

SharePoint 遷移評估工具中的模式Modes in SharePoint Migration Assessment Tool

工具提供兩種模式:評估和身分識別對應。The tool offers two modes: Assessment and Identity Mapping.

評估Assessment

這是預設模式。This is the default mode. 如果您執行 SMAT.exe,即會執行評估。If you run SMAT.exe, the assessment runs. 評估程式會針對 SharePoint 伺服器陣列和相關聯的內容執行掃描。The assessment process runs scans against the SharePoint farm and associated content. 它會尋找已知會對 SharePoint 遷移之客戶造成問題的問題。It looks for issues that have been known to cause issues for customers who are migrating into SharePoint. 如需可供掃描的詳細資訊,請參閱 SharePoint 遷移評估工具:掃描報告藍圖For more info about the scans that are available, see SharePoint Migration Assessment Tool: Scan Reports Roadmap.

身分識別對應Identity Mapping

您可以使用身分識別對應,以產生可以存取您 SharePoint 環境之所有使用者和群組的狀態報表,並嘗試將這些身分識別對應至 Azure AD 使用者和群組身分識別。You can use Identity Mapping 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.

這項處理常式對遷移非常重要。This process is very important to migration. 如果在遷移之前沒有正確地設定身分識別,使用者可能會失去存取內容,以及網站上不正確的資訊。If identities aren't correctly set up before migration, users could possibly lose access to content, as well as incorrect information on the site. 例如,[ 建立者 ] 和 [ 修改時間 ] 欄位可能不會顯示正確的身分識別後遷移。For example, the Created By and Modified fields might not show the correct identity post migration.

如需身分識別對應的詳細資訊,請參閱 SharePoint 遷移身分識別對應工具For more info about Identity Mapping, see SharePoint Migration Identity Mapping Tool.

必要條件Prerequisites

您可以從 SharePoint 2010 或2013伺服器陣列中,建立工具,以執行下列必要條件:The tool is built to be run from within a SharePoint 2010 or 2013 farm and has these prerequisites:

  • 若要執行此工具,必須先從任何壓縮套件解壓縮所有檔案,然後再執行。To run the tool, all files must be extracted from any compressed package before execution.

  • 工具必須以伺服器陣列服務帳戶的身分執行。The tool must run as the Farm service account. 伺服器陣列管理員帳戶只要獲得所有 web 應用程式的「讀取」存取權,即可接受。A farm administrator account is acceptable as long as the account has been given read access to all web applications. 此帳戶也需要在 Operations > Administrators 上和 > User Profile Service 應用程式的共用 許可權 上進行明確的「完全控制」許可權。The account also needs explicit Full Control permissions on both Operations > Administrators and Sharing > Permissions on the User Profile service application. 有一系列的檢查可確保該帳戶在掃描環境之前具有足夠的許可權。There are a series of checks to ensure that the account has enough permissions before it scans the environment.

  • 工具僅支援英文版的 SharePoint。The tool supports only English versions of SharePoint.

設定檔Config files

您可以修改 SMAT 的兩個設定檔:You can modify two config files for SMAT:

  • SiteSkipList.csv 與 SMAT.exe 安裝在相同的目錄中。SiteSkipList.csv is installed in the same directory as SMAT.exe. 將網站新增至此 CSV,可告訴 SMAT 不要在報表輸出中包含這些網站。Adding sites to this CSV tells SMAT not to include these sites in the report output. 如需如何將網站新增至 [略過清單] 的範例,請參閱 SiteSkipList.csv。For examples about how to add sites to the skip list, see SiteSkipList.csv.

  • ScanDef.json 與 SMAT 安裝在相同的目錄中。ScanDef.json is installed in the same directory as the SMAT. 您可以使用 ScanDef.js開啟以啟用或停用 SMAT 的個別掃描。You can use ScanDef.json to enable or disable individual scans for SMAT. 此檔案包含用於評估 SharePoint 2010 和2013以及身分識別對應的設定。This file contains configurations for assessment on both SharePoint 2010 and 2013, as well as Identity Mapping.

若要停用掃描,請找出 ScanDef.js檔案] 中的專案,並將 啟用 設定為 falseTo disable a scan, locate the entry in the ScanDef.json file, and set Enabled to false. 如果有您的業務不介意的掃描,這會很有用。This is useful if there is a scan that your business doesn't care about. 停用掃描會減少 SMAT 的整體執行時間。Disabling the scan reduces the overall execution time of SMAT.

下列情況會停用警示掃描。The following disables the Alerts scan.

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

SupportedVersion 通知 SMAT 套用特定掃描的 SharePoint 版本。The SupportedVersion informs SMAT which versions of SharePoint a specific scan applies to. 例如,SharePoint 2010 沒有 SharePoint 增益集,因此應用程式掃描程式不會將2010列為支援的版本。For example, SharePoint 2010 didn't have SharePoint add-ins, so the Apps scanner doesn't list 2010 as a supported version.

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

有些掃描具有其他設定選項。Some scans have additional configuration options. 這些是可在檔案的 ScanDef.js上進行設定。These are configurable in the ScanDef.json file. 並非所有掃描都有可設定的屬性。Not all scans have configurable properties. 不過,如果掃描確實具有屬性,則會在 [ScanDef.js上的可修改的檔案] 中設定預設屬性。However, if a scan does have a property, there's a default property configured in the ScanDef.json file that can be modified. 例如, SiteTemplateLanguage 掃描具有一個排除英文網站的篩選 [區域設定 1033]。For example, the SiteTemplateLanguage scan has a filter to exclude English sites [locale 1033]. 如果您的小組擔心遷移英文網站,您可以修改篩選,以包含這些網站:If your team has concerns about migrating English sites, you could modify the filter to include those sites:

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

如果您移除或損毀檔上的 ScanDef.js,將會改為使用內嵌在 SMAT.exe 可執行檔中的預設設定。If you remove or corrupt the ScanDef.json file, a default configuration that is embedded in the SMAT.exe executable file will be used instead. 這會在 SMAT 檔案中注明。This is noted in the SMAT.log file. 如果您停用掃描或變更屬性,並注意到當您執行 SMAT.exe 時並未挑選變更,請參閱 SMAT 檔案中的詳細資料。If you disable a scan or change a property and notice that the change isn't picked up when you run SMAT.exe, look in the SMAT.log file for details.

執行Execution

從解壓縮的檔案位置執行 smat.exe。Run smat.exe from the extracted files location. 若要查看所有可用的參數,請執行: smat.exe /helpTo see all the available parameters, run: smat.exe /help.

SMAT.exe 啟動器程式會根據傳入的參數判斷您的意圖,然後載入適當的應用程式來執行所要求的工作。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 requested work. 在封面底下,有三個可執行檔負責執行工作:Under the covers, there are three executable files that are responsible for doing the work:

  • SMAT2010.exe -在 SharePoint 2010 環境上執行評估。SMAT2010.exe - Performs assessment on SharePoint 2010 environments.

  • SMAT2013.exe -在 SharePoint 2013 環境上執行評估。SMAT2013.exe - Performs assessment on SharePoint 2013 environments.

  • SMIT.exe -執行 SharePoint 2010 和2013環境的身分識別對應工作。SMIT.exe - Performs identity mapping work for both SharePoint 2010 and 2013 environments.

執行 SMAT.exe 以從 PowerShell.exe 執行評估時,會發生下列動作。When running SMAT.exe to perform an assessment from PowerShell.exe, the following actions occur. 執行 SMAT.exe 的 PowerShell 視窗會啟動應用程式以執行工作。The PowerShell window running SMAT.exe launches the app to perform the work. 載入正常運作的應用程式之後,SMAT.exe 載入程式程式會終止,並將 control 傳回操作員。After the working app is loaded, the SMAT.exe loader program terminates, and returns control to the operator. 執行工作的工具會在其自己的視窗中執行,直到完成為止。The tool performing the work runs in its own window until it completes.

記錄檔Log files

您最多可以在輸出目錄中看到三個記錄檔:You might see up to three log files in the output directory:

  • SMAT -此檔案包含工具執行的所有記錄。SMAT.log - This file contains all the logging from the tool execution. 這包含三種記錄層級: 資訊警告錯誤This contains three levels of logging: Information, Warning, and Errors. 資訊可協助追蹤進度及疑難排解的問題。Information helps track down progress and troubleshooting issues. 通常,警告是預期的錯誤狀況。Typically, Warnings are expected error conditions. [!注意] 錯誤是我們的工具無法判斷是否會封鎖以繼續向前移動的意外情況。Errors are unexpected conditions that our tooling was unable to determine whether they will be a blocker to moving forward. 這些都是必須複查的。These need to be reviewed.

  • SMAT_Errors .log -這只包含錯誤事件。SMAT_Errors.log - This contains only the Error events. 如果此檔案在工具完成後遺失,它會指出沒有找到錯誤。If this file is missing after the tooling completes, it indicates that no errors were found.

  • SMATTelemetry -包含遙測上傳工具記錄。SMATTelemetry.log - This contains logging for the telemetry upload tooling. 這裡的任何問題不會影響產生您的報告。Any issues in here don't impact generating your reports.

自動化評估Automating assessment

如果您需要排程評估程式,您可以執行特定 .exe 檔來執行此動作。If you need to schedule the assessment process, you can do so by running the specific .exe file. 例如,如果您想要在 SharePoint 2010 伺服器陣列上設定排程的任務,以進行評估,您可以將排定的任務指向 SMAT2010.exe。For example, if you want to set up a scheduled task on a SharePoint 2010 farm for assessment, you would point the scheduled task to SMAT2010.exe. 如果您想要在 SharePoint 2013 上撰寫執行評估的 PowerShell 腳本,您可以將腳本指向 SMAT2013.exe。If you want to write a PowerShell script that ran assessment on SharePoint 2013, you would point the script to SMAT2013.exe.

任何腳本案例都必須使用 -q 參數,以安靜模式執行 .exe 檔案。Any scripting scenario must use the -q switch to run the .exe file in quiet mode. 這種模式不會提供任何輸出至主控台,避免輸入操作員時的任何提示。This mode doesn't provide any output to the console and avoids anything that would prompt the operator for input.

目前,身分識別對應的可執行檔 ( # A0) 不支援腳本編寫。At this time, the executable file for Identity Mapping (SMIT.exe) doesn't support scripting. 此程式至少會提示 Azure 的認證,而且可能會提示認證連線至 Active Directory。This process prompts for credentials to Azure at a minimum and might prompt for credentials to connect to Active Directory. 如果您嘗試在此可執行檔上進行腳本,當程式提示您輸入認證時,它會懸掛,而且不會完成。If you attempt to script against this executable file, it hangs and doesn't complete when the program prompts for credentials.

詳細資訊More info

若要下載 SharePoint 遷移工具,以及如何處理評估報告中所識別之問題的詳細資訊,請參閱To download the SharePoint Migration Tool, and for more info about how to address issues identified in the assessment reports, see