Установка расширения агента синхронизации файлов Azure и управление ими на серверах Windows с поддержкой Azure Arc

В этой статье описывается установка, проверка и удаление расширения агента синхронизации файлов Azure на серверах Windows с поддержкой Azure Arc. Агент синхронизации файлов Azure для Windows развертывает Агент синхронизации файлов Azure на сервере Windows, подключенном через Azure Arc, что позволяет серверу синхронизировать файлы с файловым хранилищем Azure. Расширение публикуется корпорацией Майкрософт и может управляться с помощью портала Azure, Azure PowerShell или Azure CLI.

Предпосылки

• Сервер с поддержкой Azure Arc (только для Windows): Целевой компьютер должен быть подключен к Azure Arc (агент подключенного компьютера Azure установлен, процесс подключения завершен) и должен работать под управлением поддерживаемой ОС Windows Server. Расширение синхронизации файлов Azure поддерживается в Windows Server 2016 и более поздних версиях. Поддерживаются только версии RTM. Дополнительные сведения о поддерживаемых версиях см. в требованиях к системе синхронизации файлов Azure и взаимодействии.

  Это важно

  Расширение агента синхронизации файлов Azure поддерживается только в Windows. Серверы с поддержкой Linux Arc не поддерживаются для синхронизации файлов Azure.

• На сервере с поддержкой Arc должен быть установлен корневой сертификат Майкрософт (Центр сертификации Майкрософт 2011). Дополнительные сведения см. в этом документе.

• Ресурсы Azure:Служба синхронизации службы хранилища Azure должна существовать в подписке Azure, чтобы зарегистрировать сервер после установки агента. ( Перед установкой не нужно зарегистрировать сервер, но вы зарегистрируете его в службе синхронизации хранилища, чтобы начать синхронизацию. Это рассматривается в следующих шагах.)

• Среда Azure PowerShell или Azure CLI:

  • Для Azure PowerShell установите модуль Azure PowerShell (модуль Az) с модулем Az.ConnectedMachine . Убедитесь, что установлена последняя версия Az PowerShell и выполните вход Connect-AzAccount в Azure.

  • Для Azure CLI установите Azure CLI и войдите (az login). Убедитесь, что в Azure CLI установлено расширение подключенного компьютера, выполнив следующую команду:

    az extension add --name connectedmachine
    

    Расширение Connected Machine предоставляет az connectedmachine команды, которые вам понадобятся.

• Сетевое подключение: Сервер должен иметь сетевой доступ к конечным точкам Azure, необходимым для Синхронизации файлов Azure Arc и Azure (например, для скачивания расширения и доступа к конечным точкам службы синхронизации файлов Azure). Убедитесь, что параметры брандмауэра или прокси-сервера разрешают необходимые URL-адреса службы Azure. Дополнительные сведения см. в параметрах прокси-сервера и брандмауэра службы "Синхронизация файлов Azure ".

Установка расширения агента

Агент синхронизации файлов Azure для Windows можно установить на сервере Windows с поддержкой Arc с помощью портала Azure, Azure PowerShell или Azure CLI.

$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

$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

{
  "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"
}

{
  "ProxyPassword": "your_proxy_password"
}

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"

Установка с помощью шаблона ARM

Вы также можете развернуть расширение агента синхронизации файлов Azure на сервере Windows с поддержкой Arc с помощью шаблона Azure Resource Manager (ARM). Этот метод полезен для автоматизации или крупномасштабных развертываний.

1. Подготовка файла параметров

parameters.json Создайте файл с подробными сведениями о настройке, включая имя виртуальной машины и параметры расширения:

{
  "$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. Подготовка файла шаблона

template.json Создайте файл, как показано здесь. Этот шаблон определяет ресурс расширения и сопоставляет параметры с параметрами расширения:

{
  "$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. Развертывание шаблона

Чтобы развернуть шаблон в группе ресурсов, используйте следующую команду PowerShell:

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

Замените <ResourceGroupName> именем группы ресурсов, содержащей компьютер с поддержкой Arc. Это развернет расширение агента синхронизации файлов Azure с указанными параметрами на целевом сервере Windows с поддержкой Arc.

Доступные параметры

Во время установки расширения агента синхронизации файлов Azure можно настроить следующие параметры:

Если на компьютере Azure Arc уже установлен агент синхронизации файлов Azure, расширение будет успешно установлено и не изменит существующий агент синхронизации файлов Azure, установленный на компьютере.

Проверка установки

После установки убедитесь, что расширение агента синхронизации файлов Azure успешно развернуто и что агент запущен на сервере.

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

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

Выходные данные будут содержать информацию о расширении, например о его состоянии подготовки (которое должно быть успешно выполнено если агент установлен правильно), Тип (имя типа расширения) и versionTypeHandler (которое указывает на версию установленного агента синхронизации файлов Azure). Убедитесь, что состояние конфигурации успешно выполнено и что зарегистрированная версия соответствует ожидаемой версии агента. Если расширение не указано или состояние не успешное, просмотрите сведения об ошибке в результатах, или на портале Azure, для устранения неполадок.

Дальнейшие шаги

После установки расширения агент синхронизации файлов Azure должен быть установлен на компьютере Arc. Однако для включения синхронизации файлов Azure на компьютерах необходимо выполнить следующие действия.

• Зарегистрируйте сервер с помощью службы "Синхронизация файлов Azure": Установка агента — это только первый шаг. Чтобы начать синхронизацию файлов, необходимо зарегистрировать Windows Server в службе синхронизации службы хранилища Azure, чтобы установить доверие между сервером и синхронизацией файлов Azure. Выполните действия, описанные в разделе "Управление зарегистрированными серверами" с помощью службы "Синхронизация файлов Azure" (регистрация или отмена регистрации сервера), чтобы зарегистрировать сервер, если это еще не сделано.

• Создайте группы синхронизации и облачные конечные точки: После регистрации создайте группу синхронизации в службе синхронизации хранилища. Группа синхронизации связывает общую папку Azure (облачную конечную точку) и папку на зарегистрированном сервере (конечная точка сервера). Узнайте , как развернуть синхронизацию файлов Azure для комплексного руководства по настройке службы синхронизации хранилища, созданию групп синхронизации и добавлению конечных точек сервера.

• Дополнительные сведения и устранение неполадок: Дополнительные сведения см. в статье "Планирование развертывания службы "Синхронизация файлов Azure ", чтобы понять требования и рекомендации. Если во время установки или регистрации сервера возникают проблемы, см. сведения об устранении неполадок и регистрации агента синхронизации файлов Azure для распространенных проблем и решений.

Удалите расширение агента

Если на определенном сервере с поддержкой Arc больше не требуется расширение агента синхронизации файлов Azure, его можно удалить с помощью портала Azure, Azure PowerShell или Azure CLI. Удаление расширения не приведет к удалению агента синхронизации файлов Azure с сервера.

Удаление агента синхронизации файлов Azure остановит любую облачную синхронизацию на этом сервере. Если сервер в настоящее время зарегистрирован в службе синхронизации хранилища и участвует в группах синхронизации, удаление агента приведет к прерыванию подключения синхронизации и топологии синхронизации файлов. Если вы решите удалить агент на компьютере Arc, убедитесь, что вы ознакомитесь с инструкциями по удалению или деактивации конечной точки сервера синхронизации файлов Azure, чтобы получить подробное руководство по удалению агента синхронизации файлов Azure.

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

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

Вы можете проверить удаление, проверив список расширений на портале Azure (расширение больше не должно отображаться) или выполнив приведенные выше команды проверки (которые больше не должны находить расширение). Если расширение не удается удалить, проверьте журнал действий Azure или представление экземпляра расширения для получения сведений об ошибке.

Скидки на серверные цены

Начиная с января 2026 года, организации с Software Assurance (SA) и серверами с поддержкой Azure Arc получают полную скидку на тарифы Azure File Sync за сервер при использовании агента синхронизации файлов Azure версии 22 или более поздней. Клиенты, использующие агент синхронизации файлов Azure старше версии 22, не получат скидку.

Это преимущество помогает клиентам сократить операционные затраты по мере масштабирования гибридных развертываний файлов.