針對移轉管理員的問題和錯誤進行疑難排解Troubleshoot Migration Manager issues and errors

本文說明使用移轉管理員時您可能會遇到的問題和錯誤,以及如何解決它們。This article describes issues and errors you may encounter when using Migration Manager and how to resolve them.

檢查必要條件和設定Check prerequisites and settings

請確認您已符合安裝代理程式的先決條件,並已檢閱所需的端點。Make sure you have met the prerequisites for agent installation, and have reviewed the required endpoints. 政府雲端客戶應確認他們已正確設定。Government cloud customers should confirm they have set their configuration correctly.

代理程式錯誤訊息Agent error messages

訊息Message 動作Action
目前使用者無法存取來源檔案共用Current user does not have access to source file share 請確定來源檔案共用是網路檔案共用。Make sure the source file share is a network file share. 確認與代理程式相關的 Windows 帳戶有讀取您要移轉的檔案共用之權限。Confirm that the Windows account associated with the agent has read permissions to the file share you want to migrate.
來源檔案共用不存在The source file share does not exist 請確定來源檔案共用是現有的網路檔案共用。Make sure the source file share is an existing network file share. 確認與代理程式相關的 Windows 帳戶有讀取您要移轉的檔案共用之權限。Confirm that the Windows account associated with the agent has read permissions to the file share you want to migrate.

目的地站台 URL 問題Destination site URL issues

訊息Message 建議的動作Recommended action
目的地站台或網站不存在Destination site or web does not exist 確認目的地站台或子站台存在。Confirm the destination site or subsite exists. 如果是使用 OneDrive 帳戶,請確認已預先佈建該帳戶。If OneDrive account, make sure that it has been pre-provisioned.
無法檢查站台或網站是否存在。Failed to check site or web existence. 確認目的地站台或子站台存在。Confirm the destination site or subsite exists.

常見的錯誤訊息Frequently seen error messages

訊息Message 建議的動作Recommended action
無效的來源資料夾Invalid source folder 確認您輸入的路徑正確並遵循適當的格式Confirm the path you entered is correct and follows the proper format

確認您擁有該資料夾的讀取存取權。Confirm you have read access to the folder.
無法建立或更新網站The site cannot be created or updated 確認您有建立網站的權限,並且 URL 有效Confirm that you have permissions to create the site and that the URL is valid

如果網站存在,請確認您是網站集合管理員If the site exists, confirm you are the site collection administrator

如果還是失敗,請手動建立網站,並將移轉工具指向這個新建立的網站。If it still fails, create the site manually and point the migration tool to this newly created site.
掃描檔案失敗:資料夾名稱無效Scan file failure: The folder name is invalid 請參閱 OneDrive 和 SharePoint 中無效的檔案名稱和檔案類型See Invalid file names and file types in OneDrive and SharePoint
掃描檔案失敗:目標路徑太長Scan file failure: Target path is too long 請參閱 OneDrive 和 SharePoint 中無效的檔案名稱和檔案類型See Invalid file names and file types in OneDrive and SharePoint


OneDrive 和 SharePoint 的完整路徑 (包括檔案名稱在內) 必須少於 400 個字元。The entire path, including the file name, must contain fewer than 400 characters for OneDrive and SharePoint.
掃描檔案失敗:磁碟空間不足,無法封裝檔案Scan File Failure: Not enough disk space to pack the file 可供移轉工作資料夾使用的磁碟空間對您的來源檔案來說太小。The disk space available for the migration working folder is too small for the size of your source file. 放大您工作資料夾的大小,然後再試一次。Enlarge your size of your working folder try again.
封裝失敗:無法開啟檔案Packaging failure: Cannot open file 由於非現有來源而造成封裝失敗。Packaging failed due to non-existing source. 檢查您是否可以存取來源根資料夾。Check if you can access the source root folder.
已建立重複的工作。A duplicate task has already been created. 用來執行大量移轉的 CSV 檔案不能有重複的項目。The CSV file used to do bulk migration cannot have duplicate entries. 請移除重複的行,然後再試一次。Remove the duplicate line(s) and try again.
未移轉上層資料夾The parent folder was not migrated 未移轉上層資料夾,因此該資料夾下的所有項目都無法移轉。The parent folder was not migrated, therefore all items under the folder will fail to migrate. 檢查您的父資料夾,然後重試移轉。Check your parent folder and retry your migration.

代理程式安裝失敗Agent installation failure

問題: 移轉代理程式安裝不成功,或者 clientsetup.exe 無法開啟。Issue: The migration agent doesn't install successfully, or the clientsetup.exe cannot be opened.

範例:Example:

移轉管理員代理程式安裝失敗

診斷 / 調查Diagnosis / Investigation

如果 clientsetup.exe 無法開啟:If the clientsetup.exe cannot be opened:

  • 以系統管理員身份登入 Windows,或在開啟應用程式時提供系統管理員使用者名稱和密碼。Sign in to Windows as Administrator, or provide the Administrator username and password upon opening the application. 系統管理員帳戶應已新增至網域中。The Administrator account should already be added to the domain.

如果安裝流程中發生錯誤:If errors occurred during installation process:

  • 錯誤訊息應該已經包括失敗原因,以及要採取的適當措施 (如果可能)。The error message should already include the failure reason, and the appropriate actions to take if possible.
  • 如果錯誤不建議採取措施來解决,則問題可能是由臨時網路故障或其他未知問題引起的。If errors do not suggest actions to resolve, the problem could be caused by temporary network failure, or other unknown issues.

風險降低Mitigation

如果 clientsetup.exe 無法開啟:If the clientsetup.exe cannot be opened:

  1. 以系統管理員身份登入 Windows。Sign in to Windows as Administrator.
  2. 重新開啟 clientsetup.exe 應用程式或在開啟應用程式時提供系統管理員使用者名稱和密碼。Reopen the clientsetup.exe application, or provide the Administrator username and password upon opening the application.

如果安裝流程中發生錯誤:If errors occurred during installation process:

  • 對於具有特定指定動作的錯誤,請執行相應的操作,然後重新開啟 clientsetup.exe。For errors with specific stated actions, take the corresponding action and then reopen the clientsetup.exe.
  • 對於其他非特定錯誤,請確保已將系統管理員帳戶新增到網域中。For other non-specific errors, make sure your Administrator account has been added to the domain. 關閉應用程式視窗,然後重試安裝。Close the application window and then retry installation.

代理程式已中斷連線Agent disconnected

問題:代理的「狀態」會被卡在「中斷連線」,並且永遠不復原。Issue: The "state" of the agent gets stuck as "Disconnected" and never comes back.

代理程式已中斷連線

診斷 / 調查Diagnosis / Investigation

  • 檢查安裝了代理程式的電腦上的網路連線狀態。Check the network health on the computer on which the agent is installed.
  • 如果已登入的租用戶系統管理員帳戶之密碼已變更,或套用至租用戶系統管理員帳戶的任何其他類似的關鍵變更需要重新登入,則所有代理程式都將中斷連線,並且需要重新安裝所有代理程式。If the password of the logged-in Tenant Administrator account has changed, or any other similar, critical changes applied to the Tenant Admin account that would require re-sign in, all of the agents will be disconnected and reinstallation is required on all of them.

風險降低Mitigation

  • 如有網路問題,請解决。If there's a network issue, fix that. 代理程式應該很快重新連線。The agent should reconnect soon after.
  • 如果租用戶系統管理帳戶發生需要您重新登入的關鍵變更:請在所有電腦上重新安裝代理程式。If there are critical changes to the Tenant Admin account that require you to re-sign in: Reinstall the agent on all the computers.
  • 如果這兩個條件都不適用,請首先重新安裝代理程式。If neither of these condition applies, start by reinstalling the agent first.

工作處於「已佇列」狀態Task stuck in "Queued" status

問題 工作的狀態保持為「已佇列」,並且從不在代理程式上排程執行。Issue The status of a task stays at "Queued" and never gets scheduled on an agent to run.

工作處於「已佇列」狀態

診斷 / 調查Diagnosis / Investigation

  • 確保已為此租用戶安裝代理程式。Make sure there are agents installed for this tenant. 它們應該被列入代理程式清單。They should be listed in the Agents list.
  • 檢查每個代理程式的狀態。Check the state of each agent. 它們應設定為「啟用」。They should be set to "Enabled".
  • 「使用中」狀態表示代理程式已在處理另一個工作。A status of "In use" indicates the agent is already processing another task. 如果不完成目前工作,代理程式將無法指派更多工作。The agent won't be able to be assigned more tasks without finishing the current one.
  • 如果某個代理程式被列為「已停用」,則啟用它們;If an agent is listed as "Disabled", enable them;
  • 如果它們長時間處於「中斷連線」狀態,請檢查 [代理程式已中斷連線]。If they appear to be "Disconnected" for a long time, check Agent Disconnected.

風險降低Mitigation

  • 如果清單中有可用的、已啟用的代理程式,但工作已經很長時間沒有被排程了:請建立另一個相同的工作。If there are available, enabled agents in the list, but the tasks haven't been scheduled for a long time: Create another task that is the same. 有時它會解决問題。Sometimes it will fix the problem.

無法下載任務報表Task Report cannot be downloaded

問題 無法從工作詳細資訊面板上的連結下載 [任務報表]。Issue The Task report cannot be downloaded from the link on the task details panel.

  • 下載任務報表連結已停用。The Download task report link is disabled.
  • 下載任務報表連結顯示為使用中,但按一下後不會發生任何事情The Download task report link displays active, but nothing happens after clicking on it

無法下載任務報表

診斷 / 調查Diagnosis / Investigation

  • 「下載任務報表」連結將被停用,直到工作完成爲止。The link, "Download task report", is disabled until the task is finished. 報告僅在工作狀態變為「完成」或「失敗」後可用。Reports are only available after the status of the task has become "Complete" or "Failed". 由於超時而失敗的工作也將具有停用的任務報表連結。Tasks that failed due to time-out will also have a disabled task report link.
  • 如果無法為已完成的非超時工作下載任何報表,則很可能是移轉過程中發生了錯誤,從而中斷了將報表上傳至 SharePoint 的流程。If no reports can be downloaded for finished, non-timed-out tasks, most likely there are errors that have occurred during the migration process which interrupted the uploading of the reports to SharePoint. 然而,只要它們存在,就可以在本機找到。However, they can be found locally as long as they exist.

風險降低Mitigation

在完成工作的電腦上,嘗試擷取報表。On the computer that completed the task, try to retrieve the reports.

  • 在資料夾 %AppData%\Microsoft\SPMigration\Logs\Migration\MigrationTool[tenant_site] 中,按修改時間對子資料夾進行排序。In folder %AppData%\Microsoft\SPMigration\Logs\Migration\MigrationTool[tenant_site], sort the subfolders by their modified time. 尋找修改時間最接近工作開始時間的子資料夾。Find the subfolder whose modified time is the closest to the task's start time. 如果任務報表存在,它們將位於該子資料夾中的「報表」資料夾中。If the task reports exist, they will be in the "Report" folder within this subfolder.

Or

  • 如果工作失敗,請瀏覽到資料夾 %AppData%\Microsoft\SPMigration\Logs\ErrorReports,然後按修改時間對子資料夾進行排序。If the task has failed, navigate to the folder %AppData%\Microsoft\SPMigration\Logs\ErrorReports, then sort the subfolders by their modified time. 尋找修改時間最接近工作開始時間的子資料夾。Find the subfolder whose modified time is the closest to the task's start time. 錯誤報告將在此子資料夾中。The error report will be in this subfolder.

移轉錯誤Migration error

問題 移轉工作由於各種原因而失敗,工作報表中對此進行了詳細說明。Issue Migration tasks fail due to various reasons and are detailed in the task reports.

移轉管理員錯誤

診斷 / 調查Diagnosis / Investigation

  • 失敗的原因應該已經詳細地寫在報表中,並提出建議解決方法。The failure reasons should already be written in detail to the reports along with suggested solutions.

  • 如果您無法下載任務報表,請參閱無法下載任務報表If you can't download the task reports, please refer to Task Report Cannot Be Downloaded

風險降低 在此處尋找特定錯誤以取得更多資訊:錯誤代碼Mitigation Find the specific error here for more information: Error codes.

如果收到類似以下錯誤:提交失敗無法將工作提交到伺服器:提交工作時出現未知失敗原因。0x01610002If you receive an error similar to this: SUBMITTING FAILURE Failed to Submit the Job to Server:Unknown failed reason when submitting a job. 0x01610002

檢查代理程式電腦上安裝的所有防病毒應用程式的設定。Check the settings on any AntiVirus application installed on the agent machine. 新增我們的兩個移轉應用程式作為例外,以便移轉流量不會中斷:Add our two migration applications as exceptions so that the migration traffic won't be interrupted:

  • microsoft.sharepoint.migration.clientservice.exemicrosoft.sharepoint.migration.clientservice.exe
  • microsoft.sharepoint.migration.mthost.exemicrosoft.sharepoint.migration.mthost.exe

錯誤碼Error codes

錯誤碼Error Code 建議的動作Recommended action
0x0111000F0x0111000F 未移轉上層資料夾。The parent folder was not migrated. 檢查失敗報告以判斷檔案,然後再試一次。Check the failure report to determine the file and then try again.
0x011100100x01110010 檔案名稱中的無效字元。Invalid characters in the file name. 檢查檔案名稱具有下列各項的報告:<>:"Check report for files names with <>:" ?*/,?*/,
0x0201000D0x0201000D 檢查清單是否存在,或您是否可以在來源網站及目標網站中存取它。Check if the list exists or if you can access it in the source site and target site.
0x020500080x02050008 無法存取您的本機儲存空間。Unable to access your local storage. 重新開始移轉。Restart your migration.
0x020100230x02010023 不支援您的來源清單範本。Your source list template is not supported. 嘗試其他清單範本。Try another.
0x0201000C0x0201000C 請檢查您的認證,然後重新輸入您的使用者名稱和密碼。Check your credentials and then reenter your username and password.
0x020100170x02010017 您必須是網站集合管理員。You must be a site collection admin.
0x020600090x02060009 1 - 無法建立網站集合,因為 URL 已在使用中或為無效的 URL。1 - The site collection cannot be created because the URL is already in use or an invalid URL.
2 - 無法建立網站集合,因為 URL 包含無效的字元。2 - The site collection cannot be created because the URL contains invalid character.
3 - 無法建立或更新網站集合。3 - The site collection cannot be created or updated.
0x020600070x02060007 1 - 無法建立網站集合,因為 URL 已在使用中或為無效的 URL。1 - The site collection cannot be created because the URL is already in use or an invalid URL.
2 - 無法建立網站集合,因為 URL 包含無效的字元。2 - The site collection cannot be created because the URL contains invalid character.
0x020100180x02010018 1 - 請檢查您的認證,然後再試一次。1 - Check your credentials and then try again.
2 - 存取 SharePoint 時發生問題。2 - A problem occurred accessing SharePoint. 請檢查您的認證,然後再試一次。Check your credentials and try again.
3 - 存取 SharePoint 時發生問題。3 - A problem occurred accessing SharePoint. 請檢查您的認證和網路連線,然後再試一次。Check your credentials and your network connection and try again.
4 - 存取 SharePoint 時發生問題。4 - A problem occurred accessing SharePoint. 請檢查您的認證和網站 URL 的正確性,然後再試一次。Check your credentials and your site URL for accuracy and try again.
5 - 存取 SharePoint 時發生問題。5 - A problem occurred accessing SharePoint. 請檢查您的認證和 URL 格式。Check your credentials and the format of your URL. 請再試一次。Retry.
6 - 存取 SharePoint 時發生問題。6 - A problem occurred accessing SharePoint. 請檢查您的認證,然後再試一次。Check your credentials and try again. 如果問題持續發生,請建立支援案例。If the problem continues, please create a support case.
7 - 存取 SharePoint 時發生問題。7 - A problem occurred accessing SharePoint. 請檢查您的認證,並試著在瀏覽器中開啟您的網站。Check your credentials and try opening your site in a browser.
0x0204000A0x0204000A 無法建立套件檔案。Cannot create package file. 在移轉期間,移轉管理員工作資料夾 %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 中的所有檔案和資料夾都必須關閉。All files and folders in the Migration Manager working folder, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage, must be closed. 重新開始移轉。Restart your migration.
0x020300010x02030001 1 - 請檢查您的認證。1 - Check your credentials. 重新開始移轉。Restart your migration.
2 - 請檢查您的認證。2 - Check your credentials. 重新開始移轉。Restart your migration.
3 - 請檢查您的認證和網路連線。3 - Check your credentials and your network connection. 重新開始移轉。Restart your migration.
4 - 請檢查您的認證和您的網站 URL。4 - Check your credentials and your site URL. 重新開始移轉。Restart your migration.
5 - 請檢查您的認證和 URL 格式。5 - Check your credentials and the format of your URL. 重新開始移轉。Restart your migration.
6 - 請檢查您的認證,並重新開始移轉。6 - Check your credentials and restart your migration. 如果問題持續發生,請建立支援案例。If this continues, please a support case.
7 - 請檢查您的認證,並試著在瀏覽器中開啟您的網站。7 - Check your credentials and try opening your site in a browser. 重新開始移轉。Restart your migration.
0x020100080x02010008 請確認使用者對應檔案的路徑和格式,以及您是否有存取權限。Confirm the path and format of the user-mapping file and that you have permission to access it.
0x020500010x02050001 在移轉期間,移轉管理員工作資料夾 %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 中的所有檔案和資料夾都必須關閉。All files and folders in the Migration Manager working folder, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage, must be closed. 重新開始移轉。Restart your migration.
0x020100020x02010002 請檢查您的網路狀態。Check your network status. 如果您可以從瀏覽器存取來源網站,請建立支援案例。If you can access the source sites from a browser, then create a support case.
0x020100100x02010010 請確認來源清單和目標清單具有相同範本。Make sure the source list and target list have the same template.
0x0204000D0x0204000D 在移轉期間,移轉管理員工作資料夾 %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 中的所有檔案和資料夾都必須關閉。All files and folders in the Migration Manager working folder, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage, must be closed during migration. 重新開始移轉。Restart your migration.
0x020400120x02040012 您本機電腦上的暫時儲存空間太小。The temporary storage on your local computer is too low. 移轉管理員會在工作資料夾上快取套件。Migration Manager caches the package on the working folder. 擴充您的暫時儲存空間,然後重試。Expand your temporary storage and retry.
0x020300030x02030003 具有唯一權限的項目太多。There are too many items with unique permissions. 透過減少唯一權限的數目,以簡化您的權限清單。Simplify your permissions list by reducing the number of unique permissions. 重試移轉。aRetry your migration.
0x020500010x02050001 本機儲存體檔案已經損毀。Local storage file is corrupted. 在移轉過程中,已經處理或修改工作資料夾。The working folder was touched or modified during the migration. 重試移轉。Retry your migration.
0x020800010x02080001 套件中的檔案在上傳時遭到變更或刪除。The file in the package has been changed or deleted while uploading. 在移轉期間,移轉管理員工作資料夾 %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 中的所有檔案和資料夾都必須關閉。All files and folders in the Migration Manager working folder, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage, must be closed. 重新開始移轉。Restart your migration.
0x020400090x02040009 無法建立套件,因為找不到目錄。The package can't be created because the directory cannot be found. 在移轉期間,移轉管理員工作資料夾 %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 中的所有檔案和資料夾都必須關閉。All files and folders in the Migration Manager working folder, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage, must be closed. 重新開始移轉。Restart your migration.
0x020100200x02010020 停用移轉管理員設定中的移轉版本歷程記錄,或啟用 SPO 中的版本設定。Disable migrating version history in Migration Manager settings or enable versioning in SPO.
0x0201000E0x0201000E 檢查全域設定是否有篩選出目標路徑中的特殊字元,或是路徑是否有不支援的字元。Check if the global setting has filtered out special characters in the target path or if the path has unsupported characters.
0X0201000F0X0201000F 無效的網站 URL。Invalid site URL. 檢查網站 URL 是否有效。Check if the site URL is valid. 嘗試透過瀏覽器存取 URL。Try to access the URL via a browser. 如果這是 OneDrive 帳戶,請確認已預先佈建該帳戶,然後再進行移轉。If this is a OneDrive account, make sure it has been pre-provisioned before you migrate.
0x02070010x0207001 您沒有工作資料夾的存取權。You do not have access to the task folder. 檢查您是否可以存取 %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorageCheck if you can access %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage.
0x014100100x01410010 由於清單項目的相依性遺失而導致失敗。A failure occurred because of missing dependencies on list items. 如需詳細資訊,請參閱 FailureSummaryReport.csv。Check the FailureSummaryReport.csv for details. 檢查是否已在您的移轉範圍中包含相依性。Check if the dependencies have been included in your migration scope.
0x015100010x01510001 無法上傳套件。Packages failed to upload. 如果您已自訂 Azure 儲存體,請檢查您是否能夠存取 Azure 儲存體,並檢查您是否能夠存取目標網站。If you have customized Azure storage, check if you can access the Azure storage and check if you can access the target site. 嘗試再次移轉。Try migrating again.
0x015100010x01510001 無法上傳工作到伺服器:上傳檔案在移轉期間失敗。Failed to Upload the Job to Server: Upload file failed during migration.
0x020700090x02070009 無法上傳數個套件。Several packages failed to upload. 請暫停工作並檢查您的網路連線。Pause the task and check your network connection.
0x017100090x01710009 由於工作端失敗而導致失敗;套件中的部分項目失敗。A failure occurred due to job end failures; some items failed in the package. 重新開始移轉。Restart migration.
0x017100090x01710009 伺服器處理檔案時發生錯誤或逾時:未移轉套件中的所有項目。Errors or timeout for Server Processing the file: Not all the items in the package have been migrated.
0x016100010x01610001 Azure 容器已過期。The Azure container is expired. 重試移轉工作。Retry migration task.
0x017100060x01710006 伺服器處理檔案時發生錯誤或逾時:工作嚴重錯誤。Errors or timeout for server processing the file: Job Fatal Error.
0x017100040x01710004 伺服器處理檔案時發生錯誤或逾時。Errors or timeout for server processing the file. 無法查閱資料夾名稱。Fail to look up folder name. 項目可能存在於相同網站集合的其他清單或網站中。The item may exist in other list or site in the same site collection. 或項目位於資源回收筒中。Or the item is in the recycle bin.
0x0131000F0x0131000F 無法讀取檔案。Failed to Read the file. 已取出檔案。File is checked out.