疑難解答 Azure 檔案同步

發行項
04/10/2024

您可以使用 Azure 檔案同步在 Azure 檔案儲存體集中組織檔案共享，同時保有內部部署檔伺服器的彈性、效能和相容性。本文旨在協助您針對 Azure 檔案同步部署可能會遇到的問題進行疑難解答和解決。我們也會說明在需要更深入調查問題時，如何從系統收集重要記錄。

常見疑難解答檔

根據您遇到的問題，檢閱適當的疑難解答檔：

問題	疑難解答檔
代理程式安裝或伺服器註冊問題	針對代理程式安裝和伺服器註冊 Azure 檔案同步進行疑難解答
雲端端點或伺服器端點建立問題，或已註冊的伺服器離線	針對同步群組管理 Azure 檔案同步疑難解答
伺服器端點有錯誤狀態，或檔案無法同步	針對 Azure 檔案同步同步健康情況和錯誤進行疑難解答
檔案無法分層或重新叫用	針對雲端階層 Azure 檔案同步進行疑難解答

如果您不確定要從何處開始，請參閱一般疑難解答第一個步驟。

一般疑難解答第一個步驟

如果您遇到 Azure 檔案同步的問題，請先完成下列步驟：

使用伺服器上的 Azure 入口網站或事件記錄來檢查是否有任何錯誤。如需如何使用 Azure 入口網站或事件記錄來檢視 Azure 檔案同步環境健康情況的詳細資訊，請參閱監視 Azure 檔案同步。
確認 Azure 檔案同步服務正在伺服器上執行：
- 開啟 [服務 MMC] 嵌入式管理單元，並確認 (FileSyncSvc) 執行中的記憶體同步代理程序服務。
確認 Azure 檔案同步篩選驅動程式 (StorageSync.sys 和 StorageSyncGuard.sys) 正在伺服器上執行：
- 在提升權限的指令提示字元中，執行 fltmc。確認 已列出StorageSync.sys 和 StorageSyncGuard.sys 檔案系統篩選驅動程式。
使用伺服器上的 Debug-StorageSyncServer Cmdlet 來檢查常見問題。

Debug-StorageSyncServer Cmdlet

此 Debug-StorageSyncServer Cmdlet 會診斷 Azure 檔案同步伺服器上的常見問題，例如憑證設定錯誤和伺服器時間不正確。我們也簡化了 Azure 檔案同步疑難解答，方法是將一些現有腳本和 Cmdlet 的功能合併 (AFSDiag.ps1、 FileSyncErrorsReport.ps1和 Test-StorageSyncNetworkConnectivity) 到 Debug-StorageSyncServer Cmdlet。

若要在伺服器上執行診斷，請執行下列 PowerShell 命令：

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

若要測試伺服器上的網路連線能力，請執行下列 PowerShell 命令：

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

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

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

若要收集伺服器上的記錄和追蹤，請執行下列 PowerShell 命令：

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -AFSDiag -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose

如何收集 Azure 檔案同步伺服器上的記錄和追蹤

如果您的問題在遵循疑難解答檔中的步驟之後未解決，請執行 AFSDiag 工具，並將其 .zip 檔案輸出傳送給指派給您案例的支持工程師，以供進一步診斷。

若要執行 AFSDiag，請執行下列步驟：

開啟提升權限的 PowerShell 視窗，然後執行下列命令 (在每個命令) 之後按 Enter ：

注意事項

AFSDiag 會在收集記錄之前，先在其中建立輸出目錄和暫存資料夾，並在執行之後刪除暫存資料夾。指定不包含資料的輸出位置。
```
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -AFSDiag -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose
```
重現問題。當您完成時，請輸入 D。
包含記錄和追蹤檔案的 .zip 檔案會儲存到您指定的輸出目錄。

另請參閱

與我們連絡，以取得說明

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