Share via

Служебная программа обнаружения и удаления MMA

  • Статья

После переноса компьютеров в агент Azure Monitor (AMA) необходимо удалить агент Log Analytics (также называемый microsoft Management Agent или MMA), чтобы избежать дублирования журналов. Служебная программа обнаружения и удаления MMA решения azure (AzTS) для обеспечения безопасности клиента (AzTS) может централизованно удалить расширение MMA из виртуальных машин Azure, масштабируемых наборов виртуальных машин Azure и серверов Azure Arc из клиента.

Примечание.

Эта программа используется для обнаружения и удаления расширений MMA. Это не приведет к удалению расширений OMS, OMS необходимо удалить вручную, выполнив сценарий очистки здесь: очистка агента Linux

Служебная программа работает двумя шагами:

  1. Обнаружение: служебная программа создает инвентаризацию всех компьютеров, на которых установлена MMA. Рекомендуется не создавать новые виртуальные машины, масштабируемые наборы виртуальных машин или серверы Azure Arc с расширением MMA во время выполнения программы.

  2. Удаление: служебная программа выбирает компьютеры, имеющие как MMA, так и AMA, и удаляет расширение MMA. Этот шаг можно отключить и запустить после проверки списка компьютеров. Существует возможность удалить расширение с компьютеров, имеющих только MMA, но мы рекомендуем сначала перенести все зависимости в AMA, а затем удалить MMA.

Необходимые компоненты

Выполните все действия по настройке в Visual Studio Code с расширением PowerShell. Необходимые компоненты:

  • Windows 10 или более поздней версии или Windows Server 2019 или более поздней версии.
  • PowerShell 5.0 или более поздней версии. Проверьте версию, выполнив команду $PSVersionTable.
  • PowerShell. Язык должен быть задан в FullLanguage режиме. Проверьте режим, выполнив в $ExecutionContext.SessionState.LanguageMode PowerShell. Дополнительные сведения см. в справочнике по PowerShell.
  • Bicep Скрипты установки используют Bicep для автоматизации установки. Проверьте установку, выполнив команду bicep --version. Дополнительные сведения см. в статье Установка средств Bicep.
  • Назначаемое пользователем управляемое удостоверение с доступом читателя, участника виртуальной машины и участника виртуальной машины Azure Arc ScVmm на целевых область.
  • Новая группа ресурсов, которая будет содержать все ресурсы Azure, создаваемые автоматизацией установки автоматически.
  • Соответствующее разрешение для настроенных область. Чтобы предоставить управляемое удостоверение, назначаемое пользователем, с ранее упоминание ролями в целевых область, необходимо иметь разрешение Администратор доступа пользователей или владельца. Например, если вы настраиваете настройку для определенной подписки, необходимо указать назначение роли пользователя Администратор istrator в этой подписке, чтобы скрипт смог предоставить разрешения для управляемого удостоверения, назначаемого пользователем.

Скачивание пакета развертывания

Пакет развертывания содержит следующее:

  • Шаблоны Bicep, содержащие сведения о конфигурации ресурсов, которые создаются в процессе установки.
  • Скрипты установки развертывания, которые предоставляют командлет для запуска установки.

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

  1. Перейдите в репозиторий GitHub AzTS-docs. Скачайте файл пакета развертывания AzTSMMARemovalUtilityDeploymentFiles.zip на локальный компьютер.

  2. Извлеките файл .zip в расположение локальной папки.

  3. Разблокируйте файлы с помощью этого скрипта:

    Get-ChildItem -Path "<Extracted folder path>" -Recurse | Unblock-File

Настройка служебной программы

  1. Перейдите в папку развертывания и загрузите консолидированный скрипт установки. У вас должен быть доступ владельца к подписке.

    CD "<LocalExtractedFolderPath>\AzTSMMARemovalUtilityDeploymentFiles"
. ".\MMARemovalUtilityConsolidatedSetup.ps1"

  2. Войдите в учетную запись Azure с помощью следующей команды PowerShell:

    $TenantId = "<TenantId>"
Connect-AzAccount -Tenant $TenantId

  3. Запустите скрипт установки, чтобы выполнить следующие операции:

    • Установите необходимые модули Az.
    • Настройте управляемое удостоверение, назначаемое пользователем.
    • Запрос и сбор сведений о подключении для сбора данных телеметрии использования на основе предпочтений пользователя.
    • Создайте или обновите группу ресурсов.
    • Создайте или обновите ресурсы с назначенными управляемыми удостоверениями.
    • Создайте или обновите панель мониторинга.
    • Настройте целевые область.
    $SetupInstallation = Install-AzTSMMARemovalUtilitySolutionConsolidated `
         -RemediationIdentityHostSubId <MIHostingSubId> `
         -RemediationIdentityHostRGName <MIHostingRGName> `
         -RemediationIdentityName <MIName> `
         -TargetSubscriptionIds @("<SubId1>","<SubId2>","<SubId3>") `
         -TargetManagementGroupNames @("<MGName1>","<MGName2>","<MGName3>") `
         -TenantScope `
         -SubscriptionId <HostingSubId> `
         -HostRGName <HostingRGName> `
         -Location <Location> `
         -AzureEnvironmentName <AzureEnvironmentName>

    Скрипт содержит следующие параметры:

    Наименование параметра Description Обязательное поле
    RemediationIdentityHostSubId Идентификатор подписки для создания ресурсов исправления. Да
    RemediationIdentityHostRGName Новое имя группы ресурсов для создания исправления. По умолчанию — AzTS-MMARemovalUtility-RG. No
    RemediationIdentityName Имя управляемого удостоверения исправления. Да
    TargetSubscriptionIds Список идентификаторов целевых подписок для запуска. No
    TargetManagementGroupNames Список имен целевых групп управления для запуска. No
    TenantScope Область клиента для назначения ролей с помощью идентификатора клиента. No
    SubscriptionId Идентификатор подписки, в которой установлена программа установки. Да
    HostRGName Имя новой группы ресурсов, в которой создается управляемое удостоверение исправления. Значение по умолчанию: AzTS-MMARemovalUtility-Host-RG. No
    Location Контроллер домена расположения, в котором создается настройка. Значение по умолчанию: EastUS2. No
    AzureEnvironmentName Среда Azure, в которой установлено решение: AzureCloud или AzureGovernmentCloud. Значение по умолчанию: AzureCloud. No

Запуск служебной программы

Update-AzTSMMARemovalUtilityDiscoveryTrigger ` 
    -SubscriptionId <HostingSubId> `
    -ResourceGroupName <HostingRGName> `
    -StartScopeResolverAfterMinutes 60 `
    -StartExtensionDiscoveryAfterMinutes 30

Скрипт содержит следующие параметры:

Наименование параметра Description Обязательное поле
SubscriptionId Идентификатор подписки, в которой установлена программа. Да
ResourceGroupName Имя группы ресурсов, в которой установлена программа. Да
StartScopeResolverAfterMinutes Время в минутах, чтобы ждать перед запуском сопоставителя. Да (взаимоисключающ с -StartScopeResolverImmediately)
StartScopeResolverImmediately Индикатор для немедленного запуска сопоставителя. Да (взаимоисключающ с -StartScopeResolverAfterMinutes)
StartExtensionDiscoveryAfterMinutes Время( в минутах) для ожидания выполнения обнаружения (должно быть после завершения разрешения). Да (взаимоисключающ с -StartExtensionDiscoveryImmediatley)
StartExtensionDiscoveryImmediatley Индикатор немедленного запуска обнаружения расширений. Да (взаимоисключающ с -StartExtensionDiscoveryAfterMinutes)