針對 Azure 檔案同步進行移難排解

使用 Azure 檔案同步,將組織的檔案共用集中在 Azure 檔案服務中,同時保有內部部署檔案伺服器的彈性、效能及相容性。 Azure 檔案同步會將 Windows Server 轉換成 Azure 檔案共用的快速快取。 您可以使用 Windows Server 上可用的任何通訊協定來從本機存取資料,包括 SMB、NFS 和 FTPS。 您可以視需要存取多個散佈於世界各地的快取。

本文旨在協助您針對使用 Azure 檔案同步部署時所發生的問題進行疑難排解,並解決這些問題。 文中也說明如果需要更深入調查問題,如何從系統收集重要的記錄。 如果您找不到問題的答案,可透過下列管道 (依先後順序) 和我們連絡:

我在伺服器上的 Azure 檔案同步有問題 (同步、雲端分層等)。 我是否應移除並重新建立伺服器端點?

否:移除伺服器端點不像將伺服器重新開機! 移除並重新建立伺服器端點幾乎不是修正同步、雲端階層處理或 Azure 檔案同步其他方面問題的適當解決方案。移除伺服器端點是破壞性作業。 當階層式檔案存在於伺服器端點命名空間之外時,可能會導致資料遺失。 如需詳細資訊,請參閱為什麼階層式檔案 存在於伺服器端點命名空間外部 ,以取得詳細資訊。 或者,它可能會導致伺服器端點命名空間記憶體在的階層式檔案無法存取檔案。 重新建立伺服器端點時,不會解決這些問題。 分層的檔案可能會位於您的伺服器端點命名空間內部,即使您從未啟用過雲端分層。 這就是為什麼我們建議您不要移除伺服器端點,除非您想要停止在此特定資料夾中使用 Azure 檔案同步,或由 Microsoft 工程師明確指示您這樣做。 如需關於移除伺服器端點的詳細資訊,請參閱移除伺服器端點

代理程式安裝和伺服器註冊

針對代理程式安裝失敗進行疑難排解
如果 Azure 檔案同步代理程式安裝失敗,使用提升權限的命令提示字元,執行下列命令,以啟用代理程式安裝期間的記錄:

StorageSyncAgent.msi /l*v AFSInstaller.log

檢閱 installer.log 判斷安裝失敗的原因。

代理程式安裝失敗,發生錯誤:儲存體同步代理程式安裝程式嚮導因為錯誤而提前結束

在代理程式安裝記錄中,會記錄下列錯誤:

CAQuietExec64:  + CategoryInfo          : SecurityError: (:) , PSSecurityException
CAQuietExec64:  + FullyQualifiedErrorId : UnauthorizedAccess
CAQuietExec64:  Error 0x80070001: Command line returned an error.

如果 PowerShell 執行原則 是使用群組原則設定的,且原則設定為 [只允許已簽署的腳本],就會發生此問題。 Azure 檔案同步代理程式中包含的所有腳本都會經過簽署。 Azure 檔案同步代理程式安裝失敗,因為安裝程式正在使用 [略過執行] 原則設定執行腳本執行。

若要解決此問題,請暫時停用伺服器上的 [ 開啟腳本執行 ] 群組原則設定。 代理程式安裝完成後,就可以重新啟用群組原則設定。

在 Active Directory 網域控制站上安裝代理程式失敗
如果您嘗試在 PDC 角色擁有者執行 Windows Server 2008 R2 或更低 OS 版本的 Active Directory 網域控制站上安裝同步代理程式,則可能會遇到無法安裝同步代理程式的問題。

若要解決此問題,請將 PDC 角色轉移到另一個執行 Windows Server 2012 R2 或更新版本的網域控制站,然後安裝同步代理程式。

存取 Windows Server 2012 R2 上的磁碟區失敗,錯誤:參數不正確
在 Windows Server 2012 R2 上建立伺服器端點之後,會於存取磁碟區時發生下列錯誤:

磁碟機號: \無法存取。
參數錯誤。

若要解決此問題,請安裝 KB2919355 並重新啟動伺服器。 如果此更新將不會安裝,因為已安裝較新的更新,請移至 Windows Update,並安裝 Windows Server 2012 R2 的最新更新,然後重新開機伺服器。

伺服器註冊未列出所有 Azure 訂用帳戶
使用 ServerRegistration.exe 註冊伺服器時,按一下 [Azure 訂用帳戶] 下拉式清單後未顯示訂用帳戶。

發生此問題的原因是 ServerRegistration.exe 只會從前五個 Azure AD 租使用者取得訂用帳戶。

若要增加伺服器的伺服器註冊租使用者限制,請在 [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync 下建立名為 ServerRegistrationTenantLimit 的 DWORD 值,其值大於5。

您也可以使用下列 PowerShell 命令來註冊伺服器,以解決此問題:

Connect-AzAccount -Subscription "<guid>" -Tenant "<guid>"
Register-AzStorageSyncServer -ResourceGroupName "<your-resource-group-name>" -StorageSyncServiceName "<your-storage-sync-service-name>"

伺服器註冊顯示下列訊息:「遺漏必要元件」
如果未在 PowerShell 5.1 上安裝 Az 或 AzureRM PowerShell 模組,就會出現此訊息。

注意

ServerRegistration.exe 不支援 PowerShell6.x。 您可在 PowerShell 6.x 上使用 Register-AzStorageSyncServer Cmdlet 來註冊伺服器。

若要在 PowerShell 5.1 上安裝 Az 或 AzureRM 模組,請執行下列步驟:

  1. 在提升權限的命令提示字元中輸入 powershell,然後按下 Enter。
  2. 參閱下列文件來安裝最新的 Az 或 AzureRM 模組:
  3. 執行 ServerRegistration.exe,然後完成精靈的指示向儲存體同步服務註冊伺服器。

伺服器註冊顯示下列訊息:「此伺服器已註冊」

[伺服器註冊] 對話方塊的螢幕擷取畫面顯示 [此伺服器已註冊] 錯誤訊息

如果先前已向儲存體同步服務註冊該伺服器,就會出現此訊息。 若要向目前的儲存體同步服務取消註冊伺服器,再向新的儲存體同步服務註冊,請完成向 Azure 檔案同步取消註冊伺服器中所述的步驟。

如果伺服器未列在儲存體同步服務的 [已註冊的伺服器] 底下,請在您想要取消註冊的伺服器上執行下列 PowerShell 命令:

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

注意

如果伺服器是叢集的一部分,您可以使用選擇性的 Reset-StorageSyncServer -CleanClusterRegistration 參數,一併移除叢集的註冊。

我在註冊伺服器時收到多個「網站不受信任」回應,原因為何?
如果在伺服器註冊期間啟用了 增強的 Internet Explorer 安全性 原則,便會發生此問題。 若想進一步了解如何正確停用 增強的 Internet Explorer 安全性 原則,請參閱 準備 Windows Server 以搭配 Azure 檔案同步使用如何部署 Azure 檔案同步

伺服器未列在 Azure 入口網站的 [已註冊的伺服器] 下
如果伺服器未列在儲存體同步服務的 [已註冊的伺服器] 下:

  1. 登入您要註冊的伺服器。
  2. 開啟 [檔案總管],然後移至儲存體同步代理程式的安裝目錄 (預設位置是 C:\Program Files\Azure\StorageSyncAgent)。
  3. 執行 ServerRegistration.exe,然後完成精靈的指示向儲存體同步服務註冊伺服器。

同步群組管理

雲端端點建立錯誤

雲端端點建立失敗,發生此錯誤:「指定的 Azure 檔案共用已由不同雲端端點使用中」
如果 Azure 檔案共用已由另一個雲端端點使用中,則會發生這個錯誤。

如果您看到這個訊息,而 Azure 檔案共用目前未由雲端端點使用中,請執行下列步驟,以清除 Azure 檔案共用上的 Azure 檔案同步中繼資料:

警告

刪除 Azure 檔案共用上目前正由雲端端點使用中的中繼資料時,會導致 Azure 檔案同步作業失敗。 如果您接著在不同的同步群組中使用此檔案共用進行同步處理,則舊同步群組中的檔案資料遺失幾乎是特定的。

  1. 在 Azure 入口網站中,移至您的 Azure 檔案共用。
  2. 以滑鼠右鍵按一下 Azure 檔案共用,然後選取 [編輯中繼資料]。
  3. 以滑鼠右鍵按一下 [SyncService],然後選取 [刪除]。

雲端端點建立失敗,發生此錯誤:"AuthorizationFailed"
如果使用者帳戶沒有足夠權限可建立雲端端點,就會發生此錯誤。

若要建立雲端端點,您的使用者帳戶必須具有下列 Microsoft 授權權限:

  • 讀取:取得角色定義
  • 寫入:建立或更新自訂角色定義
  • 讀取:取得角色指派
  • 寫入:建立角色指派

下列內建角色具有所需的 Microsoft 授權權限:

  • 擁有者
  • 使用者存取系統管理員

判斷您的使用者帳戶角色是否具有所需的權限:

  1. 在 Azure 入口網站中,按一下 [資源群組]。
  2. 選取儲存體帳戶所在的資源群組,然後選取 [存取控制 (IAM)]。
  3. 選取 [角色指派] 索引標籤。
  4. 選取您的使用者帳戶的 [角色] (例如,[擁有者]、[參與者])。
  5. 在 [資源提供者] 清單中,選取 [Microsoft 授權]。
    • [角色指派] 應具有 [讀取] 和 [寫入] 權限。
    • [角色定義] 應具有 [讀取] 和 [寫入] 權限。

伺服器端點建立和刪除錯誤

伺服器端點建立失敗,發生此錯誤:"MgmtServerJobFailed" (錯誤碼:-2134375898 或 0x80c80226)
如果伺服器端點路徑位於系統磁碟區上,而且已啟用雲端階層處理,就會發生此錯誤。 系統磁碟區上不支援雲端階層。 若要在系統磁碟區上建立伺服器端點,請於建立伺服器端點時,停用雲端階層處理。

伺服器端點建立失敗,發生此錯誤:"MgmtServerJobFailed" (錯誤碼:-2147024894 或 0x80070002)
如果指定的伺服器端點路徑無效,就會發生這個錯誤。 確認指定的伺服器端點路徑是本機連結的 NTFS 磁碟區。 請注意,Azure 檔案同步不支援將對應磁碟機當做伺服器端點路徑。

伺服器端點建立失敗,發生此錯誤:"MgmtServerJobFailed" (錯誤碼:-2134375640 或 0x80c80328)
如果指定的伺服器端點路徑不是 NTFS 磁碟區,就會發生這個錯誤。 確認指定的伺服器端點路徑是本機連結的 NTFS 磁碟區。 請注意,Azure 檔案同步不支援將對應磁碟機當做伺服器端點路徑。

伺服器端點建立失敗,發生此錯誤:"MgmtServerJobFailed" (錯誤碼:-2134347507 或 0x80c8710)
發生此錯誤的原因是 Azure 檔案同步在具有壓縮的系統磁碟區資訊資料夾的磁片區上不支援伺服器端點。 若要解決此問題,請將「系統磁碟區資訊」資料夾解壓縮。 如果「系統磁碟區資訊」資料夾是磁碟區上唯一已壓縮的資料夾,請執行下列步驟:

  1. 下載 PsExec 工具。
  2. 從提升權限的命令提示字元執行下列命令,以啟動在系統帳戶下執行的命令提示字元:PsExec.exe -i -s -d cmd
  3. 從系統帳戶下執行的命令提示字元中,輸入下列命令,然後按 Enter 鍵:
    cd /d "drive letter:\System Volume Information"
    compact /u /s

伺服器端點建立失敗,發生此錯誤:"MgmtServerJobFailed" (錯誤碼:-2134376345 或 0x80C80067)
如果達到每個伺服器的伺服器端點限制,就會發生此錯誤。 Azure 檔案同步目前支援每個伺服器最多 30 個伺服器端點。 如需詳細資訊,請參閱 Azure 檔案同步擴展目標 (機器翻譯)。

伺服器端點建立失敗,發生此錯誤:"MgmtServerJobFailed" (錯誤碼:-2134376427 或 0x80c80015)
如果另一個伺服器端點已經同步指定的伺服器端點路徑,就會發生此錯誤。 Azure 檔案同步不支援多個伺服器端點同步相同的目錄或磁碟區。

伺服器端點建立失敗,發生此錯誤:"MgmtServerJobFailed (錯誤碼:-2160590967 或 0x80c80077)
如果伺服器端點路徑包含孤立的階層式檔案,就會發生這個錯誤。 如果最近移除了伺服器端點,請等到孤立的階層式檔案清除完成。 一旦開始孤立的階層式檔案清除,就會將事件識別碼 6662 記錄到遙測事件記錄檔中。 一旦完成孤立的階層式檔案清除且可使用路徑重新建立伺服器端點時,就會記錄事件識別碼 6661。 如果無法在完成孤立的階層式檔案清除後建立伺服器端點,或由於事件記錄檔變換而無法在遙測事件記錄檔中找到事件識別碼 6661 時,請通過執行刪除伺服器端點之後,無法存取伺服器上的分層檔案 (機器翻譯) 一節中所描述步驟來移除孤立的階層式檔案。

伺服器端點刪除失敗,發生此錯誤:"MgmtServerJobExpired" (錯誤碼:-2134347757 或 0x80c87013)
如果伺服器離線或沒有網路連線能力,就會發生此錯誤。 如果伺服器無法再使用,請在入口網站中取消註冊伺服器,這將會刪除伺服器端點。 若要刪除伺服器端點,請依照向 Azure 檔案同步取消註冊伺服器中所述的步驟進行。

伺服器端點健全狀況

無法開啟伺服器端點屬性頁面,或更新雲端階層處理原則
如果伺服器端點上的管理作業失敗,就會發生此問題。 如果伺服器端點屬性頁面未在 Azure 入口網站中開啟,則從伺服器使用 PowerShell 命令來更新伺服器端點可修正此問題。

# Get the server endpoint id based on the server endpoint DisplayName property
Get-AzStorageSyncServerEndpoint `
    -ResourceGroupName myrgname `
    -StorageSyncServiceName storagesvcname `
    -SyncGroupName mysyncgroup | `
Tee-Object -Variable serverEndpoint

# Update the free space percent policy for the server endpoint
Set-AzStorageSyncServerEndpoint `
    -InputObject $serverEndpoint
    -CloudTiering `
    -VolumeFreeSpacePercent 60

伺服器端點的健康狀態為 [無活動] 或 [擱置中],且 [已註冊的伺服器] 刀鋒視窗上的伺服器狀態為 [顯示為離線]

如果儲存體同步監視器程序 (AzureStorageSyncMonitor.exe) 未執行,或伺服器無法存取 Azure 檔案同步服務,即可能發生此問題。

在入口網站中 [顯示為離線] 的伺服器上,查看遙測事件記錄檔中的事件識別碼 9301 (位於 [事件檢視器] 中的 Applications and Services\Microsoft\FileSync\Agent),以判斷伺服器無法存取 Azure 檔案同步服務的原因。

  • 如果記錄 已完成 GetNextJob,且狀態為:0,則該伺服器便可與 Azure 檔案同步服務進行通訊。

    • 在伺服器上開啟工作管理員,並確認儲存體同步監視器 (AzureStorageSyncMonitor.exe) 程序正在執行。 如果此程序未執行,先嘗試重新啟動伺服器。 如果重新啟動伺服器無法解決此問題,請升級至最新版 Azure 檔案同步代理程式版本
  • 如果已記錄 GetNextJob 完成,且狀態為:-2134347756 ,則伺服器無法與 Azure 檔案同步服務通訊,因為防火牆、PROXY 或 TLS 加密套件順序設定。

    • 如果伺服器位於防火牆後方,請確認允許連接埠 443 輸出。 如果防火牆限制僅允許對特定網域的流量,請確認您可以存取防火牆文件中列出的網域。

    • 如果伺服器位於 Proxy 後方,請依照 Proxy 文件中的步驟設定整部電腦或應用程式專屬的 Proxy 設定。

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

    • 如果伺服器上已設定 TLS 加密套件順序,您可以使用群組原則或 TLS Cmdlet 來新增加密套件:

      Azure 檔案同步目前支援下列 TLS 1.2 通訊協定的加密套件:

      • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
      • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
      • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
      • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
  • 如果記錄 已完成 GetNextJob,且狀態為:-2134347764,則表示伺服器的憑證已到期或刪除,所以無法與 Azure 檔案同步服務進行通訊。

    • 在伺服器上執行下列 PowerShell 命令,以重新設定要用於驗證的憑證:
    Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>
    

伺服器端點的健康狀態為 [無活動],且 [已註冊的伺服器] 刀鋒視窗上的伺服器狀態為 [線上]

伺服器端點健康狀態為 [無活動] 時,表示伺服器端點在過去兩小時內未記錄任何同步活動。

若要查看伺服器上目前的同步活動,請參閱如何監視目前同步工作階段的進度?

伺服器端點可能因為 Bug 或系統資源不足導致無法記錄同步活動長達數小時。 確認已安裝最新的 Azure 檔案同步代理程式版本。 如果問題持續發生,請開啟支援要求。

注意

如果 [已註冊的伺服器] 刀鋒視窗上的伺服器狀態為 [顯示為離線],請執行伺服器端點的健康狀態為 [無活動] 或 [擱置中],且 [已註冊的伺服器] 刀鋒視窗上的伺服器狀態為 [顯示為離線] 區段中所列步驟。

Sync

如果我直接在我的 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 文件。

注意

AzStorageSyncChangeDetection PowerShell Cmdlet 只能偵測到最多10000個專案。 如需其他限制,請參閱 AzStorageSyncChangeDetection 檔。

注意

使用 REST 對 Azure 檔案共用所做的變更不會更新 SMB 上次修改時間,而且將不會被同步視為變更。

我們發現,為 Azure 檔案新增變更偵測,類似於在 Windows 伺服器上磁碟區的 USN 變更偵測。

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

如何監視同步健康情況?

在每個同步群組內,您可以向下切入至其個別的伺服器端點,以查看上次完成的同步工作階段所處的狀態。 若 [健康情況] 資料行為綠色,且 [檔案無法同步] 的值為 0,表示同步運作正常。 如果沒有,請參閱下方的常見同步錯誤清單,以及如何處理未同步處理的檔案。

Azure 入口網站的螢幕擷取畫面

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

在您的同步群組中,移至有問題的伺服器端點,並查看 [同步活動] 區段以確認目前的同步工作階段中已上傳或下載的檔案計數。 請記住,此狀態將延遲大約5分鐘,如果您的同步會話夠小而無法在這段期間內完成,則可能不會在入口網站中報告。

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

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

  • 上傳和下載的「上次嘗試的同步」時間戳記都是最新的。
  • 上傳和下載的狀態都是綠色的。
  • [同步活動] 欄位中僅顯示少許或沒有待同步的檔案。
  • 上傳和下載的 [檔案無法同步] 欄位皆為 0。

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

就任何給定的同步工作階段而言,如果伺服器上的 PerItemErrorCount 或入口網站中的「檔案無法同步」計數大於 0,則表示有部分項目無法同步。檔案和資料夾可能有某些特性使其無法同步。 特性可能是持續性的,且您必須執行明確的動作才能繼續同步,例如,從檔案或資料夾名稱中移除不支援的字元。 特性也有可能是暫時性的,這表示檔案或資料夾將會自動繼續同步;例如,具有開啟控制代碼的檔案,將會檔案關閉時自動繼續同步。 當 Azure 檔案同步引擎偵測到此類問題時,將會產生錯誤記錄,而此記錄可經由剖析列出目前未正確同步的項目。

若要查看這些錯誤,請執行 FileSyncErrorsReport.ps1 PowerShell 指令碼 (位於 Azure 檔案同步代理程式的代理程式安裝目錄中),以識別因開啟的控制代碼、不支援的字元或其他問題而無法同步的檔案。 ItemPath 欄位會指出檔案與根同步目錄的相對位置。 請參閱下方的常見同步錯誤清單,以取得補救步驟。

注意

如果 FileSyncErrorsReport.ps1 指令碼傳回「找不到任何檔案錯誤」,或未列出同步群組的每個項目錯誤,則原因可能為:

  • 原因 1:最後完成的同步工作階段未包含每個項目錯誤。 入口網站應更新以顯示 0 個 [檔案無法同步]。 根據預設,FileSyncErrorsReport.ps1 腳本只會顯示上次完成的同步會話之每個專案的錯誤。 若要針對所有同步會話查看每個專案的錯誤,請使用-ReportAllErrors 參數。

  • 原因 2:伺服器上的 ItemResults 事件記錄檔因每個項目錯誤太多而自動換行,且事件記錄檔不再包含此同步群組的錯誤。

    • 若要避免此問題,請增加 ItemResults 事件記錄檔的大小。 ItemResults 事件記錄檔位於事件檢視器中的 "Applications and Services Logs\Microsoft\FileSync\Agent" 下方。

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

ItemResults 記錄 - 個別項目同步錯誤

HRESULT HRESULT (十進位) 錯誤字串 問題 補救
0x80070043 -2147942467 ERROR_BAD_NET_NAME 無法存取伺服器上的階層式檔案。 如果未在刪除伺服器端點之前重新叫用分層檔案,就會發生此問題。 若要解決此問題,請參閱刪除伺服器端點之後,無法存取伺服器上的階層式檔案 (機器翻譯)。
0x80c80207 -2134375929 ECS_E_SYNC_CONSTRAINT_CONFLICT 尚無法同步檔案或目錄的變更,因為尚未同步相依的資料夾。 將在同步相依的變更之後同步此項目。 不需要任何動作。 如果錯誤持續數天,請使用 FileSyncErrorsReport.ps1 PowerShell 指令碼來判斷相依資料夾尚未同步的原因。
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 檔案或目錄名稱無效。 請重新命名有問題的檔案或目錄。 如需詳細資訊,請參閱處理不支援的字元
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 -2147942403 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 位址或虛擬網路。
0x80c80243 -2134375869 ECS_E_SECURITY_DESCRIPTOR_SIZE_TOO_LARGE 因為安全描述項大小超過 64 KiB 限制,所以無法同步檔案。 若要解決此問題,請移除檔案上的存取控制項目 (ACE),以縮小安全描述項大小。
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 伺服器的備份還原階層式檔案,就會發生此問題。 若要解決此問題,請從 Azure 檔案共用中的快照集還原該檔案。

處理不支援的字元

如果 FileSyncErrorsReport.ps1 PowerShell 腳本顯示每個專案的同步錯誤,因為不支援的字元 (錯誤碼0x8007007b 或 0x80c80255) ,您應該從個別的檔案名中移除或重新命名錯誤的字元。 由於這些字元大多沒有標準的視覺編碼,PowerShell 可能會將這些字元列印為問號或空的矩形。

注意

評估工具可用來識別不受支援的字元。 如果您的資料集有多個檔案有不正確字元,請使用 ScanUnsupportedChars 腳本來重新命名包含不受支援字元的檔案。

下表列出 Azure 檔案同步尚不支援的所有 Unicode 字元。

字元集 字元計數
0x00000000-0x0000001F (控制字元) 32
0x0000FDD0-0x0000FDDD (阿拉伯文簡報表單-a) 14
  • 0x00000022 (引號)
  • 0x0000002A (星號)
  • 0x0000002F (正斜線)
  • 0x0000003A (冒號)
  • 0x0000003C (小於)
  • 0x0000003E (大於)
  • 0x0000003F (問號)
  • 0x0000005C (反斜線)
  • 0x0000007C (管道或條形)
9
  • 0x0004FFFE - 0x0004FFFF = 2 (非字元)
  • 0x0008FFFE - 0x0008FFFF = 2 (非字元)
  • 0x000CFFFE - 0x000CFFFF = 2 (非字元)
  • 0x0010FFFE-0x0010FFFF = 2 (非字元)
8
  • 0x0000009D (osc 作業系統命令)
  • 0x00000090 (dcs 裝置控制字串)
  • 0x0000008F (ss3 單一移位三)
  • 0x00000081 (高八位元組前置)
  • 0x0000007F (del 刪除)
  • 0x0000008D (ri 反向換行)
6
0x0000FFF0、0x0000FFFD、0x0000FFFE、0x0000FFFF (特殊) 4
以句點結尾的檔案或目錄 1

常見同步錯誤

同步工作階段已取消。

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

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

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

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

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

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

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

    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 Cmdlet 來檢查與服務端點的網路連線能力。 若要深入了解,請參閱測試與服務端點的網路連線能力 (機器翻譯)。

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

注意

一旦還原 Azure 檔案同步服務的網路連線,同步處理可能不會立即恢復。 依預設,如果在伺服器端點位置內未偵測到任何變更,Azure 檔案同步將會每隔30分鐘起始一次同步處理會話。 若要強制同步會話,請重新開機儲存體同步代理程式 (FileSyncSvc) service,或對伺服器端點位置內的檔案或目錄進行變更。

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

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

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

同步失敗,因為操作已中止

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

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

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

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

您不需要執行任何動作。 使用 Azure 備份還原檔案或檔案共用 (雲端端點) 時,同步會遭到封鎖,直到完成 Azure 檔案共用上的變更偵測為止。 變更偵測會在還原完成時立即執行,而執行時間會取決於檔案共用中的檔案數目。

同步失敗,因為同步處理資料庫已卸載。

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

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

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

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

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

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

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

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

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

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

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

錯誤 程式碼
HRESULT 0x80C83060
HRESULT (十進位) -2134364064
錯誤字串 ECS_E_STORAGE_ACCOUNT_NAME_UNRESOLVED
需要補救
  1. 確認您可以解析來自伺服器的儲存體 DNS 名稱。

    Test-NetConnection -ComputerName <storage-account-name>.file.core.windows.net -Port 443
    
  2. 確認儲存體帳戶確實存在。

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

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

錯誤 程式碼
HRESULT 0x80c8308a
HRESULT (十進位) -2134364022
錯誤字串 ECS_E_STORAGE_ACCOUNT_UNKNOWN_ERROR
需要補救
  1. 確認儲存體帳戶確實存在。
  2. 請確認是否已在儲存體帳戶上正確設定防火牆和虛擬網路設定 (若已啟用的話)

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

錯誤 程式碼
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 檔案共用目前的限制

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

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

  3. 記下開啟的窗格中顯示的 Azure 檔案共用名稱。

  4. 選取連結的儲存體帳戶。 如果此連結失敗,表示參考的儲存體帳戶已移除。

    此螢幕擷取畫面顯示有連結通往儲存體帳戶的雲端端點詳細資料窗格。

  5. 選取 [檔案],以檢視檔案共用清單。

  6. 按一下資料列結尾處的三個點,以顯示雲端端點所參考的 Azure 檔案共用。

  7. 確認 [使用量] 低於 [配額]。 請注意,除非已指定替代配額,否則配額將會符合 Azure 檔案共用的大小上限

    Azure 檔案共用屬性的螢幕擷取畫面。

如果共用已滿,且未設定配額,修正此問題的可行方式之一,是使目前伺服器端點的每個子資料夾,成為其各自所屬同步群組內的專屬伺服器端點。 如此一來,每個子資料夾將會同步至個別的 Azure 檔案共用。

找不到 Azure 檔案共用。

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

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

  1. 確認儲存體帳戶確實存在。
  2. 確定 Azure 檔案共用確實存在。

如果 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 0x800b0109
HRESULT (十進位) -2146762487
錯誤字串 CERT_E_UNTRUSTEDROOT
需要補救

如果組織目前使用 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 憑證。

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

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

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

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

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

    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 Cmdlet 來檢查與服務端點的網路連線能力。 若要深入了解,請參閱測試與服務端點的網路連線能力 (機器翻譯)。

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

注意

一旦還原 Azure 檔案同步服務的網路連線,同步處理可能不會立即恢復。 依預設,如果在伺服器端點位置內未偵測到任何變更,Azure 檔案同步將會每隔30分鐘起始一次同步處理會話。 若要強制同步會話,請重新開機儲存體同步代理程式 (FileSyncSvc) service,或對伺服器端點位置內的檔案或目錄進行變更。

因為伺服器無法解碼 Azure 檔案同步服務的回應,所以同步失敗

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

如果網路 proxy 正在修改 Azure 檔案同步服務的回應,通常就會發生此錯誤。 請檢查您的 proxy 設定。

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

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

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

因為憑證過期,所以同步失敗。

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

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

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

  1. 開啟 [憑證 MMC 嵌入式管理單元],選取 [電腦帳戶],並瀏覽至 [憑證 (本機電腦)\個人\憑證]。
  2. 檢查用戶端驗證憑證是否已過期。

如果用戶端驗證憑證已過期,請執行下列步驟來解決此問題:

  1. 確認已安裝 Azure 檔案同步代理程式版本 4.0.1.0 或更新版本。

  2. 在伺服器上執行下列 PowerShell 命令:

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

因為找不到驗證憑證,所以同步失敗。

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

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

若要解決此問題,請執行下列步驟:

  1. 確認已安裝 Azure 檔案同步代理程式版本 4.0.1.0 或更新版本。

  2. 在伺服器上執行下列 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 ManagerNTFS 配額設定磁片配額,請增加配額限制。

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

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

發生此錯誤的原因為您已使用 Azure 檔案共用上現有內容來建立雲端端點。 Azure 檔案同步必須先掃描所有內容的 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) service,或對伺服器端點位置內的檔案或目錄進行變更。

因為發生例外狀況,所以同步失敗。

錯誤 程式碼
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
需要補救

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

因為變更 Azure Active Directory 中的租用戶,所以同步失敗

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

請確定具最新的 Azure 檔案同步代理程式。 從代理程式 V10 開始,Azure 檔案同步可支援將訂用帳戶移至不同的 Azure Active Directory 租用戶。

當擁有最新的代理程式版本後,即必須將儲存體帳戶的存取權授與 Microsoft.StorageSync 應用程式,請參閱 確定 Azure 檔案同步具有儲存體帳戶的存取權 (機器翻譯)。

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

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

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

因為系統磁碟區資訊資料夾的權限不正確,所以同步失敗。

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

如果 NT AUTHORITY\SYSTEM 帳戶無權存取伺服器端點所在磁碟區上的 [系統磁碟區資訊] 資料夾,就會發生此錯誤。 請注意,如果個別檔案無法與 ERROR_ACCESS_DENIED 同步,請執行個別檔案/目錄同步錯誤的疑難排解 (機器翻譯) 一節中描述的步驟。

若要解決此問題,請執行下列步驟:

  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"
    • 如果步驟 #4 因為拒絕存取而失敗,請執行下列命令來取得系統磁碟區資訊資料夾的擁有權,然後重複步驟 #4: takeown /A /R /F "drive letter:\System Volume Information"

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

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

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

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

  1. 刪除同步群組中的所有伺服器端點。
  2. 刪除雲端端點。
  3. 刪除同步群組。
  4. 如果已在伺服器端點上啟用雲端階層處理,請執行刪除伺服器端點之後,無法存取伺服器上的階層式檔案 (機器翻譯) 一節中所述的步驟,以刪除伺服器上的孤立階層式檔案。
  5. 重新建立同步群組。

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

錯誤 程式碼
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 0x80c83085
HRESULT (十進位) -2134364027
錯誤字串 ECS_E_DATA_INGESTION_WAIT_TIMEOUT
需要補救

當資料擷取作業逾時,就會發生此錯誤。 如果正在進行同步作業 (AppliedItemCount 大於 0),則可忽略此錯誤。 請參閱如何監視目前同步工作階段的進度?

因為在伺服器上找不到伺服器端點路徑,所以同步失敗。

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

如果當做伺服器端點路徑使用的目錄已重新命名或刪除,就會發生此錯誤。 如果目錄已重新命名,請將目錄重新命名為原始名稱,然後重新開機儲存體同步代理程式服務 (FileSyncSvc) 。

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

  1. 遵循 移除伺服器端點中記載的步驟,移除同步群組中的伺服器端點。
  2. 遵循 新增伺服器端點中所述的步驟,在同步群組中建立新的伺服器端點。

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

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

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

  • 此伺服器端點是以初始同步處理模式布建: 伺服器授權
  • 本機伺服器路徑是空的,或未包含可同步處理的專案。

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

  1. 遵循 移除伺服器端點中記載的步驟,移除同步群組中的伺服器端點。
  2. 遵循 新增伺服器端點中所述的步驟,在同步群組中建立新的伺服器端點。

常用的疑難排解步驟

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

  1. 瀏覽至儲存體同步服務中的同步群組。
  2. 選取同步群組內的雲端端點。
  3. 記下開啟的窗格中顯示的 Azure 檔案共用名稱。
  4. 選取連結的儲存體帳戶。 如果此連結失敗,表示參考的儲存體帳戶已移除。 此螢幕擷取畫面顯示有連結通往儲存體帳戶的雲端端點詳細資料窗格。

確定 Azure 檔案共用確實存在。

  1. 按一下位於目錄左側的 [概觀],以返回主要儲存體帳戶頁面。
  2. 選取 [檔案],以檢視檔案共用清單。
  3. 確認雲端端點所參考的檔案共用出現在檔案共用清單中 (您應已先前的步驟 1 中記下這項資料)。

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

  1. 按一下左側目錄的 [存取控制 (IAM)]。

  2. 按一下 [角色指派] 索引標籤,列出可存取儲存體帳戶的使用者和應用程式 (服務主體)。

  3. 確認 [Microsoft.StorageSync] 或 [混合式檔案同步服務] (舊的應用程式名稱) 出現在清單中,且包含 [讀者及資料存取] 角色。

    此螢幕擷取畫面顯示儲存體帳戶的存取控制索引標籤所包含的「混合式檔案同步服務」服務主體

    如果清單中未顯示 [Microsoft.StorageSync] 或 [混合式檔案同步服務],請執行下列步驟:

    • 按一下 [新增] 。
    • 在 [角色] 欄位中,選取 [讀取者及資料存取]。
    • 在 [選取] 欄位中,輸入 Microsoft.StorageSync,選取角色並按一下 [儲存]。

雲端階層處理

在雲端階層中有以下兩種失敗:

  • 檔案無法分層,表示 Azure 檔案同步嘗試將檔案分層至 Azure 檔案但不成功。
  • 檔案無法回收,這表示當使用者嘗試存取已分層的檔案時,Azure 檔案同步檔案系統篩選器 (StorageSync.sys) 無法下載資料。

上述任一種失敗會導致兩種主要類型的失敗:

  • 雲端儲存體失敗
    • 暫時性儲存體服務可用性問題。 如需詳細資訊,請參閱 Azure 儲存體服務等級協定 (SLA)
    • 無法存取 Azure 檔案共用。 此失敗通常發生在您刪除的 Azure 檔案共用仍是同步群組中的雲端端點時。
    • 無法存取儲存體帳戶。 當刪除的儲存體帳戶仍有 Azure 檔案共用是同步處理群組中雲端端點時,通常會發生此失敗。
  • 伺服器失敗
    • 未載入 Azure 檔案同步處理檔案系統篩選器 (StorageSync.sys)。 一定要載入 Azure 檔案同步處理檔案系統篩選器,才能回應分層/回收要求。 發生無法載入篩選器的情況可能有幾個原因,但最常見的是系統管理員手動將它卸載。 Azure 檔案同步處理檔案系統篩選器不論何時都必須保持載入,Azure 檔案同步才能正常運作。
    • 遺失、損毀或中斷的重新剖析點。 重新剖析點是檔案上的特殊資料結構,由以下兩部分所組成:
      1. 重新剖析標記。它會向作業系統指示,Azure 檔案同步處理檔案系統篩選器 (StorageSync.sys) 可能需要對檔案的 IO 採取一些動作。

      2. 重新剖析資料。它會向檔案系統篩選器指示相關聯雲端端點 (Azure 檔案共用) 上檔案的 URI。

        造成重新剖析點損毀的最常見狀況是系統管理員嘗試修改標記或其資料。

    • 網路連線問題。 為了分層或回收檔案,伺服器必須有網際網路連線。

下列各節將說明如何針對雲端階層問題進行疑難排解,以及如何判別雲端儲存體問題或伺服器問題。

如何監視伺服器上的分層活動

若要監視伺服器上的分層活動,請在遙測事件記錄中使用事件識別碼 9003、9016 和 9029 (位於事件檢視器中的 Applications and Services\Microsoft\FileSync\Agent 下)。

  • 事件識別碼 9003 會提供伺服器端點的錯誤分布。 例如錯誤總數、錯誤碼等。請注意,系統會為每個錯誤碼記錄一個事件。
  • 事件識別碼 9016 會提供磁碟區的建立映像結果。 例如可用空間百分比、在工作階段中建立映像的檔案數目、無法建立映像的檔案數目等。
  • 事件識別碼 9029 會提供伺服器端點的虛像化工作階段資訊。 例如,在工作階段中嘗試的檔案數目、在工作階段中分層的檔案數目、已分層的檔案數目等。

如何監視伺服器上的回收活動

若要監視伺服器上的回收活動,請在遙測事件記錄中使用事件識別碼 9005、9006、9009 和 9059 (位於事件檢視器中的 Applications and Services\Microsoft\FileSync\Agent 下)。

  • 事件識別碼 9005 會提供伺服器端點的回收可靠性。 例如,存取的唯一檔案總數、存取失敗的唯一檔案總數等。
  • 事件識別碼 9006 會提供伺服器端點的回收錯誤分布。 例如失敗的要求總數、錯誤碼等。請注意,系統會為每個錯誤碼記錄一個事件。
  • 事件識別碼 9009 會提供伺服器端點的回收工作階段資訊。 例如,DurationSeconds、CountFilesRecallSucceeded、CountFilesRecallFailed 等。
  • 事件識別碼 9059 會提供伺服器端點的應用程式回收分布。 例如,ShareId、應用程式名稱和 TotalEgressNetworkBytes。

如何針對檔案無法分層的問題進行疑難排解

如果無法在 Azure 檔案中將檔案分層:

  1. 在 [事件檢視器] 中,檢閱 Applications and Services\Microsoft\FileSync\Agent 下的遙測、作業和診斷事件記錄。
    1. 確認檔案存在於 Azure 檔案共用中。

      注意

      檔案必須同步到 Azure 檔案共用,才能將它分層。

    2. 確認伺服器具有網際網路連線。

    3. 確認 Azure 檔案同步篩選器驅動程式 (StorageSync.sys 與 StorageSyncGuard.sys) 正在執行:

      • 在提高權限的命令提示字元,執行 fltmc。 確認已列出 StorageSync.sys 和 StorageSyncGuard.sys 檔案系統篩選器驅動程式。

注意

如果檔案無法分層,則會每小時在遙測事件記錄中記錄一次事件識別碼 9003 (對於每個錯誤碼會記錄一個事件)。 請參閱<分層錯誤和補救>一節,以查看是否有列出該錯誤碼的補救步驟。

分層錯誤和補救

HRESULT HRESULT (十進位) 錯誤字串 問題 補救
0x80c86045 -2134351803 ECS_E_INITIAL_UPLOAD_PENDING 檔案無法分層,因為初始上傳正在進行中。 不需要任何動作。 初始上傳完成後,就會將檔案分層。
0x80c86043 -2134351805 ECS_E_GHOSTING_FILE_IN_USE 因為檔案正在使用中,所以無法對檔案進行分層處理。 不需要任何動作。 檔案不再處於使用中狀態時即會進行分層處理。
0x80c80241 -2134375871 ECS_E_GHOSTING_EXCLUDED_BY_SYNC 因為同步作業已排除檔案,所以無法對檔案進行分層處理。 不需要任何動作。 同步排除清單中的檔案無法分層。
0x80c86042 -2134351806 ECS_E_GHOSTING_FILE_NOT_FOUND 因為在伺服器上找不到檔案,所以無法對檔案進行分層處理。 不需要任何動作。 如果錯誤持續發生,請檢查伺服器中是否有該檔案。
0x80c83053 -2134364077 ECS_E_CREATE_SV_FILE_DELETED 因為檔案已在 Azure 檔案共用中刪除,所以無法對檔案進行分層處理。 不需要任何動作。 當下一個下載同步工作階段執行時,系統應該會刪除伺服器上的該檔案。
0x80c8600e -2134351858 ECS_E_AZURE_SERVER_BUSY 因為發生網路問題,所以無法對檔案進行分層處理。 不需要任何動作。 如果錯誤持續發生,請檢查 Azure 檔案共用的網路連線。
0x80072ee7 -2147012889 WININET_E_NAME_NOT_RESOLVED 因為發生網路問題,所以無法對檔案進行分層處理。 不需要任何動作。 如果錯誤持續發生,請檢查 Azure 檔案共用的網路連線。
0x80070005 -2147024891 ERROR_ACCESS_DENIED 因為發生拒絕存取錯誤,所以無法對檔案進行分層處理。 之所以發生此錯誤,是因為檔案位於 DFS-R 唯讀複寫資料夾上。 Azure 檔案同步不支援 DFS-R 唯讀複寫資料夾上的伺服器端點。 如需詳細資訊,請參閱規劃指南
0x80072efe -2147012866 WININET_E_CONNECTION_ABORTED 因為發生網路問題,所以無法對檔案進行分層處理。 不需要任何動作。 如果錯誤持續發生,請檢查 Azure 檔案共用的網路連線。
0x80c80261 -2134375839 ECS_E_GHOSTING_MIN_FILE_SIZE 因為檔案小於支援的大小,所以無法對檔案進行分層處理。 如果代理程式版本小於9.0,則支援的最低檔案大小為 64 KiB。 如果代理程式版本是 9.0 或更新版本,則支援的最低檔案大小是以檔案系統叢集大小 (檔案系統叢集大小的兩倍) 為基礎。 例如,如果檔案系統叢集大小為 4 KiB,檔案大小下限為 8 KiB。
0x80c83007 -2134364153 ECS_E_STORAGE_ERROR 因為發生 Azure 儲存體問題,所以無法對檔案進行分層處理。 如果錯誤持續發生,請開啟支援要求。
0x800703e3 -2147023901 ERROR_OPERATION_ABORTED 因為同時重新叫用檔案,所以無法對檔案進行分層處理。 不需要任何動作。 當重新叫用完成且不再使用檔案時,系統會將此檔案分層處理。
0x80c80264 -2134375836 ECS_E_GHOSTING_FILE_NOT_SYNCED 因為檔案未同步到 Azure 檔案共用,所以無法對檔案進行分層處理。 不需要任何動作。 當檔案已同步至 Azure 檔案共用後,就會進行分層處理。
0x80070001 -2147942401 ERROR_INVALID_FUNCTION 因為雲端分層處理篩選驅動程式 (storagesync.sys) 未執行,所以無法對檔案進行分層處理。 若要解決此問題,請開啟提升權限的命令提示字元並執行下列命令:fltmc load storagesync
執行 fltmc 命令時,如果 Azure 檔案同步濾波器驅動程式無法載入,請將 Azure 檔案同步代理程式卸載、重新開機伺服器,然後重新安裝 Azure 檔案同步代理程式。
0x80070070 -2147024784 ERROR_DISK_FULL 由於伺服器端點所在磁碟區上的可用磁碟空間不足,所以無法對檔案進行分層處理。 若要解決此問題,請在伺服器端點所在的磁片區上,至少釋放 100 MiB 的磁碟空間。
0x80070490 -2147023728 ERROR_NOT_FOUND 因為檔案未同步到 Azure 檔案共用,所以無法對檔案進行分層處理。 不需要任何動作。 當檔案已同步至 Azure 檔案共用後,就會進行分層處理。
0x80c80262 -2134375838 ECS_E_GHOSTING_UNSUPPORTED_RP 因為檔案是不支援的重新剖析點,所以無法對檔案進行分層處理。 如果檔案是重複資料刪除剖析點,請遵循規劃指南中的步驟,以啟用重複資料刪除支援。 若檔案的重新剖析點不是資料刪除,則不受支援,也不會進行分層。
0x80c83052 -2134364078 ECS_E_CREATE_SV_STREAM_ID_MISMATCH 因為檔案已修改,所以無法對檔案進行分層處理。 不需要任何動作。 當已修改的檔案同步至 Azure 檔案共用後,就會進行分層處理。
0x80c80269 -2134375831 ECS_E_GHOSTING_REPLICA_NOT_FOUND 因為檔案未同步到 Azure 檔案共用,所以無法對檔案進行分層處理。 不需要任何動作。 當檔案已同步至 Azure 檔案共用後,就會進行分層處理。
0x80072ee2 -2147012894 WININET_E_TIMEOUT 因為發生網路問題,所以無法對檔案進行分層處理。 不需要任何動作。 如果錯誤持續發生,請檢查 Azure 檔案共用的網路連線。
0x80c80017 -2134376425 ECS_E_SYNC_OPLOCK_BROKEN 因為檔案已修改,所以無法對檔案進行分層處理。 不需要任何動作。 當已修改的檔案同步至 Azure 檔案共用後,就會進行分層處理。
0x800705aa -2147023446 ERROR_NO_SYSTEM_RESOURCES 因為系統資源不足,所以無法對檔案進行分層處理。 如果錯誤持續發生,請調查哪一個應用程式或核心模式驅動程式耗用系統資源。
0x8e5e03fe -1906441218 JET_errDiskIO 因為寫入雲端階層處理資料庫時發生 i/o 錯誤,所以檔案無法分層。 如果錯誤持續發生,請在磁片區上執行 chkdsk,並檢查存放裝置硬體。
0x8e5e0442 -1906441150 JET_errInstanceUnavailable 因為雲端階層處理資料庫未執行,所以檔案無法分層。 若要解決此問題,請重新開機 FileSyncSvc 服務或伺服器。 如果錯誤持續發生,請在磁片區上執行 chkdsk,並檢查存放裝置硬體。
0x80C80285 -2160591493 ECS_E_GHOSTING_SKIPPED_BY_CUSTOM_EXCLUSION_LIST 因為檔案類型已從階層處理中排除,所以無法將檔案分層。 若要使用此檔案類型將檔案分層,請修改位於 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync 下的 GhostingExclusionList 登錄設定。
0x80C86050 -2160615504 ECS_E_REPLICA_NOT_READY_FOR_TIERING 因為目前的同步模式為初始上傳或對帳,所以檔案無法分層。 不需要任何動作。 當同步完成初始上傳或對帳之後,會將檔案分層。

如何針對無法重新叫用檔案的問題進行疑難排解

如果無法重新叫用檔案:

  1. 在 [事件檢視器] 中,檢閱 Applications and Services\Microsoft\FileSync\Agent 下的遙測、作業和診斷事件記錄。
    1. 確認檔案存在於 Azure 檔案共用中。
    2. 確認伺服器具有網際網路連線。
    3. 開啟 [服務 MMC 嵌入式管理單元],並確認儲存體同步代理程式服務 (FileSyncSvc) 正在執行。
    4. 確認 Azure 檔案同步篩選器驅動程式 (StorageSync.sys 與 StorageSyncGuard.sys) 正在執行:
      • 在提高權限的命令提示字元,執行 fltmc。 確認已列出 StorageSync.sys 和 StorageSyncGuard.sys 檔案系統篩選器驅動程式。

注意

如果檔案無法回收,則會每小時在遙測事件記錄中記錄一次事件識別碼 9006 (對於每個錯誤碼會記錄一個事件)。 請參閱<回收錯誤和補救>一節,以查看是否有列出該錯誤碼的補救步驟。

回收錯誤和補救

HRESULT HRESULT (十進位) 錯誤字串 問題 補救
0x80070079 -2147942521 ERROR_SEM_TIMEOUT 因為 I/O 逾時,所以無法回收檔案。 發生此問題的原因有好幾個:伺服器資源限制、網路連線不佳或 Azure 儲存體問題 (例如節流)。 不需要任何動作。 如果錯誤持續數小時,請開啟支援案例。
0x80070036 -2147024842 ERROR_NETWORK_BUSY 因為發生網路問題,所以無法回收檔案。 如果錯誤持續發生,請檢查 Azure 檔案共用的網路連線。
0x80c80037 -2134376393 ECS_E_SYNC_SHARE_NOT_FOUND 因為已刪除伺服器端點,所以無法回收檔案。 若要解決此問題,請參閱刪除伺服器端點之後,無法存取伺服器上的階層式檔案 (機器翻譯)。
0x80070005 -2147024891 ERROR_ACCESS_DENIED 因為發生拒絕存取錯誤,所以無法回收檔案。 之所以發生此問題,是因為儲存體帳戶上的防火牆和虛擬網路設定已啟用,而伺服器無法存取儲存體帳戶。 若要解決此問題,請遵循部署指南中設定防火牆和虛擬網路設定一節中所述的步驟,以新增伺服器 IP 位址或虛擬網路。
0x80c86002 -2134351870 ECS_E_AZURE_RESOURCE_NOT_FOUND 因為無法存取 Azure 檔案共用中的檔案,所以無法回收檔案。 若要解決此問題,請確認 Azure 檔案共用中的確存在該檔案。 如果 Azure 檔案共用中的確有該檔案,請升級至最新的 Azure 檔案同步代理程式版本
0x80c8305f -2134364065 ECS_E_EXTERNAL_STORAGE_ACCOUNT_AUTHORIZATION_FAILED 因為儲存體帳戶的授權失敗,所以無法回收檔案。 若要解決此問題,請確認 Azure 檔案同步具有儲存體帳戶的存取權 (機器翻譯)。
0x80c86030 -2134351824 ECS_E_AZURE_FILE_SHARE_NOT_FOUND 因為無法存取 Azure 檔案共用,所以無法回收檔案。 請確認檔案共用的確存在且可存取。 如果已刪除並重新建立檔案共用,請執行因為已刪除並重新建立 Azure 檔案共用,所以同步失敗一節中所述的步驟,以刪除並重新建立同步群組。
0x800705aa -2147023446 ERROR_NO_SYSTEM_RESOURCES 因為系統資源不足,所以無法回收檔案。 如果錯誤持續發生,請調查哪一個應用程式或核心模式驅動程式耗用系統資源。
0x8007000e -2147024882 ERROR_OUTOFMEMORY 因為記憶體不足,所以無法回收檔案。 如果錯誤持續發生,請調查哪一個應用程式或核心模式驅動程式造成記憶體不足的狀況。
0x80070070 -2147024784 ERROR_DISK_FULL 因為磁碟空間不足,所以無法回收檔案。 若要解決此問題,請將檔案移至不同的磁碟區、增加磁碟區的大小,或使用 Invoke-StorageSyncCloudTiering Cmdlet 強制將檔案分層,以釋出磁碟區的空間。
0x80072f8f 代碼 -2147012721 WININET_E_DECODING_FAILED 無法重新叫用檔案,因為伺服器無法解碼 Azure 檔案同步服務的回應。 如果網路 proxy 正在修改 Azure 檔案同步服務的回應,通常就會發生此錯誤。 請檢查您的 proxy 設定。
0x80090352 -2146892974 SEC_E_ISSUING_CA_UNTRUSTED 因為您的組織使用 TLS 終止 proxy 或惡意實體正在攔截您伺服器與 Azure 檔案同步服務之間的流量,所以無法重新叫用檔案。 如果您認為這是預期的 (因為您的組織使用 TLS 終止 proxy) ,請遵循記載的步驟來解決此問題 CERT_E_UNTRUSTEDROOT 錯誤。
0x80c86047 -2134351801 ECS_E_AZURE_SHARE_SNAPSHOT_NOT_FOUND 無法重新叫用檔案,因為它參考了不再存在於 Azure 檔案共用中的檔案版本。 如果從 Windows 伺服器的備份還原階層式檔案,就會發生此問題。 若要解決此問題,請從 Azure 檔案共用中的快照集還原該檔案。

刪除伺服器端點之後,無法存取伺服器上的階層式檔案

如果未在刪除伺服器端點之前回收階層式檔案,則階層式檔案會變成無法存取的狀態。

無法存取階層式檔案時所記錄的錯誤

  • 同步檔案時,會在 ItemResults 事件記錄檔中記錄錯誤碼 -2147942467 (0x80070043 - ERROR_BAD_NET_NAME)
  • 回收檔案時,會在 ItemResults 事件記錄檔中記錄錯誤碼 -2134376393 (0x80c80037 - ECS_E_SYNC_SHARE_NOT_FOUND)

如果符合下列條件,分層檔案的存取就有可能還原:

  • 伺服器端點在過去 30 天內刪除
  • 未刪除雲端端點
  • 檔案共用未刪除
  • 未刪除同步群組

如果符合上述條件,您就可以在 30 天內還原伺服器上檔案的存取權,只要在相同同步群組中,將伺服器端點重新建立在伺服器上的相同路徑上即可。

如果不符合上述條件,您就無法還原存取,因為伺服器上的這些分層檔案現在是孤立狀態。 請依照下列指示來移除孤立的階層式檔案。

注意事項

  • 當伺服器上的階層式檔案無法存取時,如果直接存取 Azure 檔案共用,則完整檔案應該仍然可以存取。
  • 若要在未來避免孤立的階層式檔案,請遵循移除伺服器端點 (機器翻譯) 中所述的步驟來刪除伺服器端點。

如何取得孤立的階層式檔案清單

  1. 確認已安裝 Azure 檔案同步代理程式版本 v5.1 或更新版本。
  2. 執行下列 PowerShell 命令以列出孤立的階層式檔案:
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
$orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path>
$orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt
  1. 儲存 OrphanTieredFiles.txt 輸出檔案,以防需要在檔案刪除後,從備份還原檔案。

如何移除孤立的階層式檔案

選項 1:刪除孤立的階層式檔案

此選項會刪除 Windows Server 上孤立的階層式檔案,但需要移除已存在的伺服器端點,以便在 30 天後重新建立伺服器端點,或將其連線到不同的同步群組。 如果在重新建立伺服器端點之前更新 Windows Server 或 Azure 檔案共用上的檔案,就會發生檔案衝突。

  1. 確認已安裝 Azure 檔案同步代理程式版本 v5.1 或更新版本。
  2. 備份 Azure 檔案共用和伺服器端點的位置。
  3. 請遵循移除伺服器端點 (機器翻譯) 中所述的步驟,以移除同步群組中的伺服器端點 (如果存在)。

警告

如果在使用 Remove-StorageSyncOrphanedTieredFiles Cmdlet 之前未移除伺服器端點,則在伺服器上刪除孤立的階層式檔案將會刪除 Azure 檔案共用中的完整檔案。

  1. 執行下列 PowerShell 命令以列出孤立的階層式檔案:
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
$orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path>
$orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt
  1. 儲存 OrphanTieredFiles.txt 輸出檔案,以防需要在檔案刪除後,從備份還原檔案。
  2. 執行下列 PowerShell 命令以刪除孤立的階層式檔案:
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
$orphanFilesRemoved = Remove-StorageSyncOrphanedTieredFiles -Path <folder path containing orphaned tiered files> -Verbose
$orphanFilesRemoved.OrphanedTieredFiles > DeletedOrphanFiles.txt

注意事項

  • 在伺服器上修改的階層式檔案若未同步至 Azure 檔案共用,將會遭到刪除。
  • 可存取 (非孤立) 的階層式檔案則不會被刪除。
  • 非階層式檔案仍會保留在伺服器上。
  1. 選擇性:如果在步驟 3 中刪除伺服器端點,請重新建立。

選項 2:掛接 Azure 檔案共用,並將伺服器上的孤立檔案複製到本機

此選項無需移除伺服器端點,但需要有足夠的磁碟空間才能將完整檔案複製到本機。

  1. 在具有孤立階層式檔案的 Windows Server 上,掛接 Azure 檔案共用。
  2. 執行下列 PowerShell 命令以列出孤立的階層式檔案:
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
$orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path>
$orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt
  1. 使用 OrphanTieredFiles.txt 輸出檔案來識別伺服器上的孤立階層式檔案。
  2. 將完整檔案從 Azure 檔案共用複製到 Windows Server,以覆寫孤立的階層式檔案。

如何針對在伺服器上意外回收的檔案進行疑難排解

防毒程式、備份及其他讀取大量檔案的應用程式,除非採用離線屬性並略過讀取這些檔案的內容,否則將會導致非預期的重新叫用。 略過支援此選項之產品的離線檔案,有助於在執行防毒掃描、備份等作業時,避免發生非預期的重新叫用。

請洽詢您的軟體廠商,了解如何設定其解決方案以略過讀取離線檔案。

非預期的重新叫用也會在其他情況下發生,例如在 [檔案總管] 中瀏覽檔案時。 在伺服器的 [檔案總管]中開啟包含雲端層檔案的資料夾,可能會導致非預期的重新叫用。 特別是伺服器上已啟用防毒程式時,更容易發生。

注意

使用遙測事件記錄中的事件識別碼 9059 來判斷哪些應用程式造成回收。 此事件會提供伺服器端點的應用程式回收分布,且一小時記錄一次。

Azure 檔案同步的進程排除專案

如果您想要將防毒軟體或其他應用程式設定為略過掃描 Azure 檔案同步所存取的檔案,請設定下列進程排除專案:

  • C:\Program Files\Azure\StorageSyncAgent\AfsAutoUpdater.exe
  • C:\Program Files\Azure\StorageSyncAgent\FileSyncSvc.exe
  • C:\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentLauncher.exe
  • C:\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentHost.exe
  • C:\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentManager.exe
  • C:\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentCore.exe
  • C:\Program Files\Azure\StorageSyncAgent\MAAgent\Extensions\XSyncMonitoringExtension\AzureStorageSyncMonitor.exe

Azure 檔案同步需要 TLS 1.2

您可藉由查看登錄設定 (機器翻譯) 來檢視伺服器上的 TLS 設定。

如果使用 Proxy,請參閱 Proxy 文件,並確定已將其設定為使用 TLS 1.2。

一般疑難排解

如果在伺服器上使用 Azure 檔案同步時發生問題,請完成以下步驟開始疑難排解:

  1. 在 [事件檢視器] 中檢閱遙測、作業和診斷事件記錄。
    • 系統會將同步、分層和回收問題記錄在 Applications and Services\Microsoft\FileSync\Agent 下的遙測、診斷和作業事件記錄中。
    • 與管理伺服器相關的問題 (例如組態設定) 則記錄在 Applications and Services\Microsoft\FileSync\Management 下的作業和診斷事件記錄中。
  2. 確認 Azure 檔案同步服務正在伺服器上執行:
    • 開啟 [服務] MMC 嵌入式管理單元,並確認儲存體同步代理程式服務 (FileSyncSvc) 正在執行。
  3. 確認 Azure 檔案同步篩選器驅動程式 (StorageSync.sys 與 StorageSyncGuard.sys) 正在執行:
    • 在提高權限的命令提示字元,執行 fltmc。 確認已列出 StorageSync.sys 和 StorageSyncGuard.sys 檔案系統篩選器驅動程式。

如果問題未解決,請執行 AFSDiag 工具,並將其 .zip 檔案輸出傳送給支援工程師,以供進一步診斷。

若要執行 AFSDiag,請執行下列步驟。

針對代理程式版本 v11 和更新版本:

  1. 開啟提升權限的 PowerShell 視窗,然後執行下列命令 (每個命令後要按 Enter 鍵):

    注意

    AFSDiag 會先建立輸出目錄和其中的暫存資料夾,再收集記錄檔,並在執行後刪除暫存資料夾。 指定不包含資料的輸出位置。

    cd "c:\Program Files\Azure\StorageSyncAgent"
    Import-Module .\afsdiag.ps1
    Debug-AFS -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose
    
  2. 重現問題。 完成時,輸入 D

  3. 含有記錄和追蹤檔案的 .zip 檔案將會儲存在指定的輸出目錄中。

針對代理程式版本 v10 和更早版本:

  1. 建立將用來儲存 AFSDiag 輸出的目錄 (例如 C:\Output)。

    注意

    AFSDiag 會先刪除輸出目錄中的所有內容,然後再收集記錄檔。 指定不包含資料的輸出位置。

  2. 開啟提升權限的 PowerShell 視窗,然後執行下列命令 (每個命令後要按 Enter 鍵):

    cd "c:\Program Files\Azure\StorageSyncAgent"
    Import-Module .\afsdiag.ps1
    Debug-Afs c:\output # Note: Use the path created in step 1.
    
  3. 針對 Azure 檔案同步核心模式追蹤層級,輸入 1 (除非為了建立更詳細的追蹤而指定其他值),然後按 Enter。

  4. 針對 Azure 檔案同步使用者模式追蹤層級,輸入 1 (除非為了建立更詳細的追蹤而指定其他值),然後按 Enter。

  5. 重現問題。 完成時,輸入 D

  6. 含有記錄和追蹤檔案的 .zip 檔案將會儲存在指定的輸出目錄中。

另請參閱