In dit artikel worden de verbeteringen en problemen beschreven die zijn opgelost in de release Azure File Sync Agent v21.2 van juli 2025. Daarnaast bevat dit artikel installatie-instructies voor deze release.
Verbeteringen en problemen die zijn opgelost
Azure File Sync agent nu beschikbaar via de Arc-extensie
Windows-servers die zijn verbonden via Azure Arc kunnen nu Azure File Sync agent installeren met behulp van een nieuwe extensie met de naam Azure File Sync Agent voor Windows. De nieuwe extensie wordt gepubliceerd door Microsoft en kan worden beheerd met behulp van Azure Portal, PowerShell of Azure CLI. Zie de documentatie over de extensie van de Azure File Sync agent voor meer informatie.
Algemeen beschikbaar: Azure File Sync in Italië - noord
De uitbreiding naar Italië - noord brengt de service dichter bij organisaties in deze regio's, biedt lagere latentie, betere prestaties en ondersteuning voor lokale gegevenslocatievereisten.
Gedetailleerde Role-Based Access Control (RBAC) voor Azure File Sync
Azure File Sync bevat nu twee toegewezen ingebouwde RBAC-rollen Azure File Sync Administrator en Azure File Sync Reader, ontworpen om de beveiliging te verbeteren en bewerkingen te stroomlijnen voor organisaties die bestandssynchronisatie tussen on-premises en cloudomgevingen beheren. Deze rollen bieden gedetailleerdere toegangsbeheer dan bredere rollen zoals Eigenaar of Inzender, waardoor organisaties het principe van minimale bevoegdheden effectiever kunnen afdwingen.
Diverse verbeteringen in betrouwbaarheid en telemetrie voor cloudlagen en synchronisatie
Er is een probleem opgelost waarbij synchronisatiedownload- en cloudlaagfouten met foutcode 0x80c80362 (ECS_E_ITEM_PATH_COMPONENT_HAS_ TRAILING_DOT) werden veroorzaakt wanneer een bestands- of mappad een volgpunt bevatte. Voorheen moesten gebruikers de naam van het betrokken item handmatig wijzigen om de synchronisatie te hervatten. Azure File Sync verwerkt nu padonderdelen met volgpunten, waardoor handmatige interventie niet meer nodig is.
Meer informatie over de release van Azure File Sync Agent v21.2
-
Deze release is beschikbaar voor installaties van Windows Server 2016, Windows Server 2019, Windows Server 2022 en Windows Server 2025.
-
De agentversie voor deze release is 21.2.0.0.
-
De volgende updates moeten worden geïnstalleerd op de Windows Server:
-
WS 2016 Microsoft Update-catalogus (meest recente cumulatieve update)
-
WS 2019 Microsoft Update-catalogus (meest recente cumulatieve update)
-
Cumulatieve updates worden maandelijks uitgebracht. Om de meest recente te implementeren, kunnen gebruikers Windows Update gebruiken of deze handmatig downloaden uit de Microsoft Update-catalogus. Als ze handmatig installeren, moeten ze het bijbehorende KB-artikel controleren om te controleren of aan alle vereisten wordt voldaan.
Opmerking: als de Windows-Updates niet zijn geïnstalleerd voordat u de Azure File Sync-agent installeert, kan de Storage Sync Agent-service (FileSyncSvc) niet worden gestart. Zie de documentatie voor het oplossen van problemen met Azure File Sync voor meer informatie.
De Azure File Sync-agent verkrijgen en installeren
De Azure File Sync-agent is beschikbaar via Microsoft Update, Microsoft Update-catalogus en Microsoft Downloadcentrum.
Opmerkingen
-
Als de Azure File Sync agent momenteel niet is geïnstalleerd op een server, gebruikt u het agentinstallatiepakket in het Microsoft Downloadcentrum. Het agentinstallatiepakket in Microsoft Update en Microsoft Update-catalogus is alleen bedoeld voor agentupgrades.
-
Als u bestaande agentinstallaties wilt bijwerken, voert u AfsUpdater.exe (in de installatiemap van de agent) uit of downloadt en installeert u de update vanuit Microsoft Update of Microsoft Update-catalogus.
Microsoft Update
Volg deze stappen op een server waarop Azure File Sync agent is geïnstalleerd om microsoft update te verkrijgen en te installeren:
-
Klik op Start en klik vervolgens op Instellingen.
-
Klik in Instellingen op & beveiliging bijwerken.
-
Klik in het venster Windows Update op Online controleren op updates van Microsoft Update.
-
Controleer of de Azure File Sync agentupdate wordt weergegeven en klik vervolgens op Nu installeren.
Microsoft Update-catalogus
Ga naar de volgende website om deze update handmatig te downloaden vanuit de Microsoft Update-catalogus:
release van Azure File Sync Agent v21.2 - juli 2025 (KB5063825)
Als u het updatepakket handmatig wilt installeren, extraheert u het cab-bestand en voert u de volgende opdracht uit vanaf een opdrachtprompt met verhoogde bevoegdheid:
msiexec.exe /p packagename.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent,StorageSyncAgentAzureFileSync,StorageSyncAgentGuardFilter,StorageSyncAgentUpdater /qb /l*v KB5063825.log
Als u bijvoorbeeld de Azure File Sync agentupdate voor Server 2016 wilt installeren, voert u de volgende opdracht uit:
msiexec.exe /p StorageSyncAgent_WS2016_KB 5063825.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent,StorageSyncAgentAzureFileSyncSync,StorageSyncAgentGuardFilter,StorageSyncAgentUpdater /qb /l*v KB5063825.log
Microsoft Downloadcentrum
Ga naar het Microsoft Downloadcentrum om het agentinstallatiepakket voor nieuwe agentinstallaties handmatig te downloaden.
Een installatie op de achtergrond uitvoeren voor een installatie van een nieuwe agent
Als u een installatie op de achtergrond wilt uitvoeren voor een nieuwe agentinstallatie die gebruikmaakt van de standaardinstellingen, voert u de volgende opdracht uit bij een opdrachtprompt met verhoogde bevoegdheid:
msiexec /i packagename.msi /qb /l*v AFSv21.2Installation.log
Als u bijvoorbeeld de Azure File Sync-agent voor Windows Server 2016 wilt installeren, voert u de volgende opdracht uit:
msiexec /i StorageSyncAgent_WS2016.msi /qb /l*v AFSv21.2Installation.log
Opmerkingen
Gebruik de schakeloptie /qb om herstartprompts (indien nodig), agentupdates en serverregistratieschermen weer te geven. Als u de schermen wilt onderdrukken en de server automatisch opnieuw wilt opstarten (indien nodig), gebruikt u de schakeloptie /qn.
Zie De Azure File Sync-agent op de achtergrond installeren om een installatie op de achtergrond uit te voeren met aangepaste instellingen.