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

本文旨在協助您針對使用 Azure 檔案同步部署時所遇到的常見同步問題進行疑難排解，並解決這些問題。

同步健康情況

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

不會立即偵測及複寫使用 Azure 入口網站或 SMB 對 Azure 檔案共用所做的變更，和伺服器端點的變更不一樣。 Azure 檔案儲存體還沒有變更通知或日誌功能，因此在檔案變更時，無法自動起始同步會話。在 Windows Server 上，Azure 檔案同步會使用 Windows USN 日誌，在檔案變更時自動啟動同步工作階段。

若要偵測 Azure 檔案共用的變更，Azure 檔案同步有個已排程的作業，稱為「變更偵測作業」。變更偵測作業會列舉檔案共用的每個檔案，然後比較該檔案的同步版本。當變更偵測作業判斷檔案已有變更時，Azure 檔案同步就會起始同步工作階段。變更偵測作業會每隔 24 小時起始。由於變更偵測作業的運作方式是列舉 Azure 檔案共用的每個檔案，大命名空間會比小命名空間耗費更長的時間。大命名空間判斷哪些檔案已變更所耗費的時間，可能會超過 24 小時 (每隔 24 小時執行一次偵測作業)。

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

我們發現，為 Azure 檔案新增變更偵測，類似於在 Windows 伺服器上磁碟區的 USN 變更偵測。請至 Azure 社群意見反應投票，協助我們決定此功能後續的開發優先順序。

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

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

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

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

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

健康狀態	Description	Remediation
Healthy	同步會話成功完成，或進行中的同步會話正在進行中（已套用檔案）。	N/A
Pending	建立伺服器端點之後，必須是擱置狀態。將伺服器端點的同步遙測傳送至服務之後，健康情況狀態將會更新。	如果健全狀況狀態未變更數小時，請參閱伺服器端點健全狀況處於擱置狀態數小時。
Error	同步會話失敗，發生錯誤。	若要解決此問題，請在入口網站中選取錯誤狀態，以取得錯誤碼和補救步驟。如果未在入口網站中列出補救步驟或無法解決問題，請搜尋本檔中的錯誤碼以取得更多指引。
沒有任何活動	過去兩小時內，記憶體同步服務尚未收到來自此伺服器端點的同步遙測。	若要解決此問題，請遵循疑難解答 Azure 檔案同步同步群組管理中的步驟。
低磁碟模式	伺服器端點所在的磁碟區沒有足夠的磁碟空間。	若要解決此問題，請釋放磁碟區上的磁碟空間。若要深入瞭解磁碟空間不足模式，請參閱雲端階層處理概觀。
佈建已取消	伺服器端點建立失敗。同步處理無法在此伺服器端點上運作。	若要解決此問題，請參閱伺服器端點建立和刪除錯誤。

Note

伺服器端點狀態（健全狀況和活動）會每隔 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 但仍繼續進行，而有部分檔案成功同步。進度可以藉由查看 [套用] 字段（AppliedFileCount、 AppliedDirCountAppliedTombstoneCount、和 AppliedSizeBytes）來決定。這些欄位可說明工作階段的完成度。如果您在連續看到多個同步處理工作階段失敗，但 [已套用] 計數增加，則您應該在開啟支援票證之前，讓同步處理時間再試一次。

如何監視目前同步工作階段的進度？

Portal
Server

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

Note

如果 [預估完成] 為空白，這表示同步處理尚未完成計算同步處理工作階段中的檔案數目。

查看伺服器上遙測記錄檔中最新的 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.

如何得知我的伺服器是否彼此保持同步？

Portal
Server

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

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

查看已完成的同步工作階段，這在每個伺服器的遙測事件記錄中會以 9102 事件標示 (在 [事件檢視器] 中，移至 Applications and Services Logs\Microsoft\FileSync\Agent\Telemetry)。

在任何給定的伺服器上，您都會想要確定最新的上傳和下載工作階段已順利完成。

若要這樣做，請檢查 HResult 和 PerItemErrorCount 是否同時上傳和下載（ SyncDirection 欄位指出指定的工作階段是否為上傳或下載會話）。請注意，如果您沒有看到最近完成的同步會話，則同步會話目前可能正在進行中，如果您剛新增或修改大量數據，就應該預期。
如果伺服器與雲端之間的狀態是最新的，且雙向都沒有需要同步的變更，您將會看到空的同步工作階段。如果上傳和下載中的所有 [同步]* 欄位 (SyncFileCount、SyncDirCount、SyncTombstoneCount 和 SyncSizeBytes) 皆為零 (表示沒有可同步的項目)，即表示此狀態。請注意，這些空的同步工作階段不會出現在高變換伺服器上，因為此處總是會有需要同步的新項目。如果沒有同步活動，此類工作階段應該每 30 分鐘出現一次。
如果所有伺服器與雲端之間的狀態都是最新的，這表示其最近的上傳和下載工作階段都是空的同步工作階段，而您可以合理斷定整體系統皆已同步。

如果您直接在 Azure 檔案共用中進行變更，Azure 檔案同步在變更列舉執行之前不會偵測到這些變更，這會每隔 24 小時執行一次。當伺服器實際上遺漏直接在 Azure 檔案共用中所做的最新變更時，它仍有可能認定本身與雲端之間的狀態是最新的。

如何確認是否有特定的檔案或資料夾並未同步？

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

Note

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

若要查看無法同步處理的檔案和目錄名稱，請執行 FileSyncErrorsReport.ps1 PowerShell 腳本（位於 Azure 檔案同步代理程式的代理程式安裝目錄中）或使用 Debug-StorageSyncServer Cmdlet。 ItemPath 欄位會指出檔案與根同步目錄的相對位置。請參閱補救步驟的常見個別項目錯誤清單。

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

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

同步處理錯誤

個別檔案/目錄同步錯誤的疑難排解

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

Note

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

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

HRESULT	HRESULT （十進位）	錯誤字串	Issue	Remediation
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 腳本來判斷相依資料夾尚未同步處理的原因。
0x80c80206	-2134375930	ECS_E_SYNC_ITEM_PROCESS_FAIL_RECOVERABLE	檔案或目錄變更尚無法同步處理，因為專案發生可復原失敗。	暫時性錯誤。如果此錯誤持續存在數日，請建立支援要求。
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	檔案或目錄名稱無效。	請重新命名有問題的檔案或目錄。如需詳細資訊，請參閱處理不支援的字元。
0x80c8026d	-2134375827	ECS_E_SYNC_ITEM_RESTRICTED_AT_ROOT	指定的專案名稱限制在同步共用的根目錄，因此無法同步處理。	不需要執行任何動作。如需詳細資訊，請參閱文件系統相容性。
0x80c80018	-2134376424	ECS_E_SYNC_FILE_IN_USE	檔案正在使用中，無法同步。檔案不再處於使用中狀態時即會同步。	不需要執行任何動作。 Azure 檔案同步每天會在伺服器上建立一個暫時的 VSS 快照集，用以同步具有開啟控制代碼的檔案。
0x80c86013	-2134351853	ECS_E_SYNC_CLOUD_FILE_IN_USE	無法同步處理雲端檔案，因為它正在使用中。當應用程式保存雲端中檔案的開啟句柄時，就會發生此錯誤，以防止執行同步處理作業，直到應用程式釋放句柄為止。	檢查開啟的檔案句柄，如果不再需要它們，請將其關閉。如需詳細資訊，請參閱列出控點和強制關閉控點。
0x80c8031d	-2134375651	ECS_E_CONCURRENCY_CHECK_FAILED	檔案已變更，但同步處理尚未偵測到變更。偵測到這項變更之後，同步處理就會復原。	不需要執行任何動作。
0x80F2019F	-2160590943	ECS_E_AZURE_FILE_PATH_TOO_LONG	檔案路徑長度超過 Azure 檔案記憶體支援的路徑長度。	執行 FileSyncErrorsReport.ps1 PowerShell 腳本（位於 Azure 檔案同步代理程式的代理程式安裝目錄中）來識別失敗的檔案路徑，然後使用 ScanUnsupportedChars 腳本。
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	由於非預期錯誤導致檔案無法同步。	如果錯誤持續數天，請開啟支援案例。
0x80c8308f	-2134364017	ECS_E_ETAG_VERIFCATION_FAILED	檔案無法同步，因為ETag驗證與目標物失敗。	如果錯誤持續數天，請開啟支援案例。
0x80070020	-2147024864	ERROR_SHARING_VIOLATION	檔案正在使用中，無法同步。檔案不再處於使用中狀態時即會同步。	不需要執行任何動作。
0x80c80017	-2134376425	ECS_E_SYNC_OPLOCK_BROKEN	檔案在同步期間有所變更，因此需要再次同步。	不需要執行任何動作。
0x80070017	-2147024873	ERROR_CRC	由於 CRC 錯誤導致檔案無法同步。如果未在刪除伺服器端點之前重新叫用階層式檔案，或檔案已損毀，就會發生此錯誤。	若要解決此問題，請參閱伺服器上的階層式檔案無法存取，以移除孤立的階層式檔案。如果移除孤立的分層檔案後，錯誤繼續發生，請在磁碟區上執行 chkdsk 。
0x800703ee	-2147023890	ERROR_FILE_INVALID	無法同步處理檔案，因為檔案已不再有效。如果檔案已分層並孤立，則通常會發生此錯誤。	如果檔案已分層，請參閱伺服器上的階層式檔案無法存取，以移除孤立的階層式檔案。
0x80070570	-2147023504	ERROR_FILE_CORRUPT	檔案或目錄已損毀，且無法讀取。	在磁碟區上執行 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	發生內部錯誤。	如果此錯誤持續存在超過一天，請建立支援要求。
0x80070032	-2147024846	錯誤_不支援	檔案無法上傳，因為分級檔案可能是孤兒檔。
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	同步處理資料庫具有比支援的版本更高的自定義元數據。	請將檔案同步代理程序升級至最新版本。如果升級代理程式之後發生錯誤，請建立支援要求。
0x80c8604b	-2134351797	ECS_E_AZURE_FILE_SHARE_FILE_NOT_FOUND	在檔案共用中找不到指定的 Azure 檔案。如果檔案已刪除且同步處理不知道變更，就可能發生此問題。	不需要執行任何動作。當變更偵測可偵測到檔案已遭刪除後，同步作業將會停止記錄此錯誤。
0x80c80201	-2134375935	ECS_E_SYNC_UNPROCESSABLE_ITEM_REPARSEPOINT	同步處理失敗，因為存在重新分析點。	拿掉重新分析點，或將它取代為一般檔案內容，然後再嘗試再次同步處理。
0x80c80362	-2134375582	ECS_E_ITEM_PATH_COMPONENT_HAS_TRAILING_DOT	項目無法同步處理，因為其中一個路徑元件具有尾端點。	拿掉路徑中出現的任何尾端點，以重新命名專案。
0x80c8024e	-2134375858	ECS_E_SYNC_ITEM_SKIP_CONSTRAINT_CONFLICT_NOT_ALLOWED	此錯誤表示偵測到但無法回報的條件約束衝突。將會略過專案。	如果錯誤持續發生，請建立支援要求。
0x80c80208	-2134375928	ECS_E_SYNC_ITEM_RECONCILIATION_SKIP	同步處理程式期間略過檔案或目錄，以重建同步用戶端的元數據。它會在下一次完整同步處理嘗試中進行同步。	如果此錯誤持續存在數日，請建立支援要求。

處理不支援的字元

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

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

常見同步錯誤

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

同步工作階段已取消。

Error	Code
HRESULT	0x800704c7
HRESULT （十進位）	-2147023673
錯誤字串	ERROR_CANCELLED
需要補救	No

同步工作階段可能因多種不同原因而失敗，包括伺服器正在重新啟動或更新、VSS 快照集等。雖然此錯誤看似需要後續追蹤，但除非錯誤持續存在達數小時，否則皆可安全地加以忽略。

磁碟區快照集同步工作階段已取消，該工作階段每天執行一次，以同步處理具有開啟控制代碼的檔案。

Error	Code
HRESULT	0x80c8029c
HRESULT （十進位）	-2134375780
錯誤字串	ECS_E_SYNC_CANCELLED_BY_VSS
需要補救	No

不需要執行任何動作。 Azure 檔案同步有一個排程的工作（VssSyncScheduledTask），每天在伺服器上執行一次，以同步處理正在使用中的檔案。當此排程工作啟動時，它會取消目前的上傳同步會話（導致0x80c8029c錯誤碼）、建立 VSS 快照集，並使用 VSS 快照集啟動新的上傳同步會話。

：無法建立與此服務的連線。

Error	Code
HRESULT	0x80072ee7
HRESULT （十進位）	-2147012889
錯誤字串	WININET_E_NAME_NOT_RESOLVED
需要補救	Yes

Error	Code
HRESULT	0x80c83081
HRESULT （十進位）	-2134364031
錯誤字串	ECS_E_HTTP_CLIENT_CONNECTION_ERROR
需要補救	Yes

Error	Code
HRESULT	0x80c8309a
HRESULT （十進位）	-2134364006
錯誤字串	ECS_E_AZURE_STORAGE_REMOTE_NAME_NOT_RESOLVED
需要補救	Yes

Error	Code
HRESULT	0xc00000c4
HRESULT （十進位）	-1073741628
錯誤字串	UNEXPECTED_NETWORK_ERROR
需要補救	Yes

Error	Code
HRESULT	0x80072ee2
HRESULT （十進位）	-2147012894
錯誤字串	WININET_E_TIMEOUT
需要補救	Yes

Error	Code
HRESULT	0x80072EFE
HRESULT （十進位）	-2147012866
錯誤字串	WININET_E_CONNECTION_ABORTED
需要補救	Yes

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

確認 Windows 服務 FileSyncSvc.exe 未被防火牆封鎖。
確認連接埠 443 已開放給 Azure 檔案同步服務的傳出連線。您可以透過 Test-NetConnection Cmdlet 完成這項作業。您可以在 Azure 檔案同步 Proxy 和防火牆設定<azure-file-sync-endpoint>URL。
```
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
```
使用 Test-StorageSyncNetworkConnectivity 來檢查與服務端點的網路連線能力。若要深入了解，請參閱測試與服務端點的網路連線能力 (機器翻譯)。
如需針對網路連線進行疑難排解的其他協助，請連絡網路系統管理員。

Note

Azure 檔案同步服務的網路連線恢復後，同步可能不會立即繼續執行。根據預設，如果在伺服器端點位置內未偵測到任何變更，Azure 檔案同步將會每 30 分鐘起始一次同步工作階段。若要強制同步工作階段，請重新啟動儲存體同步代理程式 (FileSyncSvc) 服務，或對伺服器端點位置內的檔案或目錄進行變更。

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

Error	Code
HRESULT	0x80c8004c
HRESULT （十進位）	-2134376372
錯誤字串	ECS_E_USER_REQUEST_THROTTLED
需要補救	No

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

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

Error	Code
HRESULT	0x80c83000
HRESULT （十進位）	-2134364160
錯誤字串	ECS_E_OPERATION_ABORTED
需要補救	No

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

作業已經取消。

Error	Code
HRESULT	0x80c8308d
HRESULT （十進位）	-2134364019
錯誤字串	ECS_E_REQUEST_CANCELLED_EXTERNALLY
需要補救	No

Error	Code
HRESULT	0x8013153b
HRESULT （十進位）	-2146233029
錯誤字串	COR_E_OPERATIONCANCELED
需要補救	No

不需要執行任何動作。此錯誤應該會自動解決。如果此錯誤持續存在數日，請建立支援要求。

同步會遭到封鎖，直到變更偵測完成後續還原為止

Error	Code
HRESULT	0x80c83075
HRESULT （十進位）	-2134364043
錯誤字串	ECS_E_SYNC_BLOCKED_ON_CHANGE_DETECTION_POST_RESTORE
需要補救	No

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

因為在同步處理資料夾的還原過程中已啟動暫停，所以已禁止資料夾的同步處理。

Error	Code
HRESULT	0x80c83058
HRESULT （十進位）	-2134364072
錯誤字串	ECS_E_SYNC_BLOCKED_ON_RESTORE
需要補救	No

不需要執行任何動作。此錯誤應該會自動解決。如果此錯誤持續存在數日，請建立支援要求。

同步失敗，因為同步資料庫已卸載。

Error	Code
HRESULT	0x80041295
HRESULT （十進位）	-2147216747
錯誤字串	SYNC_E_METADATA_INVALID_OPERATION
需要補救	No

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

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

Error	Code
HRESULT	0x80c8305f
HRESULT （十進位）	-2134364065
錯誤字串	ECS_E_EXTERNAL_STORAGE_ACCOUNT_AUTHORIZATION_FAILED
需要補救	Yes

Error	Code
HRESULT	0x80c86053
HRESULT （十進位）	-2134351789
錯誤字串	ECS_E_AZURE_FILE_SHARE_NOT_ACCESSIBLE
需要補救	Yes

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

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

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

Error	Code
HRESULT	0x80c86044
HRESULT （十進位）	-2134351804
錯誤字串	ECS_E_AZURE_AUTHORIZATION_FAILED
需要補救	Yes

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

使用的儲存體帳戶名稱無法解析。

Error	Code
HRESULT	0x80C83060
HRESULT （十進位）	-2134364064
錯誤字串	ECS_E_STORAGE_ACCOUNT_NAME_UNRESOLVED
需要補救	Yes

確認您可以解析來自伺服器的儲存體 DNS 名稱。

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

確認儲存體帳戶確實存在。
請確認是否已在儲存體帳戶上正確設定防火牆和虛擬網路設定 (若已啟用的話)

Note

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

Error	Code
HRESULT	0x80c8308a
HRESULT （十進位）	-2134364022
錯誤字串	ECS_E_STORAGE_ACCOUNT_UNKNOWN_ERROR
需要補救	Yes

同步失敗，因為儲存體帳戶已遭鎖定。

Error	Code
HRESULT	0x80c83092
HRESULT （十進位）	-2134364014
錯誤字串	ECS_E_STORAGE_ACCOUNT_LOCKED
需要補救	Yes

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

同步因同步資料庫發生問題而失敗。

Error	Code
HRESULT	0x8e5e044e
HRESULT （十進位）	-1906441138
錯誤字串	JET_errWriteConflict
需要補救	Yes

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

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

Error	Code
HRESULT	0x80C8306B
HRESULT （十進位）	-2134364053
錯誤字串	ECS_E_AGENT_VERSION_BLOCKED
需要補救	Yes

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

已達到 Azure 檔案共用儲存空間限制。

Error	Code
HRESULT	0x80c8603e
HRESULT （十進位）	-2134351810
錯誤字串	ECS_E_AZURE_STORAGE_SHARE_SIZE_LIMIT_REACHED
需要補救	Yes

Error	Code
HRESULT	0x80c80249
HRESULT （十進位）	-2134375863
錯誤字串	ECS_E_NOT_ENOUGH_REMOTE_STORAGE
需要補救	Yes

在達到 Azure 檔案共用儲存空間限制時 (可能在 Azure 檔案共用套用了配額，或 Azure 檔案共用的使用量超出限制時發生)，同步工作階段就會失敗並出現上述其中一項錯誤。如需詳細資訊，請參閱 Azure 檔案共用目前的限制。

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

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

找不到 Azure 檔案共用。

Error	Code
HRESULT	0x80c86030
HRESULT （十進位）	-2134351824
錯誤字串	ECS_E_AZURE_FILE_SHARE_NOT_FOUND
需要補救	Yes

無法存取 Azure 檔案共用時，就會發生此錯誤。若要疑難排解：

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

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

此 Azure 訂用帳戶暫止期間，會暫停同步。

Error	Code
HRESULT	0x80C83076
HRESULT （十進位）	-2134364042
錯誤字串	ECS_E_SYNC_BLOCKED_ON_SUSPENDED_SUBSCRIPTION
需要補救	Yes

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

儲存體帳戶已設定防火牆或虛擬網路。

Error	Code
HRESULT	0x80c8033e
HRESULT （十進位）	-2134375618
錯誤字串	ECS_E_SERVER_BLOCKED_BY_NETWORK_ACL
需要補救	Yes

因為儲存體帳戶有防火牆，或因為儲存體帳戶屬於虛擬網路，而無法存取 Azure 檔案共用時，就會發生此錯誤。請確認是否已在儲存體帳戶上正確設定防火牆和虛擬網路設定。如需詳細資訊，請參閱設定防火牆和虛擬網路設定 (機器翻譯)。

同步因同步資料庫發生問題而失敗。

Error	Code
HRESULT	0x80c80219
HRESULT （十進位）	-2134375911
錯誤字串	ECS_E_SYNC_METADATA_WRITE_LOCK_TIMEOUT
需要補救	No

Error	Code
HRESULT	0x80c83044
HRESULT （十進位）	-2134364092
錯誤字串	ECS_E_SYNC_METADATA_WRITE_LOCK_TIMEOUT_SERVICEUNAVAILABLE
需要補救	No

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

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

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

同步資料庫發生儲存體忙碌 IO 錯誤。

Error	Code
HRESULT	0x80c8021f
HRESULT （十進位）	-2134375905
錯誤字串	ECS_E_SYNC_METADATA_IO_BUSY
需要補救	No

不需要執行任何動作。此錯誤應該會自動解決。如果此錯誤持續存在數日，請建立支援要求。

同步資料庫發生 IO 逾時。

Error	Code
HRESULT	0x80c8021e
HRESULT （十進位）	-2134375906
錯誤字串	ECS_E_SYNC_METADATA_IO_TIMEOUT
需要補救	No

不需要執行任何動作。此錯誤應該會自動解決。如果此錯誤持續存在數日，請建立支援要求。

同步資料庫發生 IO 錯誤。

Error	Code
HRESULT	0x80c80220
HRESULT （十進位）	-2134375904
錯誤字串	ECS_E_SYNC_METADATA_IO_ERROR
需要補救	No

不需要執行任何動作。此錯誤應該會自動解決。如果此錯誤持續存在數日，請建立支援要求。

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

Error	Code
HRESULT	0x80071128
HRESULT （十進位）	-2147020504
錯誤字串	ERROR_INVALID_REPARSE_DATA
需要補救	Yes

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

同步失敗，因為重新分析點緩衝區中的標記無效。

Error	Code
HRESULT	0x80071129
HRESULT （十進位）	-2147020503
錯誤字串	ERROR_REPARSE_TAG_INVALID
需要補救	Yes

當不同組態的伺服器之間複製檔案時，就會發生此錯誤。例如，使用檔系統篩選驅動程式或已啟用重複資料刪除功能的伺服器，將檔案傳送到其中一個功能不存在，可能會導致無法讀取的檔案，因為重新分析點無效。若要解決此錯誤，請刪除受影響的檔案，或將它們重新複製為實際檔案，而不是重新分析點。

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

Error	Code
HRESULT	0x800b0109
HRESULT （十進位）	-2146762487
錯誤字串	CERT_E_UNTRUSTEDROOT
需要補救	Yes

如果組織目前使用 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 檔案同步服務的回應。

Error	Code
HRESULT	0x80072f8f
HRESULT （十進位）	-2147012721
錯誤字串	WININET_E_DECODING_FAILED
需要補救	Yes

如果防火牆、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 是用來檢查憑證的狀態。如果錯誤持續數天，請建立支援要求。

同步因驗證有問題而失敗。

Error	Code
HRESULT	0x80c80300
HRESULT （十進位）	-2134375680
錯誤字串	ECS_E_SERVER_CREDENTIAL_NEEDED
需要補救	Yes

此錯誤通常是因為伺服器時間不正確所造成。如果伺服器正在虛擬機器中執行，請確認主機的時間是否正確。

同步因憑證過期而失敗。

Error	Code
HRESULT	0x80c83078
HRESULT （十進位）	-2134364040
錯誤字串	ECS_E_AUTH_SRV_CERT_EXPIRED
需要補救	Yes

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

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

開啟 [憑證 MMC] 嵌入式管理單元，選取 [電腦帳戶] ，然後流覽至 [憑證（本機電腦）\個人\憑證]。
檢查用戶端驗證憑證是否已過期。

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

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

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

Error	Code
HRESULT	0x80c80228
HRESULT （十進位）	-2134375896
錯誤字串	ECS_E_AUTH_SRV_CERT_NOT_FOUND
需要補救	Yes

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

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

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

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

Error	Code
HRESULT	0x80c83079
HRESULT （十進位）	-2134364039
錯誤字串	ECS_E_AUTH_IDENTITY_NOT_FOUND
需要補救	Yes

此錯誤可能會因為下列原因而發生：

伺服器的受控識別租用戶識別碼不符合儲存體同步服務或儲存體帳戶的租用戶識別碼。
伺服器最近已重新註冊或其受控識別設定已變更，但更新尚未傳播。

伺服器端點所在的磁碟區沒有足夠的磁碟空間。

Error	Code
HRESULT	0x8e5e0211
HRESULT （十進位）	-1906441711
錯誤字串	JET_errLogDiskFull
需要補救	Yes

Error	Code
HRESULT	0x80c8031a
HRESULT （十進位）	-2134375654
錯誤字串	ECS_E_NOT_ENOUGH_LOCAL_STORAGE
需要補救	Yes

磁碟區沒有足夠的磁碟空間或已達到磁碟配額限制，因此同步工作階段失敗，並出現上述其中一項錯誤。之所以發生此錯誤，常是因為伺服器端點以外的檔案即將用盡磁碟區的空間。檢查伺服器上的可用磁碟空間。新增額外的伺服器端點、將檔案移至不同的磁碟區，或增加伺服器端點所在磁碟區的大小，便可以釋出磁碟區的空間。如果已使用檔案伺服器資源管理員或 NTFS 配額在磁碟區上設定了磁碟配額，請提高配額限制。

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

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

Error	Code
HRESULT	0x80c8300f
HRESULT （十進位）	-2134364145
錯誤字串	ECS_E_REPLICA_NOT_READY
需要補救	No

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

同步因許多個別檔案有問題而失敗。

Error	Code
HRESULT	0x80c8023b
HRESULT （十進位）	-2134375877
錯誤字串	ECS_E_SYNC_METADATA_KNOWLEDGE_SOFT_LIMIT_REACHED
需要補救	Yes

Error	Code
HRESULT	0x80c8021c
HRESULT （十進位）	-2134375908
錯誤字串	ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED
需要補救	Yes

Error	Code
HRESULT	0x80c80253
HRESULT （十進位）	-2134375853
錯誤字串	ECS_E_TOO_MANY_PER_ITEM_ERRORS
需要補救	Yes

有許多檔案因個別項目錯誤而無法同步時，同步工作階段就會失敗，並出現上述其中一項錯誤。執行如何確認是否有特定的檔案或資料夾並未同步？一節中所述的步驟，以解決個別項目錯誤。針對同步錯誤 ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED，請開啟支援案例。

Note

Azure 檔案同步每天會在伺服器上建立一個暫時的 VSS 快照集，用以同步具有開啟控制代碼的檔案。

同步因伺服器端點路徑有問題而失敗。

Error	Code
HRESULT	0x80c80019
HRESULT （十進位）	-2134376423
錯誤字串	ECS_E_SYNC_INVALID_PATH
需要補救	Yes

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

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

Error	Code
HRESULT	0x80C80277
HRESULT （十進位）	-2134375817
錯誤字串	ECS_E_INCOMPATIBLE_FILTER_VERSION
需要補救	Yes

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

服務目前無法使用。

Error	Code
HRESULT	0x80c8004b
HRESULT （十進位）	-2134376373
錯誤字串	ECS_E_SERVICE_UNAVAILABLE
需要補救	No

之所以發生此錯誤，是因為 Azure 檔案同步服務無法使用。此錯誤會在 Azure 檔案同步服務恢復運作時自動解決。

Note

同步因例外狀況而失敗。

Error	Code
HRESULT	0x80131500
HRESULT （十進位）	-2146233088
錯誤字串	COR_E_EXCEPTION
需要補救	No

發生此錯誤的原因是例外狀況造成同步失敗。如果此錯誤持續存在數小時，請建立支援要求。

儲存體帳戶已容錯移轉至另一個區域，因此同步失敗。

Error	Code
HRESULT	0x80c83073
HRESULT （十進位）	-2134364045
錯誤字串	ECS_E_STORAGE_ACCOUNT_FAILED_OVER
需要補救	Yes

之所以發生此錯誤，是因為儲存體帳戶已容錯移轉至另一個區域。 Azure 檔案同步不支援記憶體帳戶故障轉移功能。不應該容錯移轉包含在 Azure 檔案同步中作為雲端端點使用之 Azure 檔案共用的儲存體帳戶。這麼做將導致同步停止運作，且可能會在新分層的檔案中產生未預期的資料遺失。若要解決此問題，請將儲存體帳戶移至主要區域。

同步因同步資料庫發生暫時性問題而失敗。

Error	Code
HRESULT	0x80c8020e
HRESULT （十進位）	-2134375922
錯誤字串	ECS_E_SYNC_METADATA_WRITE_LEASE_LOST
需要補救	No

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

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

Error	Code
HRESULT	0x80c83088
HRESULT （十進位）	-2134364024
錯誤字串	ECS_E_INVALID_AAD_TENANT
需要補救	Yes

確認擁有最新的 Azure 檔案同步代理程式版本後，將儲存體帳戶的存取權授與 Microsoft.StorageSync 應用程式 (請參閱確定 Azure 檔案同步具有儲存體帳戶的存取權)。

同步因未設定防火牆與虛擬網路例外狀況而失敗

Error	Code
HRESULT	0x80c83096
HRESULT （十進位）	-2134364010
錯誤字串	ECS_E_MGMT_STORAGEACLSBYPASSNOTSET
需要補救	Yes

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

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

Error	Code
HRESULT	0x80070005
HRESULT （十進位）	-2147024891
錯誤字串	ERROR_ACCESS_DENIED
需要補救	Yes

如果 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 檔案共用已刪除並重新建立，因此同步失敗。

Error	Code
HRESULT	0x80c8027e
HRESULT （十進位）	-2134375810
錯誤字串	ECS_E_SYNC_REPLICA_ROOT_CHANGED
需要補救	Yes

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

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

刪除同步群組中的所有伺服器端點。
刪除雲端端點。
刪除同步群組。
如果在伺服器端點上啟用雲端階層處理，請在伺服器區段上執行階層式檔案中所述的步驟，刪除伺服器上的孤立階層式檔案。
重新建立同步群組。

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

Error	Code
HRESULT	0x80c80254
HRESULT （十進位）	-2134375852
錯誤字串	ECS_E_SYNC_REPLICA_BACK_IN_TIME
需要補救	No

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

同步失敗，因為伺服器端點的路徑已變更

Error	Code
HRESULT	0x80c802a1
HRESULT （十進位）	-2134375775
錯誤字串	ECS_E_SYNC_ROOT_VOLUME_CHANGED
需要補救	No

之所以發生此錯誤，是因為現在布建伺服器端點的路徑與原本布建的磁碟區不同。發生此問題時，請建立支援要求，我們會連絡您以協助您解決問題。

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

Error	Code
HRESULT	0x80190133
HRESULT （十進位）	-2145844941
錯誤字串	HTTP_E_STATUS_REDIRECT_KEEP_VERB
需要補救	Yes

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

同步工作階段逾時錯誤。

Error	Code
HRESULT	0x80c8304a
HRESULT （十進位）	-2134364086
錯誤字串	ECS_E_WORK_FRAMEWORK_TIMEOUT
需要補救	No

Error	Code
HRESULT	0x80c83049
HRESULT （十進位）	-2134364087
錯誤字串	ECS_E_WORK_FRAMEWORK_RESULT_NOT_FOUND
需要補救	No

Error	Code
HRESULT	0x80c83093
HRESULT （十進位）	-2134364013
錯誤字串	ECS_E_WORK_RESULT_EXPIRED
需要補救	No

不需要執行任何動作。此錯誤應該會自動解決。如果此錯誤持續存在數日，請建立支援要求。

作業超時。

Error	Code
HRESULT	0x80131505
HRESULT （十進位）	-2146233083
錯誤字串	COR_E_TIMEOUT
需要補救	No

不需要執行任何動作。此錯誤應該會自動解決。如果此錯誤持續存在數日，請建立支援要求。

逾時錯誤。

Error	Code
HRESULT	0x80c8600d
HRESULT （十進位）	-2134351859
錯誤字串	ECS_E_AZURE_OPERATION_TIME_OUT
需要補救	No

不需要執行任何動作。此錯誤應該會自動解決。如果此錯誤持續存在數日，請建立支援要求。

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

Error	Code
HRESULT	0x80c8027a
HRESULT （十進位）	-2134375814
錯誤字串	ECS_E_SYNC_ROOT_DIRECTORY_NOT_FOUND
需要補救	Yes

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

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

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

伺服器端點佈建因伺服器路徑空白而失敗。

Error	Code
HRESULT	0x80C80299
HRESULT （十進位）	-2134375783
錯誤字串	ECS_E_SYNC_AUTHORITATIVE_UPLOAD_EMPTY_SET
需要補救	Yes

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

此伺服器端點已使用初始同步模式佈建：伺服器授權
本機伺服器路徑是空的，或未包含認定為可同步的項目。

此佈建錯誤會使您無法刪除 Azure 檔案共用中可能可用的所有內容。伺服器授權上傳是一種特殊模式，可讓您利用伺服器位置的更新，得知已植入的雲端位置。檢閱此移轉指南，以瞭解已建置此模式的案例。

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

擁有儲存體帳戶的訂用帳戶已停用。

Error	Code
HRESULT	0x80c83087
HRESULT （十進位）	-2134364025
錯誤字串	ECS_E_STORAGE_ACCOUNT_SUBSCRIPTION_DISABLED
需要補救	Yes

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

指定的網路名稱不再可用。

Error	Code
HRESULT	0x80070040
HRESULT （十進位）	-2147024832
錯誤字串	ERROR_NETNAME_DELETED
需要補救	Yes

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

同步工作階段錯誤。

Error	Code
HRESULT	0x80c8300d
HRESULT （十進位）	-2134364147
錯誤字串	ECS_E_CANNOT_CREATE_ACTIVE_SESSION_PLACEHOLDER_BLOB
需要補救	No

Error	Code
HRESULT	0x80c8300e
HRESULT （十進位）	-2134364146
錯誤字串	ECS_E_CANNOT_UPDATE_REPLICA_WATERMARK
需要補救	No

Error	Code
HRESULT	0x80c8024a
HRESULT （十進位）	-2134375862
錯誤字串	ECS_E_SYNC_DEFERRAL_QUEUE_RESTART_SESSION
需要補救	No

Error	Code
HRESULT	0x80c83098
HRESULT （十進位）	-2134364008
錯誤字串	ECS_E_STORAGE_ACCOUNT_MGMT_OPERATION_THROTTLED
需要補救	No

Error	Code
HRESULT	0x80c83082
HRESULT （十進位）	-2134364030
錯誤字串	ECS_E_ASYNC_WORK_ACTION_UNABLE_TO_RETRY
需要補救	No

Error	Code
HRESULT	0x80c83006
HRESULT （十進位）	-2134364154
錯誤字串	ECS_E_ECS_BATCH_ERROR
需要補救	No

不需要執行任何動作。此錯誤應該會自動解決。如果此錯誤持續存在數日，請建立支援要求。

同步工作階段錯誤。

Error	Code
HRESULT	0x80c830a1
HRESULT （十進位）	-2134363999
錯誤字串	ECS_TOO_MANY_ETAGVERIFICATION_FAILURES
需要補救	Maybe

Error	Code
HRESULT	0x80c8023c
HRESULT （十進位）	-2134375876
錯誤字串	ECS_E_SYNC_CLOUD_METADATA_CORRUPT
需要補救	Maybe

Error	Code
HRESULT
HRESULT （十進位）
錯誤字串
需要補救	Maybe

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

發生內部錯誤。

Error	Code
HRESULT	0x80070057
HRESULT （十進位）	-2147024809
錯誤字串	ERROR_INVALID_PARAMETER
需要補救	No

Error	Code
HRESULT	0x80c80302
HRESULT （十進位）	-2134375678
錯誤字串	ECS_E_UNKNOWN_HTTP_SERVER_ERROR
需要補救	No

Error	Code
HRESULT	0x8004100c
HRESULT （十進位）	-2147217396
錯誤字串	SYNC_E_DESERIALIZATION
需要補救	No

Error	Code
HRESULT	0x80c8022d
HRESULT （十進位）	-2134375891
錯誤字串	ECS_E_SYNC_METADATA_UNCOMMITTED_TX_LIMIT_REACHED
需要補救	No

Error	Code
HRESULT	0x80c83097
HRESULT （十進位）	-2134364009
錯誤字串	ECS_E_QUEUE_CLIENT_EXCEPTION
需要補救	No

Error	Code
HRESULT	0x80c80245
HRESULT （十進位）	-2134375867
錯誤字串	ECS_E_EPOCH_CHANGE_DETECTED
需要補救	No

Error	Code
HRESULT	0x80072ef3
HRESULT （十進位）	-2147012877
錯誤字串	WININET_E_INCORRECT_HANDLE_STATE
需要補救	No

Error	Code
HRESULT	0x80c87093
HRESULT （十進位）	-2134347629
錯誤字串	ECS_E_MGMT_DATA_PLANE_INTERNAL_ERROR
需要補救	No

Error	Code
HRESULT	0x80c87005
HRESULT （十進位）	-2134347771
錯誤字串	ECS_E_MGMT_INTERNAL_ERROR
需要補救	No

不需要執行任何動作。此錯誤應該會自動解決。如果此錯誤持續存在數日，請建立支援要求。

發生內部錯誤。

Error	Code
HRESULT	0x80131509
HRESULT （十進位）	-2146233079
錯誤字串	COR_E_INVALIDOPERATION
需要補救	Maybe

Error	Code
HRESULT	0x80070718
HRESULT （十進位）	-2147023080
錯誤字串	ERROR_NOT_ENOUGH_QUOTA
需要補救	Maybe

Error	Code
HRESULT	0x80131622
HRESULT （十進位）	-2146232798
錯誤字串	COR_E_OBJECTDISPOSED
需要補救	Maybe

Error	Code
HRESULT	0x80004002
HRESULT （十進位）	-2147467262
錯誤字串	E_NOINTERFACE
需要補救	Maybe

Error	Code
HRESULT	0x800700a1
HRESULT （十進位）	-2147024735
錯誤字串	ERROR_BAD_PATHNAME
需要補救	Maybe

Error	Code
HRESULT	0x8007054f
HRESULT （十進位）	-2147023537
錯誤字串	ERROR_INTERNAL_ERROR
需要補救	Maybe

Error	Code
HRESULT	0x80131501
HRESULT （十進位）	-2146233087
錯誤字串	COR_E_SYSTEM
需要補救	Maybe

Error	Code
HRESULT	0x80131620
HRESULT （十進位）	-2146232800
錯誤字串	COR_E_IO
需要補救	Maybe

Error	Code
HRESULT	0x80070026
HRESULT （十進位）	-2147024858
錯誤字串	COR_E_ENDOFSTREAM
需要補救	Maybe

Error	Code
HRESULT	0x80070554
HRESULT （十進位）	-2147023532
錯誤字串	ERROR_NO_SUCH_PACKAGE
需要補救	Maybe

Error	Code
HRESULT	0x80131537
HRESULT （十進位）	-2146233033
錯誤字串	COR_E_FORMAT
需要補救	Maybe

Error	Code
HRESULT	0x8007001f
HRESULT （十進位）	-2147024865
錯誤字串	ERROR_GEN_FAILURE
需要補救	Maybe

Error	Code
HRESULT	0x80041005
HRESULT （十進位）	-2147217403
錯誤字串	SYNC_E_KNOWLEDGE_DECREASED
需要補救	Maybe

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

發生內部錯誤。

Error	Code
HRESULT	0x80004003
HRESULT （十進位）	-2147467261
錯誤字串	E_POINTER
需要補救	Yes

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

作業因為驗證失敗而失敗。

Error	Code
HRESULT	0x8007052e
HRESULT （十進位）	-2147023570
錯誤字串	ERROR_LOGON_FAILURE
需要補救	Maybe

Error	Code
HRESULT	0x8007051f
HRESULT （十進位）	-2147023585
錯誤字串	ERROR_NO_LOGON_SERVERS
需要補救	Maybe

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

已停用指定的 Azure 帳戶。

Error	Code
HRESULT	0x80c86003
HRESULT （十進位）	-2134351869
錯誤字串	ECS_E_AZURE_ACCOUNT_IS_DISABLED
需要補救	Yes

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

已封鎖儲存體帳戶金鑰型驗證。

Error	Code
HRESULT	0x80c8307c
HRESULT （十進位）	-2134364036
錯誤字串	ECS_E_STORAGE_ACCOUNT_KEY_BASED_AUTHENTICATION_BLOCKED
需要補救	Yes

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

同步作業需要更新伺服器上的資料庫。

Error	Code
HRESULT	0x80c8003f
HRESULT （十進位）	-2134376385
錯誤字串	ECS_E_SYNC_EPOCH_MISMATCH
需要補救	No

不需要執行任何動作。此錯誤應該會自動解決。如果此錯誤持續存在數日，請建立支援要求。

磁碟區已離線。磁碟區已移除、尚未就緒或未連線。

Error	Code
HRESULT	0x80c87104
HRESULT （十進位）	-2134347516
錯誤字串	ECS_E_VOLUME_OFFLINE
需要補救	Yes

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

已封鎖私人端點組態存取。

Error	Code
HRESULT	0x80c83099
HRESULT （十進位）	-2134364007
錯誤字串	ECS_E_PRIVATE_ENDPOINT_ACCESS_BLOCKED
需要補救	Yes

檢查私人端點組態並允許存取檔案同步服務。深入瞭解。

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

Error	Code
HRESULT	0x80c80248
HRESULT （十進位）	-2134375864
錯誤字串	ECS_E_REPLICA_RECONCILIATION_NEEDED
需要補救	No

不需要執行任何動作。此錯誤應該會自動解決。如果此錯誤持續存在數日，請建立支援要求。

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

Error	Code
HRESULT	0x800704c3
HRESULT （十進位）	-2147023677
錯誤字串	ERROR_SESSION_CREDENTIAL_CONFLICT
需要補救	Yes

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

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

Error	Code
HRESULT	0x80c80050
HRESULT （十進位）	-2134376368
錯誤字串	ECS_E_SERVER_INVALID_OR_EXPIRED_CERTIFICATE
需要補救	Yes

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

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

常用的疑難排解步驟

確認儲存體帳戶確實存在。

Portal
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 檔案共用確實存在。

Portal
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 檔案同步具有儲存體帳戶的存取權。

Portal
PowerShell

從左側導覽中選取 [存取控制 (IAM)]。
選取 [角色指派] 索引標籤，列出可存取您儲存體帳戶的使用者和應用程式（服務主體）。
確認 Microsoft.StorageSync 或 混合式檔案同步服務 （舊的應用程式名稱）是否顯示在具有 [讀取者] 和 [資料存取 ] 角色的清單中。

如果清單中未出現 Microsoft.StorageSync 或 混合式檔案同步服務 ，請執行下列步驟：
- 選取 ，然後新增。
- 在角色欄位中，選取 讀者和資料存取。
- 在 [選取] 欄位中，輸入 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 社群支援。您也可以向 Azure 意見反應社群提交產品意見反應。

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-08-28

共用方式為

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

同步健康情況

如何監視同步健康情況？

如何監視目前同步工作階段的進度？

如何得知我的伺服器是否彼此保持同步？

如何確認是否有特定的檔案或資料夾並未同步？

同步處理錯誤

個別檔案/目錄同步錯誤的疑難排解

處理不支援的字元

常見同步錯誤

常用的疑難排解步驟

另請參閱

與我們連絡，以取得說明

意見反應

其他資源