Condividi tramite

Installare e gestire l'estensione agente di Sincronizzazione file di Azure nei server Windows abilitati per Azure Arc

Questo articolo descrive come installare, convalidare e disinstallare l'estensione dell'agente sincronizzazione file di Azure nei server Windows abilitati per Azure Arc. L'agente di Sincronizzazione file di Azure per l'estensione Windows distribuisce l'agente di Sincronizzazione file di Azure in un server Windows connesso tramite Azure Arc, consentendo al server di sincronizzare i file con una condivisione file di Azure. L'estensione viene pubblicata da Microsoft e può essere gestita tramite il portale di Azure, Azure PowerShell o l'interfaccia della riga di comando di Azure.

Prerequisiti

  • Server abilitato per Azure Arc (solo Windows): Il computer di destinazione deve essere connesso ad Azure Arc (l'agente azure Connected Machine installato e l'onboarding completato) ed eseguire un sistema operativo Windows Server supportato. Sincronizzazione file di Azure è supportata in Windows Server 2012 R2 o versione successiva.Per informazioni dettagliate sulle versioni supportate, vedere Requisiti del sistema di Sincronizzazione file di Azure e interoperabilità .

    Importante

    L'estensione dell'agente sincronizzazione file di Azure è supportata solo in Windows. I server abilitati per Linux Arc non sono supportati per Sincronizzazione file di Azure.

  • Il server con abilitazione di Arc deve avere installato il certificato radice Microsoft (Microsoft Root Certificate Authority 2011). Per altri dettagli, vedere questo documento.

  • Risorse di Azure: Un servizio di sincronizzazione archiviazione di Azure deve esistere nella sottoscrizione di Azure per registrare il server dopo l'installazione dell'agente. Non è necessario che il server sia registrato prima dell'installazione, ma lo si registrerà in un servizio di sincronizzazione archiviazione per iniziare la sincronizzazione. Questo argomento è illustrato nei passaggi successivi.

  • Azure PowerShell o l'ambiente dell'interfaccia della riga di comando di Azure:

    • Per Azure PowerShell, installare il modulo Azure PowerShell (modulo Az) con il modulo Az.ConnectedMachine . Assicurarsi di avere installato la versione più recente di Az PowerShell ed eseguire Connect-AzAccount per accedere ad Azure.

    • Per l'interfaccia della riga di comando di Azure, installare l'interfaccia della riga di comando di Azure e accedere (az login). Verificare che l'interfaccia della riga di comando di Azure disponga dell'estensione Connected Machine installata eseguendo:

      az extension add --name connectedmachine

      L'estensione Connected Machine fornisce i az connectedmachine comandi necessari.

  • Connettività di rete: Il server deve avere accesso di rete agli endpoint di Azure richiesti da Azure Arc e Sincronizzazione file di Azure, ad esempio per scaricare l'estensione e raggiungere gli endpoint del servizio Sincronizzazione file di Azure. Assicurarsi che le impostazioni del firewall o del proxy consentano gli URL del servizio di Azure necessari. Vedere Impostazioni di proxy e firewall di Sincronizzazione file di Azure per altre informazioni.

Installare l'estensione dell'agente

È possibile installare l'agente di Sincronizzazione file di Azure per Windows in un server Windows abilitato per Arc usando il portale di Azure, Azure PowerShell o l'interfaccia della riga di comando di Azure.

  1. Aprire la risorsa server abilitata per Arc: Nel portale di Azure passare ad Azure Arc > Machines e selezionare il server Windows abilitato per Arc in cui si vuole installare l'estensione.

  2. Aggiungi estensione: Nella sezione Estensioni del server selezionare + Aggiungi. Nell'elenco delle estensioni disponibili trovare e selezionare l'agente di Sincronizzazione file di Azure per l'estensione Windows (pubblicata da Microsoft) e quindi selezionare Avanti.

Screenshot che mostra come installare l'estensione agente di Sincronizzazione file di Azure per Windows

  1. Configurare le impostazioni: Configurare le impostazioni per l'agente di Sincronizzazione file di Azure che verrà installato nel computer Arc. Vedere Impostazioni disponibili per l'elenco completo delle impostazioni e il relativo significato.

Screenshot che mostra come configurare l'estensione dell'agente di Sincronizzazione file di Azure per Windows

  1. Installare: Selezionare Rivedi e crea per distribuire l'estensione. Azure avvierà l'installazione dell'estensione che installa la versione più recente dell'agente sincronizzazione file di Azure nel server. Entro pochi minuti, l'estensione deve essere installata. È possibile monitorare lo stato di avanzamento della distribuzione nel portale di Azure. Al termine, l'estensione verrà visualizzata con stato Provisioning completato nell'elenco Estensioni.

Installare con un modello di ARM

È anche possibile distribuire l'estensione dell'agente sincronizzazione file di Azure in un server Windows abilitato per Arc usando un modello di Azure Resource Manager (ARM). Questo metodo è utile per l'automazione o le distribuzioni su larga scala.

1. Preparare il file dei parametri

Creare un parameters.json file con i dettagli di personalizzazione, inclusi il nome della macchina virtuale e le impostazioni dell'estensione:

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "AgentInstallDir": { "value": "C:\\Program Files\\Azure\\StorageSyncAgent\\" },
    "UseCustomProxy": { "value": true },
    "ProxyAddress": { "value": "http://proxy.contoso.com" },
    "ProxyPort": { "value": "80" },
    "ProxyAuthRequired": { "value": true },
    "ProxyUserName": { "value": "ProxyUserName" },
    "ProxyPassword": { "value": "ProxyPassword" },
    "EnrollInMicrosoftUpdate": { "value": true },
    "EnableAgentAutoUpdate": { "value": true },
    "AutoUpdateScheduledDayOfWeek": { "value": "Monday" },
    "AutoUpdateScheduledHourOfDay": { "value": "23" },
    "EnableServerDiagnostics": { "value": true },
    "vmName": { "value": "ArcVM1" },
    "location": { "value": "eastus2euap" }
  }
}

2. Preparare il file modello

Creare un template.json file come illustrato di seguito. Questo modello definisce la risorsa di estensione e esegue il mapping dei parametri alle impostazioni di estensione:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "0.43.0.0",
  "parameters": {
    "vmName": { "type": "string" },
    "location": { "type": "string" },
    "agentInstallDir": { "type": "string", "defaultValue": "C:\\Program Files\\Azure\\StorageSyncAgent\\" },
    "useCustomProxy": { "type": "bool", "defaultValue": false },
    "proxyAddress": { "type": "string", "defaultValue": "" },
    "proxyPort": { "type": "string", "defaultValue": "0" },
    "proxyAuthRequired": { "type": "bool", "defaultValue": false },
    "proxyUsername": { "type": "string", "defaultValue": "" },
    "proxyPassword": { "type": "securestring", "defaultValue": "" },
    "enrollInMicrosoftUpdate": { "type": "bool", "defaultValue": true },
    "enableAgentAutoUpdate": { "type": "bool", "defaultValue": false },
    "autoUpdateScheduledDayOfWeek": { "type": "string", "defaultValue": "Tuesday" },
    "autoUpdateScheduledHourOfDay": { "type": "string", "defaultValue": "18" },
    "enableServerDiagnostics": { "type": "bool", "defaultValue": true }
  },
  "variables": {
    "AgentInstallDir": "[parameters('agentInstallDir')]",
    "UseCustomProxy": "[parameters('useCustomProxy')]",
    "ProxyAddress": "[parameters('proxyAddress')]",
    "ProxyPort": "[int(parameters('proxyPort'))]",
    "ProxyAuthRequired": "[parameters('proxyAuthRequired')]",
    "ProxyUserName": "[parameters('proxyUserName')]",
    "ProxyPassword": "[parameters('proxyPassword')]",
    "EnrollInMicrosoftUpdate": "[parameters('enrollInMicrosoftUpdate')]",
    "EnableAgentAutoUpdate": "[parameters('enableAgentAutoUpdate')]",
    "AutoUpdateScheduledDayOfWeek": "[parameters('autoUpdateScheduledDayOfWeek')]",
    "AutoUpdateScheduledHourOfDay": "[parameters('autoUpdateScheduledHourOfDay')]",
    "EnableServerDiagnostics": "[parameters('enableServerDiagnostics')]"
  },
  "resources": [
    {
      "name": "[concat(parameters('vmName'),'/AzureFileSyncAgentExtension')]",
      "type": "Microsoft.HybridCompute/machines/extensions",
      "location": "[parameters('location')]",
      "apiVersion": "2021-05-20",
      "properties": {
        "publisher": "Microsoft.StorageSync",
        "type": "AzureFileSyncAgentExtension",
        "autoUpgradeMinorVersion": true,
        "enableAutomaticUpgrade": true,
        "settings": {
          "agentInstallDir": "[variables('AgentInstallDir')]",
          "useCustomProxy": "[variables('UseCustomProxy')]",
          "proxyAddress": "[variables('ProxyAddress')]",
          "proxyPort": "[variables('ProxyPort')]",
          "proxyAuthRequired": "[variables('ProxyAuthRequired')]",
          "proxyUsername": "[variables('ProxyUserName')]",
          "enrollInMicrosoftUpdate": "[variables('EnrollInMicrosoftUpdate')]",
          "enableAgentAutoUpdate": "[variables('EnableAgentAutoUpdate')]",
          "autoUpdateScheduledDayOfWeek": "[variables('AutoUpdateScheduledDayOfWeek')]",
          "autoUpdateScheduledHourOfDay": "[variables('AutoUpdateScheduledHourOfDay')]",
          "enableServerDiagnostics": "[variables('EnableServerDiagnostics')]"
        },
        "protectedSettings": {
          "proxyPassword": "[parameters('proxyPassword')]"
        }
      }
    }
  ]
}

3. Distribuire il modello

Usare il comando di PowerShell seguente per distribuire il modello nel gruppo di risorse:

New-AzResourceGroupDeployment -ResourceGroupName "<ResourceGroupName>" -TemplateFile "template.json" -TemplateParameterFile "parameters.json"

Sostituire <ResourceGroupName> con il nome del gruppo di risorse contenente il computer abilitato per Arc. Verrà distribuita l'estensione dell'agente Azure File Sync con le impostazioni specificate sul server Windows di destinazione con abilitazione Arc.

Impostazioni disponibili

È possibile configurare le impostazioni seguenti durante l'installazione dell'estensione agente di Sincronizzazione file di Azure:

Nome Scopo Tipo di valore e opzioni Impostazione predefinita
AgentInstallDir Directory per installare l'agente di Sincronizzazione file di Azure Percorso del file C:\Program Files\Azure\StorageSyncAgent\
EnableAgentAutoUpdate Installare automaticamente gli aggiornamenti più recenti dell'agente true / false false
AutoUpdateScheduledDayOfWeek Giorno della settimana per pianificare l'aggiornamento automatico Sunday a Saturday Tuesday
AutoUpdateScheduledHourOfDay Ora del giorno per l'aggiornamento automatico pianificato 0 a 23 (formato 24 ore) 18 (16:00)
EnableServerDiagnostics Abilitare o disabilitare la registrazione diagnostica dell'agente true / false true
EnrollInMicrosoftUpdate Iscriversi al servizio Microsoft Update true / false true
UseCustomProxy Usare un server proxy personalizzato per la connettività true / false false
ProxyAddress Indirizzo del server proxy personalizzato URL o indirizzo IP (ad esempio, http://proxy.example.com o https://192.168.1.1) (Obbligatorio se UseCustomProxy è true)
ProxyPort Porta per la comunicazione del server proxy Numero di porta (ad esempio, 8080) (Obbligatorio se UseCustomProxy è true)
ProxyAuthRequired Indica se il proxy richiede l'autenticazione true / false false
ProxyUserName Nome utente per l'autenticazione proxy Stringa Nome utente (Obbligatorio se ProxyAuthRequired è true)
ProxyPassword Password per l'autenticazione del proxy Stringa Password (Obbligatorio se ProxyAuthRequired è true)

Se nel computer Azure Arc è già installato un agente di Sincronizzazione file di Azure, l'estensione verrà installata correttamente e non modificherà l'agente di Sincronizzazione file di Azure esistente installato nel computer.

Convalidare l'installazione

Dopo l'installazione, verificare che l'estensione dell'agente di Sincronizzazione file di Azure sia stata distribuita correttamente e che l'agente sia in esecuzione nel server.

Nel portale di Azure passare alla risorsa server abilitata per Arc e aprire il pannello Estensioni . Verificare che l'estensione dell'agente di Azure File Sync sia elencata e che il Stato mostri Riuscito. È possibile fare clic sull'estensione per visualizzare altri dettagli, ad esempio il numero di versione e il messaggio di stato. Inoltre, nel server stesso, è possibile verificare che l'agente di Sincronizzazione file di Azure sia installato( ad esempio, controllare Programmi e funzionalità o assicurarsi che il servizio FileSyncSvc sia in esecuzione).

L'output includerà informazioni sull'estensione, come il provisioningState (che dovrebbe essere Succeeded se l'agente è installato correttamente), il Tipo (nome del tipo di estensione) e la typeHandlerVersion (che indica la versione dell'agente di Sincronizzazione file di Azure installata). Verificare che lo stato di provisioning abbia esito positivo e che la versione segnalata corrisponda alla versione prevista dell'agente. Se l'estensione non è elencata o lo stato non riesce, esaminare i dettagli dell'errore nell'output o nel portale di Azure per la risoluzione dei problemi.

Passaggi successivi

Dopo aver installato l'estensione, l'agente di Sincronizzazione file di Azure deve essere installato nel computer Arc. Tuttavia, per abilitare Sincronizzazione file di Azure nei computer, è necessario completare i passaggi seguenti.

Disinstallare l'estensione dell'agente

Se non è più necessaria l'estensione dell'agente di Sincronizzazione file di Azure in un server specifico abilitato per Arc, è possibile disinstallare l'estensione usando il portale di Azure, Azure PowerShell o l'interfaccia della riga di comando di Azure. La disinstallazione dell'estensione non rimuoverà l'agente di Sincronizzazione file di Azure dal server.

La rimozione dell'agente sincronizzazione file di Azure arresterà qualsiasi sincronizzazione cloud in tale server. Se il server è attualmente registrato in un servizio di sincronizzazione archiviazione e partecipa ai gruppi di sincronizzazione, la disinstallazione dell'agente interromperà la connessione di sincronizzazione e la topologia di sincronizzazione file. Se si decide di rimuovere l'agente sul computer Arc, assicurarsi di consultare come deprovisionare o eliminare l'endpoint server di Sincronizzazione file Azure per istruzioni dettagliate sulla disinstallazione dell'agente di Sincronizzazione file Azure.

Per disinstallare l'estensione dell'agente di Sincronizzazione file di Azure usando il portale di Azure:

  1. Nel portale di Azure passare al server abilitato per Arc e aprire la sezione Estensioni e applicazioni .
  2. Trovare l'estensione dell'agente di Sincronizzazione file di Azure nell'elenco delle estensioni installate. Selezionare l'estensione per aprire i suoi dettagli.
  3. Selezionare Disinstalla (o Elimina estensione) e confermare la richiesta di rimuovere l'estensione. Azure disinstalla l'estensione dal computer.
  4. Attendere che l'estensione venga rimossa. La voce di estensione scomparirà dall'elenco Estensioni al termine della disinstallazione. Nel server Windows il software dell'agente di Sincronizzazione file di Azure verrà disinstallato automaticamente durante questo processo.

È possibile verificare la rimozione controllando l'elenco Estensioni nel portale di Azure (l'estensione non dovrebbe più essere visualizzata) o eseguendo i comandi di convalida precedenti (che non dovrebbero più trovare l'estensione). Se l'estensione non riesce a disinstallare, controllare il log attività di Azure o la visualizzazione dell'istanza dell'estensione per informazioni dettagliate sull'errore.