針對同步處理健康情況和錯誤 Azure 檔案同步進行疑難解答

發行項
04/11/2024

本文旨在協助您針對 Azure 檔案同步部署可能遇到的常見同步問題進行疑難解答並加以解決。

同步健康情況

如果我透過SMB或透過入口網站直接在 Azure 檔案共用中建立檔案，檔案同步至同步群組中的伺服器需要多久時間？

不會立即偵測到使用 Azure 入口網站或 SMB 對 Azure 檔案共用所做的變更，而且會像伺服器端點的變更一樣進行複寫。 Azure 檔案儲存體尚未有變更通知或日誌記錄，因此無法在檔案變更時自動起始同步會話。在 Windows Server 上，Azure 檔案同步使用 Windows USN 日誌，在檔案變更時自動起始同步會話。

若要偵測 Azure 檔案共享的變更，Azure 檔案同步具有稱為變更偵測作業的排程工作。變更偵測作業會列舉檔案共用中的每個檔案，然後將其與該檔案的同步版本進行比較。當變更偵測作業判斷檔案已變更時，Azure 檔案同步會起始同步會話。變更偵測工作會每隔 24 小時起始一次。因為變更偵測作業的運作方式是列舉 Azure 檔案共用中的每個檔案，所以變更偵測在較大的命名空間中所花費的時間比在較小的命名空間中還要長。對於大型命名空間，每 24 小時可能需要超過一次的時間來判斷哪些檔案已變更。

若要立即同步處理 Azure 檔案共享中變更的檔案， Invoke-AzStorageSyncChangeDetection 您可以使用 PowerShell Cmdlet 手動起始 Azure 檔案共用中變更的偵測。此 Cmdlet 適用於某種類型的自動化程式正在 Azure 檔案共用中進行變更，或由系統管理員 (進行變更，例如將檔案和目錄移至共用) 。針對使用者變更，建議您在 IaaS VM 中安裝 Azure 檔案同步代理程式，並讓終端使用者透過 IaaS VM 存取檔案共用。如此一來，所有變更都會快速同步至其他代理程式，而不需要使用 Cmdlet Invoke-AzStorageSyncChangeDetection 。若要深入瞭解，請參閱 Invoke-AzStorageSyncChangeDetection 檔。

我們正探索如何為 Azure 檔案共用新增變更偵測，類似於 Windows Server 上磁碟區的 USN。透過在 Azure 社群意見反應中投票，協助我們排定這項功能未來開發的優先順序。

伺服器端點健康情況處於擱置狀態長達數小時

如果您建立雲端端點並使用包含數據的 Azure 檔案共用，則會發生此問題。掃描 Azure 檔案共享中變更的雲端變更列舉作業必須先完成，檔案才能在雲端和伺服器端點之間同步。完成作業的時間取決於 Azure 檔案共用中的命名空間大小。變更列舉作業完成後，伺服器端點健康情況應該會更新。

若要檢查雲端變更列舉作業的狀態，請移至入口網站中的 雲端端點 屬性，並在 [ 變更列舉 ] 區段中提供狀態。

若要在入口網站中檢視伺服器端點的健康情況，請瀏覽至記憶體同步服務的 [同步群組] 區段，然後選取同步群組。

狀況良好狀態和持續性同步處理錯誤計數為 0 表示同步處理如預期般運作。如果持續性同步處理錯誤的計數大於 0，請參閱如何? 查看是否有未同步處理的特定檔案或資料夾，以針對檔案無法同步的原因進行疑難解答。如果伺服器端點的健全狀況狀態不是 [狀況良好]，請遵循下表中的指引。

健康情況狀態	描述	補救
健康	同步會話已成功完成，或進行中的同步會話正在進行， (套用檔案) 。	不適用
擱置	建立伺服器端點之後，預期會出現 [擱置中] 狀態。一旦將伺服器端點的同步遙測傳送至服務，健全狀況狀態將會更新。	如果健全狀況狀態未變更數小時，請參閱伺服器端點健康情況處於擱置狀態長達數小時。
錯誤	同步會話失敗，發生錯誤。	若要解決此問題，請在入口網站中選取 [錯誤狀態]，以取得錯誤碼和補救步驟。如果補救步驟未列在入口網站中，或未解決問題，請搜尋本檔中的錯誤碼以取得更多指引。
無活動	記憶體同步服務在過去兩小時內未收到來自此伺服器端點的同步遙測。	若要解決此問題，請遵循針對同步群組管理 Azure 檔案同步疑難解答中的步驟。
低磁碟模式	伺服器端點所在的磁碟區磁碟區磁碟空間不足。	若要解決此問題，請在磁碟區上釋放磁碟空間。若要深入瞭解低磁碟空間模式，請參閱雲端階層處理概觀。
布建已取消	伺服器端點建立失敗。同步處理無法在此伺服器端點上運作。	若要解決此問題，請參閱伺服器端點建立和刪除錯誤。

注意事項

伺服器端點狀態 (健康情況和活動) 每隔 15 分鐘重新整理一次，並以從伺服器傳送至服務的遙測事件為基礎。

查看事件檢視器中伺服器 (遙測記錄檔中的最新 9102 事件，請移至應用程式和服務記錄\Microsoft\FileSync\Agent\Telemetry) 。同步會話完成後，就會記錄此事件。 SyncDirection 會告訴您此工作階段是否為上傳或下載。如果為 HResult 0，則同步會話成功。非零 HResult 表示同步期間發生錯誤;如需常見錯誤的清單，請參閱下方。 PerItemErrorCount如果大於 0，則某些檔案或資料夾未正確同步。可以有 HResult 0 的，但 PerItemErrorCount 大於 0 的。

以下是成功上傳的範例。為了簡潔起見，只會列出每個9102事件中包含的部分值。

Replica Sync session completed.
SyncDirection: Upload,
HResult: 0, 
SyncFileCount: 2, SyncDirectoryCount: 0,
AppliedFileCount: 2, AppliedDirCount: 0, AppliedTombstoneCount 0, AppliedSizeBytes: 0.
PerItemErrorCount: 0,
TransferredFiles: 2, TransferredBytes: 0, FailedToTransferFiles: 0, FailedToTransferBytes: 0.

相反地，上傳失敗可能如下所示：

Replica Sync session completed.
SyncDirection: Upload,
HResult: -2134364065,
SyncFileCount: 0, SyncDirectoryCount: 0, 
AppliedFileCount: 0, AppliedDirCount: 0, AppliedTombstoneCount 0, AppliedSizeBytes: 0.
PerItemErrorCount: 0, 
TransferredFiles: 0, TransferredBytes: 0, FailedToTransferFiles: 0, FailedToTransferBytes: 0.

有時同步會話整體失敗或非零 PerItemErrorCount ，但仍會繼續進行，某些檔案會成功同步。您可以查看、、 AppliedTombstoneCount和 AppliedSizeBytes) (AppliedFileCountAppliedDirCount的 [套用] 欄位來判斷進度。這些欄位描述會話成功多少。如果您在一個數據列中看到多個同步會話失敗，但套 用計數增加 ，則您應該在開啟支援票證之前，先提供同步時間再試一次。

如何? 監視目前同步會話的進度嗎？

入口網站
伺服器

在您的同步群組中，移至伺服器端點屬性並查看 [ 同步狀態 ] 區段，以查看目前同步會話中上傳或下載的檔案計數。此狀態會延遲約 15 分鐘。如果您的同步會話小到足以在此期間內完成，則可能無法在入口網站中回報。

注意事項

如果 [估計完成 ] 空白，這表示同步處理尚未完成計算同步會話中的檔案數目。

查看伺服器上遙測記錄中最新的 9302 事件， (在事件檢視器中，移至應用程式和服務記錄\Microsoft\FileSync\Agent\Telemetry) 。此事件指出目前同步會話的狀態。 TotalItemCount 表示要同步處理的檔案數目、 AppliedItemCount 表示到目前為止已同步處理的檔案數目，以及 PerItemErrorCount 表示無法同步處理的檔案數目 (請參閱下列內容以瞭解如何處理此) 。

Replica Sync Progress. 
ServerEndpointName: <CI>sename</CI>, SyncGroupName: <CI>sgname</CI>, ReplicaName: <CI>rname</CI>, 
SyncDirection: Upload, CorrelationId: {AB4BA07D-5B5C-461D-AAE6-4ED724762B65}. 
AppliedItemCount: 172473, TotalItemCount: 624196. AppliedBytes: 51473711577, 
TotalBytes: 293363829906. 
AreTotalCountsFinal: true. 
PerItemErrorCount: 1006.

如何? 知道我的伺服器是否彼此同步？

入口網站
伺服器

針對指定同步群組中的每個伺服器，請確定：

[上傳至雲端] 和 [下載至伺服器] 的時間戳是最新的。
上傳和下載的狀態都是綠色。
伺服器端點屬性內的 [同步狀態 ] 區段會顯示極少或沒有要同步處理的檔案。
伺服器端點屬性內的 [ 持續性同步處理錯誤 ] 和 [ 暫時性同步處理錯誤 ] 字段的計數為 0。

查看已完成的同步會話，這些會話會在遙測事件記錄檔中針對事件檢視器中每個伺服器 (標示 9102 事件，請移至應用程式和服務記錄\Microsoft\FileSync\Agent\Telemetry) 。

在任何指定的伺服器上，您都想要確定已成功完成最新的上傳和下載會話。

若要這樣做，請檢查 HResult 上傳和下載的和 PerItemErrorCount 是否為 0， (SyncDirection 欄位會指出指定的工作階段是否為上傳或下載作業階段) 。請注意，如果您沒有看到最近完成的同步會話，可能是同步會話目前正在進行，如果您剛才新增或修改大量數據，則這是預期的。
當伺服器與雲端完全保持在最新狀態，且沒有任何方向同步的變更時，您會看到空的同步會話。這些是透過上傳和下載事件來表示，其中、 SyncDirCountSyncTombstoneCount和 SyncSizeBytes) (SyncFileCount的所有 Sync* 欄位都是零，這表示沒有要同步處理的專案。請注意，這些空的同步會話可能不會發生在高變換伺服器上，因為同步處理一律有新功能。如果沒有同步活動，則應該每隔 30 分鐘發生一次。
如果所有伺服器都與雲端保持在最新狀態，這表示其最近的上傳和下載會話都是空的同步會話，您可以合理確定整個系統正在同步。

如果您直接在 Azure 檔案共享中進行變更，Azure 檔案同步在每 24 小時執行一次的變更列舉執行之前，不會偵測到這些變更。當伺服器實際上遺漏了直接在 Azure 檔案共用中進行的最近變更時，伺服器可能會說它是最新的雲端。

如何? 查看是否有未同步處理的特定檔案或資料夾？

如果入口網站或PerItemErrorCount伺服器上的持續性同步處理錯誤和暫時性同步處理錯誤計數大於任何指定同步會話的 0，這表示某些專案無法同步處理。檔案和資料夾可以具有防止同步處理的特性。這些特性可以是持續性的，而且需要明確動作才能繼續同步處理，例如從檔案或資料夾名稱中移除不支援的字元。它們也可以是暫時性的，這表示檔案或資料夾會自動繼續同步處理;例如，具有開啟句柄的檔案會在關閉檔案時自動繼續同步處理。當 Azure 檔案同步引擎偵測到這類問題時，會產生可剖析的錯誤記錄檔，以列出目前未正確同步處理的專案。

注意事項

同步會話完成後，入口網站中的 持續性同步處理錯誤 和 暫時性同步處理錯誤 計數就會更新。如果同步會話正在進行中，請等到同步會話完成，並更新持續性 同步處理錯誤 和 暫時性同步處理錯誤 計數，再調查其餘錯誤。

若要查看無法同步的檔案和目錄名稱，請執行FileSyncErrorsReport.ps1PowerShell 腳本 (位於 Azure 檔案同步 代理程式的代理程式安裝目錄中，) 或使用 Debug-StorageSyncServer Cmdlet。欄 ItemPath 位會告訴您檔案與根同步目錄相關的位置。如需補救步驟，請參閱常見個別專案錯誤的清單。

若要使用 Debug-StorageSyncServer Cmdlet 識別無法在伺服器上同步的檔案，請執行下列 PowerShell 命令：

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -FileSyncErrorsReport

注意事項

如果 FileSyncErrorsReport.ps1 腳本傳回「找不到檔案錯誤」，或未列出同步群組的每個項目錯誤，原因如下：

原因 1：上次完成的同步會話沒有每個項目的錯誤。入口網站應該很快就會更新，以顯示「0 個檔案未同步」。根據預設， FileSyncErrorsReport.ps1 文本只會顯示上一個已完成同步會話的每個項目錯誤。若要檢視所有同步會話的每個項目錯誤，請使用 -ReportAllErrors 參數。檢查遙測事件記錄檔中的最新事件標識碼 9102 ，確認 PerItemErrorCount 為 0。
原因 2： ItemResults 伺服器上因每個項目錯誤太多而包裝的事件記錄檔，而事件記錄檔不再包含此同步群組的錯誤。若要避免此問題，請增加 ItemResults 事件記錄檔大小。您可以在事件檢視器 ItemResults 的 [應用程式和服務記錄檔\Microsoft\FileSync\Agent] 下找到事件記錄檔。

同步錯誤

針對每個檔案/目錄同步錯誤進行疑難解答

如果檔案或目錄因為錯誤而無法同步處理，則會在 Microsoft-FileSync-Agent/ItemResults 事件記錄檔中記錄事件。本節涵蓋每個專案錯誤的常見錯誤碼和補救步驟。

注意事項

如果檔案或目錄無法同步，則最多可能需要 30 分鐘的時間，Azure 檔案同步重試同步處理該專案。如果在伺服器端點位置內偵測不到任何變更，Azure 檔案同步每隔 30 分鐘起始一次同步會話。若要強制同步會話，請重新啟動記憶體同步代理程式 (FileSyncSvc) 服務，或變更伺服器端點位置內的檔案或目錄。

ItemResults 事件記錄檔中記錄的常見個別專案同步處理錯誤

HRESULT	HRESULT (十進位)	錯誤字串	問題	補救
0x80070043	-2147942467	ERROR_BAD_NET_NAME	無法存取伺服器上的階層式檔案。如果在刪除伺服器端點之前未重新叫用階層式檔案，就會發生此問題。	若要解決此問題，請參閱刪除伺服器端點之後，伺服器上無法存取階層式檔案。
0x80c80207	-2134375929	ECS_E_SYNC_CONSTRAINT_CONFLICT	檔案或目錄變更還無法同步處理，因為相依資料夾尚未同步處理。此專案會在同步處理相依變更之後進行同步處理。	暫時性錯誤。如果錯誤持續數天，請建立支援要求。
0x80C8028A	-2134375798	ECS_E_SYNC_CONSTRAINT_CONFLICT_ON_FAILED_DEPENDEE	檔案或目錄變更還無法同步處理，因為相依資料夾尚未同步處理。此專案會在同步處理相依變更之後進行同步處理。	暫時性錯誤。如果錯誤持續發生，請使用 FileSyncErrorsReport.ps1 PowerShell 腳本來判斷為何尚未同步處理相依資料夾。
0x80c80284	-2134375804	ECS_E_SYNC_CONSTRAINT_CONFLICT_SESSION_FAILED	檔案或目錄變更還無法同步處理，因為相依資料夾尚未同步，而且同步會話失敗。此專案會在同步處理相依變更之後進行同步處理。	不需要採取任何動作。如果錯誤持續發生，請調查同步會話失敗。
0x8007007b	-2147024773	ERROR_INVALID_NAME	檔案或目錄名稱無效。	重新命名有問題的檔案或目錄。如需詳細資訊，請參閱處理不支援的字元。
0x80070459	-2147023783	ERROR_NO_UNICODE_TRANSLATION	檔案或目錄名稱具有不支援的 Surrogate 字組字元。	重新命名有問題的檔案或目錄。如需詳細資訊，請參閱處理不支援的字元。
0x80c80255	-2134375851	ECS_E_XSMB_REST_INCOMPATIBILITY	檔案或目錄名稱無效。	重新命名有問題的檔案或目錄。如需詳細資訊，請參閱處理不支援的字元。
0x80c80018	-2134376424	ECS_E_SYNC_FILE_IN_USE	檔案正在使用中，因此無法同步處理。檔案不再使用時會同步處理。	不需要採取任何動作。 Azure 檔案同步每天在伺服器上建立一次暫時 VSS 快照集，以同步處理具有開啟句柄的檔案。
0x80c8031d	-2134375651	ECS_E_CONCURRENCY_CHECK_FAILED	檔案已變更，但同步尚未偵測到變更。偵測到這項變更之後，同步處理將會復原。	不需要採取任何動作。
0x80070002	-2147024894	ERROR_FILE_NOT_FOUND	檔案已刪除，且同步處理並不知道變更。	不需要採取任何動作。一旦變更偵測偵測到檔案已刪除，同步處理就會停止記錄此錯誤。
0x80070003	-2147024893	ERROR_PATH_NOT_FOUND	無法同步刪除檔案或目錄，因為專案已在目的地中刪除，且同步處理並不知道變更。	不需要採取任何動作。一旦變更偵測在目的地上執行且同步偵測到專案已刪除，同步處理就會停止記錄此錯誤。
0x80c80205	-2134375931	ECS_E_SYNC_ITEM_SKIP	已略過檔案或目錄，但會在下一個同步會話期間同步處理。如果在下載項目時回報此錯誤，則檔案或目錄名稱很可能無效。	如果上傳檔案時回報此錯誤，則不需要採取任何動作。如果在下載檔案時回報錯誤，請重新命名有問題的檔案或目錄。如需詳細資訊，請參閱處理不支援的字元。
0x800700B7	-2147024713	ERROR_ALREADY_EXISTS	無法同步檔案或目錄的建立，因為專案已存在於目的地中，而同步處理並不知道變更。	不需要採取任何動作。一旦變更偵測在目的地上執行，而且同步處理知道這個新專案，同步就會停止記錄此錯誤。
0x80c8603e	-2134351810	ECS_E_AZURE_STORAGE_SHARE_SIZE_LIMIT_REACHED	無法同步處理檔案，因為已達到 Azure 檔案共用限制。	若要解決此問題，請參閱疑難解答指南中的您已達到 Azure 檔案共用記憶體限制一節。
0x80c83008	-2134364152	ECS_E_CANNOT_CREATE_AZURE_STAGED_FILE	無法同步處理檔案，因為已達到 Azure 檔案共用限制。	若要解決此問題，請參閱疑難解答指南中的您已達到 Azure 檔案共用記憶體限制一節。
0x80c8027C	-2134375812	ECS_E_ACCESS_DENIED_EFS	檔案是由不支援的解決方案加密， (例如NTFS EFS) 。	解密檔案，並使用支援的加密解決方案。如需支援解決方案的清單，請參閱規劃指南的加密一節。
0x80c80283	-2160591491	ECS_E_ACCESS_DENIED_DFSRRO	檔案位於 DFS-R 唯讀復寫資料夾上。	檔案位於 DFS-R 唯讀復寫資料夾上。 Azure 檔案同步不支援 DFS-R 只讀複寫資料夾上的伺服器端點。如需詳細資訊，請參閱規劃指南。
0x80070005	-2147024891	ERROR_ACCESS_DENIED	檔案具有刪除暫止狀態。	不需要採取任何動作。關閉所有開啟的檔句柄之後，就會刪除檔案。
0x80c86044	-2134351804	ECS_E_AZURE_AUTHORIZATION_FAILED	無法同步處理檔案，因為記憶體帳戶上的防火牆和虛擬網路設定已啟用，而且伺服器無法存取記憶體帳戶。	依照部署指南中的設定防火牆和虛擬網路設定一節中所述的步驟，新增伺服器IP位址或虛擬網路。
0x8000ffff	-2147418113	E_UNEXPECTED	無法同步處理檔案，因為發生非預期的錯誤。	如果錯誤持續數天，請開啟支援案例。
0x80070020	-2147024864	ERROR_SHARING_VIOLATION	檔案正在使用中，因此無法同步處理。檔案不再使用時會同步處理。	不需要採取任何動作。
0x80c80017	-2134376425	ECS_E_SYNC_OPLOCK_BROKEN	檔案在同步期間已變更，因此必須再次同步處理。	不需要採取任何動作。
0x80070017	-2147024873	ERROR_CRC	檔案因 CRC 錯誤而無法同步處理。如果在刪除伺服器端點之前未重新叫用階層式檔案，或檔案已損毀，就會發生此錯誤。	若要解決此問題，請參閱刪除伺服器端點之後，伺服器上無法存取階層式檔案，以移除孤立的階層式檔案。如果在移除孤立的階層式檔案之後繼續發生錯誤，請在磁碟區上執行 chkdsk 。
0x80c80200	-2134375936	ECS_E_SYNC_CONFLICT_NAME_EXISTS	無法同步處理檔案，因為已達到衝突檔案的最大數目。 Azure 檔案同步支援每個檔案 100 個衝突檔案。若要深入瞭解檔案衝突，請參閱 Azure 檔案同步常見問題。	若要解決此問題，請減少衝突檔案的數目。一旦衝突檔案的數目小於 100，檔案就會同步處理。
0x80c8027d	-2134375811	ECS_E_DIRECTORY_RENAME_FAILED	無法同步目錄的重新命名，因為目錄中的檔案或資料夾具有開啟的句柄。	不需要採取任何動作。關閉目錄內所有開啟的檔句柄之後，將會同步處理目錄的重新命名。
0x800700de	-2147024674	ERROR_BAD_FILE_TYPE	無法存取伺服器上的階層式檔案，因為它參考的檔案版本已不存在於 Azure 檔案共用中。	如果分層檔案是從 Windows Server 的備份還原，就可能發生此問題。若要解決此問題，請從 Azure 檔案共用中的快照集還原檔案。
0x80C80065	-2134376347	ECS_E_DATA_TRANSFER_BLOCKED	檔案已識別為在同步處理期間產生持續性錯誤。因此，除非達到重試間隔，否則會封鎖同步處理。稍後會重試檔案。	不需要採取任何動作。檔案將在24小時後重試。如果錯誤持續數天，請建立支援要求。
0x80C80203	-2134375933	ECS_E_SYNC_INVALID_STAGED_FILE	檔案傳輸錯誤。服務稍後會重試。	不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。
0x80c8027f	-2134375809	ECS_E_SYNC_CONSTRAINT_CONFLICT_CYCLIC_DEPENDENCY	同步會話逾時錯誤。	不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。
0x80070035	-2147024843	ERROR_BAD_NETPATH	找不到網路路徑。	不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。
0x80071779	-2147018887	ERROR_FILE_READ_ONLY	指定的檔案是唯讀的。	如果錯誤持續超過一天，請建立支援要求。
0x80070006	-2147024890	ERROR_INVALID_HANDLE	發生內部錯誤。	如果錯誤持續超過一天，請建立支援要求。
0x8007012f	-2147024593	ERROR_DELETE_PENDING	無法開啟檔案，因為它正在刪除中。	不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。
0x80041007	-2147217401	SYNC_E_ITEM_MUST_EXIST	發生內部錯誤。	如果錯誤持續超過一天，請建立支援要求。
0X80C80293	-2134375789	ECS_E_SYNC_INITIAL_SCAN_COMPLETED	同步工作階段失敗，因為初始列舉已完成。下一個工作階段將涵蓋完整命名空間。	不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。
0X80C80342	-2134375614	ECS_E_SYNC_CUSTOM_METADATA_VERSION_NOT_SUPPORTED	同步處理資料庫具有版本高於支援版本的自定義元數據。	請將檔案同步代理程序升級至最新版本。如果在升級代理程式之後持續發生錯誤，請建立支援要求。

處理不支援的字元

Azure 檔案同步代理程式 v17 支援 NTFS 檔案系統支援的所有字元，但無效的 Surrogate 配對除外。

如果入口網站或 FileSyncErrorsReport.ps1 PowerShell 腳本因為不支援的字元而顯示每個專案同步錯誤 (錯誤碼0x8007007b、0x80c80255或0x80070459) ，請檢查伺服器上是否已安裝 Azure 檔案同步代理程式 v17。如果安裝代理程式 v17，而且檔案因為無效字元而仍然無法同步，請使用 ScanUnsupportedChars 腳本來重新命名包含不支援字元的檔案。

常見的同步處理錯誤

本節涵蓋同步會話因錯誤而失敗時的常見錯誤碼和補救步驟。

同步會話已取消。

錯誤	代碼
HRESULT	0x800704c7
HRESULT (十進位)	-2147023673
錯誤字串	ERROR_CANCELLED
需要補救	否

同步會話可能會因為各種原因而失敗，包括正在重新啟動或更新的伺服器、VSS 快照集等等。雖然此錯誤看起來需要追蹤，但除非此錯誤持續數小時，否則可以放心忽略此錯誤。

每天執行一次的磁碟區快照集同步會話已取消檔案同步會話，以同步處理具有開啟句柄的檔案。

錯誤	代碼
HRESULT	0x80c8029c
HRESULT (十進位)	-2134375780
錯誤字串	ECS_E_SYNC_CANCELLED_BY_VSS
需要補救	否

不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續超過一天，請建立支援要求。

無法建立與服務的連線。

錯誤	代碼
HRESULT	0x80072ee7
HRESULT (十進位)	-2147012889
錯誤字串	WININET_E_NAME_NOT_RESOLVED
需要補救	是

錯誤	代碼
HRESULT	0x80c83081
HRESULT (十進位)	-2134364031
錯誤字串	ECS_E_HTTP_CLIENT_CONNECTION_ERROR
需要補救	是

錯誤	代碼
HRESULT	0x80c8309a
HRESULT (十進位)	-2134364006
錯誤字串	ECS_E_AZURE_STORAGE_REMOTE_NAME_NOT_RESOLVED
需要補救	是

錯誤	代碼
HRESULT	0xc00000c4
HRESULT (十進位)	-1073741628
錯誤字串	UNEXPECTED_NETWORK_ERROR
需要補救	是

錯誤	代碼
HRESULT	0x80072ee2
HRESULT (十進位)	-2147012894
錯誤字串	WININET_E_TIMEOUT
需要補救	是

每當無法從伺服器存取 Azure 檔案同步服務時，就會發生此錯誤。您可以透過下列步驟來針對此錯誤進行疑難解答：

確認您的防火牆未封鎖 Windows 服務 FileSyncSvc.exe 。
確認埠 443 已開啟至 Azure 檔案同步服務的連出連線。您可以使用 Test-NetConnection Cmdlet 來執行此動作。您可以在 Azure 檔案同步 Proxy 和防火牆設定檔中找到下列佔位元的 URL<azure-file-sync-endpoint>。
```
Test-NetConnection -ComputerName <azure-file-sync-endpoint> -Port 443
```
確定 Proxy 組態已如預期般設定。這可以使用 Get-StorageSyncProxyConfiguration Cmdlet 來完成。如需設定 Azure 檔案同步 Proxy 設定的詳細資訊，請參閱 Azure 檔案同步 Proxy 和防火牆設定。
```
$agentPath = "C:\Program Files\Azure\StorageSyncAgent"
Import-Module "$agentPath\StorageSync.Management.ServerCmdlets.dll"
Get-StorageSyncProxyConfiguration
```
使用 Cmdlet Test-StorageSyncNetworkConnectivity 來檢查服務端點的網路連線能力。若要深入瞭解，請參閱測試服務端點的網路連線能力。
請連絡您的網路管理員，以取得針對網路連線能力進行疑難解答的其他協助。

注意事項

一旦還原與 Azure 檔案同步服務的網路連線，可能不會立即繼續同步處理。根據預設，如果伺服器端點位置內未偵測到任何變更，Azure 檔案同步會每隔 30 分鐘起始一次同步會話。若要強制同步會話，請重新啟動記憶體同步代理程式 (FileSyncSvc) 服務，或變更伺服器端點位置內的檔案或目錄。

服務已對使用者要求進行節流。

錯誤	代碼
HRESULT	0x80c8004c
HRESULT (十進位)	-2134376372
錯誤字串	ECS_E_USER_REQUEST_THROTTLED
需要補救	否

不需要採取任何動作;伺服器會再試一次。如果此錯誤持續數小時，請建立支援要求。

同步失敗，因為作業已中止

錯誤	代碼
HRESULT	0x80c83000
HRESULT (十進位)	-2134364160
錯誤字串	ECS_E_OPERATION_ABORTED
需要補救	否

不用執行任何動作。如果此錯誤持續數小時，請建立支援要求。

作業已取消。

錯誤	代碼
HRESULT	0x80c8308d
HRESULT (十進位)	-2134364019
錯誤字串	ECS_E_REQUEST_CANCELLED_EXTERNALLY
需要補救	否

錯誤	代碼
HRESULT	0x8013153b
HRESULT (十進位)	-2146233029
錯誤字串	COR_E_OPERATIONCANCELED
需要補救	否

不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。

在還原後完成變更偵測之前，會封鎖同步處理

錯誤	代碼
HRESULT	0x80c83075
HRESULT (十進位)	-2134364043
錯誤字串	ECS_E_SYNC_BLOCKED_ON_CHANGE_DETECTION_POST_RESTORE
需要補救	否

不用執行任何動作。使用 Azure 備份還原 (雲端端點) 的檔案或檔案共享時，會封鎖同步，直到 Azure 檔案共用上的變更偵測完成為止。一旦還原完成且持續時間是以檔案共用中的檔案數目為基礎，變更偵測就會立即執行。

因為在同步處理資料夾上還原期間起始暫停，所以會封鎖資料夾上的同步處理。

錯誤	代碼
HRESULT	0x80c83058
HRESULT (十進位)	-2134364072
錯誤字串	ECS_E_SYNC_BLOCKED_ON_RESTORE
需要補救	否

不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。

同步失敗，因為同步處理資料庫已卸除。

錯誤	代碼
HRESULT	0x80041295
HRESULT (十進位)	-2147216747
錯誤字串	SYNC_E_METADATA_INVALID_OPERATION
需要補救	否

當備份應用程式建立 VSS 快照集並卸除同步資料庫時，通常會發生此錯誤。如果此錯誤持續數小時，請建立支援要求。

同步無法存取雲端端點中指定的 Azure 檔案共用。

錯誤	代碼
HRESULT	0x80c8305f
HRESULT (十進位)	-2134364065
錯誤字串	ECS_E_EXTERNAL_STORAGE_ACCOUNT_AUTHORIZATION_FAILED
需要補救	是

錯誤	代碼
HRESULT	0x80c86053
HRESULT (十進位)	-2134351789
錯誤字串	ECS_E_AZURE_FILE_SHARE_NOT_ACCESSIBLE
需要補救	是

發生此錯誤的原因是 Azure 檔案同步代理程式無法存取 Azure 檔案共用，這可能是因為 Azure 檔案共用或裝載它的記憶體帳戶已不存在。您可以透過下列步驟來針對此錯誤進行疑難解答：

確認記憶體帳戶存在。
確定 Azure 檔案共用存在。
確定 Azure 檔案同步可以存取記憶體帳戶。
確認記憶體帳戶上的 SMB安全性設定 允許 SMB 3.1.1 通訊協定版本、 NTLM v2 驗證和 AES-128-GCM 加密。若要檢查記憶體帳戶上的SMB安全性設定，請參閱 SMB安全性設定。
確認已正確設定記憶體帳戶上的防火牆和虛擬網路設定， (啟用時)

同步失敗，因為要求未獲授權執行此作業。

錯誤	代碼
HRESULT	0x80c86044
HRESULT (十進位)	-2134351804
錯誤字串	ECS_E_AZURE_AUTHORIZATION_FAILED
需要補救	是

發生此錯誤的原因是 Azure 檔案同步代理程式未獲授權存取 Azure 檔案共用。您可以透過下列步驟來針對此錯誤進行疑難解答：

無法解析使用的記憶體帳戶名稱。

錯誤	代碼
HRESULT	0x80C83060
HRESULT (十進位)	-2134364064
錯誤字串	ECS_E_STORAGE_ACCOUNT_NAME_UNRESOLVED
需要補救	是

檢查您是否可以從伺服器解析記憶體 DNS 名稱。

Test-NetConnection -ComputerName <storage-account-name>.file.core.windows.net -Port 443

確認記憶體帳戶存在。
確認已正確設定記憶體帳戶上的防火牆和虛擬網路設定， (啟用時)

注意事項

存取記憶體帳戶時發生未知的錯誤。

錯誤	代碼
HRESULT	0x80c8308a
HRESULT (十進位)	-2134364022
錯誤字串	ECS_E_STORAGE_ACCOUNT_UNKNOWN_ERROR
需要補救	是

同步失敗，因為記憶體帳戶已鎖定。

錯誤	代碼
HRESULT	0x80c83092
HRESULT (十進位)	-2134364014
錯誤字串	ECS_E_STORAGE_ACCOUNT_LOCKED
需要補救	是

發生此錯誤是因為記憶體帳戶具有唯讀資源鎖定。若要解決此問題，請移除記憶體帳戶上的唯讀資源鎖定。

同步處理失敗，因為同步處理資料庫發生問題。

錯誤	代碼
HRESULT	0x8e5e044e
HRESULT (十進位)	-1906441138
錯誤字串	JET_errWriteConflict
需要補救	是

當 Azure 檔案同步使用的內部資料庫發生問題時，就會發生此錯誤。發生此問題時，請建立支援要求，我們會連絡您以協助您解決此問題。

不支援安裝在伺服器上的 Azure 檔案同步代理程式版本。

錯誤	代碼
HRESULT	0x80C8306B
HRESULT (十進位)	-2134364053
錯誤字串	ECS_E_AGENT_VERSION_BLOCKED
需要補救	是

如果不支援安裝在伺服器上的 Azure 檔案同步代理程式版本，就會發生此錯誤。若要解決此問題，請升級至支援的代理程式版本。

您已達到 Azure 檔案共享記憶體限制。

錯誤	代碼
HRESULT	0x80c8603e
HRESULT (十進位)	-2134351810
錯誤字串	ECS_E_AZURE_STORAGE_SHARE_SIZE_LIMIT_REACHED
需要補救	是

錯誤	代碼
HRESULT	0x80c80249
HRESULT (十進位)	-2134375863
錯誤字串	ECS_E_NOT_ENOUGH_REMOTE_STORAGE
需要補救	是

當達到 Azure 檔案共用記憶體限制時，同步會話會失敗併發生這些錯誤，如果 Azure 檔案共用套用配額，或使用量超過 Azure 檔案共用的限制，就可能發生此情況。如需詳細資訊，請參閱 Azure 檔案共用的目前限制。

瀏覽至記憶體同步服務內的同步群組。
選取同步群組內的雲端端點。
請記下開啟窗格中的 Azure 檔案共用名。選取檔案共用名，以開啟記憶體帳戶中的檔案共享設定頁面。
選取檔案共用，以取得 [ 概觀 ] 頁面上的詳細數據。
選 取 [編輯配額 ] 以驗證檔案共用配額。除非已指定替代配額，否則配額會符合 Azure 檔案共用的大小上限。

如果檔案共用已滿 (使用的容量等於配額) ，請釋放檔案共用上的空間。修正此問題的其中一個可能方式，是將目前伺服器端點的每個子資料夾設為自己的伺服器端點，並置於自己的個別同步群組中。如此一來，每個子資料夾都會同步至個別的 Azure 檔案共用。

找不到 Azure 檔案共用。

錯誤	代碼
HRESULT	0x80c86030
HRESULT (十進位)	-2134351824
錯誤字串	ECS_E_AZURE_FILE_SHARE_NOT_FOUND
需要補救	是

當無法存取 Azure 檔案共享時，就會發生此錯誤。若要進行疑難解答：

確認記憶體帳戶存在。
確定 Azure 檔案共用存在。
確認記憶體帳戶上的 SMB安全性設定 允許 SMB 3.1.1 通訊協定版本、 NTLM v2 驗證和 AES-128-GCM 加密。若要檢查記憶體帳戶上的SMB安全性設定，請參閱 SMB安全性設定。

如果 Azure 檔案共享已刪除，您必須建立新的檔案共享，然後重新建立同步群組。

同步處理會在此 Azure 訂用帳戶暫停時暫停。

錯誤	代碼
HRESULT	0x80C83076
HRESULT (十進位)	-2134364042
錯誤字串	ECS_E_SYNC_BLOCKED_ON_SUSPENDED_SUBSCRIPTION
需要補救	是

當 Azure 訂用帳戶暫停時，就會發生此錯誤。當 Azure 訂用帳戶還原時，將會重新啟用同步處理。如需詳細資訊，請參閱為何停用我的 Azure 訂用帳戶，以及如何重新啟用它？

記憶體帳戶已設定防火牆或虛擬網路。

錯誤	代碼
HRESULT	0x80c8033e
HRESULT (十進位)	-2134375618
錯誤字串	ECS_E_SERVER_BLOCKED_BY_NETWORK_ACL
需要補救	是

當 Azure 檔案共用因為記憶體帳戶防火牆或記憶體帳戶屬於虛擬網路而無法存取時，就會發生此錯誤。確認已正確設定記憶體帳戶上的防火牆和虛擬網路設定。如需詳細資訊，請參閱設定防火牆和虛擬網路設定。

同步處理失敗，因為同步處理資料庫發生問題。

錯誤	代碼
HRESULT	0x80c80219
HRESULT (十進位)	-2134375911
錯誤字串	ECS_E_SYNC_METADATA_WRITE_LOCK_TIMEOUT
需要補救	否

錯誤	代碼
HRESULT	0x80c83044
HRESULT (十進位)	-2134364092
錯誤字串	ECS_E_SYNC_METADATA_WRITE_LOCK_TIMEOUT_SERVICEUNAVAILABLE
需要補救	否

這些錯誤通常會自行解決，如果有下列情況，可能會發生：

同步群組中伺服器上的大量檔案變更。
個別檔案和目錄發生大量錯誤。

如果此錯誤持續超過數小時，請建立支援要求，我們會與您連絡以協助您解決此問題。

同步處理資料庫發生記憶體忙碌 IO 錯誤。

錯誤	代碼
HRESULT	0x80c8021f
HRESULT (十進位)	-2134375905
錯誤字串	ECS_E_SYNC_METADATA_IO_BUSY
需要補救	否

不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。

同步處理資料庫發生 IO 逾時。

錯誤	代碼
HRESULT	0x80c8021e
HRESULT (十進位)	-2134375906
錯誤字串	ECS_E_SYNC_METADATA_IO_TIMEOUT
需要補救	否

不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。

同步處理資料庫發生 IO 錯誤。

錯誤	代碼
HRESULT	0x80c80220
HRESULT (十進位)	-2134375904
錯誤字串	ECS_E_SYNC_METADATA_IO_ERROR
需要補救	否

不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。

同步失敗，因為數據已損毀且無法讀取。

錯誤	代碼
HRESULT	0x80071128
HRESULT (十進位)	-2147020504
錯誤字串	ERROR_INVALID_REPARSE_DATA
需要補救	是

如果伺服器端點所在的NTFS磁碟區發生檔系統損毀，就會發生此錯誤。若要解決此錯誤，請在磁碟區上執行 chkdsk 。

伺服器無法建立安全連線。雲端服務收到非預期的憑證。

錯誤	代碼
HRESULT	0x800b0109
HRESULT (十進位)	-2146762487
錯誤字串	CERT_E_UNTRUSTEDROOT
需要補救	是

如果您的組織使用 TLS 終止 Proxy，或惡意實體攔截伺服器與 Azure 檔案同步服務之間的流量，就可能發生此錯誤。如果您確定因為貴組織使用 TLS 終止 Proxy) 而預期會 (，則會略過具有登錄覆寫的憑證驗證。

建立登錄 SkipVerifyingPinnedRootCertificate 值。

New-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Azure\StorageSync -Name SkipVerifyingPinnedRootCertificate -PropertyType DWORD -Value 1

在已註冊的伺服器上重新啟動同步處理服務。
```
Restart-Service -Name FileSyncSvc -Force
```

藉由設定此登錄值，Azure 檔案同步代理程式會在伺服器與雲端服務之間傳輸數據時，接受任何本機信任的 TLS/SSL 憑證。

同步失敗，因為伺服器無法譯碼來自 Azure 檔案同步服務的回應。

錯誤	代碼
HRESULT	0x80072f8f
HRESULT (十進位)	-2147012721
錯誤字串	WININET_E_DECODING_FAILED
需要補救	是

如果防火牆、Proxy 或閘道封鎖對 PKI URL 的存取，或 PKI 伺服器已關閉，通常會發生此錯誤。

若要解決此問題，請確定伺服器可以存取下列URL：

https://www.microsoft.com/pki/mscorp/cps
http://crl.microsoft.com/pki/mscorp/crl/
http://mscrl.microsoft.com/pki/mscorp/crl/
http://ocsp.msocsp.com
http://ocsp.digicert.com/
http://crl3.digicert.com/

安裝 Azure 檔案同步代理程序之後，PKI URL 會用來下載與 Azure 檔案同步服務和 Azure 檔案共享通訊所需的中繼憑證。 OCSP URL 可用來檢查憑證的狀態。如果錯誤持續數天，請建立支援要求。

同步失敗，因為驗證發生問題。

錯誤	代碼
HRESULT	0x80c80300
HRESULT (十進位)	-2134375680
錯誤字串	ECS_E_SERVER_CREDENTIAL_NEEDED
需要補救	是

此錯誤通常是因為伺服器時間不正確而發生。如果伺服器是在虛擬機中執行，請確認主機上的時間正確無誤。

同步失敗，因為憑證到期。

錯誤	代碼
HRESULT	0x80c83078
HRESULT (十進位)	-2134364040
錯誤字串	ECS_E_AUTH_SRV_CERT_EXPIRED
需要補救	是

發生此錯誤的原因是用於驗證的憑證已過期。

若要確認憑證已過期，請執行下列步驟：

開啟 [憑證 MMC] 嵌入式管理單元，選取 [ 計算機帳戶] ，然後流覽至 [ 本機計算機 (憑證) \Personal\Certificates]。
檢查客戶端驗證憑證是否已過期。

如果客戶端驗證憑證已過期，請在伺服器上執行下列 PowerShell 命令：

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

同步失敗，因為找不到驗證憑證。

錯誤	代碼
HRESULT	0x80c80228
HRESULT (十進位)	-2134375896
錯誤字串	ECS_E_AUTH_SRV_CERT_NOT_FOUND
需要補救	是

發生此錯誤是因為找不到用於驗證的憑證。

若要解決此問題，請在伺服器上執行下列 PowerShell 命令：

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

同步失敗，因為找不到驗證身分識別。

錯誤	代碼
HRESULT	0x80c83079
HRESULT (十進位)	-2134364039
錯誤字串	ECS_E_AUTH_IDENTITY_NOT_FOUND
需要補救	是

發生此錯誤的原因是伺服器端點刪除失敗，而端點現在處於部分刪除狀態。若要解決此問題，請重試刪除伺服器端點。

伺服器端點所在的磁碟區磁碟區磁碟空間不足。

錯誤	代碼
HRESULT	0x8e5e0211
HRESULT (十進位)	-1906441711
錯誤字串	JET_errLogDiskFull
需要補救	是

錯誤	代碼
HRESULT	0x80c8031a
HRESULT (十進位)	-2134375654
錯誤字串	ECS_E_NOT_ENOUGH_LOCAL_STORAGE
需要補救	是

同步會話因其中一個錯誤而失敗，因為磁碟區磁碟空間不足或達到磁碟配額限制。此錯誤通常會發生，因為伺服器端點外部的檔案正在用盡磁碟區上的空間。檢查伺服器上的可用磁碟空間。您可以藉由新增其他伺服器端點、將檔案移至不同的磁碟區，或增加伺服器端點所在的磁碟區大小，來釋放磁碟區上的空間。如果使用檔伺服器 Resource Manager 或 NTFS 配額在磁碟區上設定磁碟配額，請增加配額限制。

如果已針對伺服器端點啟用雲端階層處理，請確認檔案正在同步至 Azure 檔案共用，以避免磁碟空間不足。

服務尚未準備好與此伺服器端點同步。

錯誤	代碼
HRESULT	0x80c8300f
HRESULT (十進位)	-2134364145
錯誤字串	ECS_E_REPLICA_NOT_READY
需要補救	否

之所以發生此錯誤，是因為雲端端點是使用已存在於 Azure 檔案共用上的內容所建立。 Azure 檔案同步必須先掃描 Azure 檔案共用中的所有內容，才能允許伺服器端點繼續進行其初始同步處理。在 Azure 檔案共用上完成變更偵測之後，就會開始同步處理。變更偵測可能需要超過 24 小時才能完成，且與 Azure 檔案共用上的檔案和目錄數目成正比。如果已設定雲端階層處理，則檔案會在同步處理完成後分層。

同步失敗，因為有許多個別檔案發生問題。

錯誤	代碼
HRESULT	0x80c8023b
HRESULT (十進位)	-2134375877
錯誤字串	ECS_E_SYNC_METADATA_KNOWLEDGE_SOFT_LIMIT_REACHED
需要補救	是

錯誤	代碼
HRESULT	0x80c8021c
HRESULT (十進位)	-2134375908
錯誤字串	ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED
需要補救	是

錯誤	代碼
HRESULT	0x80c80253
HRESULT (十進位)	-2134375853
錯誤字串	ECS_E_TOO_MANY_PER_ITEM_ERRORS
需要補救	是

當有許多檔案無法與每個項目錯誤同步時，同步會話會失敗，並出現其中一個錯誤。執行如何? 查看是否有未同步處理的特定檔案或資料夾一節中所述的步驟，以解決每個項目的錯誤。針對同步錯誤ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED，請開啟支援案例。

注意事項

Azure 檔案同步每天在伺服器上建立一次暫時 VSS 快照集，以同步處理具有開啟句柄的檔案。

同步失敗，因為伺服器端點路徑發生問題。

錯誤	代碼
HRESULT	0x80c80019
HRESULT (十進位)	-2134376423
錯誤字串	ECS_E_SYNC_INVALID_PATH
需要補救	是

確定路徑存在、位於本機 NTFS 磁碟區上，且不是重新分析點或現有的伺服器端點。

同步失敗，因為篩選驅動程式版本與代理程式版本不相容

錯誤	代碼
HRESULT	0x80C80277
HRESULT (十進位)	-2134375817
錯誤字串	ECS_E_INCOMPATIBLE_FILTER_VERSION
需要補救	是

之所以發生此錯誤，是因為載入的雲端階層處理篩選驅動程式 (StorageSync.sys) 版本與記憶體同步代理程式 (FileSyncSvc) 服務不相容。如果 Azure 檔案同步代理程式已升級，請重新啟動伺服器以完成安裝。如果錯誤持續發生，請卸載代理程式、重新啟動伺服器，然後重新安裝 Azure 檔案同步代理程式。

服務目前無法使用。

錯誤	代碼
HRESULT	0x80c8004b
HRESULT (十進位)	-2134376373
錯誤字串	ECS_E_SERVICE_UNAVAILABLE
需要補救	否

發生此錯誤的原因是 Azure 檔案同步服務無法使用。當 Azure 檔案同步服務再次可用時，將會自動解決此錯誤。

注意事項

一旦還原 Azure 檔案同步服務的網路連線，可能不會立即繼續同步處理。根據預設，如果伺服器端點位置內未偵測到任何變更，Azure 檔案同步會每隔 30 分鐘起始一次同步會話。若要強制同步會話，請重新啟動記憶體同步代理程式 (FileSyncSvc) 服務，或變更伺服器端點位置內的檔案或目錄。

同步失敗，因為發生例外狀況。

錯誤	代碼
HRESULT	0x80131500
HRESULT (十進位)	-2146233088
錯誤字串	COR_E_EXCEPTION
需要補救	否

發生此錯誤是因為因例外狀況而同步失敗。如果錯誤持續數小時，請建立支援要求。

同步失敗，因為記憶體帳戶已故障轉移到另一個區域。

錯誤	代碼
HRESULT	0x80c83073
HRESULT (十進位)	-2134364045
錯誤字串	ECS_E_STORAGE_ACCOUNT_FAILED_OVER
需要補救	是

發生此錯誤的原因是記憶體帳戶已故障轉移至另一個區域。 Azure 檔案同步不支援記憶體帳戶故障轉移功能。不應故障轉移包含 Azure 檔案共用做為 Azure 檔案同步中雲端端點的記憶體帳戶。這麼做會導致同步處理停止運作，而且在新分層檔案的情況下也可能會造成非預期的數據遺失。若要解決此問題，請將記憶體帳戶移至主要區域。

同步失敗，因為同步處理資料庫發生暫時性問題。

錯誤	代碼
HRESULT	0x80c8020e
HRESULT (十進位)	-2134375922
錯誤字串	ECS_E_SYNC_METADATA_WRITE_LEASE_LOST
需要補救	否

發生此錯誤的原因是同步處理資料庫發生內部問題。此錯誤會在同步重試時自動解決。如果此錯誤持續一段時間，請建立支援要求，我們會與您連絡以協助您解決此問題。

同步失敗，因為租使用者 Microsoft Entra 變更

錯誤	代碼
HRESULT	0x80c83088
HRESULT (十進位)	-2134364024
錯誤字串	ECS_E_INVALID_AAD_TENANT
需要補救	是

確認您已安裝最新的 Azure 檔案同步代理程式版本，並將記憶體帳戶的存取權授與 Microsoft.StorageSync 應用程式 (請參閱確定 Azure 檔案同步可以存取記憶體帳戶) 。

同步失敗，因為未設定防火牆和虛擬網路例外狀況

錯誤	代碼
HRESULT	0x80c83096
HRESULT (十進位)	-2134364010
錯誤字串	ECS_E_MGMT_STORAGEACLSBYPASSNOTSET
需要補救	是

如果已在記憶體帳戶上啟用防火牆和虛擬網路設定，而且未檢查 [允許受信任的 Microsoft 服務存取此記憶體帳戶] 例外狀況，就會發生此錯誤。若要解決此問題，請遵循部署指南中設定防火牆和虛擬網路設定一節中所述的步驟。

同步失敗，因為記憶體帳戶的安全性設定或伺服器上的NTFS許可權而拒絕存取。

錯誤	代碼
HRESULT	0x80070005
HRESULT (十進位)	-2147024891
錯誤字串	ERROR_ACCESS_DENIED
需要補救	是

如果 Azure 檔案同步因為安全性設定而無法存取記憶體帳戶，或 NT AUTHORITY\SYSTEM 帳戶沒有伺服器端點所在磁碟區上 [系統磁碟區資訊] 資料夾的許可權，就會發生此錯誤。如果個別檔案無法與ERROR_ACCESS_DENIED同步，請執行針對每個檔案/目錄同步錯誤進行疑難解答一節中所述的步驟。

確認記憶體帳戶上的 SMB安全性設定 允許 SMB 3.1.1 通訊協定版本、 NTLM v2 驗證和 AES-128-GCM 加密。若要檢查記憶體帳戶上的SMB安全性設定，請參閱 SMB安全性設定。
確認已正確設定記憶體帳戶上的防火牆和虛擬網路設定， (啟用時)
執行下列步驟，確認 NT AUTHORITY\SYSTEM 帳戶具有伺服器端點所在磁碟區上 [系統磁碟區資訊 ] 資料夾的許可權：
1. 下載 Psexec 工具。
2. 從提升許可權的命令提示字元執行下列命令，以使用系統帳戶啟動命令提示字元： PsExec.exe -i -s -d cmd。
3. 從在系統帳戶下執行的命令提示字元中，執行下列命令以確認 NT AUTHORITY\SYSTEM 帳戶沒有 系統磁碟區資訊 資料夾的存取權： cacls "drive letter:\system volume information" /T /C。
4. 如果 NT AUTHORITY\SYSTEM 帳戶無法存取 [系統磁 碟區資訊] 資料夾，請執行下列命令： cacls "drive letter:\system volume information" /T /E /G "NT AUTHORITY\SYSTEM:F"。
  
  如果步驟 d 因存取遭拒而失敗，請執行下列命令來取得 系統磁碟區資訊 資料夾的擁有權，然後重複步驟 d：
  
  takeown /A /R /F "drive letter:\System Volume Information"

同步失敗，因為 Azure 檔案共用已刪除並重新建立。

錯誤	代碼
HRESULT	0x80c8027e
HRESULT (十進位)	-2134375810
錯誤字串	ECS_E_SYNC_REPLICA_ROOT_CHANGED
需要補救	是

發生此錯誤的原因是 Azure 檔案同步不支援在相同的同步群組中刪除和重新建立 Azure 檔案共用。

若要解決此問題，請執行下列步驟來刪除並重新建立同步群組：

刪除同步群組中的所有伺服器端點。
刪除雲端端點。
刪除同步群組。
如果已在伺服器端點上啟用雲端階層處理，請執行刪除伺服器端點之後伺服器無法存取階層式檔案一節中所述的步驟，刪除伺服器上的孤立階層式檔案。
重新建立同步群組。

同步偵測到複本已還原為較舊的狀態

錯誤	代碼
HRESULT	0x80c80254
HRESULT (十進位)	-2134375852
錯誤字串	ECS_E_SYNC_REPLICA_BACK_IN_TIME
需要補救	否

不用執行任何動作。發生此錯誤是因為同步偵測到複本已還原為較舊的狀態。同步現在會進入對帳模式，藉由合併 Azure 檔案共用的內容和伺服器端點上的數據來重新建立同步關聯性。觸發對帳模式時，程式可能會非常耗時，視命名空間大小而定。在對帳完成之前，不會進行一般同步處理，而且在 Azure 檔案共用與伺服器端點之間) 不同 (上次修改時間或大小的檔案將會導致檔案衝突。

同步失敗，因為已重新導向 HTTP 要求

錯誤	代碼
HRESULT	0x80190133
HRESULT (十進位)	-2145844941
錯誤字串	HTTP_E_STATUS_REDIRECT_KEEP_VERB
需要補救	是

發生此錯誤的原因是 Azure 檔案同步不支援 HTTP 重新導向 (3xx 狀態代碼) 。若要解決此問題，請停用 Proxy 伺服器或網路裝置上的 HTTP 重新導向。

同步會話逾時錯誤。

錯誤	代碼
HRESULT	0x80c8304a
HRESULT (十進位)	-2134364086
錯誤字串	ECS_E_WORK_FRAMEWORK_TIMEOUT
需要補救	否

錯誤	代碼
HRESULT	0x80c83049
HRESULT (十進位)	-2134364087
錯誤字串	ECS_E_WORK_FRAMEWORK_RESULT_NOT_FOUND
需要補救	否

錯誤	代碼
HRESULT	0x80c83093
HRESULT (十進位)	-2134364013
錯誤字串	ECS_E_WORK_RESULT_EXPIRED
需要補救	否

不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。

作業逾時。

錯誤	代碼
HRESULT	0x80131505
HRESULT (十進位)	-2146233083
錯誤字串	COR_E_TIMEOUT
需要補救	否

不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。

逾時錯誤。

錯誤	代碼
HRESULT	0x80c8600d
HRESULT (十進位)	-2134351859
錯誤字串	ECS_E_AZURE_OPERATION_TIME_OUT
需要補救	否

不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。

同步失敗，因為伺服器上找不到伺服器端點路徑。

錯誤	代碼
HRESULT	0x80c8027a
HRESULT (十進位)	-2134375814
錯誤字串	ECS_E_SYNC_ROOT_DIRECTORY_NOT_FOUND
需要補救	是

如果做為伺服器端點路徑的目錄已重新命名或刪除，就會發生此錯誤。如果目錄已重新命名，請將目錄重新命名回原始名稱，然後重新啟動記憶體同步代理程式服務 (FileSyncSvc) 。

如果已刪除目錄，請執行下列步驟來移除現有的伺服器端點，並使用新的路徑建立新的伺服器端點：

依照移除伺服器端點中所述的步驟，移除同步群組中的伺服器端點。
遵循新增伺服器端點中所述的步驟，在同步群組中建立新的伺服器端點。

伺服器端點布建失敗，因為伺服器路徑空白。

錯誤	代碼
HRESULT	0x80C80299
HRESULT (十進位)	-2134375783
錯誤字串	ECS_E_SYNC_AUTHORITATIVE_UPLOAD_EMPTY_SET
需要補救	是

如果符合下列條件，伺服器端點布建會失敗，並出現此錯誤碼：

此伺服器端點是以初始同步模式布建：伺服器授權
本地伺服器路徑是空的，或不包含可辨識為可同步處理的專案。

此布建錯誤可防止您刪除 Azure 檔案共用中可能提供的所有內容。伺服器授權上傳是一種特殊模式，可利用來自伺服器位置的更新來趕上已植入的雲端位置。請檢閱此移轉指南，以瞭解已建置此模式的案例。

依照移除伺服器端點中所述的步驟，移除同步群組中的伺服器端點。
遵循新增伺服器端點中所述的步驟，在同步群組中建立新的伺服器端點。

擁有記憶體帳戶的訂用帳戶已停用。

錯誤	代碼
HRESULT	0x80c83087
HRESULT (十進位)	-2134364025
錯誤字串	ECS_E_STORAGE_ACCOUNT_SUBSCRIPTION_DISABLED
需要補救	是

請檢查並確定記憶體帳戶所在的訂用帳戶已啟用。

指定的網路名稱已無法再使用。

錯誤	代碼
HRESULT	0x80070040
HRESULT (十進位)	-2147024832
錯誤字串	ERROR_NETNAME_DELETED
需要補救	是

使用 Cmdlet Test-StorageSyncNetworkConnectivity 來檢查服務端點的網路連線能力。如需詳細資訊，請參閱測試服務端點的網路連線能力。

同步會話錯誤。

錯誤	代碼
HRESULT	0x80c8300d
HRESULT (十進位)	-2134364147
錯誤字串	ECS_E_CANNOT_CREATE_ACTIVE_SESSION_PLACEHOLDER_BLOB
需要補救	否

錯誤	代碼
HRESULT	0x80c8300e
HRESULT (十進位)	-2134364146
錯誤字串	ECS_E_CANNOT_UPDATE_REPLICA_WATERMARK
需要補救	否

錯誤	代碼
HRESULT	0x80c8024a
HRESULT (十進位)	-2134375862
錯誤字串	ECS_E_SYNC_DEFERRAL_QUEUE_RESTART_SESSION
需要補救	否

錯誤	代碼
HRESULT	0x80c83098
HRESULT (十進位)	-2134364008
錯誤字串	ECS_E_STORAGE_ACCOUNT_MGMT_OPERATION_THROTTLED
需要補救	否

錯誤	代碼
HRESULT	0x80c83082
HRESULT (十進位)	-2134364030
錯誤字串	ECS_E_ASYNC_WORK_ACTION_UNABLE_TO_RETRY
需要補救	否

錯誤	代碼
HRESULT	0x80c83006
HRESULT (十進位)	-2134364154
錯誤字串	ECS_E_ECS_BATCH_ERROR
需要補救	否

不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。

同步會話錯誤。

錯誤	代碼
HRESULT	0x80c830a1
HRESULT (十進位)	-2134363999
錯誤字串	ECS_TOO_MANY_ETAGVERIFICATION_FAILURES
需要補救	也許

錯誤	代碼
HRESULT	0x80c8023c
HRESULT (十進位)	-2134375876
錯誤字串	ECS_E_SYNC_CLOUD_METADATA_CORRUPT
需要補救	也許

錯誤	代碼
HRESULT
HRESULT (十進位)
錯誤字串
需要補救	也許

如果錯誤持續超過一天，請建立支援要求。

發生內部錯誤。

錯誤	代碼
HRESULT	0x80070057
HRESULT (十進位)	-2147024809
錯誤字串	ERROR_INVALID_PARAMETER
需要補救	否

錯誤	代碼
HRESULT	0x80c80302
HRESULT (十進位)	-2134375678
錯誤字串	ECS_E_UNKNOWN_HTTP_SERVER_ERROR
需要補救	否

錯誤	代碼
HRESULT	0x8004100c
HRESULT (十進位)	-2147217396
錯誤字串	SYNC_E_DESERIALIZATION
需要補救	否

錯誤	代碼
HRESULT	0x80c8022d
HRESULT (十進位)	-2134375891
錯誤字串	ECS_E_SYNC_METADATA_UNCOMMITTED_TX_LIMIT_REACHED
需要補救	否

錯誤	代碼
HRESULT	0x80c83097
HRESULT (十進位)	-2134364009
錯誤字串	ECS_E_QUEUE_CLIENT_EXCEPTION
需要補救	否

錯誤	代碼
HRESULT	0x80c80245
HRESULT (十進位)	-2134375867
錯誤字串	ECS_E_EPOCH_CHANGE_DETECTED
需要補救	否

錯誤	代碼
HRESULT	0x80072ef3
HRESULT (十進位)	-2147012877
錯誤字串	WININET_E_INCORRECT_HANDLE_STATE
需要補救	否

不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。

發生內部錯誤。

錯誤	代碼
HRESULT	0x80131509
HRESULT (十進位)	-2146233079
錯誤字串	COR_E_INVALIDOPERATION
需要補救	也許

錯誤	代碼
HRESULT	0x80070718
HRESULT (十進位)	-2147023080
錯誤字串	ERROR_NOT_ENOUGH_QUOTA
需要補救	也許

錯誤	代碼
HRESULT	0x80131622
HRESULT (十進位)	-2146232798
錯誤字串	COR_E_OBJECTDISPOSED
需要補救	也許

錯誤	代碼
HRESULT	0x80004002
HRESULT (十進位)	-2147467262
錯誤字串	E_NOINTERFACE
需要補救	也許

錯誤	代碼
HRESULT	0x800700a1
HRESULT (十進位)	-2147024735
錯誤字串	ERROR_BAD_PATHNAME
需要補救	也許

錯誤	代碼
HRESULT	0x8007054f
HRESULT (十進位)	-2147023537
錯誤字串	ERROR_INTERNAL_ERROR
需要補救	也許

錯誤	代碼
HRESULT	0x80131501
HRESULT (十進位)	-2146233087
錯誤字串	COR_E_SYSTEM
需要補救	也許

錯誤	代碼
HRESULT	0x80131620
HRESULT (十進位)	-2146232800
錯誤字串	COR_E_IO
需要補救	也許

錯誤	代碼
HRESULT	0x80070026
HRESULT (十進位)	-2147024858
錯誤字串	COR_E_ENDOFSTREAM
需要補救	也許

錯誤	代碼
HRESULT	0x80070554
HRESULT (十進位)	-2147023532
錯誤字串	ERROR_NO_SUCH_PACKAGE
需要補救	也許

錯誤	代碼
HRESULT	0x80131537
HRESULT (十進位)	-2146233033
錯誤字串	COR_E_FORMAT
需要補救	也許

錯誤	代碼
HRESULT	0x8007001f
HRESULT (十進位)	-2147024865
錯誤字串	ERROR_GEN_FAILURE
需要補救	也許

如果錯誤持續超過一天，請建立支援要求。

發生內部錯誤。

錯誤	代碼
HRESULT	0x80004003
HRESULT (十進位)	-2147467261
錯誤字串	E_POINTER
需要補救	是

請升級至最新的檔案同步代理程式版本。如果在升級代理程式之後持續發生錯誤，請建立支援要求。

作業因驗證失敗而失敗。

錯誤	代碼
HRESULT	0x8007052e
HRESULT (十進位)	-2147023570
錯誤字串	ERROR_LOGON_FAILURE
需要補救	也許

錯誤	代碼
HRESULT	0x8007051f
HRESULT (十進位)	-2147023585
錯誤字串	ERROR_NO_LOGON_SERVERS
需要補救	也許

如果錯誤持續超過一天，請建立支援要求。

已停用指定的 Azure 帳戶。

錯誤	代碼
HRESULT	0x80c86003
HRESULT (十進位)	-2134351869
錯誤字串	ECS_E_AZURE_ACCOUNT_IS_DISABLED
需要補救	是

請檢查並確定記憶體帳戶所在的訂用帳戶已啟用。

已封鎖記憶體帳戶金鑰型驗證。

錯誤	代碼
HRESULT	0x80c8307c
HRESULT (十進位)	-2134364036
錯誤字串	ECS_E_STORAGE_ACCOUNT_KEY_BASED_AUTHENTICATION_BLOCKED
需要補救	是

在記憶體帳戶上啟用「允許記憶體帳戶金鑰存取」。深入了解。

同步處理需要更新伺服器上的資料庫。

錯誤	代碼
HRESULT	0x80c8003f
HRESULT (十進位)	-2134376385
錯誤字串	ECS_E_SYNC_EPOCH_MISMATCH
需要補救	否

不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。

磁碟區已離線。可能是已移除、未就緒或未連線。

錯誤	代碼
HRESULT	0x80c87104
HRESULT (十進位)	-2134347516
錯誤字串	ECS_E_VOLUME_OFFLINE
需要補救	是

請確認伺服器端點所在的磁碟區已連結至伺服器。

已封鎖私人端點設定存取。

錯誤	代碼
HRESULT	0x80c83099
HRESULT (十進位)	-2134364007
錯誤字串	ECS_E_PRIVATE_ENDPOINT_ACCESS_BLOCKED
需要補救	是

檢查私人端點設定，並允許存取檔案同步服務。深入了解。

同步處理必須先協調伺服器和 Azure 檔案共享數據，才能上傳檔案。

錯誤	代碼
HRESULT	0x80c80248
HRESULT (十進位)	-2134375864
錯誤字串	ECS_E_REPLICA_RECONCILIATION_NEEDED
需要補救	否

不需要採取任何動作。此錯誤應該會自動解決。如果錯誤持續數天，請建立支援要求。

不允許相同使用者使用多個使用者名稱對伺服器或共用資源進行多個連線。

錯誤	代碼
HRESULT	0x800704c3
HRESULT (十進位)	-2147023677
錯誤字串	ERROR_SESSION_CREDENTIAL_CONFLICT
需要補救	是

中斷所有先前與伺服器或共用資源的連線，然後再試一次。

伺服器的 SSL 憑證無效或已過期。

錯誤	代碼
HRESULT	0x80c80050
HRESULT (十進位)	-2134376368
錯誤字串	ECS_E_SERVER_INVALID_OR_EXPIRED_CERTIFICATE
需要補救	是

在伺服器上執行下列 PowerShell 命令來重設憑證：

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

常見疑難排解步驟

確認記憶體帳戶存在。

入口網站
PowerShell

瀏覽至記憶體同步服務內的同步群組。
選取同步群組內的雲端端點。
請記下開啟窗格中的 Azure 檔案共用名。
選取檔案共用名，以開啟記憶體帳戶中的檔案共享設定頁面。如果無法開啟此連結，則已移除參考的記憶體帳戶。

# Variables for you to populate based on your configuration
$region = "<Az_Region>"
$resourceGroup = "<RG_Name>"
$syncService = "<storage-sync-service>"
$syncGroup = "<sync-group>"

# Log into the Azure account
Connect-AzAccount

# Check to ensure Azure File Sync is available in the selected Azure
# region.
$regions = [System.String[]]@()
Get-AzLocation | ForEach-Object { 
    if ($_.Providers -contains "Microsoft.StorageSync") { 
        $regions += $_.Location 
    } 
}

if ($regions -notcontains $region) {
    throw [System.Exception]::new("Azure File Sync is either not available in the " + `
        " selected Azure Region or the region is mistyped.")
}

# Check to ensure resource group exists
$resourceGroups = [System.String[]]@()
Get-AzResourceGroup | ForEach-Object { 
    $resourceGroups += $_.ResourceGroupName 
}

if ($resourceGroups -notcontains $resourceGroup) {
    throw [System.Exception]::new("The provided resource group $resourceGroup does not exist.")
}

# Check to make sure the provided Storage Sync Service
# exists.
$syncServices = [System.String[]]@()

Get-AzStorageSyncService -ResourceGroupName $resourceGroup | ForEach-Object {
    $syncServices += $_.StorageSyncServiceName
}

if ($syncServices -notcontains $syncService) {
    throw [System.Exception]::new("The provided Storage Sync Service $syncService does not exist.")
}

# Check to make sure the provided Sync Group exists
$syncGroups = [System.String[]]@()

Get-AzStorageSyncGroup -ResourceGroupName $resourceGroup -StorageSyncServiceName $syncService | ForEach-Object {
    $syncGroups += $_.SyncGroupName
}

if ($syncGroups -notcontains $syncGroup) {
    throw [System.Exception]::new("The provided sync group $syncGroup does not exist.")
}

# Get reference to cloud endpoint
$cloudEndpoint = Get-AzStorageSyncCloudEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $syncService `
    -SyncGroupName $syncGroup

# Get reference to storage account
$storageAccount = Get-AzStorageAccount | Where-Object { 
    $_.Id -eq $cloudEndpoint.StorageAccountResourceId
}

if ($storageAccount -eq $null) {
    throw [System.Exception]::new("The storage account referenced in the cloud endpoint does not exist.")
}

確定 Azure 檔案共用存在。

入口網站
PowerShell

選取左側目錄上的 [概觀]，以返回主要記憶體帳戶頁面。
選 取 [檔案 ] 以檢視檔案共享清單。
確認雲端端點所參考的檔案共用會出現在檔案共享清單中， (您應該在上述步驟 1 中記下此) 。

$fileShare = Get-AzStorageShare -Context $storageAccount.Context | Where-Object {
    $_.Name -eq $cloudEndpoint.AzureFileShareName -and
    $_.IsSnapshot -eq $false
}

if ($fileShare -eq $null) {
    throw [System.Exception]::new("The Azure file share referenced by the cloud endpoint does not exist")
}

確定 Azure 檔案同步具有記憶體帳戶的存取權。

入口網站
PowerShell

從左側導 覽中選取 [訪問控制 (IAM) ]。
選取 [ 角色指派] 索引標籤，列出 (可存取記憶體帳戶 的服務主體) 使用者和應用程式。
確認 Microsoft.StorageSync 或混合式檔案同步服務 (舊應用程式名稱) 出現在具有讀取者和數據存取角色的清單中。

如果清單中未顯示 Microsoft.StorageSync 或 Hybrid 檔案同步 Service，請執行下列步驟：
- 選取新增。
- 在 [ 角色] 欄位 中，選取 [ 讀取者] 和 [數據存取]。
- 在 [ 選取 ] 字段中，輸入 Microsoft.StorageSync，選取角色，然後選取 [ 儲存]。

$role = Get-AzRoleAssignment -Scope $storageAccount.Id | Where-Object { $_.DisplayName -eq "Microsoft.StorageSync" }

if ($role -eq $null) {
    throw [System.Exception]::new("The storage account does not have the Azure File Sync " + `
                "service principal authorized to access the data within the " + ` 
                "referenced Azure file share.")
}

另請參閱

與我們連絡，以取得說明

如果您有問題或需要相關協助，請建立支援要求，或詢問 Azure community 支援。您也可以將產品意見反應提交給 Azure 意應見反社群。

針對同步處理健康情況和錯誤 Azure 檔案同步 進行疑難解答

同步健康情況

如何? 監視同步健康情況？

如何? 監視目前同步會話的進度嗎？

如何? 知道我的伺服器是否彼此同步？

如何? 查看是否有未同步處理的特定檔案或資料夾？

同步錯誤

針對每個檔案/目錄同步錯誤進行疑難解答

處理不支援的字元

常見的同步處理錯誤

常見疑難排解步驟

另請參閱

與我們連絡，以取得說明

意見反應

意見反應

其他資源

針對同步處理健康情況和錯誤 Azure 檔案同步進行疑難解答