Narzędzie do odnajdywania i usuwania MMA

  • Artykuł

Po przeprowadzeniu migracji maszyn do agenta usługi Azure Monitor (AMA) należy usunąć agenta usługi Log Analytics (nazywanego również programem Microsoft Management Agent lub MMA), aby uniknąć duplikowania dzienników. Narzędzie do odnajdywania i usuwania mma rozwiązania zabezpieczeń dzierżawy platformy Azure (AzTS) może centralnie usunąć rozszerzenie MMA z maszyn wirtualnych platformy Azure, zestawów skalowania maszyn wirtualnych platformy Azure i serwerów usługi Azure Arc z dzierżawy.

Uwaga

To narzędzie służy do odnajdywania i usuwania rozszerzeń MMA. Nie spowoduje to usunięcia rozszerzeń pakietu OMS. Usługa OMS będzie musiała zostać usunięta ręcznie, uruchamiając skrypt przeczyszczania tutaj: Przeczyszczanie agenta systemu Linux

Narzędzie działa w dwóch krokach:

  1. Odnajdywanie: narzędzie tworzy spis wszystkich maszyn, na których zainstalowano mma. Zalecamy, aby nie tworzyć żadnych nowych maszyn wirtualnych, zestawów skalowania maszyn wirtualnych ani serwerów usługi Azure Arc z rozszerzeniem MMA, gdy narzędzie jest uruchomione.

  2. Usunięcie: narzędzie wybiera maszyny, które mają zarówno MMA, jak i AMA, i usuwa rozszerzenie MMA. Możesz wyłączyć ten krok i uruchomić go po zweryfikowaniu listy maszyn. Istnieje możliwość usunięcia rozszerzenia z maszyn, które mają tylko mma, ale zalecamy najpierw zmigrowanie wszystkich zależności do usługi AMA, a następnie usunięcie mma.

Wymagania wstępne

Wykonaj wszystkie kroki konfiguracji w programie Visual Studio Code z rozszerzeniem programu PowerShell. Należy wykonać:

  • Windows 10 lub nowszy albo Windows Server 2019 lub nowszy.
  • Program PowerShell w wersji 5.0 lub nowszej. Sprawdź wersję, uruchamiając polecenie $PSVersionTable.
  • Program PowerShell. Język musi być ustawiony na FullLanguage tryb. Sprawdź tryb, uruchamiając polecenie $ExecutionContext.SessionState.LanguageMode w programie PowerShell. Aby uzyskać więcej informacji, zobacz dokumentację programu PowerShell.
  • Bicep. Skrypty konfiguracji używają narzędzia Bicep do zautomatyzowania instalacji. Sprawdź instalację, uruchamiając polecenie bicep --version. Aby uzyskać więcej informacji, zobacz Instalowanie narzędzi Bicep.
  • Tożsamość zarządzana przypisana przez użytkownika, która ma dostęp czytelnika, współautora maszyny wirtualnej i współautora maszyny wirtualnej usługi Azure Arc scVmm w zakresach docelowych.
  • Nowa grupa zasobów zawierająca wszystkie zasoby platformy Azure tworzone automatycznie przez automatyzację konfiguracji.
  • Odpowiednie uprawnienie do skonfigurowanych zakresów. Aby udzielić tożsamości zarządzanej przypisanej przez użytkownika korygowania z wcześniej wymienionymi rolami w zakresach docelowych, musisz mieć uprawnienia Administracja istrator lub właściciel dostępu użytkowników. Jeśli na przykład konfigurujesz konfigurację dla określonej subskrypcji, musisz mieć przypisanie roli Administracja istratora dostępu użytkowników w tej subskrypcji, aby skrypt mógł zapewnić uprawnienia do tożsamości zarządzanej przypisanej przez użytkownika korygowania.

Pobieranie pakietu wdrożeniowego

Pakiet wdrożeniowy zawiera:

  • Szablony Bicep, które zawierają szczegóły konfiguracji zasobów tworzone w ramach konfiguracji.
  • Skrypty konfiguracji wdrożenia, które udostępniają polecenie cmdlet do uruchomienia instalacji.

Aby zainstalować pakiet:

  1. Przejdź do repozytorium GitHub AzTS-docs. Pobierz plik pakietu wdrożeniowego AzTSMMARemovalUtilityDeploymentFiles.zip na komputer lokalny.

  2. Wyodrębnij plik .zip do lokalizacji folderu lokalnego.

  3. Odblokuj pliki przy użyciu tego skryptu:

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

Konfigurowanie narzędzia

  1. Przejdź do folderu wdrożenia i załaduj skonsolidowany skrypt konfiguracji. Musisz mieć dostęp właściciela do subskrypcji.

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

  2. Zaloguj się do konta platformy Azure przy użyciu następującego polecenia programu PowerShell:

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

  3. Uruchom skrypt instalacyjny, aby wykonać następujące operacje:

    • Zainstaluj wymagane moduły Az.
    • Skonfiguruj tożsamość zarządzaną przypisaną przez użytkownika do korygowania.
    • Monituj i zbieraj szczegóły dołączania dla kolekcji telemetrii użycia na podstawie preferencji użytkownika.
    • Utwórz lub zaktualizuj grupę zasobów.
    • Utwórz lub zaktualizuj zasoby przy użyciu przypisanych tożsamości zarządzanych.
    • Utwórz lub zaktualizuj pulpit nawigacyjny monitorowania.
    • Konfigurowanie zakresów docelowych.
    $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>

    Skrypt zawiera następujące parametry:

    Nazwa parametru opis Wymagania
    RemediationIdentityHostSubId Identyfikator subskrypcji do tworzenia zasobów korygowania. Tak
    RemediationIdentityHostRGName Nowa nazwa grupy zasobów w celu utworzenia korygowania. Wartość domyślna to AzTS-MMARemovalUtility-RG. Nie.
    RemediationIdentityName Nazwa tożsamości zarządzanej korygowania. Tak
    TargetSubscriptionIds Lista docelowych identyfikatorów subskrypcji do uruchomienia. Nie.
    TargetManagementGroupNames Lista docelowych nazw grup zarządzania do uruchomienia. Nie.
    TenantScope Zakres dzierżawy do przypisywania ról za pośrednictwem identyfikatora dzierżawy. Nie.
    SubscriptionId Identyfikator subskrypcji, w której zainstalowano instalatora. Tak
    HostRGName Nazwa nowej grupy zasobów, w której jest tworzona tożsamość zarządzana korygowania. Wartość domyślna to AzTS-MMARemovalUtility-Host-RG. Nie.
    Location Kontroler domeny lokalizacji, na którym jest tworzona konfiguracja. Wartość domyślna to EastUS2. Nie.
    AzureEnvironmentName Środowisko platformy Azure, w którym zainstalowano rozwiązanie: AzureCloud lub AzureGovernmentCloud. Wartość domyślna to AzureCloud. Nie.

Uruchamianie narzędzia

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

Skrypt zawiera następujące parametry:

Nazwa parametru opis Wymagania
SubscriptionId Identyfikator subskrypcji, w której zainstalowano narzędzie. Tak
ResourceGroupName Nazwa grupy zasobów, w której zainstalowano narzędzie. Tak
StartScopeResolverAfterMinutes Czas ( w minutach) poczekaj przed uruchomieniem narzędzia rozpoznawania. Tak (wzajemnie wykluczające się z -StartScopeResolverImmediately)
StartScopeResolverImmediately Wskaźnik, aby natychmiast uruchomić program rozpoznawania nazw. Tak (wzajemnie wykluczające się z -StartScopeResolverAfterMinutes)
StartExtensionDiscoveryAfterMinutes Czas w minutach, aby poczekać na uruchomienie odnajdywania (powinien być po zakończeniu rozpoznawania). Tak (wzajemnie wykluczające się z -StartExtensionDiscoveryImmediatley)
StartExtensionDiscoveryImmediatley Wskaźnik uruchamiania odnajdywania rozszerzeń natychmiast. Tak (wzajemnie wykluczające się z -StartExtensionDiscoveryAfterMinutes)