針對 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 檔案共用中的命名空間大小。 在變更列舉作業完成後，伺服器端點健康情況應會隨即更新。

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

如何監視同步健康情況？

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.

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

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.

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

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

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

若要查看無法同步的檔案和目錄名稱，請執行 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 事件記錄檔中記錄事件。 本節涵蓋每個專案錯誤的常見錯誤碼和補救步驟。

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

處理不支援的字元

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

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

常見同步錯誤

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

同步工作階段已取消。

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

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

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

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

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

1. 確認防火牆未封鎖 Windows 服務 FileSyncSvc.exe 。

2. 確認連接埠 443 已開放給 Azure 檔案同步服務的傳出連線。 您可以透過 Test-NetConnection Cmdlet 完成這項作業。 您可以在 Azure 檔案同步 Proxy 和防火牆設定檔中找到下列佔位元的 <azure-file-sync-endpoint> URL。

   Test-NetConnection -ComputerName <azure-file-sync-endpoint> -Port 443
   

3. 確定 Proxy 設定已如預期般設定。 這可以透過 Get-StorageSyncProxyConfiguration Cmdlet 完成這項作業。 有關針對 Azure 檔案同步進行 Proxy 設定的詳細資訊，可以在 Azure 檔案同步 Proxy 和防火牆設定中找到。

   $agentPath = "C:\Program Files\Azure\StorageSyncAgent"
   Import-Module "$agentPath\StorageSync.Management.ServerCmdlets.dll"
   Get-StorageSyncProxyConfiguration
   

4. 使用 Test-StorageSyncNetworkConnectivity 來檢查與服務端點的網路連線能力。 若要深入了解，請參閱測試與服務端點的網路連線能力 (機器翻譯)。

5. 如需針對網路連線進行疑難排解的其他協助，請連絡網路系統管理員。

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

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

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

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

作業已經取消。

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

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

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

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

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

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

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

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

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

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

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

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

1. 確認儲存體帳戶確實存在。
2. 確定 Azure 檔案共用確實存在。
3. 請確認是否已在儲存體帳戶上正確設定防火牆和虛擬網路設定 (若已啟用的話)
4. 確定 Azure 檔案同步具有儲存體帳戶的存取權。

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

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

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

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

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

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

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

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

因為儲存體帳戶具有唯讀的資源鎖定 (機器翻譯)，所以發生此錯誤。 若要解決此問題，請移除儲存體帳戶上的唯讀資源鎖定。

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

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

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

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

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

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

1. 瀏覽至儲存體同步服務中的同步群組。

2. 選取同步群組內的雲端端點。

3. 記下開啟的窗格中顯示的 Azure 檔案共用名稱。 選取檔案共享名稱，以在記憶體帳戶中開啟檔案共享設定頁面。

   

4. 選取檔案共用以取得 [ 概觀 ] 頁面上的詳細數據。

5. 選取 [ 編輯配額 ] 以確認檔案共用配額。 除非已指定替代配額，否則配額會符合 Azure 檔案共用的大小上限。

   

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

找不到 Azure 檔案共用。

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

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

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

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

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

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

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

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

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

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

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

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

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

同步資料庫發生 IO 逾時。

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

同步資料庫發生 IO 錯誤。

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

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

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

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

如果組織目前使用 TLS 終止 Proxy 或惡意實體正在攔截伺服器與 Azure 檔案同步服務之間的流量，即可能發生此錯誤。 若確定這是預期中的情況 (因為組織使用 TLS 終止 Proxy)，則透過登錄覆寫來過憑證驗證。

1. 建立登錄 SkipVerifyingPinnedRootCertificate 值。

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

2. 在已註冊的伺服器上重新啟動同步服務。

   Restart-Service -Name FileSyncSvc -Force
   

設定此登錄值之後，在伺服器與雲端服務之間傳送資料時，Azure 檔案同步代理程式即會接受所有本機信任的 TLS/SSL 憑證。

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

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

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

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

同步因憑證過期而失敗。

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

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

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

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

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

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

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

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

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

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

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

• 新的伺服器證書會在 Azure 檔案同步 伺服器上產生，而且舊的憑證仍會快取。 一旦重新整理伺服器快取，就會在幾個小時內解決此錯誤。
• 伺服器端點刪除失敗，使端點處於部分刪除狀態。 若要解決此問題，請再次嘗試刪除伺服器端點。

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

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

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

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

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

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

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

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

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

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

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

服務目前無法使用。

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

同步因例外狀況而失敗。

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

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

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

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

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

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

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

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

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

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

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

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

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

3. 執行下列步驟，確認 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 檔案共用已刪除並重新建立，因此同步失敗。

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

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

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

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

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

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

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

同步工作階段逾時錯誤。

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

作業超時。

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

逾時錯誤。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

同步工作階段錯誤。

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

同步工作階段錯誤。

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

發生內部錯誤。

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

發生內部錯誤。

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

發生內部錯誤。

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

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

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

已停用指定的 Azure 帳戶。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

常用的疑難排解步驟

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

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

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

$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 檔案同步代理程式安裝和伺服器註冊進行疑難排解
• 針對 Azure 檔案同步雲端階層處理進行疑難排解
• 監視 Azure 檔案同步
• 針對 Azure 檔案儲存體問題進行疑難排解

與我們連絡，以取得說明

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