Questo articolo descrive i miglioramenti e i problemi risolti nella versione Sincronizzazione file di Azure Agent v21.2 datata luglio 2025. Inoltre, questo articolo contiene le istruzioni di installazione per questa versione.
Miglioramenti e problemi risolti
Sincronizzazione file di Azure agent ora disponibile tramite Arc Extension
I server Windows connessi tramite Azure arc ora possono installare Sincronizzazione file di Azure agente utilizzando una nuova estensione denominata Agente Sincronizzazione file di Azure per Windows. La nuova estensione viene pubblicata da Microsoft e può essere gestita tramite il portale di Azure, PowerShell o azure CLI. Per ulteriori informazioni, vedi la documentazione dell'estensione dell'agente di Sincronizzazione file di Azure.
Disponibilità generale: Sincronizzazione file di Azure in Italia nord
L'espansione in Italia nord avvicina il servizio alle organizzazioni in queste regioni, offrendo una latenza inferiore, migliori prestazioni e supporto per i requisiti di residenza dei dati locali.
Role-Based Controllo di accesso granulare (RBAC) per Sincronizzazione file di Azure
Sincronizzazione file di Azure include ora due ruoli predefiniti del controllo degli accessi in base al ruolo Sincronizzazione file di Azure amministratore e Sincronizzazione file di Azure lettore, progettato per rafforzare la sicurezza e semplificare le operazioni per le organizzazioni che gestiscono la sincronizzazione dei file tra ambienti locali e cloud. Questi ruoli offrono un controllo dell'accesso più granulare rispetto a ruoli più ampi come Proprietario o Collaboratore, consentendo alle organizzazioni di applicare il principio dei privilegi minimi in modo più efficace.
Miglioramenti di affidabilità e telemetria vari per il tiering e la sincronizzazione del cloud
È stato risolto un problema che causava errori di download della sincronizzazione e di tiering nel cloud con codice di errore 0x80c80362 (ECS_E_ITEM_PATH_COMPONENT_HAS_ TRAILING_DOT) quando un percorso di file o cartella includeva un punto finale. In precedenza, gli utenti dovevano rinominare manualmente l'elemento interessato per riprendere la sincronizzazione. Sincronizzazione file di Azure ora gestisce correttamente i componenti del percorso con punti finali, eliminando la necessità di intervento manuale.
Altre informazioni sulla versione Sincronizzazione file di Azure Agent v21.2
-
Questa versione è disponibile per le installazioni di Windows Server 2016, Windows Server 2019, Windows Server 2022 e Windows Server 2025.
-
La versione agente di questa versione è 21.2.0.0.
-
Gli aggiornamenti seguenti devono essere installati nel Windows Server:
-
WS 2016 Microsoft Update Catalog (aggiornamento cumulativo più recente)
-
WS 2019 Microsoft Update Catalog (aggiornamento cumulativo più recente)
-
Gli aggiornamenti cumulativi vengono rilasciati mensilmente. Per distribuire l'ultima versione, gli utenti possono usare Windows Update o scaricarla manualmente da Microsoft Update Catalog. Se si installa manualmente, è consigliabile esaminare l'articolo della Knowledge Base associato per assicurarsi che tutti i prerequisiti siano soddisfatti.
Nota: se il Aggiornamenti di Windows non viene installato prima dell'installazione dell'agente di Sincronizzazione file di Azure, il servizio Agente di sincronizzazione di archiviazione (FileSyncSvc) non verrà avviato. Per altre informazioni, vedi la documentazione per la risoluzione dei problemi di Sincronizzazione file di Azure.
Come ottenere e installare l'agente di Sincronizzazione file di Azure
L'agente Sincronizzazione file di Azure è disponibile da Microsoft Update, Microsoft Update Catalog e Area download Microsoft.
Note
-
Se l'agente Sincronizzazione file di Azure non è attualmente installato in un server, usare il pacchetto di installazione dell'agente nell'Area download Microsoft. Il pacchetto di installazione dell'agente in Microsoft Update e Microsoft Update Catalog è destinato solo agli aggiornamenti dell'agente.
-
Per aggiornare le installazioni di agenti esistenti, eseguire AfsUpdater.exe (disponibile nella directory di installazione dell'agente) o scaricare e installare l'aggiornamento da Microsoft Update o Microsoft Update Catalog.
Microsoft Update
Per ottenere e installare da Microsoft Update, seguire questa procedura in un server in cui è installato Sincronizzazione file di Azure agente:
-
Fare clic sul pulsante Start e quindi su Impostazioni.
-
In Impostazioni fare clic su Aggiorna sicurezza &.
-
Nella finestra Windows Update fare clic su Verifica disponibilità aggiornamenti online da Microsoft Update.
-
Verifica che l'aggiornamento dell'agente Sincronizzazione file di Azure sia elencato e quindi fai clic su Installa ora.
Microsoft Update Catalog
Vai al sito Web seguente per scaricare manualmente questo aggiornamento da Microsoft Update Catalog:
Rilascio agente Sincronizzazione file di Azure v21.2 - luglio 2025 (KB5063825)
Per installare manualmente il pacchetto di aggiornamento, estrarre il file CAB ed eseguire il comando seguente da un prompt dei comandi con privilegi elevati:
msiexec.exe /p packagename.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent,StorageSyncAgentAzureFileSync,StorageSyncAgentGuardFilter,StorageSyncAgentUpdater /qb /l*v KB5063825.log
Ad esempio, per installare l'aggiornamento dell'agente Sincronizzazione file di Azure per Server 2016, eseguire il comando seguente:
msiexec.exe /p StorageSyncAgent_WS2016_KB 5063825.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent,StorageSyncAgentAzureFileSync,StorageSyncAgentGuardFilter,StorageSyncAgentUpdater /qb /l*v KB5063825.log
Area download Microsoft
Vai all'Area download Microsoft per scaricare manualmente il pacchetto di installazione dell'agente per le installazioni di nuovi agenti.
Come eseguire un'installazione invisibile all'utente per un'installazione di un nuovo agente
Per eseguire un'installazione invisibile all'utente per una nuova installazione agente che usa le impostazioni predefinite, eseguire il comando seguente a un prompt dei comandi con privilegi elevati:
msiexec /i packagename.msi /qb /l*v AFSv21.2Installation.log
Ad esempio, per installare l'agente Sincronizzazione file di Azure per Windows Server 2016, eseguire il comando seguente:
msiexec /i StorageSyncAgent_WS2016.msi /qb /l*v AFSv21.2Installation.log
Note
Usa l'opzione /qb per visualizzare le schermate di prompt di riavvio (se necessario), aggiornamento agente e registrazione del server. Per eliminare le schermate e riavviare automaticamente il server (se necessario), usare l'opzione /qn.
Per eseguire un'installazione invisibile all'utente con impostazioni personalizzate, vedere Come installare l'agente di Sincronizzazione file di Azure automaticamente.