Installera och hantera Azure File Sync-agenttillägget på Azure Arc-aktiverade Windows-servrar

2025-06-21

I den här artikeln beskrivs hur du installerar, validerar och avinstallerar Azure File Sync-agenttillägget på Azure Arc-aktiverade Windows-servrar. Azure File Sync Agent för Windows-tillägget distribuerar Azure File Sync Agent på en Windows-server som är ansluten via Azure Arc, så att servern kan synkronisera filer med en Azure-filresurs. Tillägget publiceras av Microsoft och kan hanteras med hjälp av Azure-portalen, Azure PowerShell eller Azure CLI.

Förutsättningar

Azure Arc-aktiverad server (endast Windows): Måldatorn måste vara ansluten till Azure Arc (Azure Connected Machine-agenten är installerad och registreringen har slutförts) och köra ett Windows Server-operativsystem som stöds. Azure File Sync-tillägget stöds i Windows Server 2016 och senare versioner. Endast RTM-versioner stöds. Mer information om versioner som stöds finns i Systemkrav för Azure File Sync och samverkan .

Viktigt!

Azure File Sync-agenttillägget stöds endast i Windows. Linux Arc-aktiverade servrar stöds inte för Azure File Sync.
Arc-aktiverad server måste ha Microsoft Root Certificate (Microsoft Root Certificate Authority 2011) installerat. Mer information finns i det här dokumentet.
Azure-resurser: En Azure Storage Sync Service bör finnas i din Azure-prenumeration för att registrera servern när agenten har installerats. (Du behöver inte ha servern registrerad före installationen, men du registrerar den till en synkroniseringstjänst för lagring för att börja synkronisera. Detta beskrivs i Nästa steg.)
Azure PowerShell- eller Azure CLI-miljö:
- För Azure PowerShell installerar du Azure PowerShell-modulen (Az-modulen) med modulen Az.ConnectedMachine . Se till att du har den senaste Az PowerShell installerad och kör Connect-AzAccount för att logga in på Azure.
- För Azure CLI installerar du Azure CLI och loggar in (az login). Kontrollera att Azure CLI har tillägget Ansluten dator installerat genom att köra:
```
az extension add --name connectedmachine
```
  Tillägget Ansluten dator innehåller de az connectedmachine kommandon som du behöver.
Nätverksanslutning: Servern måste ha nätverksåtkomst till Azure-slutpunkter som krävs av Azure Arc och Azure File Sync (till exempel för att ladda ned tillägget och för att nå Azure File Sync-tjänstslutpunkter). Se till att brandväggs- eller proxyinställningarna tillåter nödvändiga Url:er för Azure-tjänsten. Mer information finns i Proxy- och brandväggsinställningar för Azure File Sync .

Installera agenttillägget

Du kan installera Azure File Sync Agent för Windows-tillägget på en Arc-aktiverad Windows-server med hjälp av Azure-portalen, Azure PowerShell eller Azure CLI.

Öppna den Arc-aktiverade serverresursen: I Azure-portalen går du till Azure Arc > Machines och väljer den Arc-aktiverade Windows-server där du vill installera tillägget.
Lägg till tillägg: Under avsnittet Tillägg för servern väljer du + Lägg till. I listan över tillgängliga tillägg letar du upp och väljer Azure File Sync Agent för Windows-tillägget (publicerat av Microsoft) och väljer sedan Nästa.

Skärmbild som visar hur du installerar Azure File Sync-agenttillägget för Windows

Konfigurera inställningar: Konfigurera inställningarna för Azure File Sync-agenten som ska installeras på Arc-datorn. Se Tillgängliga inställningar för den fullständiga listan över inställningar och deras innebörd.

Skärmbild som visar hur du konfigurerar Azure File Sync-agenttillägget för Windows

Installera: Välj Granska + skapa för att distribuera tillägget. Azure initierar installationen av tillägget som installerar den senaste versionen av Azure File Sync-agenten på servern. Inom några minuter bör tillägget installeras. Du kan övervaka distributionsframstegen i Azure-portalen. När det är klart visas tillägget med status Provisionering lyckades i listan Tillägg.

Använd cmdleten New-AzConnectedMachineExtension för att installera tillägget på en Arc-aktiverad Windows-server. I följande exempel installeras tillägget på en angiven dator. Ersätt platshållarna med dina resursnamn. Se Tillgängliga inställningar för den fullständiga listan över inställningar som du kan lägga till i inställningsparametern.

Installera Azure File Sync-tillägget utan proxyinställningar

$Settings = @{
  EnableAgentAutoUpdate = "true"
  AutoUpdateScheduledDayOfWeek = "Monday"
  AutoUpdateScheduledHourOfDay = 05
  EnableServerDiagnostics = "true"
  AgentInstallDir = "C:\Custom Path\AFS"
  EnrollInMicrosoftUpdate = "true"
}

New-AzConnectedMachineExtension `
  -ResourceGroupName <resource-group-name> `
  -MachineName <machine-name> `
  -Name AzureFileSyncExtension `
  -SubscriptionId <subscriptionId> `
  -Location <region> `
  -TypeHandlerVersion <version> `
  -Publisher Microsoft.StorageSync `
  -ExtensionType AzureFileSyncExtension `
  -Settings $settings

Installera Azure File Sync-tillägget med proxyinställningar

$Settings = @{
  EnableAgentAutoUpdate = "true"
  AutoUpdateScheduledDayOfWeek = "Monday"
  AutoUpdateScheduledHourOfDay = 05
  EnableServerDiagnostics = "true"
  AgentInstallDir = "C:\Custom Path\AFS"
  EnrollInMicrosoftUpdate = "true"
  UseCustomProxy = "true"
  ProxyAddress = "http://proxy.contoso.com"
  ProxyPort = 1009
  ProxyAuthRequired = "true"
  ProxyUsername = "myuser"
}

$protectedSettings =@{
  ProxyPassword = "your_proxy_password"
}

New-AzConnectedMachineExtension `
  -ResourceGroupName <resource-group-name> `
  -MachineName <machine-name> `
  -Name AzureFileSyncExtension `
  -SubscriptionId <subscriptionId> `
  -Location <region> `
  -TypeHandlerVersion <version> `
  -Publisher Microsoft.StorageSync `
  -ExtensionType AzureFileSyncExtension `
  -Settings $settings `
  -ProtectedSetting $protectedSettings

az connectedmachine extension create Använd kommandot för att installera tillägget via Azure CLI. I följande exempel distribueras tillägget till den angivna Arc-aktiverade servern. Ersätt platshållarna med din information och ändra värdena som du vill. Se Tillgängliga inställningar för den fullständiga listan med inställningar.

Skapa en JSON-fil (afs_settings.json) med inställningarna för agenten:

{
  "EnableAgentAutoUpdate": "true",
  "AutoUpdateScheduledDayOfWeek": "Monday",
  "AutoUpdateScheduledHourOfDay": 5,
  "EnableServerDiagnostics": "true",
  "AgentInstallDir": "C:\\Custom Path\\AFS",
  "EnrollInMicrosoftUpdate": "true",
  "UseCustomProxy": "true",
  "ProxyAddress": "http://proxy.contoso.com",
  "ProxyPort": 1009,
  "ProxyAuthRequired": "true",
  "ProxyUsername": "your_username"
}

Skapa en annan fil (afs_pwd.json) med skyddade inställningar (t.ex. proxylösenord).

{
  "ProxyPassword": "your_proxy_password"
}

Kör följande kommando:

az connectedmachine extension create \
  --name AzureFileSyncAgentExtension \
  --machine-name <machine> \
  --resource-group <machine rg> \
  --publisher Microsoft.StorageSync \
  --type AzureFileSyncAgentExtension \
  --settings "afs_settings.json" \
  --protected-settings "afs_pwd.json"

Installera med ARM-mall

Du kan också distribuera Azure File Sync-agenttillägget till en Arc-aktiverad Windows-server med hjälp av en ARM-mall (Azure Resource Manager). Den här metoden är användbar för automatisering eller storskaliga distributioner.

1. Förbered parameterfilen

Skapa en parameters.json fil med din anpassningsinformation, inklusive vm-namnet och tilläggsinställningarna:

{
  "$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. Förbered mallfilen

Skapa en template.json fil som visas här. Den här mallen definierar tilläggsresursen och mappar parametrar till tilläggsinställningar:

{
  "$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. Distribuera mallen

Använd följande PowerShell-kommando för att distribuera mallen till resursgruppen:

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

Ersätt <ResourceGroupName> med namnet på resursgruppen som innehåller din Arc-aktiverade dator. Då distribueras Azure File Sync-agenttillägget med dina angivna inställningar till den Arc-aktiverade Windows-målservern.

Tillgängliga inställningar

Du kan konfigurera följande inställningar under installationen av Azure File Sync-agenttillägget:

Namn	Avsikt	Värdetyp/alternativ	Förinställning
`AgentInstallDir`	Katalog för att installera Azure File Sync-agenten	Filväg	`C:\Program Files\Azure\StorageSyncAgent\`
`EnableAgentAutoUpdate`	Installera de senaste agentuppdateringarna automatiskt	`true` / `false`	`false`
`AutoUpdateScheduledDayOfWeek`	Veckodag för att schemalägga automatisk uppdatering	`Sunday` till `Saturday`	`Tuesday`
`AutoUpdateScheduledHourOfDay`	Timme på dagen för schemalagd automatisk uppdatering	`0` till `23` (24-timmarsformat)	`18` (18.00)
`EnableServerDiagnostics`	Aktivera eller inaktivera agentdiagnostikloggning	`true` / `false`	`true`
`EnrollInMicrosoftUpdate`	Registrera i Microsoft Update-tjänsten	`true` / `false`	`true`
`UseCustomProxy`	Använda en anpassad proxyserver för anslutning	`true` / `false`	`false`
`ProxyAddress`	Adress för anpassad proxyserver	URL eller IP-adress (t.ex. `http://proxy.example.com` eller https://192.168.1.1)	(Krävs om `UseCustomProxy`* är `true`)*
`ProxyPort`	Port för proxyserverkommunikation	Portnummer (t.ex. `8080`)	(Krävs om `UseCustomProxy`* är `true`)*
`ProxyAuthRequired`	Anger om proxy kräver autentisering	`true` / `false`	`false`
`ProxyUserName`	Användarnamn för proxyautentisering	Användarnamnssträng	(Krävs om `ProxyAuthRequired`* är `true`)*
`ProxyPassword`	Lösenord för proxyautentisering	Lösenordssträng	(Krävs om `ProxyAuthRequired`* är `true`)*

Om Azure Arc-datorn redan har en Azure File Sync-agent installerad installeras tillägget och ändrar inte den befintliga Azure File Sync-agenten som är installerad på datorn.

Verifiera installationen

Efter installationen kontrollerar du att Azure File Sync-agenttillägget har distribuerats och att agenten körs på servern.

I Azure-portalen navigerar du till den Arc-aktiverade serverresursen och öppnar bladet Tillägg . Se till att Azure File Sync-agenttillägget visas och att dess status visar Lyckades. Du kan klicka på tillägget för att visa mer information som versionsnummer och statusmeddelande. Dessutom kan du på själva servern bekräfta att Azure File Sync Agent är installerad (till exempel kontrollera Program och funktioner eller se till att FileSyncSvc-tjänsten körs).

Du kan använda Azure PowerShell för att bekräfta att tillägget är installerat och i ett lyckat tillstånd.

Använd Get-AzConnectedMachineExtension för att lista eller hämta tillägget på datorn:

Get-AzConnectedMachineExtension `
  -ResourceGroupName <resource-group-name> `
  -MachineName <machine-name> `
  -Name <EXTENSION_NAME>

Du kan använda Azure CLI för att bekräfta att tillägget är installerat och i ett lyckat tillstånd.

Använd az connectedmachine extension show för att hämta information om det installerade tillägget:

az connectedmachine extension show \
  --resource-group "<resource-group-name>" \
  --machine-name "<machine-name>" \
  --name "<EXTENSION_NAME>"

Utdata kommer att innehålla information om tillägget, såsom dess provisioningState (som bör vara Succeeded om agenten installerades korrekt), typen för tillägget (Type) och typeHandlerVersion (som anger vilken version av Azure File Sync-agenten som installerades). Kontrollera att tillståndet för provisionering är framgångsrikt och att den rapporterade versionen matchar den förväntade agentversionen. Om tillägget inte visas eller om statusen inte är framgångsrik kan du läsa felinformationen i utdatafilerna eller i Azure-portalen för felsökning.

Nästa steg

När du har installerat tillägget bör Azure File Sync-agenten installeras på Arc-datorn. För att aktivera Azure File Sync på datorerna måste du dock utföra följande steg.

Registrera servern med Azure File Sync: Att installera agenten är bara det första steget. Om du vill börja synkronisera filer måste du registrera din Windows Server med en Azure Storage Sync-tjänst för att upprätta förtroende mellan servern och Azure File Sync. Följ stegen i Hantera registrerade servrar med Azure File Sync (Registrera/avregistrera en server) för att registrera servern om du inte redan har gjort det.
Skapa synkroniseringsgrupper och molnslutpunkter: Efter registreringen skapar du en synkroniseringsgrupp i lagringssynkroniseringstjänsten. En synkroniseringsgrupp länkar en Azure-filresurs (molnslutpunkt) och en mapp på din registrerade server (serverslutpunkt). Se Distribuera Azure File Sync för en guide från slutpunkt till slutpunkt om hur du konfigurerar Tjänsten för synkronisering av lagring, skapar synkroniseringsgrupper och lägger till serverslutpunkter.
Läs mer och felsök: Mer information finns i Planera för en Azure File Sync-distribution för att förstå krav och metodtips. Om du stöter på problem under installationen eller serverregistreringen kan du läsa Felsöka installation och registrering av Azure File Sync-agenten för vanliga problem och lösningar.

Avinstallera agenttillägget

Om du inte längre behöver Azure File Sync-agenttillägget på en viss Arc-aktiverad server kan du avinstallera tillägget med hjälp av Azure-portalen, Azure PowerShell eller Azure CLI. Om du avinstallerar tillägget tas inte Azure File Sync-agenten bort från servern.

Om du tar bort Azure File Sync-agenten stoppas alla molnsynkroniseringar på servern. Om servern för närvarande är registrerad på en tjänst för synkronisering av lagring och deltar i synkroniseringsgrupper kommer avinstallationen av agenten att bryta synkroniseringsanslutningen och filsynkroniseringstopologin. Om du bestämmer dig för att ta bort agenten på Arc-maskinen, ska du se till att avetablera eller ta bort Azure File Sync-serverns slutpunkt för detaljerade instruktioner om hur du avinstallerar Azure File Sync-agenten.

Så här avinstallerar du Azure File Sync-agenttillägget med hjälp av Azure-portalen:

I Azure-portalen går du till din Arc-aktiverade server och öppnar avsnittet Tillägg + program .
Leta upp Azure File Sync-agenttillägget i listan över installerade tillägg. Välj tillägget för att öppna dess information.
Välj Avinstallera (eller Ta bort tillägg) och bekräfta uppmaningen att ta bort tillägget. Azure avinstallerar tillägget från datorn.
Vänta tills tillägget har tagits bort. Tilläggsposten försvinner från listan Tillägg när avinstallationen är klar. På Windows-servern avinstalleras Azure File Sync-agentprogramvaran automatiskt som en del av den här processen.

Använd cmdleten Remove-AzConnectedMachineExtension för att avinstallera tillägget från den Arc-aktiverade servern:

Remove-AzConnectedMachineExtension `
  -MachineName <machine-name> `
  -ResourceGroupName <resource-group-name> `
  -Name <EXTENSION_NAME>

Det här kommandot initierar borttagningen av Azure File Sync-agenttillägget. När det har lyckats avregistreras tillägget i Azure och du kan inte längre hantera Azure File Sync-agenten via tillägget.

Använd az connectedmachine extension delete för att ta bort tillägget från den Arc-aktiverade servern:

az connectedmachine extension delete \
  --machine-name "<machine-name>" \
  --resource-group "<resource-group-name>" \
  --name "<EXTENSION_NAME>"

Du kan kontrollera borttagningen genom att kontrollera listan Tillägg i Azure-portalen (tillägget bör inte längre visas) eller genom att köra valideringskommandona ovan (som inte längre bör hitta tillägget). Om tillägget inte kan avinstalleras kontrollerar du felinformationen i Azure-aktivitetsloggen eller tilläggsinstansvyn.

Feedback

Var den här sidan till hjälp?