Risolvere gli errori e l'integrità della sincronizzazione file di Azure

Questo articolo è progettato per semplificare la risoluzione dei problemi di sincronizzazione comuni che potrebbero verificarsi con la distribuzione di Sincronizzazione file di Azure.

Integrità della sincronizzazione

Se è stato creato un file direttamente nella condivisione file di Azure tramite SMB o tramite il portale, quanto tempo è necessario per la sincronizzazione del file con i server nel gruppo di sincronizzazione?

Le modifiche apportate alla condivisione file di Azure tramite il portale di Azure o SMB non vengono rilevate immediatamente e replicate come modifiche all'endpoint server. File di Azure non ha ancora notifiche di modifica o inserimento nel journal, quindi non è possibile avviare automaticamente una sessione di sincronizzazione quando i file vengono modificati. In Windows Server Sincronizzazione file di Azure usa l'inserimento nel journal USN di Windows per avviare automaticamente una sessione di sincronizzazione quando i file cambiano.

Per rilevare le modifiche alla condivisione file di Azure, Sincronizzazione file di Azure ha un processo pianificato denominato processo di rilevamento delle modifiche. Un processo di rilevamento delle modifiche enumera ogni file nella condivisione file e quindi lo confronta con la versione di sincronizzazione per tale file. Quando il processo di rilevamento delle modifiche determina che i file sono stati modificati, Sincronizzazione file di Azure avvia una sessione di sincronizzazione. Il processo di rilevamento delle modifiche viene avviato ogni 24 ore. Poiché il processo di rilevamento delle modifiche funziona enumerando ogni file nella condivisione file di Azure, il rilevamento delle modifiche richiede più tempo negli spazi dei nomi più grandi che negli spazi dei nomi più piccoli. Per gli spazi dei nomi di grandi dimensioni, potrebbe essere necessario più di una volta ogni 24 ore per determinare quali file sono stati modificati.

Per sincronizzare immediatamente i file modificati nella condivisione file di Azure, è possibile usare il Invoke-AzStorageSyncChangeDetection cmdlet di PowerShell per avviare manualmente il rilevamento delle modifiche nella condivisione file di Azure. Questo cmdlet è destinato agli scenari in cui un tipo di processo automatizzato apporta modifiche nella condivisione file di Azure o le modifiche vengono eseguite da un amministratore , ad esempio lo spostamento di file e directory nella condivisione. Per le modifiche dell'utente finale, è consigliabile installare l'agente di Sincronizzazione file di Azure in una macchina virtuale IaaS e chiedere agli utenti finali di accedere alla condivisione file tramite la macchina virtuale IaaS. In questo modo tutte le modifiche verranno sincronizzate rapidamente con altri agenti senza la necessità di usare il Invoke-AzStorageSyncChangeDetection cmdlet . Per altre informazioni, vedere la documentazione Invoke-AzStorageSyncChangeDetection .

Si sta esplorando l'aggiunta del rilevamento delle modifiche per una condivisione file di Azure simile a USN per i volumi in Windows Server. È possibile assegnare priorità a questa funzionalità per lo sviluppo futuro votandola in Feedback della community di Azure.

L'integrità dell'endpoint server è in sospeso per diverse ore

Questo problema è previsto se si crea un endpoint cloud e si usa una condivisione file di Azure che contiene dati. Il processo di enumerazione delle modifiche cloud che analizza le modifiche nella condivisione file di Azure deve essere completato prima che i file possano essere sincronizzati tra gli endpoint cloud e server. Il tempo necessario per completare il processo dipende dalle dimensioni dello spazio dei nomi nella condivisione file di Azure. L'integrità dell'endpoint server deve essere aggiornata al termine del processo di enumerazione delle modifiche.

Per controllare lo stato del processo di enumerazione delle modifiche cloud, passare alle proprietà dell'endpoint cloud nel portale e lo stato viene fornito nella sezione Modifica enumerazione .

Come si monitora l'integrità della sincronizzazione?

Replica Sync session completed.
SyncDirection: Upload,
HResult: 0, 
SyncFileCount: 2, SyncDirectoryCount: 0,
AppliedFileCount: 2, AppliedDirCount: 0, AppliedTombstoneCount 0, AppliedSizeBytes: 0.
PerItemErrorCount: 0,
TransferredFiles: 2, TransferredBytes: 0, FailedToTransferFiles: 0, FailedToTransferBytes: 0.

Replica Sync session completed.
SyncDirection: Upload,
HResult: -2134364065,
SyncFileCount: 0, SyncDirectoryCount: 0, 
AppliedFileCount: 0, AppliedDirCount: 0, AppliedTombstoneCount 0, AppliedSizeBytes: 0.
PerItemErrorCount: 0, 
TransferredFiles: 0, TransferredBytes: 0, FailedToTransferFiles: 0, FailedToTransferBytes: 0.

Come si monitora lo stato di avanzamento di una sessione di sincronizzazione corrente?

Replica Sync Progress. 
ServerEndpointName: <CI>sename</CI>, SyncGroupName: <CI>sgname</CI>, ReplicaName: <CI>rname</CI>, 
SyncDirection: Upload, CorrelationId: {AB4BA07D-5B5C-461D-AAE6-4ED724762B65}. 
AppliedItemCount: 172473, TotalItemCount: 624196. AppliedBytes: 51473711577, 
TotalBytes: 293363829906. 
AreTotalCountsFinal: true. 
PerItemErrorCount: 1006.

Come faccio a sapere se i server sono sincronizzati tra loro?

Come si verifica se sono presenti file o cartelle specifici che non vengono sincronizzati?

Se gli errori di sincronizzazione persistente e gli errori di sincronizzazione temporanei vengono conteggiati nel portale o PerItemErrorCount nel server è maggiore di 0 per una determinata sessione di sincronizzazione, ciò significa che alcuni elementi non vengono sincronizzati. I file e le cartelle possono avere caratteristiche che impediscono la sincronizzazione. Queste caratteristiche possono essere persistenti e richiedono un'azione esplicita per riprendere la sincronizzazione, ad esempio la rimozione di caratteri non supportati dal nome del file o della cartella. Possono anche essere temporanei, ovvero il file o la cartella riprenderà automaticamente la sincronizzazione; Ad esempio, i file con handle aperti riprenderanno automaticamente la sincronizzazione quando il file viene chiuso. Quando il motore di Sincronizzazione file di Azure rileva un problema di questo tipo, viene generato un log degli errori che può essere analizzato per elencare gli elementi attualmente non sincronizzati correttamente.

Per visualizzare i nomi dei file e delle directory che non riescono a eseguire la sincronizzazione, eseguire lo script di PowerShell FileSyncErrorsReport.ps1 (disponibile nella directory di installazione dell'agente di Sincronizzazione file di Azure) o usare il Debug-StorageSyncServer cmdlet . Il ItemPath campo indica il percorso del file in relazione alla directory di sincronizzazione radice. Vedere l'elenco degli errori comuni per elemento per i passaggi di correzione.

Per identificare i file che non riescono a eseguire la sincronizzazione nel server usando il Debug-StorageSyncServer cmdlet , eseguire i comandi di PowerShell seguenti:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -FileSyncErrorsReport

Errori di sincronizzazione

Risoluzione degli errori di sincronizzazione per file/directory

Se la sincronizzazione di un file o di una directory non riesce a causa di un errore, viene registrato un evento nel registro eventi Microsoft-FileSync-Agent/ItemResults . Questa sezione illustra i codici di errore comuni e i passaggi di correzione per gli errori per elemento.

Errori comuni di sincronizzazione per elemento registrati nel registro eventi ItemResults

Gestione di caratteri non supportati

L'agente di Sincronizzazione file di Azure v17 supporta tutti i caratteri supportati dal file system NTFS , ad eccezione delle coppie di surrogati non valide.

Se lo script di PowerShell del portale o FileSyncErrorsReport.ps1 mostra errori di sincronizzazione per elemento (codice di errore 0x8007007b, 0x80c80255 o 0x80070459) a causa di caratteri non supportati, controllare se l'agente di Sincronizzazione file di Azure v17 è installato nel server. Se l'agente v17 è installato e la sincronizzazione dei file non riesce a causa di caratteri non validi, usare lo script ScanUnsupportedChars per rinominare i file che contengono caratteri non supportati.

Errori di sincronizzazione comuni

Questa sezione illustra i codici di errore comuni e i passaggi di correzione quando una sessione di sincronizzazione ha esito negativo con un errore.

La sessione di sincronizzazione è stata annullata.

Le sessioni di sincronizzazione potrebbero non riuscire per vari motivi, tra cui il riavvio o l'aggiornamento del server, gli snapshot vss e così via. Anche se questo errore sembra richiedere un follow-up, è sicuro ignorare questo errore a meno che non persista per un periodo di diverse ore.

La sessione di sincronizzazione file è stata annullata dalla sessione di sincronizzazione dello snapshot del volume che viene eseguita una volta al giorno per sincronizzare i file con handle aperti.

Non è necessaria alcuna azione. Sincronizzazione file di Azure ha un'attività pianificata (VssSyncScheduledTask) che viene eseguita una volta al giorno nel server per sincronizzare i file in uso. All'avvio di questa attività pianificata, annulla la sessione di sincronizzazione del caricamento corrente ,generando il codice di errore 0x80c8029c, crea uno snapshot vss e avvia una nuova sessione di sincronizzazione del caricamento usando lo snapshot vss.

Non è stato possibile stabilire una connessione con il servizio.

Questo errore può verificarsi ogni volta che il servizio Sincronizzazione file di Azure non è accessibile dal server. È possibile risolvere questo errore seguendo questa procedura:

1. Verificare che il servizio Windows FileSyncSvc.exe non sia bloccato dal firewall.

2. Verificare che la porta 443 sia aperta alle connessioni in uscita al servizio Sincronizzazione file di Azure. A tale scopo, è possibile usare il Test-NetConnection cmdlet . L'URL per il <azure-file-sync-endpoint> segnaposto seguente è disponibile nel documento relativo alle impostazioni del firewall e del proxy di Sincronizzazione file di Azure .

   Test-NetConnection -ComputerName <azure-file-sync-endpoint> -Port 443
   

3. Assicurarsi che la configurazione del proxy sia impostata come previsto. Questa operazione può essere eseguita con il Get-StorageSyncProxyConfiguration cmdlet . Altre informazioni sulla configurazione del proxy per Sincronizzazione file di Azure sono disponibili nelle impostazioni del proxy e del firewall di Sincronizzazione file di Azure.

   $agentPath = "C:\Program Files\Azure\StorageSyncAgent"
   Import-Module "$agentPath\StorageSync.Management.ServerCmdlets.dll"
   Get-StorageSyncProxyConfiguration
   

4. Usare il cmdlet per controllare la Test-StorageSyncNetworkConnectivity connettività di rete agli endpoint del servizio. Per altre informazioni, vedere Testare la connettività di rete agli endpoint di servizio.

5. Contattare l'amministratore di rete per assistenza aggiuntiva per la risoluzione dei problemi di connettività di rete.

La richiesta utente è stata limitata dal servizio.

Non è necessaria alcuna azione; il server proverà di nuovo. Se questo errore persiste per diverse ore, creare una richiesta di supporto.

Sincronizzazione non riuscita perché l'operazione è stata interrotta

Non è richiesta alcuna azione. Se questo errore persiste per diverse ore, creare una richiesta di supporto.

L'operazione è stata annullata.

Non è necessaria alcuna azione. Questo errore deve essere risolto automaticamente. Se l'errore persiste per diversi giorni, creare una richiesta di supporto.

La sincronizzazione viene bloccata fino al completamento del rilevamento delle modifiche dopo il ripristino

Non è richiesta alcuna azione. Quando viene ripristinata una condivisione file o file (endpoint cloud) con Backup di Azure, la sincronizzazione viene bloccata fino al completamento del rilevamento delle modifiche nella condivisione file di Azure. Il rilevamento delle modifiche viene eseguito immediatamente al termine del ripristino e la durata è basata sul numero di file nella condivisione file.

La sincronizzazione è bloccata nella cartella a causa di una sospensione avviata come parte del ripristino nella cartella di sincronizzazione.

Non è necessaria alcuna azione. Questo errore deve essere risolto automaticamente. Se l'errore persiste per diversi giorni, creare una richiesta di supporto.

La sincronizzazione non è riuscita perché il database di sincronizzazione è stato scaricato.

Questo errore si verifica in genere quando un'applicazione di backup crea uno snapshot vss e il database di sincronizzazione viene scaricato. Se questo errore persiste per diverse ore, creare una richiesta di supporto.

La sincronizzazione non può accedere alla condivisione file di Azure specificata nell'endpoint cloud.

Questo errore si verifica perché l'agente di Sincronizzazione file di Azure non può accedere alla condivisione file di Azure, il che potrebbe essere dovuto al fatto che la condivisione file di Azure o l'account di archiviazione che lo ospita non esiste più. È possibile risolvere questo errore seguendo questa procedura:

1. Verificare che l'account di archiviazione esista.
2. Verificare che la condivisione file di Azure esista.
3. Verificare che Sincronizzazione file di Azure abbia accesso all'account di archiviazione.
4. Verificare che le impostazioni di sicurezza SMB nell'account di archiviazione consentano la versione del protocollo SMB 3.1.1 , l'autenticazione NTLM v2 e la crittografia AES-128-GCM . Per controllare le impostazioni di sicurezza SMB nell'account di archiviazione, vedere Impostazioni di sicurezza SMB.
5. Verificare che le impostazioni del firewall e della rete virtuale nell'account di archiviazione siano configurate correttamente (se abilitate)

La sincronizzazione non è riuscita perché la richiesta non è autorizzata a eseguire questa operazione.

Questo errore si verifica perché l'agente di Sincronizzazione file di Azure non è autorizzato ad accedere alla condivisione file di Azure. È possibile risolvere questo errore seguendo questa procedura:

1. Verificare che l'account di archiviazione esista.
2. Verificare che la condivisione file di Azure esista.
3. Verificare che le impostazioni del firewall e della rete virtuale nell'account di archiviazione siano configurate correttamente (se abilitate)
4. Verificare che Sincronizzazione file di Azure abbia accesso all'account di archiviazione.

Impossibile risolvere il nome dell'account di archiviazione usato.

1. Verificare che sia possibile risolvere il nome DNS di archiviazione dal server.

   Test-NetConnection -ComputerName <storage-account-name>.file.core.windows.net -Port 443
   

2. Verificare che l'account di archiviazione esista.

3. Verificare che le impostazioni del firewall e della rete virtuale nell'account di archiviazione siano configurate correttamente (se abilitate)

Errore sconosciuto durante l'accesso all'account di archiviazione.

1. Verificare che l'account di archiviazione esista.
2. Verificare che le impostazioni del firewall e della rete virtuale nell'account di archiviazione siano configurate correttamente (se abilitate)

La sincronizzazione non è riuscita a causa del blocco dell'account di archiviazione.

Questo errore si verifica perché l'account di archiviazione ha un blocco di risorse di sola lettura. Per risolvere questo problema, rimuovere il blocco delle risorse di sola lettura nell'account di archiviazione.

Sincronizzazione non riuscita a causa di un problema con il database di sincronizzazione.

Questo errore si verifica quando si verifica un problema con il database interno usato da Sincronizzazione file di Azure. Quando si verifica questo problema, creare una richiesta di supporto e l'utente verrà contattato per risolvere il problema.

La versione dell'agente di Sincronizzazione file di Azure installata nel server non è supportata.

Questo errore si verifica se la versione dell'agente di Sincronizzazione file di Azure installata nel server non è supportata. Per risolvere questo problema, eseguire l'aggiornamento a una versione dell'agente supportata.

È stato raggiunto il limite di archiviazione della condivisione file di Azure.

Le sessioni di sincronizzazione hanno esito negativo con uno di questi errori quando è stato raggiunto il limite di archiviazione della condivisione file di Azure, che può verificarsi se viene applicata una quota per una condivisione file di Azure o se l'utilizzo supera i limiti per una condivisione file di Azure. Per altre informazioni, vedere i limiti correnti per una condivisione file di Azure.

1. Passare al gruppo di sincronizzazione all'interno del servizio di sincronizzazione archiviazione.

2. Selezionare l'endpoint cloud all'interno del gruppo di sincronizzazione.

3. Si noti il nome della condivisione file di Azure nel riquadro aperto. Selezionare il nome della condivisione file per aprire la pagina delle impostazioni della condivisione file nell'account di archiviazione.

   

4. Selezionare la condivisione file per ottenere i dettagli nella pagina Panoramica .

5. Selezionare Modifica quota per verificare la quota di condivisione file. A meno che non sia stata specificata una quota alternativa, la quota corrisponderà alle dimensioni massime della condivisione file di Azure.

   

Se la condivisione file è completa (la capacità usata è uguale alla quota), liberare spazio nella condivisione file. Un possibile modo per risolvere questo problema consiste nel trasformare ogni sottocartella dell'endpoint server corrente nel proprio endpoint server nei propri gruppi di sincronizzazione separati. In questo modo ogni sottocartella verrà sincronizzata con singole condivisioni file di Azure.

Impossibile trovare la condivisione file di Azure.

Questo errore si verifica quando la condivisione file di Azure non è accessibile. Per risolvere i problemi:

1. Verificare che l'account di archiviazione esista.
2. Verificare che la condivisione file di Azure esista.
3. Verificare che le impostazioni di sicurezza SMB nell'account di archiviazione consentano la versione del protocollo SMB 3.1.1 , l'autenticazione NTLM v2 e la crittografia AES-128-GCM . Per controllare le impostazioni di sicurezza SMB nell'account di archiviazione, vedere Impostazioni di sicurezza SMB.

Se la condivisione file di Azure è stata eliminata, è necessario creare una nuova condivisione file e quindi ricreare il gruppo di sincronizzazione.

La sincronizzazione viene sospesa durante la sospensione della sottoscrizione di Azure.

Questo errore si verifica quando la sottoscrizione di Azure viene sospesa. La sincronizzazione verrà riabilitata quando viene ripristinata la sottoscrizione di Azure. Per altre informazioni, vedere Perché la sottoscrizione di Azure è disabilitata e come riattivarla .

L'account di archiviazione ha un firewall o reti virtuali configurate.

Questo errore si verifica quando la condivisione file di Azure non è accessibile a causa di un firewall dell'account di archiviazione o perché l'account di archiviazione appartiene a una rete virtuale. Verificare che le impostazioni del firewall e della rete virtuale nell'account di archiviazione siano configurate correttamente. Per altre informazioni, vedere Configurare le impostazioni del firewall e della rete virtuale.

Sincronizzazione non riuscita a causa di un problema con il database di sincronizzazione.

Questi errori in genere si risolveranno autonomamente e possono verificarsi se sono presenti:

• Un numero elevato di modifiche ai file nei server nel gruppo di sincronizzazione.
• Un numero elevato di errori in singoli file e directory.

Se questo errore persiste per più di alcune ore, creare una richiesta di supporto e l'utente verrà contattato per risolvere il problema.

Il database di sincronizzazione ha rilevato un errore di I/O occupato nell'archiviazione.

Non è necessaria alcuna azione. Questo errore deve essere risolto automaticamente. Se l'errore persiste per diversi giorni, creare una richiesta di supporto.

Il database di sincronizzazione ha rilevato un timeout di I/O.

Non è necessaria alcuna azione. Questo errore deve essere risolto automaticamente. Se l'errore persiste per diversi giorni, creare una richiesta di supporto.

Si è verificato un errore di I/O nel database di sincronizzazione.

Non è necessaria alcuna azione. Questo errore deve essere risolto automaticamente. Se l'errore persiste per diversi giorni, creare una richiesta di supporto.

La sincronizzazione non è riuscita perché i dati sono danneggiati e illeggibili.

Questo errore può verificarsi se si verifica un danneggiamento del file system nel volume NTFS in cui si trova l'endpoint server. Per risolvere questo errore, eseguire chkdsk nel volume.

Il server non è riuscito a stabilire una connessione sicura. Il servizio cloud ha ricevuto un certificato imprevisto.

Questo errore può verificarsi se l'organizzazione usa un proxy di terminazione TLS o se un'entità dannosa intercetta il traffico tra il server e il servizio Sincronizzazione file di Azure. Se si è certi che ciò sia previsto (poiché l'organizzazione usa un proxy di terminazione TLS), ignorare la verifica del certificato con una sostituzione del Registro di sistema.

1. Creare il valore del SkipVerifyingPinnedRootCertificate Registro di sistema.

   New-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Azure\StorageSync -Name SkipVerifyingPinnedRootCertificate -PropertyType DWORD -Value 1
   

2. Riavviare il servizio di sincronizzazione nel server registrato.

   Restart-Service -Name FileSyncSvc -Force
   

Impostando questo valore del Registro di sistema, l'agente di Sincronizzazione file di Azure accetterà qualsiasi certificato TLS/SSL attendibile in locale durante il trasferimento dei dati tra il server e il servizio cloud.

La sincronizzazione non è riuscita perché il server non è riuscito a decodificare la risposta dal servizio Sincronizzazione file di Azure.

Questo errore si verifica in genere se un firewall, un proxy o un gateway blocca l'accesso all'URL PKI o se il server PKI è inattivo.

Per risolvere questo problema, assicurarsi che il server possa accedere agli URL seguenti:

• https://www.microsoft.com/pki/mscorp/cps
• http://crl.microsoft.com/pki/mscorp/crl/
• http://mscrl.microsoft.com/pki/mscorp/crl/
• http://ocsp.msocsp.com
• http://ocsp.digicert.com/
• http://crl3.digicert.com/

Dopo aver installato l'agente di Sincronizzazione file di Azure, viene usato l'URL PKI per scaricare i certificati intermedi necessari per comunicare con il servizio Sincronizzazione file di Azure e la condivisione file di Azure. L'URL OCSP viene usato per controllare lo stato di un certificato. Se l'errore persiste per diversi giorni, creare una richiesta di supporto.

La sincronizzazione non è riuscita a causa di un problema di autenticazione.

Questo errore si verifica in genere perché l'ora del server non è corretta. Se il server è in esecuzione in una macchina virtuale, verificare che l'ora nell'host sia corretta.

Sincronizzazione non riuscita a causa della scadenza del certificato.

Questo errore si verifica perché il certificato usato per l'autenticazione è scaduto.

Per verificare che il certificato sia scaduto, seguire questa procedura:

1. Aprire lo snap-in MMC Certificati, selezionare Account computer e passare a Certificati (computer locale)\Personale\Certificati.
2. Controllare se il certificato di autenticazione client è scaduto.

Se il certificato di autenticazione client è scaduto, eseguire il comando di PowerShell seguente nel server:

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

La sincronizzazione non è riuscita a causa di un certificato di autenticazione non trovato.

Questo errore si verifica perché il certificato usato per l'autenticazione non viene trovato.

Per risolvere questo problema, eseguire il comando di PowerShell seguente nel server:

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

La sincronizzazione non è riuscita a causa dell'identità di autenticazione non trovata.

Questo errore si verifica perché l'eliminazione dell'endpoint server non è riuscita e l'endpoint si trova ora in uno stato parzialmente eliminato. Per risolvere questo problema, riprovare a eliminare l'endpoint server.

Lo spazio su disco del volume in cui si trova l'endpoint server è insufficiente.

Le sessioni di sincronizzazione hanno esito negativo con uno di questi errori perché il volume non ha spazio su disco sufficiente o viene raggiunto il limite di quota su disco. Questo errore si verifica in genere perché i file all'esterno dell'endpoint server usano lo spazio disponibile nel volume. Controllare lo spazio su disco disponibile nel server. È possibile liberare spazio sul volume aggiungendo altri endpoint server, spostando i file in un volume diverso o aumentando le dimensioni del volume in cui si trova l'endpoint server. Se una quota del disco è configurata nel volume usando Gestione risorse file server o la quota NTFS, aumentare il limite di quota.

Se la suddivisione in livelli cloud è abilitata per l'endpoint server, verificare che i file vengano sincronizzati con la condivisione file di Azure per evitare di esaurire lo spazio su disco.

Il servizio non è ancora pronto per la sincronizzazione con questo endpoint server.

Questo errore si verifica perché l'endpoint cloud è stato creato con contenuto già esistente nella condivisione file di Azure. Sincronizzazione file di Azure deve analizzare la condivisione file di Azure per tutto il contenuto prima di consentire all'endpoint server di procedere con la sincronizzazione iniziale. Al termine del rilevamento delle modifiche nella condivisione file di Azure, verrà avviata la sincronizzazione. Il completamento del rilevamento delle modifiche può richiedere più di 24 ore ed è proporzionale al numero di file e directory nella condivisione file di Azure. Se la suddivisione in livelli cloud è configurata, i file verranno a livelli al termine della sincronizzazione.

La sincronizzazione non è riuscita a causa di problemi con molti singoli file.

Le sessioni di sincronizzazione hanno esito negativo con uno di questi errori quando sono presenti molti file che non riescono a eseguire la sincronizzazione con errori per elemento. Eseguire i passaggi descritti nella sezione Come si verifica se sono presenti file o cartelle specifici che non vengono sincronizzati? per risolvere gli errori per elemento. Per ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED di errore di sincronizzazione, aprire un caso di supporto.

La sincronizzazione non è riuscita a causa di un problema con il percorso dell'endpoint server.

Verificare che il percorso esista, si trova in un volume NTFS locale e non sia un punto di analisi o un endpoint server esistente.

Sincronizzazione non riuscita perché la versione del driver di filtro non è compatibile con la versione dell'agente

Questo errore si verifica perché la versione del driver di filtro cloud a livelli (StorageSync.sys) caricata non è compatibile con il servizio Agente di sincronizzazione archiviazione (FileSyncSvc). Se l'agente di Sincronizzazione file di Azure è stato aggiornato, riavviare il server per completare l'installazione. Se l'errore persiste, disinstallare l'agente, riavviare il server e reinstallare l'agente di Sincronizzazione file di Azure.

Il servizio non è attualmente disponibile.

Questo errore si verifica perché il servizio Sincronizzazione file di Azure non è disponibile. Questo errore verrà risolto automaticamente quando il servizio Sincronizzazione file di Azure sarà nuovamente disponibile.

Sincronizzazione non riuscita a causa di un'eccezione.

Questo errore si verifica perché la sincronizzazione non è riuscita a causa di un'eccezione. Se l'errore persiste per diverse ore, creare una richiesta di supporto.

La sincronizzazione non è riuscita perché l'account di archiviazione ha eseguito il failover in un'altra area.

Questo errore si verifica perché l'account di archiviazione ha eseguito il failover in un'altra area. Sincronizzazione file di Azure non supporta la funzionalità di failover dell'account di archiviazione. Gli account di archiviazione contenenti condivisioni file di Azure usati come endpoint cloud in Sincronizzazione file di Azure non devono essere sottoposti a failover. In questo modo la sincronizzazione smetterà di funzionare e potrebbe anche causare una perdita di dati imprevista nel caso di file a livelli nuovi. Per risolvere questo problema, spostare l'account di archiviazione nell'area primaria.

La sincronizzazione non è riuscita a causa di un problema temporaneo con il database di sincronizzazione.

Questo errore si verifica a causa di un problema interno con il database di sincronizzazione. Questo errore verrà risolto automaticamente durante i tentativi di sincronizzazione. Se l'errore persiste per un periodo di tempo prolungato, creare una richiesta di supporto e l'utente verrà contattato per risolvere il problema.

La sincronizzazione non è riuscita a causa della modifica nel tenant di Microsoft Entra

Verificare che sia installata la versione più recente dell'agente di Sincronizzazione file di Azure e concedere all'applicazione Microsoft.StorageSync l'accesso all'account di archiviazione. Vedere Verificare che Sincronizzazione file di Azure abbia accesso all'account di archiviazione.

La sincronizzazione non è riuscita a causa di un'eccezione del firewall e della rete virtuale non configurata

Questo errore si verifica se le impostazioni del firewall e della rete virtuale sono abilitate nell'account di archiviazione e l'eccezione "Consenti ai servizi Microsoft attendibili di accedere a questo account di archiviazione" non è selezionata. Per risolvere questo problema, seguire i passaggi descritti nella sezione Configurare le impostazioni del firewall e della rete virtuale nella guida alla distribuzione.

Sincronizzazione non riuscita con accesso negato a causa delle impostazioni di sicurezza nell'account di archiviazione o delle autorizzazioni NTFS nel server.

Questo errore può verificarsi se Sincronizzazione file di Azure non riesce ad accedere all'account di archiviazione a causa delle impostazioni di sicurezza o se l'account NT AUTHORITY\SYSTEM non dispone delle autorizzazioni per la cartella System Volume Information nel volume in cui si trova l'endpoint server. Se non è possibile eseguire la sincronizzazione dei singoli file con ERROR_ACCESS_DENIED, seguire questa procedura descritta nella sezione Risoluzione degli errori di sincronizzazione per file/directory .

1. Verificare che le impostazioni di sicurezza SMB nell'account di archiviazione consentano la versione del protocollo SMB 3.1.1 , l'autenticazione NTLM v2 e la crittografia AES-128-GCM . Per controllare le impostazioni di sicurezza SMB nell'account di archiviazione, vedere Impostazioni di sicurezza SMB.

2. Verificare che le impostazioni del firewall e della rete virtuale nell'account di archiviazione siano configurate correttamente (se abilitate)

3. Verificare che l'account NT AUTHORITY\SYSTEM disponga delle autorizzazioni per la cartella System Volume Information nel volume in cui si trova l'endpoint server seguendo questa procedura:

   1. Scaricare lo strumento Psexec .

   2. Eseguire il comando seguente da un prompt dei comandi con privilegi elevati per avviare un prompt dei comandi usando l'account di sistema: PsExec.exe -i -s -d cmd.

   3. Dal prompt dei comandi in esecuzione nell'account di sistema eseguire il comando seguente per verificare che l'account NT AUTHORITY\SYSTEM non abbia accesso alla cartella System Volume Information : cacls "drive letter:\system volume information" /T /C.

   4. Se l'account NT AUTHORITY\SYSTEM non ha accesso alla cartella System Volume Information , eseguire il comando seguente: cacls "drive letter:\system volume information" /T /E /G "NT AUTHORITY\SYSTEM:F".

      Se il passaggio d non riesce con accesso negato, eseguire il comando seguente per acquisire la proprietà della cartella System Volume Information e quindi ripetere il passaggio d:

      takeown /A /R /F "drive letter:\System Volume Information"

La sincronizzazione non è riuscita perché la condivisione file di Azure è stata eliminata e ricreata.

Questo errore si verifica perché Sincronizzazione file di Azure non supporta l'eliminazione e la ricreazione di una condivisione file di Azure nello stesso gruppo di sincronizzazione.

Per risolvere questo problema, eliminare e ricreare il gruppo di sincronizzazione seguendo questa procedura:

1. Eliminare tutti gli endpoint server nel gruppo di sincronizzazione.
2. Eliminare l'endpoint cloud.
3. Eliminare il gruppo di sincronizzazione.
4. Se la suddivisione in livelli cloud è stata abilitata in un endpoint server, eliminare i file a livelli orfani nel server eseguendo i passaggi documentati nei file a livelli non sono accessibili nel server dopo l'eliminazione di un endpoint server .
5. Ricreare il gruppo di sincronizzazione.

La sincronizzazione ha rilevato che la replica è stata ripristinata in uno stato precedente

Non è richiesta alcuna azione. Questo errore si verifica perché la sincronizzazione ha rilevato che la replica è stata ripristinata in uno stato precedente. La sincronizzazione entrerà ora in modalità di riconciliazione, in cui ricrea la relazione di sincronizzazione unendo il contenuto della condivisione file di Azure e i dati nell'endpoint server. Quando viene attivata la modalità di riconciliazione, il processo può richiedere molto tempo, a seconda delle dimensioni dello spazio dei nomi. La sincronizzazione regolare non viene eseguita fino al termine della riconciliazione e i file diversi (ora o dimensioni dell'ultima modifica) tra la condivisione file di Azure e l'endpoint server genereranno conflitti di file.

Sincronizzazione non riuscita perché la richiesta HTTP è stata reindirizzata

Questo errore si verifica perché Sincronizzazione file di Azure non supporta il reindirizzamento HTTP (codice di stato 3xx). Per risolvere questo problema, disabilitare il reindirizzamento HTTP nel server proxy o nel dispositivo di rete.

Errore di timeout della sessione di sincronizzazione.

Non è necessaria alcuna azione. Questo errore deve essere risolto automaticamente. Se l'errore persiste per diversi giorni, creare una richiesta di supporto.

Timeout dell'operazione.

Non è necessaria alcuna azione. Questo errore deve essere risolto automaticamente. Se l'errore persiste per diversi giorni, creare una richiesta di supporto.

Errore di timeout.

Non è necessaria alcuna azione. Questo errore deve essere risolto automaticamente. Se l'errore persiste per diversi giorni, creare una richiesta di supporto.

La sincronizzazione non è riuscita perché non è possibile trovare il percorso dell'endpoint server nel server.

Questo errore si verifica se la directory usata come percorso dell'endpoint server è stata rinominata o eliminata. Se la directory è stata rinominata, rinominare nuovamente la directory con il nome originale e riavviare il servizio Agente di sincronizzazione archiviazione (FileSyncSvc).

Se la directory è stata eliminata, seguire questa procedura per rimuovere l'endpoint server esistente e creare un nuovo endpoint server usando un nuovo percorso:

1. Rimuovere l'endpoint server nel gruppo di sincronizzazione seguendo i passaggi descritti in Rimuovere un endpoint server.
2. Creare un nuovo endpoint server nel gruppo di sincronizzazione seguendo i passaggi descritti in Aggiungere un endpoint server.

Provisioning dell'endpoint server non riuscito a causa di un percorso del server vuoto.

Il provisioning degli endpoint server ha esito negativo con questo codice di errore se vengono soddisfatte queste condizioni:

• Questo endpoint server è stato sottoposto a provisioning con la modalità di sincronizzazione iniziale: server autorevole
• Il percorso del server locale è vuoto o non contiene elementi riconosciuti come in grado di eseguire la sincronizzazione.

Questo errore di provisioning consente di evitare l'eliminazione di tutto il contenuto che potrebbe essere disponibile in una condivisione file di Azure. Il caricamento autorevole del server è una modalità speciale per recuperare un percorso cloud già sottoposto a seeding, con gli aggiornamenti dal percorso del server. Esaminare questa guida alla migrazione per comprendere lo scenario per cui è stata compilata questa modalità.

1. Rimuovere l'endpoint server nel gruppo di sincronizzazione seguendo i passaggi descritti in Rimuovere un endpoint server.
2. Creare un nuovo endpoint server nel gruppo di sincronizzazione seguendo i passaggi descritti in Aggiungere un endpoint server.

La sottoscrizione proprietaria dell'account di archiviazione è disabilitata.

Controllare e verificare che la sottoscrizione in cui risiede l'account di archiviazione sia abilitata.

Il nome di rete specificato non è più disponibile.

Usare il cmdlet per controllare la Test-StorageSyncNetworkConnectivity connettività di rete agli endpoint del servizio. Per altre informazioni, vedere Testare la connettività di rete agli endpoint di servizio.

Errore della sessione di sincronizzazione.

Non è necessaria alcuna azione. Questo errore deve essere risolto automaticamente. Se l'errore persiste per diversi giorni, creare una richiesta di supporto.

Errore della sessione di sincronizzazione.

Se l'errore persiste per più di un giorno, creare una richiesta di supporto.

Si è verificato un errore interno.

Non è necessaria alcuna azione. Questo errore deve essere risolto automaticamente. Se l'errore persiste per diversi giorni, creare una richiesta di supporto.

Si è verificato un errore interno.

Se l'errore persiste per più di un giorno, creare una richiesta di supporto.

Si è verificato un errore interno.

Eseguire l'aggiornamento alla versione più recente dell'agente di sincronizzazione file. Se l'errore persiste dopo l'aggiornamento dell'agente, creare una richiesta di supporto.

Operazione non riuscita a causa di un errore di autenticazione.

Se l'errore persiste per più di un giorno, creare una richiesta di supporto.

L'account Azure specificato è disabilitato.

Controllare e verificare che la sottoscrizione in cui risiede l'account di archiviazione sia abilitata.

Autenticazione basata su chiave dell'account di archiviazione bloccata.

Abilitare "Consenti l'accesso alla chiave dell'account di archiviazione" nell'account di archiviazione. Altre informazioni.

La sincronizzazione deve aggiornare il database nel server.

Non è necessaria alcuna azione. Questo errore deve essere risolto automaticamente. Se l'errore persiste per diversi giorni, creare una richiesta di supporto.

Il volume è offline. Viene rimosso, non è pronto o non è connesso.

Verificare che il volume in cui si trova l'endpoint server sia collegato al server.

Accesso alla configurazione dell'endpoint privato bloccato.

Controllare la configurazione dell'endpoint privato e consentire l'accesso al servizio di sincronizzazione file. Altre informazioni.

La sincronizzazione deve riconciliare i dati del server e della condivisione file di Azure prima che i file possano essere caricati.

Non è necessaria alcuna azione. Questo errore deve essere risolto automaticamente. Se l'errore persiste per diversi giorni, creare una richiesta di supporto.

Non sono consentite più connessioni a un server o a una risorsa condivisa dallo stesso utente, usando più di un nome utente.

Disconnettere tutte le connessioni precedenti al server o alla risorsa condivisa e riprovare.

Il certificato SSL del server non è valido o è scaduto.

Eseguire il comando di PowerShell seguente nel server per reimpostare il certificato:

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

Procedura per la risoluzione dei problemi comuni

Verificare che l'account di archiviazione esista.

# Variables for you to populate based on your configuration
$region = "<Az_Region>"
$resourceGroup = "<RG_Name>"
$syncService = "<storage-sync-service>"
$syncGroup = "<sync-group>"

# Log into the Azure account
Connect-AzAccount

# Check to ensure Azure File Sync is available in the selected Azure
# region.
$regions = [System.String[]]@()
Get-AzLocation | ForEach-Object { 
    if ($_.Providers -contains "Microsoft.StorageSync") { 
        $regions += $_.Location 
    } 
}

if ($regions -notcontains $region) {
    throw [System.Exception]::new("Azure File Sync is either not available in the " + `
        " selected Azure Region or the region is mistyped.")
}

# Check to ensure resource group exists
$resourceGroups = [System.String[]]@()
Get-AzResourceGroup | ForEach-Object { 
    $resourceGroups += $_.ResourceGroupName 
}

if ($resourceGroups -notcontains $resourceGroup) {
    throw [System.Exception]::new("The provided resource group $resourceGroup does not exist.")
}

# Check to make sure the provided Storage Sync Service
# exists.
$syncServices = [System.String[]]@()

Get-AzStorageSyncService -ResourceGroupName $resourceGroup | ForEach-Object {
    $syncServices += $_.StorageSyncServiceName
}

if ($syncServices -notcontains $syncService) {
    throw [System.Exception]::new("The provided Storage Sync Service $syncService does not exist.")
}

# Check to make sure the provided Sync Group exists
$syncGroups = [System.String[]]@()

Get-AzStorageSyncGroup -ResourceGroupName $resourceGroup -StorageSyncServiceName $syncService | ForEach-Object {
    $syncGroups += $_.SyncGroupName
}

if ($syncGroups -notcontains $syncGroup) {
    throw [System.Exception]::new("The provided sync group $syncGroup does not exist.")
}

# Get reference to cloud endpoint
$cloudEndpoint = Get-AzStorageSyncCloudEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $syncService `
    -SyncGroupName $syncGroup

# Get reference to storage account
$storageAccount = Get-AzStorageAccount | Where-Object { 
    $_.Id -eq $cloudEndpoint.StorageAccountResourceId
}

if ($storageAccount -eq $null) {
    throw [System.Exception]::new("The storage account referenced in the cloud endpoint does not exist.")
}

Verificare che la condivisione file di Azure esista.

$fileShare = Get-AzStorageShare -Context $storageAccount.Context | Where-Object {
    $_.Name -eq $cloudEndpoint.AzureFileShareName -and
    $_.IsSnapshot -eq $false
}

if ($fileShare -eq $null) {
    throw [System.Exception]::new("The Azure file share referenced by the cloud endpoint does not exist")
}

Verificare che Sincronizzazione file di Azure abbia accesso all'account di archiviazione.

$role = Get-AzRoleAssignment -Scope $storageAccount.Id | Where-Object { $_.DisplayName -eq "Microsoft.StorageSync" }

if ($role -eq $null) {
    throw [System.Exception]::new("The storage account does not have the Azure File Sync " + `
                "service principal authorized to access the data within the " + ` 
                "referenced Azure file share.")
}

Vedere anche

• Risolvere i problemi di gestione dei gruppi di sincronizzazione di Sincronizzazione file di Azure
• Risolvere i problemi relativi all'installazione e alla registrazione del server dell'agente di Sincronizzazione file di Azure
• Risolvere i problemi relativi alla suddivisione in livelli cloud di Sincronizzazione file di Azure
• Monitorare Sincronizzazione file di Azure
• Risolvere i problemi relativi a File di Azure

Contattaci per ricevere assistenza

In caso di domande o bisogno di assistenza, creare una richiesta di supporto tecnico oppure formula una domanda nel Supporto della community di Azure. È possibile anche inviare un feedback sul prodotto al feedback della community di Azure.