SharePoint 移轉評估工具的概觀

SharePoint 移轉評估工具是簡單的命令行可執行檔工具。 它會掃描 SharePoint 伺服器數位的內容,以協助識別使用 Microsoft 365 將伺服器移轉至 SharePoint 的影響。

此工具的設計目的是要在不影響環境的情況下執行,因此您可能會發現此工具需要一到兩天的時間才能完成環境掃描。 在此期間,此工具會在主控台視窗中報告進度。 掃描完成之後,輸出檔案會位於Logs目錄中。 您可以在這裡找到可能受到移轉影響之案例的摘要和更詳細的深入解析。

注意事項

若要下載 SharePoint 移轉評估工具,請參閱 下載 SharePoint 移轉評估工具

注意事項

為了改善 Microsoft 產品和服務的品質,此工具會將匿名統計資訊回報給 Microsoft。 或者,您可以在掃描結束時出現提示時識別您的組織。 如果工具無法連線到因特網來報告此資訊,則工具仍會如預期般運作。

必要條件

此工具是建置成從 SharePoint 2010、2013 或 2016 伺服器陣列內執行,並具有下列必要條件:

  • 若要執行此工具,在執行之前,必須先從任何壓縮的封裝擷取所有檔案。

  • 此工具必須以伺服器數位服務帳戶執行。 只要帳戶已獲得所有 Web 應用程式的讀取許可權,就可接受伺服器數位系統管理員帳戶。 帳戶也需要使用者配置檔服務應用程式上 Operations>系統管理員共用>許可權明確完全控制許可權。 有一系列的檢查可確保帳戶在掃描環境之前有足夠的許可權。

  • 此工具僅支援英文版的 SharePoint。

組態檔

您可以修改 SMAT 的兩個組態檔:

  • SiteSkipList.csv 與 SMAT.exe 安裝在同一個目錄中。 將網站新增至此 CSV 會告知 SMAT 不要在報表輸出中包含這些網站。 如需如何將網站新增至略過清單的範例,請參閱 SiteSkipList.csv。

  • ScanDef.json 與SMAT安裝在同一個目錄中。 您可以使用ScanDef.json來啟用或停用SMAT的個別掃描。 此檔案包含 SharePoint 2010 和 2013 的評量組態。

若要停用掃描,請在ScanDef.json檔中找出專案,並將 [已啟用 ] 設定為 false。 如果您的企業不在意掃描,這會很有用。 停用掃描可減少SMAT的整體運行時間。

下列程式代碼會停用警示掃描。

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

SupportedVersion 會通知 SMAT 特定掃描適用的 SharePoint 版本。 例如,SharePoint 2010 沒有 SharePoint 載入宏,因此應用程式掃描器不會將 2010 列為支援的版本。

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

某些掃描有其他設定選項。 這些可在 ScanDef.json 檔案中設定。 並非所有掃描都有可設定的屬性。 不過,如果掃描有 屬性,則ScanDef.json檔案中會設定可修改的默認屬性。 例如, SiteTemplateLanguage 掃描具有排除英文網站 [locale 1033] 的篩選條件。 如果您的小組對於移轉英文網站有疑慮,您可以修改篩選以包含這些網站:

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

如果您移除或損毀ScanDef.json檔案,將會改用內嵌在 SMAT.exe 可執行檔中的預設組態。 這會在SMAT.log檔中記下。 如果您停用掃描或變更屬性,並注意到當您執行 SMAT.exe 時未挑選變更,請查看SMAT.log檔案以取得詳細數據。

執行

從擷取的檔案位置執行 smat.exe。 若要查看所有可用的參數,請執行: smat.exe /help

SMAT.exe 是一個啟動程式,會根據傳入的參數來判斷您的意圖,然後載入適當的應用程式來執行要求的工作。 實際上,有三個可執行檔負責執行此工作:

  • SMAT2010.exe - 在 SharePoint 2010 環境中執行評量。

  • SMAT2013.exe - 在 SharePoint 2013 環境中執行評量。

  • SMIT.exe - 針對 SharePoint 2010 和 2013 環境執行身分識別對應工作。

注意事項

SMIT 在 2023 年 6 月 30 日之後因為 Azure AD Graph 服務已被取代而停止運作。 如需最新公告的詳細資訊,請 參閱重要事項:Azure AD Graph 淘汰和 Powershell 模組淘汰。 執行 SMAT.exe 以從 PowerShell.exe 執行評量時,會發生下列動作。 執行 SMAT.exe 的 PowerShell 視窗會啟動應用程式來執行工作。 載入工作應用程式之後,SMAT.exe 載入器程式會終止,並將控制權傳回給操作員。 執行工作的工具會在自己的視窗中執行,直到完成為止。

記錄檔

您可能會在輸出目錄中看到最多三個記錄檔:

  • SMAT.log - 此檔案包含工具執行中的所有記錄。 這包含三個層級的記錄: 資訊警告錯誤。 信息有助於追蹤進度和疑難解答問題。 警告通常是預期的錯誤狀況。 錯誤是非預期的情況,我們的工具無法判斷這些錯誤是否會成為前進的阻礙。 這些需要檢閱。

  • SMAT_Errors.log - 這僅包含 Error 事件。 如果此檔案在工具完成後遺失,表示找不到任何錯誤。

  • SMATTelemetry.log - 這包含遙測上傳工具的記錄。 此處的任何問題不會影響產生您的報表。

自動化評量

如果您需要排程評定程式,您可以執行特定的 .exe 檔案來執行此作業。 例如,如果您想要在 SharePoint 2010 伺服器陣列上設定排程工作以進行評量,您會將排程的工作指向 SMAT2010.exe。 如果您想要撰寫在 SharePoint 2013 上執行評量的 PowerShell 腳本,您會將腳本指向 SMAT2013.exe。

任何腳本案例都必須使用 -q 參數,以無訊息模式執行 .exe 檔案。 此模式不會提供任何輸出給控制台,並避免任何會提示操作員輸入的內容。

詳細資訊

若要下載 SharePoint 移轉工具,以及如需如何解決評定報告中所識別問題的詳細資訊,請參閱