У цій статті описано покращення та проблеми, які усуваються в Azure file Sync Agent версії 21.2 від липня 2025 р. Крім того, ця стаття містить інструкції з інсталяції для цього випуску.
Усунуто покращення та проблеми
Агент синхронізації файлів Azure тепер доступний через розширення Arc
Тепер сервери Windows, підключені через Azure Arc, можуть інсталювати агент Azure File Sync за допомогою нового розширення Azure File Sync Agent для Windows. Нове розширення публікує корпорація Майкрософт, і ними можна керувати за допомогою Порталу Azure, PowerShell або Azure CLI. Щоб дізнатися більше, див. документацію агента Azure File Sync.
Загальний доступ: Azure File Sync в Італії Північ
Розширення на Північ Італії наближає сервіс до організацій у цих регіонах, пропонуючи більш низьку затримку, кращу продуктивність і підтримку вимог до місцевого проживання даних.
Granular Role-Based Access Control (RBAC) for Azure File Sync
Azure File Sync тепер включає в себе дві спеціальні вбудовані ролі RBAC Azure File Sync Administrator і Azure File Sync Reader, призначені для посилення безпеки та спрощення операцій для організацій, які керують синхронізацією файлів між локальним і хмарним середовищами. Ці ролі забезпечують більш деталізований контроль доступу, ніж більш широкі ролі, такі як Власник або Співавтор, що дає змогу організаціям ефективніше дотримуватися принципу найменших привілеїв.
Різні покращення надійності та телеметрії для хмарних рівнів і синхронізації
Вирішено проблему, яка призводила до помилок завантаження синхронізації та хмарного рівня з кодом помилки 0x80c80362 (ECS_E_ITEM_PATH_COMPONENT_HAS_ TRAILING_DOT), коли шлях до файлу або папки включав точку в кінці. Раніше користувачам доводилося вручну перейменовувати цей елемент, щоб відновити синхронізацію. Azure File Sync тепер правильно обробляє компоненти шляху з кінцевими точками, усуваючи необхідність ручного втручання.
Додаткові відомості про Azure file Sync Agent версії 21.2
-
Цей випуск доступний для інсталяцій Windows Server 2016, Windows Server 2019, Windows Server 2022 та Windows Server 2025.
-
Версія агента для цього випуску – 21.2.0.0.
-
На Windows Server потрібно інсталювати такі оновлення:
-
Каталог Microsoft Update від WS 2016 (останнє сукупне оновлення)
-
Каталог Microsoft Update 2019 WS (останнє сукупне оновлення)
-
Сукупні оновлення випускаються щомісяця. Щоб розгорнути останню версію, користувачі можуть скористатися Windows Update або вручну завантажити її з каталогу Microsoft Update. Під час інсталяції вручну вони мають переглянути пов'язану статтю бази знань, щоб переконатися, що всі передумови виконано.
Примітка. Якщо Оновлення Windows не інстальовано перед інсталяцією агента синхронізації файлів Azure, не вдасться запустити службу агента синхронізації сховищ (FileSyncSvc). Докладні відомості див. в документації з виправлення неполадок синхронізації файлів Azure.
Отримання та інсталяція агента синхронізації файлів Azure
Агент Azure File Sync доступний з Microsoft Update, Каталогу Microsoft Update і Центру завантажень Microsoft.
Примітки
-
Якщо агент синхронізації файлів Azure наразі не інстальовано на сервері, скористайтеся пакетом інсталяції агента в Центрі завантажень Microsoft. Пакет інсталяції агента в Microsoft Update і Каталозі Microsoft Update призначено лише для оновлення агента.
-
Щоб оновити наявні екземпляри агента, запустіть AfsUpdater.exe (міститься в каталозі інсталяції агента) або завантажте та інсталюйте оновлення з Microsoft Update або Каталогу Microsoft Update.
Microsoft Update
Щоб отримати та інсталювати пакет Microsoft Update, виконайте такі дії на сервері, на якому інстальовано агент синхронізації файлів Azure:
-
Натисніть кнопку Пуск і виберіть пункт Настройки.
-
У настройках виберіть пункт Оновити & безпеки.
-
У вікні Windows Update натисніть кнопку Перевірити наявність оновлень в Інтернеті за допомогою служби Microsoft Update.
-
Переконайтеся, що в списку вказано оновлення агента синхронізації файлів Azure, а потім натисніть кнопку Інсталювати зараз.
Каталог Microsoft Update
Перейдіть на такий веб-сайт, щоб вручну завантажити це оновлення з каталогу Microsoft Update:
Azure File Sync Agent v21.2 release – липень 2025 р. (KB5063825)
Щоб вручну інсталювати пакет оновлень, видобути CAB-файл і виконати таку команду з командного рядка в режимі адміністратора:
msiexec.exe /p packagename.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent,StorageSyncAgentAzureFileSync,StorageSyncAgentGuardFilter,StorageSyncAgentUpdater /qb /l*v KB5063825.log
Наприклад, щоб інсталювати оновлення агента синхронізації файлів Azure для Server 2016, виконайте таку команду:
msiexec.exe /p StorageSyncAgent_WS2016_KB 5063825.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent,StorageSyncAgentAzureFileSync,StorageSyncAgentGuardFilter,StorageSyncAgentUpdater /qb /l*v KB5063825.log
Центр завантажень Майкрософт
Перейдіть до Центру завантажень Microsoft, щоб вручну завантажити пакет інсталяції агента для інсталяції нових агентів.
Як виконати автоматичну інсталяцію для нового агента інсталяції
Щоб виконати автоматичну інсталяцію для інсталяції нового агента, який використовує настройки за промовчанням, виконайте таку команду в командному рядку в режимі адміністратора:
msiexec /i packagename.msi /qb /l*v AFSv21.2Installation.log
Наприклад, щоб інсталювати агент Azure File Sync для Windows Server 2016, виконайте таку команду:
msiexec /i StorageSyncAgent_WS2016.msi /qb /l*v AFSv21.2Installation.log
Примітки
Скористайтеся перемикачем /qb, щоб відобразити запити на перезавантаження (якщо потрібно), оновлення агента та екрани реєстрації сервера. Щоб заборонити екрани та автоматично перезавантажити сервер (якщо потрібно), скористайтеся перемикачем /qn.
Відомості про автоматичну інсталяцію з настроюваними параметрами див. в статті Автоматична інсталяція агента Синхронізації файлів Azure.