Обслуживание агента Connected Machine и управление им

Статья
06/08/2023

Внимание

Эта статья ссылается на CentOS, дистрибутив Linux, который приближается к состоянию конца жизни (EOL). Пожалуйста, рассмотрите возможность использования и планирования соответствующим образом. Дополнительные сведения см. в руководстве centOS End Of Life.

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

Установка определенной версии агента

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

Ссылки на текущие и предыдущие выпуски агентов Windows доступны под заголовком каждого заметки о выпуске. Если вы ищете версию агента, которая более 6 месяцев, проверка архив заметок о выпуске.

Если вы еще не сделали этого, настройте диспетчер пакетов с помощью репозитория программного обеспечения Linux для продуктов Майкрософт.
Поиск доступных версий агента с помощью apt-cache:
```
sudo apt-cache madison azcmagent
```
Найдите версию, которую вы хотите установить, замените VERSION в следующей команде полный номер версии (4-часть) и выполните команду, чтобы установить агент:
```
sudo apt install azcmagent=VERSION
```
Например, чтобы установить версию 1.28, выполните следующую команду:
```
sudo apt install azcmagent=1.28.02260.736
```

Если вы еще не сделали этого, настройте диспетчер пакетов с помощью репозитория программного обеспечения Linux для продуктов Майкрософт.
Поиск доступных версий агента с помощью yum list:
```
sudo yum list azcmagent --showduplicates
```
Найдите версию, которую вы хотите установить, замените VERSION в следующей команде полный номер версии (4-часть) и выполните команду, чтобы установить агент:
```
sudo yum install azcmagent-VERSION
```
Например, чтобы установить версию 1.28, команда установки будет выглядеть следующим образом:
```
sudo yum install azcmagent-1.28.02260-755
```

Если вы еще не сделали этого, настройте диспетчер пакетов с помощью репозитория программного обеспечения Linux для продуктов Майкрософт.
Поиск доступных версий агента с помощью zypper search:
```
sudo zypper search -s azcmagent
```
Найдите версию, которую вы хотите установить, замените VERSION в следующей команде полный номер версии (4-часть) и выполните команду, чтобы установить агент:
```
sudo zypper install -f azcmagent-VERSION
```
Например, чтобы установить версию 1.28, команда установки будет выглядеть следующим образом:
```
sudo zypper install -f azcmagent-1.28.02260-755
```

Обновление агента

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

Агент Azure Connected Machine для Windows и Linux можно обновить до последней версии вручную или автоматически в зависимости от требований. Установка, обновление или удаление агента машин Azure Подключение ed Machine Agent не потребует перезапуска сервера.

В следующей таблице описаны методы, поддерживаемые для обновления агента:

Операционная система	Метод перехода
Windows	Вручную Центр обновления Майкрософт
Ubuntu	Apt
SUSE Linux Enterprise Server	zypper

Агент Windows

Последнюю версию агента Подключение машин Azure для компьютеров под управлением Windows можно получить:

Конфигурация Центра обновления Майкрософт

Рекомендуемый способ обновления агента Windows — автоматически получать последнюю версию с помощью Центра обновления Майкрософт. Это позволяет использовать существующую инфраструктуру обновлений (например, Microsoft Configuration Manager или Службы Центра обновления Windows Server) и включить обновления агента машин Azure Подключение с расписанием регулярного обновления ОС.

Windows Server по умолчанию не проверка обновлений в Центре обновления Майкрософт. Чтобы получать автоматические обновления для агента компьютера Azure Подключение, необходимо настроить клиент Обновл. Windows на компьютере, чтобы проверка для других продуктов Майкрософт.

Для серверов Windows, принадлежащих рабочей группе и подключающихся к Интернету, чтобы проверка обновлений, можно включить Центр обновления Майкрософт, выполнив следующие команды в PowerShell в качестве администратора:

$ServiceManager = (New-Object -com "Microsoft.Update.ServiceManager")
$ServiceID = "7971f918-a847-4430-9279-4a52d1efe18d"
$ServiceManager.AddService2($ServiceId,7,"")

Для серверов Windows, принадлежащих домену и подключающихся к Интернету, чтобы проверка обновлений, этот параметр можно настроить в масштабе с помощью групповой политики:

Войдите на компьютер, используемый для администрирования сервера с учетной записью, которая может управлять объектами групповой политики (GPO) для вашей организации.
Откройте Консоль управления групповыми политиками.
Разверните лес, домен и подразделения, чтобы выбрать соответствующую область для нового объекта групповой политики. Если у вас уже есть объект групповой политики, который вы хотите изменить, перейдите к шагу 6.
Щелкните правой кнопкой мыши контейнер и выберите "Создать объект групповой политики" в этом домене и связать его здесь....
Укажите имя политики, например "Включить центр обновления Майкрософт".
Щелкните правой кнопкой мыши политику и выберите пункт "Изменить".
Перейдите к Администратор устойчивым шаблонам >Компонентов > Windows Обновл. Windows конфигурации > компьютера.
Выберите параметр автоматического Обновления, чтобы изменить его.
Нажмите переключатель "Включено", чтобы разрешить политике входить в силу.
В нижней части раздела "Параметры" проверка поле для установки обновлений для других продуктов Майкрософт в нижней части экрана.
Нажмите ОК.

При следующем обновлении политики компьютеры в выбранном область начнут проверка обновлений как в Обновл. Windows, так и в Центре обновления Майкрософт.

Для организаций, использующих Microsoft Configuration Manager (MECM) или службы windows Server Update Services (WSUS) для доставки обновлений на свои серверы, необходимо настроить WSUS для синхронизации пакетов агента машин Azure Подключение и утвердить их для установки на серверах. Следуйте указаниям для служб windows Server Update Services или MECM , чтобы добавить следующие продукты и классификации в конфигурацию:

Имя продукта: агент машинного компьютера Azure Подключение (выберите все 3 вложенных параметра)
Классификации: критически важные Обновления, Обновления

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

Обновление вручную с помощью мастера установки

Войдите на компьютер с учетной записью с правами администратора.
Скачайте последнюю версию установщика агента из https://aka.ms/AzureConnectedMachineAgent
Запустите Azure Подключение edMachineAgent.msi, чтобы запустить мастер установки.

Если мастер установки обнаруживает предыдущую версию агента, он автоматически обновится. После завершения обновления мастер установки автоматически закрывается.

Обновление с помощью командной строки

Если вы не знакомы с параметрами командной строки для пакетов установщика Windows, ознакомьтесь со стандартными параметрами командной строки Msiexec и параметрами командной строки Msiexec.

Войдите в систему компьютера, используя учетную запись с правами администратора.
Скачайте последнюю версию установщика агента из https://aka.ms/AzureConnectedMachineAgent
Чтобы автоматически обновить агент и создать файл журнала установки в папке C:\Support\Logs , выполните следующую команду:
```
msiexec.exe /i AzureConnectedMachineAgent.msi /qn /l*v "C:\Support\Logs\azcmagentupgradesetup.log"
```

Агент Linux

Обновление агента на компьютере Linux включает две команды; одна команда для обновления индекса локального пакета со списком последних доступных пакетов из репозиториев, а другая команда для обновления локального пакета.

Вы можете скачать последнюю версию пакета агента из репозитория пакетов корпорации Майкрософт.

Примечание.

Для обновления агента необходимо иметь разрешения на корневой доступ или учетную запись с повышенными правами с помощью Sudo.

Обновление агента в Ubuntu

Чтобы обновить индекс локального пакета с помощью последних изменений, внесенных в репозитории, выполните следующую команду:
```
sudo apt update
```
Чтобы обновить систему, выполните следующую команду:
```
sudo apt upgrade azcmagent
```

Действия команды apt, такие как установка и удаление пакетов, записываются в файл журнала /var/log/dpkg.log.

Обновление агента в Red Hat/CentOS/Oracle Linux/Amazon Linux

Чтобы обновить индекс локального пакета с помощью последних изменений, внесенных в репозитории, выполните следующую команду:
```
sudo yum check-update
```
Чтобы обновить систему, выполните следующую команду:
```
sudo yum update azcmagent
```

Действия команды yum, такие как установка и удаление пакетов, записываются в файл журнала /var/log/yum.log.

Обновление агента в SUSE Linux Enterprise

Чтобы обновить индекс локального пакета с помощью последних изменений, внесенных в репозитории, выполните следующую команду:
```
sudo zypper refresh
```
Чтобы обновить систему, выполните следующую команду:
```
sudo zypper update azcmagent
```

Действия команды zypper, такие как установка и удаление пакетов, записываются в файл журнала /var/log/zypper.log.

Автоматическое обновление агента

Агент Подключение компьютера Azure не обновляется автоматически при выпуске новой версии. Необходимо включить последнюю версию агента с запланированными циклами исправлений.

Переименование ресурса сервера с поддержкой Azure Arc

При изменении имени компьютера Linux или Windows, подключенного к серверам с поддержкой Azure Arc, новое имя не распознается автоматически, так как имя ресурса в Azure неизменяемо. Как и в других ресурсах Azure, необходимо удалить ресурс и повторно создать его, чтобы использовать новое имя.

Для серверов с поддержкой Azure Arc перед переименованием компьютера необходимо удалить расширения виртуальной машины, прежде чем продолжить:

Проверьте расширения виртуальной машины, установленные на компьютере, и запишите их конфигурацию с помощью Azure CLI или Azure PowerShell.
Удалите все расширения виртуальных машин, установленные на компьютере. Это можно сделать с помощью портал Azure, Azure CLI или Azure PowerShell.
Воспользуйтесь инструментом azcmagent с параметром Disconnect, чтобы отключить компьютер от Azure Arc и удалить ресурс компьютера из Azure. Эту процедуру можно запустить вручную при входе в систему с помощью маркера доступа к удостоверениям Майкрософт или с помощью субъекта-службы, используемого для подключения (или с новым создаваемым субъектом-службой.

Отключение компьютера от серверов с поддержкой Azure Arc не удаляет агент Подключение компьютера, и вам не нужно удалять агент в рамках этого процесса.
Повторно зарегистрируйте Подключение агент компьютера с поддержкой Azure Arc. azcmagent Запустите средство с параметром Подключение, чтобы выполнить этот шаг. Агент по умолчанию будет использовать текущее имя узла компьютера, но вы можете выбрать собственное имя ресурса, передав --resource-name параметр в команду connect.
Повторно разверните расширения виртуальной машины, которые были первоначально развернуты на компьютере с серверов с поддержкой Azure Arc. Если вы развернули агент Azure Monitor для виртуальных машин (аналитика) или агент Log Analytics с помощью определения политики Azure, агенты будут повторно развернуты после следующего цикла оценки.

Удаление агента

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

Шаг 1. Удаление расширений виртуальной машины

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

Инструкции по выявлению и удалению расширений на сервере с поддержкой Azure Arc см. в следующих ресурсах:

Шаг 2. Отключение сервера от Azure Arc

Отключение агента удаляет соответствующий ресурс Azure для сервера и очищает локальное состояние агента. Чтобы отключить агент, выполните azcmagent disconnect команду от имени администратора на сервере. Вам будет предложено войти с помощью учетной записи Azure, которая имеет разрешение на удаление ресурса в подписке. Если ресурс уже удален в Azure, необходимо передать дополнительный флаг для очистки локального состояния: azcmagent disconnect --force-local-only

Шаг 3a. Удаление агента Windows

Оба следующих метода удаляют агент, но не удаляют папку C:\Program Files\AzureConnectedMachineAgent на компьютере.

Удаление из панели управления

Выполните следующие действия, чтобы удалить агент Windows с компьютера:

Войдите в систему компьютера, используя учетную запись с правами администратора.
На панели управления выберите "Программы и компоненты".
В разделе Программы и компоненты выберите Azure Connected Machine Agent (Агент подключенного компьютера Azure), затем Удалить, а затем Да.

Вы также можете удалить агент Windows непосредственно из мастера установки агента. Выполните пакет установщика Azure Подключение edMachineAgent.msi для этого.

Удаление из командной строки

Агент можно удалить вручную из командной строки или с помощью автоматизированного метода (например, скрипта), выполнив приведенный ниже пример. Сначала из операционной системы необходимо извлечь код продукта, который является уникальным идентификатором, представляющим собой идентификатор субъекта пакета приложения. Удаление выполняется с помощью командной строки Msiexec.exe — msiexec /x {Product Code}.

откройте редактор реестра;
в разделе реестра HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall найдите и скопируйте код GUID продукта;

Удалите агент с помощью Msiexec, как показано в следующих примерах:

из командной строки введите:
```
msiexec.exe /x {product code GUID} /qn
```

эти же действия можно выполнить с помощью PowerShell:

Get-ChildItem -Path HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall | `
Get-ItemProperty | `
Where-Object {$_.DisplayName -eq "Azure Connected Machine Agent"} | `
ForEach-Object {MsiExec.exe /x "$($_.PsChildName)" /qn}

Шаг 3b. Удаление агента Linux

Примечание.

Чтобы удалить агент, необходимо иметь разрешения на корневой доступ или учетную запись с повышенными правами с помощью sudo.

Команда, используемая для удаления агента Linux, зависит от операционной системы Linux.

В ОС Ubuntu выполните следующую команду:
```
sudo apt purge azcmagent
```
Для RHEL, CentOS, Oracle Linux и Amazon Linux выполните следующую команду:
```
sudo yum remove azcmagent
```
В ОС SLES выполните следующую команду:
```
sudo zypper remove azcmagent
```

Обновление или удаление параметров прокси-сервера

Чтобы настроить агент для взаимодействия со службой через прокси-сервер или удалить эту конфигурацию после развертывания, используйте один из описанных ниже методов. Обратите внимание, что агент передает исходящий трафик с помощью протокола HTTP в этом сценарии.

Начиная с версии 1.13 агент, параметры прокси-сервера можно настроить с помощью переменных командной azcmagent config или системной среды. Если прокси-сервер указан как в конфигурации агента, так и в системных переменных среды, конфигурация агента будет иметь приоритет и станет эффективным параметром. Используется azcmagent show для просмотра эффективной конфигурации прокси-сервера для агента.

Примечание.

Серверы с поддержкой Azure Arc не поддерживают использование прокси-серверов, требующих проверки подлинности, подключений TLS (HTTPS) или шлюза Log Analytics в качестве прокси-сервера для агента Подключение компьютера.

Конфигурация прокси-сервера для конкретного агента

Конфигурация прокси-сервера для конкретного агента доступна начиная с версии 1.13 агента Подключение компьютера Azure и является предпочтительным способом настройки параметров прокси-сервера. Этот подход предотвращает использование параметров прокси-сервера для агента машин azure Подключение ed Machine от вмешательства в другие приложения в вашей системе.

Примечание.

Расширения, развернутые Azure Arc, не наследуют конфигурацию прокси-сервера для конкретного агента. Дополнительные сведения о настройке параметров прокси-сервера для каждого расширения см. в документации по расширениям, которые вы развертываете.

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

azcmagent config set proxy.url "http://ProxyServerFQDN:port"

Вы можете использовать IP-адрес или простое имя узла вместо полного доменного имени, если требуется сеть. Если прокси-сервер выполняется через порт 80, в конце можно не указывать ":80".

Чтобы проверка, если URL-адрес прокси-сервера настроен в параметрах агента, выполните следующую команду:

azcmagent config get proxy.url

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

azcmagent config clear proxy.url

При перенастройки параметров прокси-сервера с azcmagent config помощью команды не требуется перезапускать службы.

Обход прокси-сервера для частных конечных точек

Начиная с версии 1.15 агента, можно также указать службы, которые не должны использовать указанный прокси-сервер. Это может помочь в сценариях разбиения сети и частных конечных точек, в которых требуется, чтобы идентификатор Microsoft Entra и трафик Azure Resource Manager проходил через прокси-сервер к общедоступным конечным точкам, но требуется, чтобы трафик Azure Arc пропускал прокси-сервер и взаимодействовал с частным IP-адресом в сети.

Функция обхода прокси-сервера не требует ввода определенных URL-адресов для обхода. Вместо этого укажите имя служб, которые не должны использовать прокси-сервер. Параметр расположения ссылается на регион Azure серверов Arc.

Значение обхода прокси-сервера, если задано ArcData только путем передачи трафика расширения Azure для SQL Server, а не агента Arc.

Значение обхода прокси-сервера	Затронутые конечные точки
`AAD`	`login.windows.net` `login.microsoftonline.com` `pas.windows.net`
`ARM`	`management.azure.com`
`Arc`	`his.arc.azure.com` `guestconfiguration.azure.com`
`ArcData`¹	`*.<region>.arcdataservices.com`

¹ Значение ArcData обхода прокси-сервера доступно начиная с azure Подключение агента машин версии 1.36 и расширения Azure для SQL Server версии 1.1.2504.99. Более ранние версии включают SQL Server, включенную конечными точками Azure Arc, в значение обхода прокси-сервера Arc.

Чтобы отправить идентификатор Microsoft Entra и трафик Azure Resource Manager через прокси-сервер, но пропустить прокси-сервер для трафика Azure Arc, выполните следующую команду:

azcmagent config set proxy.url "http://ProxyServerFQDN:port"
azcmagent config set proxy.bypass "Arc"

Чтобы предоставить список служб, разделите имена служб запятыми:

azcmagent config set proxy.bypass "ARM,Arc"

Чтобы очистить обход прокси-сервера, выполните следующую команду:

azcmagent config clear proxy.bypass

Вы можете просмотреть эффективную конфигурацию обхода прокси-сервера и прокси-сервера, выполнив команду azcmagent show.

Переменные среды Windows

В Windows агент Подключение компьютера Azure сначала проверка proxy.url свойство конфигурации агента (начиная с агента версии 1.13), а затем переменную среды на уровне HTTPS_PROXY системы, чтобы определить, какой прокси-сервер следует использовать. Если оба являются пустыми, прокси-сервер не используется, даже если настроен параметр прокси-сервера на уровне системы Windows по умолчанию.

Корпорация Майкрософт рекомендует использовать конфигурацию прокси-сервера для конкретного агента вместо системной переменной среды.

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

# If a proxy server is needed, execute these commands with the proxy URL and port.
[Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://ProxyServerFQDN:port", "Machine")
$env:HTTPS_PROXY = [System.Environment]::GetEnvironmentVariable("HTTPS_PROXY", "Machine")
# For the changes to take effect, the agent services need to be restarted after the proxy environment variable is set.
Restart-Service -Name himds, ExtensionService, GCArcService

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

[Environment]::SetEnvironmentVariable("HTTPS_PROXY", $null, "Machine")
$env:HTTPS_PROXY = [System.Environment]::GetEnvironmentVariable("HTTPS_PROXY", "Machine")
# For the changes to take effect, the agent services need to be restarted after the proxy environment variable removed.
Restart-Service -Name himds, ExtensionService, GCArcService

Переменные среды Linux

В Linux агент машин Подключение Azure сначала проверка proxy.url свойство конфигурации агента (начиная с агента версии 1.13), а затем HTTPS_PROXY переменная среды, заданная для хидд, GC_Ext и GCArcService daemons. Существует включенный скрипт, который настроит параметры прокси-сервера по умолчанию системы для агента машины Azure Подключение и всех других служб на компьютере для использования указанного прокси-сервера.

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

sudo /opt/azcmagent/bin/azcmagent_proxy add "http://ProxyServerFQDN:port"

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

sudo /opt/azcmagent/bin/azcmagent_proxy remove

Миграция из переменных среды в конфигурацию прокси-сервера для конкретного агента

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

Обновите агент компьютера Azure Подключение до последней версии (начиная с версии 1.13), чтобы использовать новые параметры конфигурации прокси-сервера.
Настройте агент с сведениями о прокси-сервере, выполнив команду azcmagent config set proxy.url "http://ProxyServerFQDN:port".
Удалите неиспользуемые переменные среды, выполнив действия для Windows или Linux.

Следующие шаги

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

Share via

Обслуживание агента Connected Machine и управление им

Установка определенной версии агента

Обновление агента

Агент Windows

Конфигурация Центра обновления Майкрософт

Обновление вручную с помощью мастера установки

Обновление с помощью командной строки

Агент Linux

Обновление агента в Ubuntu

Обновление агента в Red Hat/CentOS/Oracle Linux/Amazon Linux

Обновление агента в SUSE Linux Enterprise

Автоматическое обновление агента

Переименование ресурса сервера с поддержкой Azure Arc

Удаление агента

Шаг 1. Удаление расширений виртуальной машины

Шаг 2. Отключение сервера от Azure Arc

Шаг 3a. Удаление агента Windows

Удаление из панели управления

Удаление из командной строки

Шаг 3b. Удаление агента Linux

Обновление или удаление параметров прокси-сервера

Конфигурация прокси-сервера для конкретного агента

Обход прокси-сервера для частных конечных точек

Переменные среды Windows

Переменные среды Linux

Миграция из переменных среды в конфигурацию прокси-сервера для конкретного агента

Следующие шаги

Дополнительные ресурсы