使用 SharePoint 移轉工具Using the SharePoint Migration Tool

SharePoint 移轉工具 (SPMT) 可以移轉 SharePoint 內部部署文件庫或是一般檔案共用中的檔案,並將檔案輕鬆複製到 Microsoft 365 的 SharePoint 中。這項工具可供所有 Microsoft 365 使用者使用。The SharePoint Migration Tool (SPMT) is a tool that migrates your files from SharePoint on-premises document libraries or regular file shares and easily copies them to SharePoint in Microsoft 365. It is available to all Microsoft 365 users.

下載並安裝Download and install

使用下列其中一個連結來下載並安裝 SPMT。Download and install SPMT using one of the links listed below.

公開預覽Public preview 初次發行First release 一般可用性General Availability
由此處安裝Install here 由此處安裝Install here 由此處安裝Install here

開始之前Before you begin

開始移轉之前,請檢閱系統需求、設定和權限行為。Review the system requirements, settings, and permissions behavior before beginning your migration.

重要

  • 若要在組織層級進行移轉,您必須以 Microsoft 365 中的全域或 SharePoint 系統管理員身分登入。To migrate at the organization-level, you must be signed in as a global or SharePoint admin in Microsoft 365.
  • 若要在網站集合層級遷移,您必須是網站管理員。To migrate at the site collection level, you must be a site admin.

允許或防止自訂指令碼 (NoScript)Allow or prevent Custom Script (NoScript)

在 Microsoft 365 租用戶中,您可以控制使用者是否可以在個人網站和自助架設的網站上執行自訂指令碼。In Microsoft 365, tenants you can control whether users can run custom script on personal sites and self-service created sites.

在移轉期間,有些網頁組件會要求將這項設定設定為 [允許]。否則,網頁組件將不會移轉。During migration, some web parts require this setting set to allow. Otherwise, the web part will not be migrated.

請在開始移轉至少 24 小時之前,先執行下列動作:At least 24 hours before you start migration, do the following:

  1. 移至新 SharePoint 系統管理中心的設定頁面,並使用具有組織系統管理員權限的帳戶登入。Go to the Settings page of the new SharePoint admin center, and sign in with an account that has admin permissions for your organization.

    注意

    如果您使用 Office 365 Germany,請登入 Microsoft 365 系統管理中心,然後瀏覽至 SharePoint 系統管理中心,並開啟設定頁面。 If you have Office 365 Germany, sign in to the Microsoft 365 admin center, then browse to the SharePoint admin center and open the Settings page.
    如果您使用由 21Vianet (中國) 提供的 Office 365,請登入 Microsoft 365 系統管理中心,然後瀏覽至 SharePoint 系統管理中心,並開啟 [設定] 頁面。If you have Office 365 operated by 21Vianet (China), sign in to the Microsoft 365 admin center, then browse to the SharePoint admin center and open the Settings page.

  2. 在頁面底部,選取 [傳統設定頁面]At the bottom of the page, select classic settings page.

  3. [自訂腳本] 底下,選取:Under Custom Script, select:

    允許使用者在個人網站上執行自訂指令碼Allow users to run custom script on personal sites
    允許使用者在自助架設的網站上執行自訂指令碼Allow users to run customer script on self-service created sites

    在移轉期間,請原地保留這些設定。Leave these settings in place for the duration of your migration.

    注意

    這些設定的變更可能需要 24 小時才會生效。Changes to this setting might take up to 24 hours to take effect.

    如需詳細資訊,請參閱[允許或防止自訂腳本]For more info, see, Allow or prevent custom script.

登入的注意事項Note about logging in

第一次啟動 SharePoint 移轉工具 (SPMT) 時,系統會提示您輸入 Microsoft 365 使用者名稱和密碼。When you first launch the SharePoint Migration Tool (SPMT), you are prompted for your Microsoft 365 username and password. 您提供的認證將會在移轉目的地中。The credentials you provide will be to the migration destination.

支援的驗證Authentication supported

SPMT 支援下列驗證方法:SPMT supports the following authentication methods:

  • NTLMNTLM
  • KerberosKerberos
  • 表單Forms
  • ADFSADFS
  • 多重要素驗證Multi-factor authentication
  • SAML 宣告SAML-based claims
  • 用戶端憑證驗證Client certificate authentication

重要

如果內部部署伺服器設定為支援包括 Windows 驗證在內的多種驗證提供者,則不支援 Windows 驗證。If the on-premises server is configured to support multiple authentication providers, including Windows authentication, then Windows authentication will not be supported. 如果您的環境就是如此,請使用 Windows 驗證以外的其他驗證方法。If this describes your environment, use other authentication methods instead of Windows authentication.

您的資料目前位於何處?Where is your data currently located?

在開始使用 SharePoint 移轉工具 (SPMT) 之前,請注意資料的所在位置以及在移轉後您想要放置檔案的位置。Before you start using the SharePoint Migration Tool (SPMT), note where your data is located, and where you want those files located after migration. 系統會提示您資料檔案的目前位置,以及您想要將它們複製到的 SharePoint 網站位置。You will be prompted for the current location of your data files and the location of the SharePoint site where you want them copied. SPMT 提供兩種資料移轉來源選項:從內部部署 SharePoint Server 2010 或 2013 網站,或是從本機檔案共用或網路路徑。SPMT lets you select from two sources from which to migrate your data: from an on-premises SharePoint Server 2010 or 2013 site, or from a local file share or network path.

  • SharePoint 內部部署: 如果選取 [SharePoint 內部部署] 選項,系統會提示您輸入檔案所在的 SharePoint Server 網站名稱,以及您在該網站上的認證。SharePoint on-premises: If you select the SharePoint on-premises option, you are prompted to enter the name of the SharePoint Server site where your files are located and prompted for your credentials for that site. 您需要指出想要移轉的文件庫。You will indicate what document library you wish to migrate.

    注意

    SPMT 支援 SharePoint Server 2010* 和 2013。SPMT supports SharePoint Server 2010* and 2013.

  • 檔案共用: 如果選取 [檔案共用] 選項,系統會提示您輸入檔案共用的位置、SharePoint 網站 URL,以及要複製檔案的文件庫位置。File share: If you select the file share option, you are prompted to enter the location of the file share, the URL of the SharePoint site, and the document library where they will be copied. 檔案不會從來源刪除。The files are not deleted from the source.

使用 SharePoint 移轉工具Using the SharePoint Migration tool

若要安裝最新版本下載,請移至:SharePoint 移轉工具To install the current release download, go to: SharePoint Migration Tool

從 SharePoint Server 文件庫移轉資料檔案Migrating data files from SharePoint Server document libraries

  1. 啟動 SPMT。輸入您的 Microsoft 365 使用者名稱和密碼。Start SPMT, and then enter your Microsoft 365 username and password.

  2. 選取 [開始您的第一次移轉]Select Start your first migration.

  3. 選取 [SharePoint Server]Select SharePoint Server.

  4. 輸入您內容所在的 SharePoint Server 網站 URL,然後選取 [下一步]****。Enter the SharePoint Server site URL where your content is located, and then select Next.

    重要

    不支援 Proxy 連線。Proxy connections are not supported. 使用 Proxy 連線會產生「SharePoint 登入失敗」或「無法載入文件庫」等錯誤。Using Proxy connections yields errors such as "SharePoint login fail" or "cannot load document library".

  5. 輸入您於該 SharePoint Server 網站的使用者名稱或密碼;使用者名稱必須為 someone@example.com 的格式。Enter your username and password to the SharePoint Server site; username must use the format of someone@example.com. 選取 [登入]****。Select Sign in.

    注意

    如果您在使用此工具時已登入該網站,系統就不會再針對相同網站出現提示。If you have already signed in to that site once while using this tool, you won't be prompted again for the same site.

  6. 選取檔案所在的文件庫位置。Select the document library where your files are located. 下拉式清單裡會包含所有可能選項。The dropdown contains all your possible choices.

  7. 輸入您想要將檔案移轉至其中的 SharePoint 網站的 URL。Enter the URL of the SharePoint site where you want your files migrated.

  8. 選取您要將檔案複製到其中的文件庫。Select the document library to where your files will be copied.

  9. 選取 [新增]****。Select Add. 此工作會新增至清單。This task is added to the list. 如果您想要選取另一組要遷移的資料檔案,請選取 [新增來源]****。If you want to select another set of data files to migrate, select Add a source.

從本機檔案共用遷移資料檔案Migrating data files from a local file share

  1. 啟動 SPMT。輸入您的 Microsoft 365 使用者名稱和密碼。Start SPMT, and then enter your Microsoft 365 username and password.

  2. 選取 [開始您的第一次移轉]Select Start your first migration.

  3. 選取 [檔案共用]Select File Share.

  4. 輸入您內容所在的檔案共用來源路徑,然後選取 [下一步]****。Enter the source path of the file share where your content is located, and then select Next.

  5. 輸入您想要將檔案遷移至其中的 SharePoint 網站 URL,然後選取 [下一步]Enter the URL of the SharePoint site where you want your files migrated, and then select Next.

    注意

    如果您在使用此工具時已登入該網站,系統就不會再針對相同網站出現提示。If you have already signed in to that site once while using this tool, you won't be prompted again for the same site.

  6. 選取您要將檔案複製到其中的文件庫,然後選取 [下一步]****。Select the document library to where your files will be copied, and then select Next.

  7. 此工作會新增至清單。This task is added to the list. 如果您想要選取另一組要遷移的資料檔案,請選取 [新增其他來源]****。If you want to select another set of data files to migrate, select Add another source.

  8. 當您完成選取來源時,選取 [下一步]****。When you have finished selecting your sources, select Next.

  9. 檢閱您的設定,然後選取 [遷移]****。 Review your settings, and then select Migrate.

如果要使用 JSON 或 CSV 檔案進行大量移轉To use a JSON or CSV file for bulk migration

如果您需要移轉多個來源,您可以使用 JSON 或 CSV 檔案進行大量移轉。如需深入了解如何建立適用於資料內容移轉的 JSON 或 CSV 檔案,請參閱如何針對資料內容移轉格式化您的 JSON 或 CSV 檔案If you have many sources to migrate, you can use either a JSON or CSV file to do a bulk migration. To learn more on how to create a JSON or CSV file for data content migration, see How to format your JSON or CSV file for data content migration.

  1. 啟動 SPMT。輸入您的 Microsoft 365 使用者名稱和密碼。Start SPMT, and then enter your Microsoft 365 username and password.

  2. 選取 [開始您的第一次移轉]Select Start your first migration.

  3. 選取JSON 或 CSV 檔案進行大量移轉Select JSON or CSV file for bulk migration.

  4. 輸入您內容所在的 .CSV 或 .JSON 完整路徑,然後選取 [新增]****。Enter the full path of your .CSV or .JSON file where your content is located, and then select Add.

  5. 輸入您想要將檔案遷移至其中的 SharePoint 網站 URL,然後選取 [下一步]Enter the URL of the SharePoint site where you want your files migrated, and then select Next.

    注意

    如果您在使用此工具時已登入該網站,系統就不會再針對相同網站出現提示。If you have already signed in to that site once while using this tool, you won't be prompted again for the same site.

  6. 選取 [使用 JSON 或 CSV 檔案行大量移轉]****。Select JSON or CSV file for bulk migration. 輸入檔案的位置,或選取 [選擇檔案]**** 來尋找檔案。Enter the location of your file, or select Choose File to locate it. 選取 [新增]****。Select Add.

    如果要從內部部署的 SharePoint Server 遷移檔案,除非已經在先前的步驟中提供過這些認證,否則系統會提示您輸入該網站的使用者名稱和密碼。If you are migrating files from an on-premises SharePoint Server, you are prompted for your username and password for that site unless you provided those credentials in previous steps.

    如果您的檔案中出現任何錯誤,則會逐行偵測。If any errors appear in your file, it is detected on a line-by-line basis. 錯誤訊息會指出哪一行或哪幾行中有錯誤。The error indicates which line or lines contain(s) the errors. 在您修正檔案中的錯誤之前,您無法繼續進行。You cannot proceed until you correct the errors in your file.

    重要

    我們不支援 Proxy 連線。We do not support proxy connections. 使用 Proxy 連線會產生「SharePoint 登入失敗」或「無法載入文件庫」等錯誤。Using Proxy connections yields errors, such as "SharePoint login fail" or "cannot load document library".

  7. 如果您想要選取另一組要遷移的資料檔案,請選取 [新增來源]****,否則,選取 [下一步]****。If you want to select another set of data files to migrate, select Add a source; otherwise, select Next.

  8. 檢閱您的設定,然後選取 [遷移]****。Review your settings, and the select Migrate.

監視及報告移轉工作的狀態Monitoring and reporting status of migration jobs

選取 [遷移]**** 之後,移轉工作的進度隨即顯示。After you select Migrate, the progress of your migration jobs appears. As they complete, you can view either detailed or summary reports of an individual job or a single summary report that includes all migration jobs submitted during this session.As they complete, you can view either detailed or summary reports of an individual job or a single summary report that includes all migration jobs submitted during this session. 若要深入了解,請參閱使用 SharePoint 移轉工具報告To learn more, see Using the SharePoint Migration Tool Reports.

繼續移轉工作Resuming migration jobs

如果您需要在提交的工作完成之前關閉 SPMT,您可以從任何電腦重新啟動工具。If you need to close SPMT before a submitted job has completed, you can restart the tool from any computer.

注意

若要繼續提交的移轉工作,該工作必須「至少」** 已執行 5 分鐘****。To resume a submitted migration job, it has to have been running at least 5 minutes. 其會在您關閉 SPMT 時暫停。It pauses at the point you closed the SPMT. 如果在工具關閉時,提交工作的執行時間小於 5 分鐘,則必須重新提交該工作。If your submitted job was running less than five minutes before the tool closed, you must resubmit the job.

若要繼續移轉工作To resume migration jobs

  1. 啟動 SPMT。Launch SPMT. 請使用您原先提交工作時所使用的 Microsoft 365 使用者名稱和密碼,然後選取 [登入]****。Using the same Microsoft 365 username and password you used when you originally submitted the job, select Sign In.

  2. 登入後,畫面會顯示任何暫停的移轉,提供已完成和維持原狀的詳細資訊。After you sign in, a screen displays any paused migrations, providing details about what has been completed and what remains.

  3. 如果想要新增其他移轉工作,請選取 [選取新的來源和目的地]****,否則,選取 [下一步]****。If you want to add additional migration tasks, select Select new sources and destinations; otherwise, select Next. 您的移轉工作將會繼續執行。Your migration jobs will be resumed. 如果要從內部部署的 SharePoint Server 遷移檔案,系統會提示您輸入該網站的使用者名稱和密碼。If you are migrating files from an on-premises SharePoint Server, you are prompted for your username and password for that site.

增量移轉Incremental migration

移轉工作完成後,您可以儲存工作以供日後重新執行,系統讓您可以只複製來源位置中這些新增或是更新過的檔案。After a migration task has completed, you can save it to be rerun at a later date, allowing you to copy only those new or updated files in the source location.

注意

如果您想要變更此設定,請在提交您的移轉工作之前進行。此設定為全域設定,將會套用至您提交的所有後續工作。If you wish to make changes to this setting, do so before your initial migration job is submitted. This setting is global; it will apply to all subsequent tasks you submit.

當開啟此設定時,系統會進行 SharePoint 目標環境累加檢查。When this setting is on, an incremental check of the SharePoint target environment is performed. 檔案會受到如下評估:Files are evaluated as follows:

狀態Status 結果Result
來源檔案的修改時間早於目標檔案的修改時間。Modified time of the source file is earlier than the modified time of the target file.
檔案不會被移轉。File will not be migrated.
檔案或清單存在於 SharePoint 目標位置。Files or lists exist in the SharePoint target location.
移轉會在掃描時跳過這些已經存在的物件。Migration will skip those existing objects during scan.
來源中來源位置內檔案或物件上的時間戳記較新Time stamp on files or object in the source location is newer in the source
將會遷移較新的檔案。The newer files are migrated.
來源為檔案共用。Source is a file share.
移轉驗證將會以檔案/資料夾為基礎。Validation for migration will be based on the file/folder path.
來源為內部部署的 SharePoint Server/Source is an on-premises SharePoint Server/
移轉的驗證是根據清單項目 GUID。使用資料夾路徑作為後援。Validation for migration will be based on list item GUID. Use the folder path as a fallback.

可用性Availability

注意

目前 SharePoint 移轉工具不適用於由中國 21Vianet 運作的 Office 365 使用者。 Currently, the SharePoint Migration Tool is not available for users of Office 365 operated by 21Vianet in China.

Microsoft 365 使用者的德國雲端若使用 German Telekom 資料信任者,則也不適用此工具。It is also not available for users of Microsoft 365 with the German cloud with the data trustee, German Telekom. 但是,資料位置不在德國資料中心的德國使用者則可使用此工具。However, we do support it for users in Germany whose data location is not in the German datacenter.

SharePoint 移轉工具簡介Introducing the SharePoint Migration Tool

SharePoint 移轉工具的運作方式How the SharePoint Migration Tool works

如何針對資料內容移轉格式化您的 JSON 或 CSV 檔案How to format your JSON or CSV file for data content migration

為資料內容移轉建立使用者對應檔案Create a user mapping file for data content migration

SharePoint Online 和 OneDrive 的移轉速度SharePoint and OneDrive migration speed

SharePoint 移轉工具意見反應及支援論壇SharePoint Migration Tool Feedback and Support Forum