Este artigo descreve os aprimoramentos e problemas corrigidos na versão Sincronização de Arquivos do Azure Agent v21.2 datada de julho de 2025. Além disso, este artigo contém instruções de instalação para esta versão.
Melhorias e problemas corrigidos
Agente Sincronização de Arquivos do Azure Agora Disponível por meio da Extensão do Arc
Os servidores Windows conectados por meio do arco do Azure agora podem instalar Sincronização de Arquivos do Azure agente usando uma nova extensão chamada Agente Sincronização de Arquivos do Azure para Windows. A nova extensão é publicada pela Microsoft e pode ser gerenciada usando o Portal do Azure, o PowerShell ou a CLI do Azure. Para saber mais, confira a documentação de extensão do agente Sincronização de Arquivos do Azure.
Geralmente Disponível: Sincronização de Arquivos do Azure no Norte da Itália
A expansão para o Norte da Itália aproxima o serviço das organizações nessas regiões, oferecendo menor latência, melhor desempenho e suporte para requisitos locais de residência de dados.
RBAC (Role-Based Controle de Acesso granular) para Sincronização de Arquivos do Azure
Sincronização de Arquivos do Azure agora inclui duas funções internas dedicadas do RBAC Sincronização de Arquivos do Azure Administrador e leitor de Sincronização de Arquivos do Azure, projetado para fortalecer a segurança e simplificar as operações para organizações que gerenciam a sincronização de arquivos entre ambientes locais e de nuvem. Essas funções oferecem um controle de acesso mais granular do que funções mais amplas, como Proprietário ou Colaborador, permitindo que as organizações imponham o princípio de menor privilégio de forma mais eficaz.
Melhorias diversas de confiabilidade e telemetria para camadas de nuvem e sincronização
Corrigimos um problema que causava falhas de download de sincronização e camadas de nuvem com 0x80c80362 de código de erro (ECS_E_ITEM_PATH_COMPONENT_HAS_ TRAILING_DOT) quando um caminho de arquivo ou pasta incluía um ponto à direita. Anteriormente, os usuários tinham que renomear manualmente o item afetado para retomar a sincronização. Sincronização de Arquivos do Azure agora lida corretamente com componentes de caminho com pontos à direita, eliminando a necessidade de intervenção manual.
Mais informações sobre a versão Sincronização de Arquivos do Azure Agent v21.2
-
Essa versão está disponível para instalações Windows Server 2016, Windows Server 2019, Windows Server 2022 e Windows Server 2025.
-
A versão do agente para esta versão é 21.2.0.0.
-
As seguintes atualizações devem ser instaladas no Windows Server:
-
Catálogo de Atualizações da Microsoft do WS 2016 (atualização cumulativa mais recente)
-
Catálogo de Atualizações da Microsoft do WS 2019 (atualização cumulativa mais recente)
-
As atualizações cumulativas são lançadas mensalmente. Para implantar o mais recente, os usuários podem usar Windows Update ou baixá-lo manualmente no Catálogo de Atualizações da Microsoft. Se estiver instalando manualmente, eles deverão examinar o artigo KB associado para garantir que todos os pré-requisitos sejam atendidos.
Observação: se o Windows Atualizações não estiver instalado antes de instalar o agente Sincronização de Arquivos do Azure, o serviço do Agente de Sincronização de Armazenamento (FileSyncSvc) não será iniciado. Para saber mais, confira a Sincronização de Arquivos do Azure documentação de solução de problemas.
Como obter e instalar o agente de Sincronização de Arquivos do Azure
O agente Sincronização de Arquivos do Azure está disponível no Microsoft Update, no Catálogo de Atualizações da Microsoft e no Centro de Download da Microsoft.
Observações
-
Se o agente Sincronização de Arquivos do Azure não estiver instalado atualmente em um servidor, use o pacote de instalação do agente no Centro de Download da Microsoft. O pacote de instalação do agente no Microsoft Update e no Catálogo de Atualizações da Microsoft destina-se apenas a atualizações de agente.
-
Para atualizar as instalações de agente existentes, execute AfsUpdater.exe (localizado no diretório de instalação do agente) ou baixe e instale a atualização do Microsoft Update ou do Catálogo de Atualizações da Microsoft.
Microsoft Update
Para obter e instalar no Microsoft Update, siga estas etapas em um servidor que tenha Sincronização de Arquivos do Azure agente instalado:
-
Clique em Iniciar e clique em Configurações.
-
Em Configurações, clique em Atualizar & segurança.
-
Na janela Windows Update, clique em Verificar online para obter atualizações do Microsoft Update.
-
Verifique se a atualização do agente Sincronização de Arquivos do Azure está listada e clique em Instalar agora.
Catálogo do Microsoft Update
Acesse o seguinte site para baixar manualmente esta atualização do Catálogo de Atualizações da Microsoft:
versão do Agente Sincronização de Arquivos do Azure v21.2 – julho de 2025 (KB5063825)
Para instalar manualmente o pacote de atualização, extraia o arquivo de táxi e execute o seguinte comando de um prompt de comando elevado:
msiexec.exe /p packagename.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent,StorageSyncAgentAzureFileSync,StorageSyncAgentGuardFilter,StorageSyncAgentUpdater /qb /l*v KB5063825.log
Por exemplo, para instalar a atualização do agente Sincronização de Arquivos do Azure para o Server 2016, execute o seguinte comando:
msiexec.exe /p StorageSyncAgent_WS2016_KB 5063825.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent,StorageSyncAgentAzureFileSync,StorageSyncAgentGuardFilter,StorageSyncAgentUpdater /qb /l*v KB5063825.log
Centro de Download da Microsoft
Acesse o Centro de Download da Microsoft para baixar manualmente o pacote de instalação do agente para novas instalações de agente.
Como executar uma instalação silenciosa para uma instalação de um novo agente
Para executar uma instalação silenciosa para uma nova instalação de agente que usa as configurações padrão, execute o seguinte comando em um prompt de comando elevado:
msiexec /i packagename.msi /qb /l*v AFSv21.2Installation.log
Por exemplo, para instalar o agente Sincronização de Arquivos do Azure para Windows Server 2016, execute o seguinte comando:
msiexec /i StorageSyncAgent_WS2016.msi /qb /l*v AFSv21.2Installation.log
Observações
Use a opção /qb para exibir prompts de reinicialização (se necessário), atualização do agente e telas de registro do servidor. Para suprimir as telas e reiniciar automaticamente o servidor (se necessário), use o comutador /qn.
Para executar uma instalação silenciosa com configurações personalizadas, consulte Como instalar o agente Sincronização de Arquivos do Azure silenciosamente.