Azure 檔案同步代理程式 v21.2 版本 – 2025 年 7 月

已修正的改善和問題 

Azure 檔案同步代理程式現在可透過 Arc 擴充功能使用

透過 Azure Arc 連線的 Windows 伺服器現在可以使用稱為 Azure 檔案同步代理程式的新延伸模組來安裝 Azure 檔案同步代理程式 （適用於 Windows）。 新的延伸模組是由 Microsoft 發佈，可以使用 Azure 入口網站、PowerShell 或 Azure CLI 進行管理。 若要深入瞭解，請參閱 Azure 檔案同步代理程式延伸模組檔。

正式發行：義大利北部的 Azure 檔案同步 

向意大利北部的擴展使該服務更貼近這些地區的組織，提供更低的延遲、更好的性能並支持本地數據駐留要求。  

Azure 檔案同步的精細 Role-Based 存取控制 (RBAC)  

Azure 檔案同步現在包括兩個專用的內建 RBAC 角色：Azure 檔案同步管理員和 Azure 檔案同步讀取器，旨在增強安全性並簡化組織管理內部部署和雲端環境之間檔案同步的操作。 這些角色提供比擁有者或參與者等更廣泛的角色更精細的存取控制，使組織能夠更有效地執行最小權限原則。

雲端分層和同步處理的其他可靠性和遙測改進

修正當檔案或資料夾路徑包含尾端點時，導致同步下載和雲端分層失敗，並0x80c80362 (ECS_E_ITEM_PATH_COMPONENT_HAS_ TRAILING_DOT) 錯誤碼。 以前，用戶必須手動重命名受影響的項目才能恢復同步。 Azure 檔案同步現在可以正確處理具有尾端點的路徑元件，無需手動介入。

Azure 檔案同步代理程式 v21.2 版本的詳細資訊 

• 此版本適用於 Windows Server 2016、Windows Server 2019、Windows Server 2022 和 Windows Server 2025 安裝。 

• 此版本的代理程式版本為 21.2.0.0。 

• Windows Server 上必須安裝下列更新：

  • WS 2016 Microsoft 更新目錄 (最新的累積更新)

  • WS 2019 Microsoft 更新目錄 (最新的累積更新)

​​​​​​​累積更新每月發布一次。 若要部署最新的，使用者可以使用 Windows Update 或從 Microsoft Update 目錄手動下載。 如果手動安裝，他們應該檢閱相關聯的知識庫文章，以確保符合所有必要條件。

附註： 如果在安裝 Azure 檔案同步 代理程式之前未安裝 Windows 匯報，則 FileSyncSvc) (儲存體同步代理程式服務將無法啟動。 若要深入瞭解，請參閱 Azure 檔案同步疑難排解檔。 

如何取得和安裝 Azure 檔案同步代理程式

 Azure 檔案同步代理程式可從 Microsoft Update、Microsoft Update 目錄和 Microsoft 下載中心取得。 

注意事項 

• 如果伺服器上目前未安裝 Azure 檔案同步代理程式，請使用 Microsoft 下載中心的代理程式安裝套件。 Microsoft Update 和 Microsoft Update 目錄上的代理程式安裝套件僅適用於代理程式升級。

• 若要更新現有的代理程式安裝，請執行位於代理程式安裝目錄) 中的 AfsUpdater.exe (，或從 Microsoft Update 或 Microsoft Update 目錄下載並安裝更新。

Microsoft Update 

若要從 Microsoft Update 取得和安裝，請在已安裝 Azure 檔案同步代理程式的伺服器上遵循下列步驟： 

1. 按一下 [開始]，然後按一下 [設定]。

2. 在「設定」中，按一下「更新 & 安全性」。

3. 在 Windows Update 視窗中，按一下 [線上檢查 Microsoft Update 的更新]。

4. 確認已列出 Azure 檔案同步代理程式更新，然後按一下 [立即安裝]。

Microsoft Update Catalog 

移至下列網站，從 Microsoft Update 目錄手動下載此更新： 

Azure 檔案同步 代理程式 v21.2 版本 - 2025 年 7 月 (KB5063825)

若要手動安裝更新套件，請解壓縮 cab 檔案，然後從提高許可權的命令提示字元執行下列命令： 

msiexec.exe /p packagename.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent，StorageSyncAgentAzureFileSync，StorageSyncAgentGuardFilter，StorageSyncAgentUpdater /qb /l*v KB5063825.log

例如，若要安裝 Server 2016 的 Azure 檔案同步代理程式更新，請執行下列命令： 

msiexec.exe /p StorageSyncAgent_WS2016_KB 5063825.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent，StorageSyncAgentAzureFileSync，StorageSyncAgentGuardFilter，StorageSyncAgentUpdater /qb /l*v KB5063825.log

Microsoft 下載中心 

移至 Microsoft 下載中心，手動下載代理程式安裝套件，以進行新的代理程式安裝。 

如何執行新代理程式安裝的無訊息安裝 

若要針對使用預設設定的新代理程式安裝執行無訊息安裝，請在提高許可權的命令提示字元執行下列命令： 

msiexec /i packagename.msi /qb /l*v AFSv21.2Installation.log 

例如，若要安裝適用於 Windows Server 2016 的 Azure 檔案同步代理程式，請執行下列命令： 

msiexec /i StorageSyncAgent_WS2016.msi /qb /l*v AFSv21.2Installation.log 

注意事項 

使用 /qb 參數來顯示重新啟動提示， (必要的) 、代理程式更新和伺服器註冊畫面。 若要隱藏畫面，並在必要時自動重新啟動伺服器 () ，請使用 /qn 參數。

若要使用自訂設定執行無訊息安裝，請參閱如何以無訊息方式安裝 Azure 檔案同步代理程式。