Azure File Sync — Sincronizar Ficheiros entre Windows Server e a Nuvem em 2026

Por Duarte Spínola · 27 junho 2026 · kbase.pt

 

O Azure File Sync é um dos serviços mais subutilizados e, ao mesmo tempo, mais poderosos para gestão de ficheiros em ambientes híbridos Windows. Permite centralizar os ficheiros da organização num Azure File Share enquanto mantém o desempenho local de um servidor Windows Server. Este artigo percorre todas as etapas — desde a arquitetura conceptual até ao diagnóstico avançado e cenários de recuperação após desastre para PMEs — com exemplos práticos em PowerShell usando o módulo Az.StorageSync.

1. O que é o Azure File Sync

O Azure File Sync é um serviço cloud da Microsoft que replica ficheiros Windows entre um ou mais servidores on-premises e um Azure File Share. O conceito central é simples: o Azure File Share funciona como repositório central e autoritativo, enquanto os Windows Server locais actuam como caches que podem ser configuradas com políticas de tiering. O utilizador final continua a aceder aos ficheiros através do protocolo SMB, tal como sempre fez — não há alteração na experiência de acesso.

Os principais benefícios do serviço incluem:

• Centralização dos ficheiros corporativos num Azure File Share, acessível a partir de qualquer local.
• Manutenção do desempenho local do Windows Server, com cache de ficheiros quentes em disco local.
• Redução do espaço ocupado nos servidores locais através de Cloud Tiering (ficheiros frios ficam apenas na cloud).
• Suporte multi-site: vários servidores podem sincronizar a mesma partilha, permitindo colaboração entre escritórios.
• Integração nativa com Azure Backup para snapshots do File Share, sem necessidade de agentes adicionais.
• Suporte paraDFS-R como mecanismo complementar em migrações faseadas.

Para uma visão geral oficial, consulte a documentação em learn.microsoft.com — File Sync planning e learn.microsoft.com — File Sync introduction.

Num cenário típico de PME portuguesa, o Azure File Sync substitui com vantagem soluções tradicionais de replicação DFS-R, oferecendo um ponto de recuperação na cloud sem investir em hardware adicional. Para aprofundar a comparação com DFS, veja o nosso artigo DFS Namespaces e Replication no Windows Server.

2. Arquitetura: StorageSyncService, SyncGroup, ServerEndpoint e CloudEndpoint

A arquitetura do Azure File Sync assenta em quatro componentes principais que se relacionam de forma hierárquica. Compreender esta hierarquia é essencial antes de avançar para a implementação.

StorageSyncService

O Storage Sync Service é o recurso de top-level em Azure. É criado numa subscrição e região e funciona como contentor lógico para todos os grupos de sincronização. Cada Storage Sync Service gere os servidores registados e os grupos de sincronização. Pode ter um ou mais Storage Sync Services por subscrição, mas a boa prática é alinhar o recurso com a região onde o Storage Account reside para minimizar latência.

Referência: learn.microsoft.com — Deployment guide.

SyncGroup

O Sync Group é o contentor que define a relação de sincronização. Dentro de um Sync Group existe exatamente um Cloud Endpoint (um Azure File Share) e um ou mais Server Endpoints (pastas locais em servidores registados). Todos os endpoints dentro do mesmo Sync Group mantêm o conteúdo sincronizado entre si. A topologia é sempre hub-and-spoke: o Cloud Endpoint é o hub, os Server Endpoints são os spokes.

ServerEndpoint

O Server Endpoint representa uma localização num servidor Windows registado — tipicamente um caminho local como D:\Shares\Marketing ou um volume montado. É o ponto onde o agente do Azure File Sync instala a monitorização de alterações e onde o Cloud Tiering opera. Cada Server Endpoint pertence a um único Sync Group.

CloudEndpoint

O Cloud Endpoint é a referência ao Azure File Share dentro do Sync Group. É criado automaticamente quando se adiciona o File Share ao Sync Group. O File Share deve existir previamente numa Storage Account standard (GPv1, GPv2) ou premium (FileStorage). O Cloud Endpoint não é um recurso standalone — é gerido no contexto do Sync Group.

Componente	Função	Relação
StorageSyncService	Recurso top-level em Azure; gere servidores registados e Sync Groups	Contém 1..N Sync Groups
SyncGroup	Define a relação de sincronização entre endpoints	Contém 1 Cloud Endpoint + 1..N Server Endpoints
ServerEndpoint	Pasta local num Windows Server registado	Pertence a 1 Sync Group
CloudEndpoint	Referência ao Azure File Share no Sync Group	1 por Sync Group

Para mais detalhes sobre a arquitetura, consulte learn.microsoft.com — File Sync planning e o guia de deployment em learn.microsoft.com — Deployment guide.

3. Pré-requisitos

Antes de instalar o agente e configurar a sincronização, é necessário garantir um conjunto de pré-requisitos ao nível do Azure, do Windows Server e da rede.

Azure

• Subscrição Azure ativa com permissões para criar recursos (Storage Account, Storage Sync Service).
• Um Storage Account (General Purpose v2 recomendado) na mesma região do Storage Sync Service.
• Um Azure File Share criado dentro do Storage Account.
• Módulo Az PowerShell instalado ou Azure CLI para operações de gestão.

Windows Server

• Windows Server 2016, 2019, 2022 ou 2025 (verifique compatibilidade da versão do agente).
• PowerShell 5.1 ou superior.
• .NET Framework 4.6.1 ou superior.
• Espaço em disco suficiente: mínimo 5 GB para base de dados do agente, recomendado 10 GB.
• Volume formatado em NTFS (ReFS não é suportado para Server Endpoint).

Rede e Conectividade

• Acesso à internet ou a um proxy que permita ligações aos endpoints do Azure File Sync.
• Portas de saída: 443 (HTTPS) para os endpoints de serviço.
• Endpoints a permitir: *.files.windows.net, *.afs.azure.net, *.blob.core.windows.net, login.microsoftonline.com.
• DNS funcional com resolução de nomes públicos.
• Se usar firewall ou NSG, consulte a lista completa em learn.microsoft.com — File Sync firewall and proxy.

Para diagnósticos de conectividade entre o servidor e os endpoints Azure, recomendamos o nosso artigo Diagnóstico de Conectividade no Windows Server.

Verificação rápida em PowerShell

# Verificar sistema de ficheiros do volume D
Get-Volume -DriveLetter D | Select-Object DriveLetter,FileSystem,Size,SizeRemaining

# Verificar versão do PowerShell
$PSVersionTable.PSVersion

# Verificar .NET Framework
Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" -Name Release -ErrorAction SilentlyContinue | Select-Object Release

# Verificar conectividade aos endpoints
Test-NetConnection -ComputerName "afs.azure.net" -Port 443
Test-NetConnection -ComputerName "file.core.windows.net" -Port 443

4. Instalar o Agente do Azure File Sync

O agente do Azure File Sync é o componente que corre em cada Windows Server participante na sincronização. É responsável por monitorizar alterações locais, descarregar ficheiros da cloud (recall) e gerir o Cloud Tiering. A instalação é feita através de um pacote MSI disponível no Microsoft Download Center.

Download do agente

O agente pode ser descarregado a partir do Microsoft Learn — Deployment guide, que contém o link directo para a versão mais recente. Sempre que possível, instale a versão mais recente do agente, pois inclui correcções de segurança e melhorias de desempenho.

Instalação silenciosa via PowerShell

# Definir variáveis
$agentUrl = "https://download.microsoft.com/download/.../StorageSyncAgent.msi"
$msiPath  = "$env:TEMP\StorageSyncAgent.msi"

# Descarregar agente
Invoke-WebRequest -Uri $agentUrl -OutFile $msiPath

# Instalar silenciosamente
Start-Process msiexec.exe -ArgumentList "/i `"$msiPath`" /qn /l*v `"$env:TEMP\AFSInstall.log`"" -Wait

# Verificar serviço
Get-Service -Name "FileSyncSvc" | Select-Object Name,Status,StartType

# Verificar versão instalada
(Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Azure\StorageSync" -ErrorAction SilentlyContinue).Version

Instalação via Az.StorageSync (verificação)

# Instalar módulo Az.StorageSync se necessário
Install-Module -Name Az.StorageSync -Repository PSGallery -Force -AllowClobber

# Importar módulo
Import-Module Az.StorageSync

# Verificar cmdlets disponíveis
Get-Command -Module Az.StorageSync | Select-Object Name,CommandType | Format-Table -AutoSize

Para ambientes virtualizados, a instalação do agente pode ser automatizada via Hyper-V templates. Veja o nosso artigo Hyper-V e Windows Server — Virtualização com PowerShell para estratégias de automação de VMs.

5. Registar o Servidor no Storage Sync Service

Após instalar o agente, o servidor precisa de ser registado no Storage Sync Service. Este passo estabelece a confiança entre o servidor local e o recurso Azure. O registo cria um Server Resource dentro do Storage Sync Service e gera um certificado de autenticação que é renovado automaticamente.

Pré-requisito: criar o Storage Sync Service

# Conectar a Azure
Connect-AzAccount -Subscription "00000000-0000-0000-0000-000000000000"

# Variáveis
$resourceGroup = "rg-filesync-prod"
$location      = "westeurope"
$svcName       = "ssv-prod-weu-001"

# Criar resource group
New-AzResourceGroup -Name $resourceGroup -Location $location

# Criar Storage Sync Service
New-AzStorageSyncService `
    -ResourceGroupName $resourceGroup `
    -Name $svcName `
    -Location $location `
    -IncomingTrafficPolicy "AllowAllTraffic"

# Verificar
Get-AzStorageSyncService -ResourceGroupName $resourceGroup | Format-List

Registar o servidor

# Variáveis
$resourceGroup  = "rg-filesync-prod"
$svcName        = "ssv-prod-weu-001"

# Registar servidor (corre localmente no Windows Server)
Register-AzStorageSyncServer `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName

# Listar servidores registados
Get-AzStorageSyncServer `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName | Format-Table Name,ServerName,LastHeartbeat,OsVersion

O registo gera um certificado guardado no certificado store local do servidor. Este certificado é usado para autenticação com o serviço Azure File Sync e tem validade de alguns anos, sendo renovado automaticamente pelo agente. Para detalhes, consulte learn.microsoft.com — Deployment guide.

6. Criar um Sync Group e o Azure File Share

O Sync Group é a unidade lógica que junta os endpoints. Antes de criar o Sync Group, é necessário ter um Azure File Share criado numa Storage Account.

Criar o Storage Account e o File Share

# Variáveis
$resourceGroup = "rg-filesync-prod"
$location      = "westeurope"
$storageName   = "stprodweu001"
$shareName     = "marketing"

# Criar Storage Account (GPv2, LRS para custo optimizado)
New-AzStorageAccount `
    -ResourceGroupName $resourceGroup `
    -Name $storageName `
    -Location $location `
    -SkuName "Standard_LRS" `
    -Kind "StorageV2" `
    -EnableHttpsTrafficOnly $true

# Criar File Share
New-AzRmStorageShare `
    -ResourceGroupName $resourceGroup `
    -StorageAccountName $storageName `
    -Name $shareName `
    -QuotaGiB 1024 `
    -EnabledProtocol SMB

# Verificar
Get-AzRmStorageShare `
    -ResourceGroupName $resourceGroup `
    -StorageAccountName $storageName | Format-Table Name,QuotaGiB,EnabledProtocol

Criar o Sync Group

# Variáveis
$resourceGroup  = "rg-filesync-prod"
$svcName        = "ssv-prod-weu-001"
$syncGroupName  = "sg-marketing-01"

# Criar Sync Group
New-AzStorageSyncGroup `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName `
    -Name $syncGroupName

# Verificar
Get-AzStorageSyncGroup `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName | Format-Table Name,SyncGroupId

Criar o Cloud Endpoint

# Variáveis
$storageName    = "stprodweu001"
$shareName      = "marketing"

# Obter ID do Storage Account
$storageAccount = Get-AzStorageAccount -ResourceGroupName $resourceGroup -Name $storageName

# Criar Cloud Endpoint no Sync Group
New-AzStorageSyncCloudEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName `
    -SyncGroupName $syncGroupName `
    -Name "ce-marketing" `
    -StorageAccountResourceId $storageAccount.Id `
    -StorageAccountShareName $shareName `
    -StorageAccountTenantId (Get-AzContext).Tenant.Id

# Verificar
Get-AzStorageSyncCloudEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName `
    -SyncGroupName $syncGroupName | Format-List

7. Configurar o Server Endpoint

O Server Endpoint é o caminho local no Windows Server que será sincronizado com o Azure File Share. A criação do Server Endpoint dispara uma sincronização inicial que pode demorar desde minutos até várias horas, dependendo do volume de dados e da largura de banda disponível.

Criar o Server Endpoint

# Variáveis
$serverName       = "SRV-FILE-01"
$serverEndpointPath = "D:\Shares\Marketing"

# Obter o ID do servidor registado
$registeredServer = Get-AzStorageSyncServer `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName | Where-Object { $_.ServerName -eq $serverName }

# Criar Server Endpoint
New-AzStorageSyncServerEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName `
    -SyncGroupName $syncGroupName `
    -Name "se-marketing-srv01" `
    -ServerResourceId $registeredServer.ServerResourceId `
    -ServerLocalPath $serverEndpointPath `
    -CloudTiering $false `
    -VolumeFreeSpacePercent 0 `
    -TierFilesOlderThanDays 0

# Verificar
Get-AzStorageSyncServerEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName `
    -SyncGroupName $syncGroupName | Format-List Name,ServerLocalPath,CloudTiering,ProvisioningState

Parâmetros importantes do Server Endpoint

Parâmetro	Descrição	Valor por defeito
CloudTiering	Ativa o tiering de ficheiros frios para a cloud	$false
VolumeFreeSpacePercent	Percentagem de espaço livre a manter no volume	0 (não aplicável se CloudTiering off)
TierFilesOlderThanDays	Dias após os quais ficheiros acedidos ficam tiered	0 (não aplicável)
InitialDownloadPolicy	Política de download inicial (Full, Namespace, AvoidTiered)	Namespace
LocalCacheMode	Modo de cache local (UpdateLocallyCachedFiles, etc.)	Default

Para mais informação sobre os parâmetros, consulte learn.microsoft.com — Deployment guide e a referência de cmdlets em learn.microsoft.com — New-AzStorageSyncServerEndpoint.

8. Cloud Tiering — Políticas de Cache

O Cloud Tiering é a funcionalidade que distingue o Azure File Sync de soluções de replicação tradicionais. Permite que o Windows Server armazene apenas uma fracção dos ficheiros localmente, mantendo os ficheiros menos acedidos (frios) apenas na cloud. Os ficheiros tiered aparecem como ponteiros no sistema de ficheiros local e são automaticamente descarregados (recall) quando um utilizador ou aplicação tenta aceder-lhes.

Políticas de cache disponíveis

O Cloud Tiering tem duas políticas principais que podem ser combinadas:

Política de espaço livre no volume (Volume Free Space Policy)

Mantém uma percentagem configurável de espaço livre no volume. Quando o volume enche abaixo do limite, o tiering coloca ficheiros na cloud até atingir a percentagem definida. Por exemplo, com 20% definido num volume de 1 TB, o tiering garante que pelo menos 200 GB ficam livres.

Política de data (Date Policy)

Faz tier de ficheiros que não foram acedidos durante um número de dias configurado. Por exemplo, com 30 dias definido, qualquer ficheiro que não tenha sido aberto nos últimos 30 dias é tiered para a cloud, mesmo que haja espaço livre no volume.

Política	Parâmetro PowerShell	Comportamento
Volume Free Space	-VolumeFreeSpacePercent 20	Mantém 20% do volume livre; faz tier até atingir o objectivo
Date Policy	-TierFilesOlderThanDays 30	Faz tier de ficheiros não acedidos há mais de 30 dias
Combinada	Ambos parâmetros	Aplica ambas: o mais restritivo prevalece em cada ciclo

Exemplo: ativar Cloud Tiering

# Variáveis
$serverEndpointName = "se-marketing-srv01"

# atualizar Server Endpoint para ativar Cloud Tiering
Set-AzStorageSyncServerEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName `
    -SyncGroupName $syncGroupName `
    -Name $serverEndpointName `
    -CloudTiering $true `
    -VolumeFreeSpacePercent 20 `
    -TierFilesOlderThanDays 30

# Verificar configuração
Get-AzStorageSyncServerEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName `
    -SyncGroupName $syncGroupName `
    -Name $serverEndpointName | Format-List Name,CloudTiering,VolumeFreeSpacePercent,TierFilesOlderThanDays

Verificar estado de tiering localmente

# Verificar ficheiros tiered numa pasta
Get-Item -Path "D:\Shares\Marketing\*" | ForEach-Object {
    $attrs = $_.Attributes
    [PSCustomObject]@{
        Name   = $_.Name
        Tiered = ($attrs -band [System.IO.FileAttributes]::Offline) -ne 0
        Size   = $_.Length
    }
} | Format-Table -AutoSize

# Contar ficheiros tiered
Get-ChildItem -Path "D:\Shares\Marketing" -Recurse | Where-Object {
    $_.Attributes -band [System.IO.FileAttributes]::Offline
} | Measure-Object | Select-Object Count

# Forçar recall de um ficheiro específico
Invoke-StorageSyncFileRecall -Path "D:\Shares\Marketing\Relatorios\2026\Q1.xlsx"

Ficheiros tiered têm o atributo Offline ativo no sistema de ficheiros. O agente do Azure File Sync gerencia os recalls de forma transparente. Para detalhes sobre o funcionamento interno do Cloud Tiering, consulte learn.microsoft.com — Cloud Tiering overview.

9. Gestão da Sincronização

Após a configuração inicial, a gestão contínua da sincronização envolve monitorização, ajuste de políticas e resposta a alertas. O Azure File Sync oferece várias ferramentas para esta gestão.

Estado da sincronização

# Verificar estado geral da sincronização por Server Endpoint
Get-AzStorageSyncServerEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName `
    -SyncGroupName $syncGroupName | Format-Table `
    Name,ProvisioningState,LastWorkflowId,StorageSyncStatus

# Verificar detalhe de um workflow específico
$workflowId = (Get-AzStorageSyncServerEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName `
    -SyncGroupName $syncGroupName `
    -Name "se-marketing-srv01").LastWorkflowId

Get-AzStorageSyncServerEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName `
    -SyncGroupName $syncGroupName `
    -Name "se-marketing-srv01" | Select-Object -ExpandProperty SyncStatus

Forçar sincronização

# Disparar uma sincronização manual
Invoke-AzStorageSyncServerEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName `
    -SyncGroupName $syncGroupName `
    -Name "se-marketing-srv01"

Gestão de largura de banda

O Azure File Sync permite configurar limites de largura de banda para controlar o impacto da sincronização na rede. Esta configuração é feita ao nível do servidor registado.

# Definir limite de largura de banda (em kbps) durante horas de trabalho
Set-StorageSyncBandwidthThrottle `
    -Direction "Upload" `
    -StartHour 8 `
    -EndHour 18 `
    -MaxBandwidthKbps 10240

# Definir limite diferente fora das horas de trabalho
Set-StorageSyncBandwidthThrottle `
    -Direction "Upload" `
    -StartHour 18 `
    -EndHour 8 `
    -MaxBandwidthKbps 0

Alertas e métricas

O Azure File Sync integra com Azure Monitor, permitindo criar alertas sobre falhas de sincronização, recalls de ficheiros e estado do agente. Para configurar alertas básicos:

# Variáveis para alerta
$actionGroup = New-AzActionGroup -Name "ag-filesync" -ResourceGroup $resourceGroup -ShortName "AFSync"
$actionEmail = Set-AzActionGroup -Name $actionGroup.Name -ResourceGroup $resourceGroup -ShortName "Email" -EmailReceiver "[email protected]"

# Criar regra de alerta para falhas de sincronização
$criteria = New-AzMetricAlertRuleV2Criteria `
    -MetricName "SyncSessionResult" `
    -TimeAggregation "Total" `
    -Operator "GreaterThan" `
    -Threshold 0

New-AzMetricAlertRuleV2 `
    -Name "alert-sync-failures" `
    -ResourceGroupName $resourceGroup `
    -TargetResourceId "/subscriptions/.../providers/Microsoft.StorageSync/storageSyncServices/$svcName" `
    -Criteria $criteria `
    -ActionGroupId $actionGroup.Id `
    -Severity 2

Para mais informações sobre monitorização, consulte learn.microsoft.com — File Sync monitoring e learn.microsoft.com — Monitor sync health.

10. Diagnóstico: Event Logs e PowerShell

O diagnóstico de problemas no Azure File Sync passa por duas frentes: os Event Logs locais no Windows Server e os cmdlets PowerShell do módulo Az.StorageSync. Ambos são complementares e devem ser usados em conjunto.

Event Logs do Azure File Sync

O agente do Azure File Sync regista eventos em quatro canais principais do Event Viewer:

Canal	Caminho	Conteúdo
Operacional	Applications and Services Logs\FileSync\Admin	Eventos administrativos: registo, erros de sincronização, configurações
Telemetria	Applications and Services Logs\FileSync\Telemetry	Eventos de telemetria e diagnóstico detalhado
Operacional (Management)	Applications and Services Logs\StorageSync\Management	Eventos de gestão: criação/remoção de endpoints
Diagnóstico	Applications and Services Logs\FileSync\Diagnostic	Eventos de diagnóstico de baixo nível

Consultar Event Logs em PowerShell

# Últimos 50 eventos de erro no canal Admin
Get-WinEvent -LogName "Applications and Services Logs\FileSync\Admin" `
    -MaxEvents 50 | Where-Object { $_.Level -le 2 } | Format-Table TimeCreated,Id,LevelDisplayName,Message -Wrap

# Eventos de sincronização nas últimas 24 horas
$startTime = (Get-Date).AddHours(-24)
Get-WinEvent -LogName "Applications and Services Logs\FileSync\Admin" `
    -FilterHashtable @{ StartTime=$startTime; Level=2 } | Format-List TimeCreated,Id,Message

# Contar eventos por ID nas últimas 24h
Get-WinEvent -LogName "Applications and Services Logs\FileSync\Admin" -MaxEvents 500 |
    Group-Object Id | Sort-Object Count -Descending | Select-Object Count,Name | Format-Table -AutoSize

Diagnóstico avançado com Az.StorageSync

# Obter estado detalhado de sincronização de um Server Endpoint
$se = Get-AzStorageSyncServerEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName `
    -SyncGroupName $syncGroupName `
    -Name "se-marketing-srv01"

# Verificar última sessão de upload
$se.SyncStatus.UploadStatus | Format-List

# Verificar última sessão de download
$se.SyncStatus.DownloadStatus | Format-List

# Verificar conflitos
$se.SyncStatus.UploadStatus.CloudEndpoints | Format-List

# Obter heat map (mapa de acesso a ficheiros) para tiering
Get-AzStorageSyncServerEndpointHeatMap `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName `
    -SyncGroupName $syncGroupName `
    -Name "se-marketing-srv01" | Format-Table Name,HeatMapPath,IsDirectory -AutoSize

Ferramenta de diagnóstico local: afsdiag.exe

# A ferramenta afsdiag.exe (incluída com o agente) gera um pacote
# de diagnóstico completo para envio ao suporte Microsoft.
# Localização típica:
# C:\Program Files\Azure\StorageSyncAgent\afsdiag.exe

# Executar e gerar pacote
& "C:\Program Files\Azure\StorageSyncAgent\afsdiag.exe" -Output "C:\Temp\afsdiag"

# O pacote inclui:
# - Event logs completos
# - Estado do agente
# - Configuração de registry
# - Logs de telemetria
# - Informação de rede

Para mais detalhes sobre diagnóstico, consulte learn.microsoft.com — Troubleshoot sync errors e learn.microsoft.com — Troubleshoot cloud tiering.

11. Backup com Azure Backup e VSS

A estratégia de backup para dados sincronizados via Azure File Sync deve cobrir duas frentes: o Azure File Share na cloud e os dados locais no Windows Server. A boa notícia é que ambas as frentes têm soluções nativas.

Backup do Azure File Share

O Azure Backup oferece snapshots automatizados do Azure File Share, sem necessidade de agentes e sem impacto na sincronização. Os snapshots são incrementais e guardados numa Recovery Services Vault. Esta é a estratégia recomendada como linha principal de backup.

# Variáveis
$vaultName   = "rsv-filesync-prod"
$vaultRG     = $resourceGroup
$policyName  = "policy-fileshare-daily"

# Criar Recovery Services Vault
New-AzRecoveryServicesVault `
    -ResourceGroupName $vaultRG `
    -Name $vaultName `
    -Location $location

# Obter vault e definir configuração de storage
$vault = Get-AzRecoveryServicesVault -Name $vaultName -ResourceGroupName $vaultRG
Set-AzRecoveryServicesBackupProperty -Vault $vault -BackupStorageRedundancy "LocallyRedundant"

# Criar política de backup para File Share
$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType "AzureFiles"
$schedulePolicy.ScheduleRunTimes = (Get-Date -Hour 2 -Minute 0 -Second 0).ToUniversalTime()
$schedulePolicy.ScheduleRunFrequency = "Daily"

$retentionPolicy = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType "AzureFiles"
$retentionPolicy.DailyScheduleRetentionCount = 30

$policy = New-AzRecoveryServicesBackupProtectionPolicy `
    -Name $policyName `
    -WorkloadType "AzureFiles" `
    -RetentionPolicy $retentionPolicy `
    -SchedulePolicy $schedulePolicy `
    -VaultId $vault.ID

# ativar backup para o File Share
$storageAccount = Get-AzStorageAccount -ResourceGroupName $resourceGroup -Name $storageName
$share = Get-AzRmStorageShare -ResourceGroupName $resourceGroup -StorageAccountName $storageName -Name $shareName

Enable-AzRecoveryServicesBackupProtection `
    -ResourceGroupName $resourceGroup `
    -Name $shareName `
    -Policy $policy `
    -VaultId $vault.ID `
    -StorageAccountName $storageName `
    -ResourceGroupName $resourceGroup

# Verificar estado
Get-AzRecoveryServicesBackupItem `
    -VaultId $vault.ID `
    -WorkloadType "AzureFiles" | Format-Table Name,FriendlyName,ProtectionStatus

VSS (Volume Shadow Copy) no Windows Server

Para protecção local complementar, o VSS (Volume Shadow Copy) permite criar snapshots point-in-time do volume onde reside o Server Endpoint. Isto é útil para recuperação rápida de ficheiros apagados acidentalmente, sem recorrer à cloud.

# ativar VSS no volume D com limite de 10% de espaço
vssadmin add shadowstorage /for=D: /on=D: /maxsize=10%

# Verificar configuração
vssadmin list shadowstorage

# Criar snapshot manual
vssadmin create shadow /for=D:

# Listar snapshots
vssadmin list shadows /for=D:

Restaurar ficheiros a partir de Azure Backup

# Obter ponto de recuperação disponível
$startDate = (Get-Date).AddDays(-7)
$endDate   = Get-Date
$rp = Get-AzRecoveryServicesBackupRecoveryPoint `
    -VaultId $vault.ID `
    -StartDate $startDate `
    -EndDate $endDate `
    -Name $shareName | Select-Object -First 1

# Restaurar para localização alternativa
Restore-AzRecoveryServicesBackupItem `
    -RecoveryPoint $rp `
    -ResolveConflict Overwrite `
    -SourceFilePath "Relatorios/2026/Q1.xlsx" `
    -TargetStorageAccountName $storageName `
    -TargetFileShareName "marketing-restored" `
    -VaultId $vault.ID

Para mais detalhes sobre backup de File Shares, consulte learn.microsoft.com — Backup Azure Files e learn.microsoft.com — File Sync DR best practices.

12. Cenário PME: Disaster Recovery

Para uma PME portuguesa com um único servidor de ficheiros on-premises, o Azure File Sync oferece uma solução de disaster recovery elegante e económica. O cenário típico é o seguinte: uma empresa com 50-200 utilizadores tem um Windows Server local que serve ficheiros via SMB. Em caso de falha do servidor (hardware, ransomware, desastre físico), o objectivo é voltar a operar em horas, não em dias.

Arquitetura do cenário

• Servidor principal: Windows Server 2022 ou 2025 on-premises, com Cloud Tiering ativo.
• Storage Account: Standard LRS ou GRS (Geo-Redundant Storage recomendado para DR multi-região).
• Azure File Share: partilha única ou múltiplas, com Azure Backup ativo.
• Servidor de failover: VM Azure ou servidor secundário em outro escritório, registado no mesmo Sync Group.

Configuração do servidor de failover

# No servidor de failover (pode ser uma VM Azure)
# Instalar agente (ver secção 4)
# Registar no mesmo Storage Sync Service (ver secção 5)

# Criar Server Endpoint no mesmo Sync Group
$failoverServerName = "SRV-FILE-DR-01"
$failoverPath       = "D:\Shares\Marketing"

$drServer = Get-AzStorageSyncServer `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName | Where-Object { $_.ServerName -eq $failoverServerName }

New-AzStorageSyncServerEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $svcName `
    -SyncGroupName $syncGroupName `
    -Name "se-marketing-dr01" `
    -ServerResourceId $drServer.ServerResourceId `
    -ServerLocalPath $failoverPath `
    -CloudTiering $false `
    -InitialDownloadPolicy "AvoidTieredFiles"

# O parâmetro AvoidTieredFiles força o download completo de todos os ficheiros
# no servidor de failover, garantindo que está pronto para servir sem recalls.

Procedimento de failover

1. Confirmar que o servidor principal está indisponível.
2. Verificar estado do Azure File Share: Get-AzRmStorageShare e confirmar que o último sync completou.
3. No servidor de failover, forçar sincronização completa: Invoke-AzStorageSyncServerEndpoint.
4. Se o servidor de failover tinha Cloud Tiering, forçar recall de todos os ficheiros: Invoke-StorageSyncFileRecall -Path D:\Shares\Marketing -Force.
5. Redireccionar utilizadores para o servidor de failover (via DNS, DFS Namespace ou script de mapeamento).
6. Verificar integridade dos ficheiros críticos com os responsáveis de negócio.

Procedimento de failback

1. Após o servidor principal ser restaurado, garantir que o agente do Azure File Sync está a correr.
2. Forçar sincronização no sentido cloud → servidor principal: Invoke-AzStorageSyncServerEndpoint no endpoint do servidor principal.
3. Verificar que não há conflitos: Get-WinEvent -LogName "Applications and Services Logs\FileSync\Admin".
4. Redireccionar utilizadores de volta ao servidor principal.
5. Manter o servidor de failover sincronizado para o próximo incidente.

Para estratégias mais amplas de resiliência e virtualização, consulte Hyper-V e Windows Server e Windows Server 2025 — Novidades e Migração.

13. Erros Comuns

A tabela seguinte resume os erros mais frequentes no Azure File Sync, as causas prováveis e as acções de resolução. Estes valores foram compilados a partir da documentação oficial e da experiência prática de implementação.

Código/Evento	Sintoma	Causa provável	Resolução
-2134375772 (0x80C80254)	Sincronização parada; upload falha	Espaço insuficiente no volume para base de dados do agente	Libertar espaço no volume; mínimo 5 GB livres para a DB
-2134375872 (0x80C801F0)	Erro de autenticação no registo	Relógio do servidor des sincronizado	Sincronizar relógio com NTP; tolerância máxima de 15 min
-2134375680 (0x80C802B0)	Cloud Tiering não funciona	Volume não suportado ou ReFS	Verificar NTFS com Get-Volume; converter se necessário
-2134375648 (0x80C802D0)	Recall de ficheiro falha	Conectividade interrompida ou Storage Account inacessível	Verificar DNS, firewall e regras NSG; Test-NetConnection
Event ID 8304	Sessão de upload falha repetidamente	Quota do File Share excedida ou ficheiro bloqueado	Aumentar quota; identificar processo com handle.exe
Event ID 8305	Sessão de download falha	Largura de banda insuficiente ou timeout	Verificar largura de banda; ajustar throttle se necessário
-2134376423 (0x80C80049)	Servidor não consegue registar	Proxy bloqueando endpoints Azure	Configurar proxy do agente: FileSyncAgentProxy no registry
-2134375911 (0x80C801C9)	Conflito de ficheiros em sincronização inicial	Dados preexistentes em ambos os lados com nomes iguais	Rever ficheiros com sufixo “conflict”; resolver manualmente
Event ID 2001	Agente não arranca após reinício	Serviço FileSyncSvc desactivado ou dependência em falta	Set-Service FileSyncSvc -StartupType Automatic; Start-Service FileSyncSvc
-2134376426 (0x80C80046)	Erro de certificado de servidor	Certificado de registo expirado ou corrompido	Anular registo e voltar a registar servidor
-2134375936 (0x80C801B0)	Sincronização lenta sem erros	Elevado número de ficheiros pequenos ou antivírus ativo	Excluir caminhos do Server Endpoint do antivírus
-2134375896 (0x80C801D8)	Endpoint removido mas sync continua	Cleanup incompleto da base de dados do agente	Executar Reset-AzStorageSyncServer com cuidado

Para a lista completa de erros e códigos, consulte learn.microsoft.com — Troubleshoot sync errors e learn.microsoft.com — File Sync troubleshooting.

14. Checklist de Implementação

Use a seguinte checklist como guia de implementação e validação. Cada item deve ser confirmado antes de avançar para produção.

• Subscrição Azure ativa com permissões adequadas (Contributor no Resource Group).
• Região Azure seleccionada (preferencialmente West Europe para Portugal, por latência).
• Storage Account General Purpose v2 criado na mesma região do Storage Sync Service.
• Azure File Share criado com quota adequada ao volume previsto + margem de 20%.
• Storage Sync Service criado e configurado (IncomingTrafficPolicy conforme política de segurança).
• Windows Server com versão suportada (2016, 2019, 2022 ou 2025) e atualizações em dia.
• Volume do Server Endpoint formatado em NTFS (verificado com Get-Volume).
• Espaço mínimo de 5-10 GB livres no volume para base de dados do agente.
• Conectividade de saída validada: portas 443 para *.afs.azure.net, *.files.windows.net, *.blob.core.windows.net.
• Agente do Azure File Sync instalado na versão mais recente (verificar com Get-ItemProperty registry).
• Servidor reiniciado após instalação do agente.
• Servidor registado no Storage Sync Service (Get-AzStorageSyncServer confirma).
• Sync Group criado (Get-AzStorageSyncGroup confirma).
• Cloud Endpoint criado e associado ao File Share correcto.
• Server Endpoint criado no caminho local pretendido.
• Sincronização inicial completada sem erros (verificar Event Logs).
• Cloud Tiering configurado com política de volume e/ou data conforme requisitos.
• Limites de largura de banda configurados conforme horário de trabalho.
• Antivírus configurado com exclusões para pasta do agente e Server Endpoint.
• Azure Backup activado para o File Share com política de retenção definida.
• VSS ativo no volume local para snapshots point-in-time.
• Servidor de failover registado e sincronizado (se cenário DR aplicável).
• Procedimento de failover documentado e testado pelo menos uma vez.
• Alertas Azure Monitor configurados para falhas de sincronização.
• Documentação interna actualizada com caminhos, nomes de recursos e procedimentos.
• Treinamento dos administradores em diagnóstico via Event Logs e PowerShell.
• Revisão agendada trimestral para validar versão do agente e políticas de tiering.

Conclusão

O Azure File Sync é uma solução madura e robusta para gestão de ficheiros híbridos em ambientes Windows. Para PMEs portuguesas, oferece um equilíbrio excelente entre custo, desempenho local e resiliência na cloud. A combinação de Cloud Tiering, Azure Backup e um servidor de failover proporciona uma solução de disaster recovery que custa uma fracção de uma solução tradicional com hardware duplicado.

A implementação exige atenção aos detalhes — desde a configuração do antivírus até à escolha das políticas de tiering — mas o esforço inicial compensa em estabilidade e redução de risco. Use a checklist acima como guia e não hesite em recorrer aos Event Logs e cmdlets Az.StorageSync para diagnóstico proactivo.

Artigos relacionados no kbase.pt:

• Ransomware 2026 — Backup Imutável
• Hyper-V e Windows Server — Virtualização com PowerShell
• Windows Server 2025 — Novidades e Migração
• Diagnóstico de Conectividade no Windows Server
• DFS Namespaces e Replication no Windows Server