Creare un endpoint server Sincronizzazione file di Azure

Un endpoint server rappresenta una posizione specifica in un server registrato, ad esempio una cartella in un volume del server. Un endpoint server deve soddisfare le condizioni seguenti:

Un endpoint server deve essere un percorso in un server registrato (anziché una condivisione montata). L'archiviazione NAS (Network Attached Storage) non è supportata.
Anche se l'endpoint server può trovarsi nel volume di sistema, gli endpoint server nel volume di sistema potrebbero non usare il cloud a livelli.
La modifica del percorso o della lettera di unità dopo aver stabilito un endpoint server in un volume non è supportata. Assicurarsi di usare un percorso appropriato prima di creare l'endpoint server.
Un server registrato può supportare più endpoint server, ma un gruppo di sincronizzazione può avere un solo endpoint server per ogni server registrato in qualsiasi momento. Altri endpoint server all'interno del gruppo di sincronizzazione devono trovarsi in server registrati diversi.
Possono esistere più endpoint server nello stesso volume se i relativi spazi dei nomi non si sovrappongono, ad esempio F:\sync1 e F:\sync2, e ogni endpoint effettua la sincronizzazione a un gruppo specifico.

Questo articolo illustra le opzioni e le decisioni necessarie per creare un nuovo endpoint server e avviare la sincronizzazione. Per il funzionamento, è necessario aver completato pianificazione per la distribuzione Sincronizzazione file di Azure e aver distribuito anche risorse necessarie nei passaggi precedenti per creare un endpoint server.

Prerequisiti

Per creare un endpoint server, è necessario prima verificare che siano soddisfatti i criteri seguenti:

Il server ha installato l'agente Sincronizzazione file di Azure ed è stato registrato. Per informazioni dettagliate sull'installazione dell'agente Sincronizzazione file di Azure, vedere Register/unregister a server con Sincronizzazione file di Azure.
Verificare che sia stato distribuito un servizio di sincronizzazione archiviazione. Vedere Come distribuire Sincronizzazione file di Azure per informazioni dettagliate su come distribuire un servizio di sincronizzazione archiviazione.
Verificare che sia stato distribuito un gruppo di sincronizzazione. Leggere le informazioni su come creare un gruppo di sincronizzazione.
Assicurarsi che il server sia connesso a Internet e che Azure sia accessibile. Sincronizzazione file di Azure usa la porta 443 per tutte le comunicazioni tra il server e il servizio cloud.
Assicurarsi di essere entro i limiti consentiti per la creazione di endpoint. Vedere Sincronizzazione file di Azure Scale Targets per informazioni dettagliate sugli obiettivi di scalabilità e prestazioni.

Creare un endpoint server

Passare al gruppo di sincronizzazione appena creato.
In Endpoint server selezionare +Aggiungi endpoint server.
Nel riquadro Aggiungi endpoint server, immettere le informazioni seguenti:
- Server registrato: selezionare il nome del server o del cluster in cui si vuole creare l'endpoint server.
- Path: immettere il percorso nell'istanza di Windows Server da sincronizzare con la condivisione file Azure. Il percorso può essere una cartella (ad esempio D:\Data), una radice del volume (ad esempio D:\) o un punto di montaggio del volume (ad esempio D:\Mount).
- Cloud Tiering: questa sezione include un'opzione per abilitare o disabilitare la suddivisione in livelli cloud. Con il tiering del cloud, i file usati raramente o a cui si accede meno frequentemente possono essere trasferiti su File di Azure. Quando si abilita il tiering del cloud, sono disponibili due criteri che è possibile impostare per informare Sincronizzazione file di Azure quando eseguire il tiering dei file freddi.
  - Criterio di spazio disponibile nel volume: la quantità di spazio disponibile da riservare nel volume in cui si trova l'endpoint server. Ad esempio, se lo spazio disponibile del volume è impostato su 50% in un volume con un solo endpoint server, circa la metà della quantità di dati viene spostata a livelli su File di Azure. Indipendentemente se il tiering cloud è abilitato, la condivisione di file di Azure ha sempre una copia completa dei dati nel gruppo di sincronizzazione.
  - Criteri data: i file vengono archiviati a livelli nel cloud se l'utente non vi ha eseguito l'accesso (ovvero operazioni di lettura e scrittura) per il numero di giorni specificato. Ad esempio, se si è notato che i file che a cui non è eseguito l'accesso per più di 15 giorni sono in genere file di archiviazione, è consigliabile impostare i criteri data su 15 giorni.
- Sincronizzazione iniziale: questa sezione è disponibile solo per il primo endpoint server in un gruppo di sincronizzazione. (La sezione viene modificata a Download iniziale quando si creano più endpoint server in un gruppo di sincronizzazione.) È possibile selezionare il comportamento seguente:
  - Caricamento iniziale: come il server carica inizialmente i dati nella condivisione file Azure. Sono disponibili due opzioni:
    - Unire il contenuto di questo percorso del server con il contenuto nella condivisione file Azure. I file con lo stesso nome e percorso causeranno conflitti se il contenuto è diverso. Entrambe le versioni di tali file vengono archiviate l'una accanto all'altra. Se il percorso del server o la condivisione file di Azure è vuoto, scegli sempre questa opzione.
    - Sovrascrivere in modo autorevole file e cartelle nella condivisione file Azure con contenuto nel percorso del server. Tale opzione consente di evitare conflitti di file.
  Per altre informazioni, vedere la sezione Sincronizzazione iniziale.
  - Initial Download: come il server scarica inizialmente i dati della condivisione file Azure. Questa impostazione è importante quando il server si connette a una condivisione file Azure che contiene file. Sono disponibili tre opzioni:
    - Scaricare prima lo spazio dei nomi e quindi richiamare il contenuto dei file, in un quantitativo adatto al disco locale. Spazio dei nomi indica la struttura di file e cartelle senza il contenuto del file.
    - Scaricare solo lo spazio dei nomi. Il contenuto del file viene richiamato quando vi si accede.
    - Evitare file a livelli. I file vengono visualizzati nel server solo dopo che è il download è completato. L'accesso o il criterio locale richiamano il contenuto dei file a livelli dal cloud al server.
  Per altre informazioni, vedere la sezione Download iniziale.
Per completare l'aggiunta dell'endpoint server, selezionare Crea. I file vengono ora mantenuti sincronizzati nella condivisione file Azure e nell'istanza di Windows Server.

Note

Sincronizzazione file di Azure crea uno snapshot della condivisione file Azure come backup prima di creare l'endpoint server. È possibile usare questo snapshot per ripristinare la condivisione allo stato precedente alla creazione dell’endpoint server.

Lo snapshot non viene rimosso automaticamente dopo la creazione dell'endpoint server. Se non necessario, è possibile eliminarlo manualmente.

È possibile trovare gli snapshot Sincronizzazione file di Azure creati visualizzando gli snapshot per la condivisione file di Azure e verificando AzureFileSync nella colonna Initiator.

Eseguire i comandi di PowerShell seguenti per creare l'endpoint server. Sostituire <your-server-endpoint-path> e <your-volume-free-space> con i valori desiderati. Controllare le impostazioni per i criteri facoltativi di download iniziale e caricamento iniziale.

$serverEndpointPath = "<your-server-endpoint-path>"
$cloudTieringDesired = $true
$volumeFreeSpacePercentage = <your-volume-free-space>
# Optional property. Choose from: [NamespaceOnly], the default when cloud tiering is enabled. [NamespaceThenModifiedFiles], the default when cloud tiering is disabled. [AvoidTieredFiles], available only when cloud tiering is disabled.
$initialDownloadPolicy = "NamespaceOnly"
$initialUploadPolicy = "Merge"
# Optional property. Choose from: [Merge], the default for all new server endpoints. Content is from the server and the cloud merge. This is the right choice if one location is empty or other server endpoints already exist in the sync group. [ServerAuthoritative], the right choice when you seeded the Azure file share (for example, with Azure Data Box) and you're connecting the server location that you seeded from. It enables you to catch up the Azure file share with the changes that happened on the local server since the seeding.

if ($cloudTieringDesired) {
    # Ensure that the endpoint path is not the system volume
    $directoryRoot = [System.IO.Directory]::GetDirectoryRoot($serverEndpointPath)
    $osVolume = "$($env:SystemDrive)\"
    if ($directoryRoot -eq $osVolume) {
        throw [System.Exception]::new("Cloud tiering cannot be enabled on the system volume")
    }

    # Create the server endpoint
    New-AzStorageSyncServerEndpoint `
        -Name $registeredServer.FriendlyName `
        -SyncGroup $syncGroup `
        -ServerResourceId $registeredServer.ResourceId `
        -ServerLocalPath $serverEndpointPath `
        -CloudTiering `
        -VolumeFreeSpacePercent $volumeFreeSpacePercentage `
        -InitialDownloadPolicy $initialDownloadPolicy `
        -InitialUploadPolicy $initialUploadPolicy
} else {
    # Create the server endpoint
    New-AzStorageSyncServerEndpoint `
        -Name $registeredServer.FriendlyName `
        -SyncGroup $syncGroup `
        -ServerResourceId $registeredServer.ResourceId `
        -ServerLocalPath $serverEndpointPath `
        -InitialDownloadPolicy $initialDownloadPolicy
}

Usare il comando az storagesync sync-group server-endpoint per creare un nuovo endpoint server:

# Create a new sync group server endpoint 
az storagesync sync-group server-endpoint create --resource-group myResourceGroupName \
                                                 --name myNewServerEndpointName
                                                 --registered-server-id 91beed22-7e9e-4bda-9313-fec96c286e0
                                                 --server-local-path d:\myPath
                                                 --storage-sync-service myStorageSyncServiceNAme
                                                 --sync-group-name mySyncGroupName

# Create a new sync group server endpoint with additional optional parameters
az storagesync sync-group server-endpoint create --resource-group myResourceGroupName \
                                                 --storage-sync-service myStorageSyncServiceName \
                                                 --sync-group-name mySyncGroupName \
                                                 --name myNewServerEndpointName \
                                                 --registered-server-id 91beed22-7e9e-4bda-9313-fec96c286e0 \
                                                 --server-local-path d:\myPath \
                                                 --cloud-tiering on \
                                                 --volume-free-space-percent 85 \
                                                 --tier-files-older-than-days 15 \
                                                 --initial-download-policy NamespaceOnly [OR] NamespaceThenModifiedFiles [OR] AvoidTieredFiles
                                                 --initial-upload-policy Merge [OR] ServerAuthoritative

Sezione Cloud a livelli

Quando si crea un nuovo endpoint server, è possibile acconsentire esplicitamente alla funzionalità di suddivisione in livelli cloud di Sincronizzazione file di Azure. Le opzioni nella sezione Cloud a livelli possono essere modificate in un secondo momento. Tuttavia, sono disponibili opzioni diverse nella sezione seguente in base al fatto che il cloud a livelli sia abilitato o meno per il nuovo endpoint server.

Fare riferimento all'articolo sul cloud a livelli che illustra in dettaglio le nozioni di base, i criteri e le procedure consigliate.

Sezione di sincronizzazione iniziale

La sezione Sincronizzazione iniziale è disponibile solo per il primo endpoint server in un gruppo di sincronizzazione. Per qualsiasi endpoint server aggiuntivo, vedere la sezione Download iniziale.

Esistono due comportamenti di sincronizzazione iniziali fondamentalmente diversi:

Merge

Caricamento autorevole

Merge è l'opzione standard e selezionata per impostazione predefinita. È consigliabile lasciare la selezione su merge tranne che per determinati scenari di migrazione.

Quando si aggiunge un percorso del server, nella maggior parte degli scenari la posizione del server o la condivisione cloud è vuota. In questi casi, il Merge è il comportamento corretto e porterà ai risultati previsti.
Quando entrambi i percorsi contengono file e cartelle, gli spazi dei nomi verranno uniti. Se sono presenti file o nomi di cartelle nel server che esistono anche nella condivisione cloud, si verifica un conflitto di sincronizzazione. I conflitti vengono risolti automaticamente.

All'interno dell'opzione Merge, è possibile selezionare la modalità di arrivo iniziale del contenuto dalla condivisione file Azure nel server. Questa selezione non ha alcun impatto se la condivisione file Azure è vuota. Per altri dettagli, vedere la sezione Download iniziale.

Caricamento autorevole è un'opzione di sincronizzazione iniziale riservata per uno scenario di migrazione specifico. Sincronizza lo stesso percorso del server usato anche per eseguire il seeding della condivisione cloud con ad esempio Azure Data Box. In questo caso, il cloud e le posizioni del server hanno principalmente gli stessi dati, ma il server è leggermente più recente. Gli utenti continuavano a apportare modifiche durante lo spostamento di Data Box. Questo scenario di migrazione richiede quindi di aggiornare il cloud senza problemi con le modifiche nel server (più recente) senza generare conflitti. Il server è quindi l'autorità della forma dello spazio dei nomi e Data Box è stato usato per evitare un caricamento iniziale su larga scala dal server. Il caricamento autorevole del server consente un'adozione senza tempi di inattività del cloud, anche quando è stato usato un meccanismo di trasporto dati offline per eseguire il seeding dell'archiviazione cloud.

Un endpoint server può avere esito positivo solo con l'opzione di caricamento autorevole, quando il percorso del server contiene dati. Questo blocco prevede la protezione da errori di configurazione accidentali. Il caricamento autorevole funziona come RoboCopy /MIR. Questa modalità rispecchia l'origine di destinazione. L'origine è il server AFS e la destinazione è la condivisione cloud. Il caricamento autorevole forma la destinazione nell'immagine dell'origine.

I file e le cartelle nuovi o aggiornati verranno caricati dal server.
I file e le cartelle che non esistono più nel server verranno eliminati dalla condivisione cloud.
Le modifiche solo ai file e alle cartelle nel server verranno spostate in modo efficiente nella condivisione cloud come aggiornamenti di soli metadati.
I file e le cartelle potrebbero esistere nel server e nella condivisione cloud. Tuttavia, alcuni file o cartelle potrebbero aver modificato la directory principale sul server dopo il seeding sulla condivisione file di Azure. Questi file e cartelle verranno eliminati dalla condivisione cloud e caricati di nuovo. Per questo motivo, è consigliabile evitare di ristrutturare lo spazio dei nomi su larga scala durante una migrazione.

Sezione di download iniziale

La sezione Download iniziale è disponibile per il secondo e per altri endpoint server in un gruppo di sincronizzazione. L'endpoint server first in un gruppo di sincronizzazione include opzioni aggiuntive correlate alla migrazione con Azure Data Box. Queste opzioni non si applicano se questo endpoint server non è il primo nel gruppo di sincronizzazione.

Note

Se la Azure condivisione file è vuota, la selezione di un'opzione di download iniziale non ha alcun impatto.

Nell'ambito di questa sezione, si sceglie il modo in cui il contenuto della condivisione file Azure arriverà inizialmente sul server.

	Scaricare prima il namespace	Scaricare solo il namespace	Evitare file a livelli
Descrizione	Scarica prima l'intero spazio dei nomi. Il contenuto dei file viene richiamato dal cloud come attività in background al server in base alla mappa termica, che richiama prima i dati a cui si accede di recente. Se lo spazio disponibile nel volume del server è inferiore al 10%, i file rimanenti rimarranno a livelli.	Viene scaricato solo lo spazio dei nomi (file e struttura di cartelle). Nessun contenuto del file viene portato nel server.	Scarica ogni file nella sua interezza prima che il file venga visualizzato nella cartella nel server. Questa opzione consente di evitare l'esistenza di un file a livelli nel server. Un elemento dello spazio dei nomi e il contenuto del file sono sempre presenti contemporaneamente.
Impostazioni predefinite	Impostazione predefinita se la suddivisione in livelli cloud non è abilitata per questo endpoint server.	Impostazione predefinita se la suddivisione in livelli cloud è abilitata per questo endpoint server.	Non selezionato come opzione predefinita. Questa opzione è disponibile solo quando il tiering del cloud non è abilitato.
Comportamento quando è abilitata la suddivisione in livelli	Quando il tiering nel cloud è abilitato, il processo in background di richiamo dei file suddivisi in livelli verrà arrestato non appena soddisfa i criteri specificati per la politica di tiering nel cloud (rispetta anche i criteri di spazio libero del volume e i criteri di data, se presenti).	Viene scaricato solo lo spazio dei nomi (file e struttura di cartelle). Nessun contenuto del file viene portato nel server.	Opzione non disponibile.
Comportamento quando la suddivisione in livelli non è abilitata	Quando la tierizzazione del cloud non è abilitata, l'intento è di richiamare tutti i dati all'endpoint del server tramite richiamo in background. È necessario effettuare il provisioning di un volume sufficientemente grande per contenere tutti i dati. Se il volume non ha spazio libero sufficiente, alcuni file verranno lasciati a livelli anche quando il cloud a livelli è disabilitato.	Viene scaricato solo lo spazio dei nomi (file e struttura di cartelle). Nessun contenuto del file viene portato nel server.	Scarica ogni file nella sua interezza prima che il file venga visualizzato nella cartella nel server.
Quando utilizzare	Quando gli utenti devono accedere rapidamente ai file recenti subito dopo il download del namespace e la maggior parte dei dati è presente nella condivisione file Azure al momento del provisioning. I clienti con larghezza di banda ridotta possono anche trarre vantaggio dal richiamo in background dopo il provisioning iniziale. Per altre informazioni sul richiamo di file a livelli, vedere Come gestire Sincronizzazione file di Azure file a livelli. Ideale per Sincronizzazione file di Azure scenari di ripristino di emergenza lato server in cui il percorso del server inizia come cartella vuota, ad esempio un nuovo endpoint server nella succursale.	Ideale per le applicazioni che devono richiamare i dati meno spesso o solo una piccola quantità di dati su richiesta.	Quando tutti i dati devono essere sempre disponibili in locale senza basarsi sulla suddivisione in livelli. Ideale per le applicazioni che richiedono l'accesso a tutti i file in qualsiasi momento. Utile nei server a larghezza di banda ridotta in cui non si vogliono file a livelli per i problemi di prestazioni di accesso ai dati.
Implicazioni	La CPU/memoria deve essere ridimensionata in base alla scalabilità dello spazio dei nomi e alle risorse necessarie per evitare problemi di prestazioni di I/O. Per informazioni dettagliate, vedere Risorse di sistema consigliate per Sincronizzazione file di Azure	-	Il volume deve avere spazio sufficiente per archiviare tutti i dati. Il download iniziale richiederà probabilmente molto più tempo a causa della necessità di scaricare tutto il contenuto del file. Non adatto per il ripristino di emergenza rapido perché questo è più lento rispetto alle prime due opzioni.

Dopo aver selezionato un'opzione di download iniziale, non è possibile modificarla dopo aver confermato di creare l'endpoint server.

Note

Quando si aggiunge un endpoint server e i file sono presenti nella condivisione file Azure, se si sceglie di scaricare prima lo spazio dei nomi, i file verranno visualizzati come a livelli finché non vengono scaricati localmente. I file vengono scaricati usando un singolo thread per impostazione predefinita per limitare l'utilizzo della larghezza di banda di rete. Per migliorare le prestazioni di download dei file, usare il cmdlet Invoke-StorageSyncFileRecall con un numero di thread maggiore di 1.

Comportamento di download dei file al termine del download iniziale

La modalità di visualizzazione dei file nel server al termine del download iniziale dipende dall'uso della funzionalità di suddivisione in livelli nel cloud e dal fatto che sia stato scelto di richiamare in modo proattivo le modifiche nel cloud. Quest'ultima è una funzionalità utile per i gruppi di sincronizzazione con più endpoint server in posizioni geografiche diverse.

La suddivisione cloud a livelli è abilitata
File nuovi e modificati da altri endpoint server verranno visualizzati come file a livelli in questo endpoint server. Queste modifiche verranno scaricate come file completi solo se si è scelto il richiamo proattivo delle modifiche nella condivisione file Azure da altri endpoint del server.
La suddivisione cloud a livelli è disabilitata
File nuovi e modificati da altri endpoint server verranno visualizzati come file completi in questo endpoint server. Non verranno prima visualizzati come file a livelli e quindi richiamati. I file a livelli con suddivisione cloud a livelli sono una funzionalità di ripristino di emergenza veloce e vengono visualizzati solo durante il provisioning iniziale.

Passaggi di provisioning

Quando viene creato un nuovo endpoint server usando il portale o PowerShell, l'endpoint non è pronto per essere usato immediatamente. A seconda della quantità di dati presenti nella condivisione file corrispondente nel cloud, potrebbero essere necessari alcuni minuti prima che l'endpoint server sia funzionale e pronto per l'uso.

In passato, se si voleva controllare lo stato del provisioning dell'endpoint server e se il server fosse pronto per consentire agli utenti di accedere ai dati, era necessario accedere all'endpoint server e verificare se tutti i dati fossero stati scaricati. Con la procedura di provisioning, è possibile capire se un endpoint server è pronto per l'uso o meno e se la sincronizzazione è completamente funzionante direttamente dal portale di Azure, nel pannello panoramica dell'endpoint server.

Per gli scenari supportati, la scheda Passaggi di provisioning fornisce informazioni su cosa accade nell'endpoint server, incluso quando l'endpoint server è pronto per l'accesso degli utenti.

Scenari supportati

Attualmente, i passaggi di provisioning vengono visualizzati solo quando il nuovo endpoint server aggiunto non contiene dati nel percorso del server selezionato per l'endpoint server. In altri scenari la scheda Passaggi di provisioning non è disponibile.

Stato del provisioning

Ecco i diversi stati visualizzati quando il provisioning degli endpoint server è in corso e il loro significato:

In corso: l'endpoint server non è pronto per l'accesso degli utenti.
Pronto (sincronizzazione non funzionale): gli utenti possono accedere ai dati, ma le modifiche non verranno sincronizzate con la condivisione file cloud.
Pronto (funzionalità di sincronizzazione): gli utenti possono accedere ai dati e alle modifiche verranno sincronizzati con la condivisione cloud, rendendo l'endpoint completamente funzionante.
Operazione non riuscita: il provisioning non è riuscito a causa di un errore.

La scheda dei passaggi di provisioning è visibile nel portale di Azure solo per gli scenari supportati. Non sarà disponibile o visibile per gli scenari non supportati.

Passaggi successivi

Sono disponibili altre informazioni su Azure condivisioni file e Sincronizzazione file di Azure. Gli articoli seguenti consentono di comprendere opzioni avanzate, procedure consigliate e risoluzione dei problemi.

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-04-09

Condividi tramite

Creare un endpoint server Sincronizzazione file di Azure

Prerequisiti

Creare un endpoint server

Sezione Cloud a livelli

Sezione di sincronizzazione iniziale

Sezione di download iniziale

Comportamento di download dei file al termine del download iniziale

Passaggi di provisioning

Scenari supportati

Stato del provisioning

Passaggi successivi

Commenti e suggerimenti

Risorse aggiuntive