Share via


Hulpprogramma voor detectie en verwijdering van MMA

Nadat u uw machines naar de AMA (Azure Monitor Agent) hebt gemigreerd, moet u de Log Analytics-agent (ook wel de Microsoft Management Agent of MMA genoemd) verwijderen om duplicatie van logboeken te voorkomen. De MMA Discovery and Removal Utility (Azure Tenant Security Solution) (AzTS) kan de MMA-extensie centraal verwijderen uit virtuele Azure-machines (VM's), virtuele-machineschaalsets van Azure en Azure Arc-servers uit een tenant.

Notitie

Dit hulpprogramma wordt gebruikt om MMA-extensies te detecteren en te verwijderen. Hiermee worden OMS-extensies niet verwijderd. OMS moet handmatig worden verwijderd door het opschoningsscript hier uit te voeren: De Linux-agent opschonen

Het hulpprogramma werkt in twee stappen:

  1. Detectie: Het hulpprogramma maakt een inventaris van alle computers waarop de MMA is geïnstalleerd. U wordt aangeraden geen nieuwe VM's, virtuele-machineschaalsets of Azure Arc-servers te maken met de MMA-extensie terwijl het hulpprogramma wordt uitgevoerd.

  2. Verwijderen: Het hulpprogramma selecteert machines met zowel de MMA als de AMA en verwijdert de MMA-extensie. U kunt deze stap uitschakelen en uitvoeren nadat u de lijst met computers hebt gevalideerd. Er is een optie om de extensie te verwijderen van computers met alleen de MMA, maar we raden u aan eerst alle afhankelijkheden naar de AMA te migreren en vervolgens de MMA te verwijderen.

Vereisten

Voer alle installatiestappen in Visual Studio Code uit met de PowerShell-extensie. U hebt het volgende nodig:

  • Windows 10 of hoger, of Windows Server 2019 of hoger.
  • PowerShell 5.0 of hoger. Controleer de versie door $PSVersionTable uit te voeren.
  • PowerShell. De taal moet worden ingesteld op FullLanguage de modus. Controleer de modus door in PowerShell uit te voeren $ExecutionContext.SessionState.LanguageMode . Zie de PowerShell-verwijzing voor meer informatie.
  • Bicep. De installatiescripts maken gebruik van Bicep om de installatie te automatiseren. Controleer de installatie door uit te voeren bicep --version. Zie Bicep-hulpprogramma's installeren voor meer informatie.
  • Een door de gebruiker toegewezen beheerde identiteit met inzender voor lezer, inzender voor virtuele machines en Toegang tot inzenders voor Azure Arc ScVmm-VM's voor doelbereiken.
  • Een nieuwe resourcegroep die alle Azure-resources bevat die automatisch door de installatieautomatisering worden gemaakt.
  • De juiste machtiging voor de geconfigureerde bereiken. Als u de door de gebruiker toegewezen beheerde identiteit met de eerder genoemde rollen in de doelbereiken wilt verlenen, moet u beschikken over de machtiging Gebruikerstoegang Beheer istrator of Eigenaar. Als u bijvoorbeeld de installatie voor een bepaald abonnement configureert, moet u de roltoewijzing gebruikerstoegang Beheer istrator voor dat abonnement hebben, zodat het script de machtigingen voor de door de gebruiker toegewezen beheerde identiteit kan opgeven.

Het implementatiepakket downloaden

Het implementatiepakket bevat:

  • Bicep-sjablonen, die resourceconfiguratiegegevens bevatten die u maakt als onderdeel van de installatie.
  • Implementatie-installatiescripts, die de cmdlet bieden om de installatie uit te voeren.

Het pakket installeren:

  1. Ga naar de GitHub-opslagplaats azTS-docs. Download het implementatiepakketbestand, AzTSMMARemovalUtilityDeploymentFiles.zip, naar uw lokale computer.

  2. Pak het .zip-bestand uit naar de locatie van de lokale map.

  3. De blokkering van de bestanden opheffen met behulp van dit script:

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

Het hulpprogramma instellen

  1. Ga naar de implementatiemap en laad het geconsolideerde installatiescript. U moet eigenaarstoegang hebben voor het abonnement.

    CD "<LocalExtractedFolderPath>\AzTSMMARemovalUtilityDeploymentFiles"
    . ".\MMARemovalUtilityConsolidatedSetup.ps1"
    
  2. Meld u aan bij het Azure-account met behulp van de volgende PowerShell-opdracht:

    $TenantId = "<TenantId>"
    Connect-AzAccount -Tenant $TenantId
    
  3. Voer het installatiescript uit om de volgende bewerkingen uit te voeren:

    • Installeer de vereiste Az-modules.
    • Stel de door de gebruiker toegewezen beheerde identiteit voor herstel in.
    • Vragen en verzamelen van onboardingdetails voor het verzamelen van gebruikstelemetrie op basis van gebruikersvoorkeur.
    • Maak of werk de resourcegroep bij.
    • Maak of werk de resources bij met toegewezen beheerde identiteiten.
    • Het bewakingsdashboard maken of bijwerken.
    • Doelbereiken configureren.
    $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>
    

    Het script bevat de volgende parameters:

    Parameternaam Beschrijving Vereist
    RemediationIdentityHostSubId Abonnements-id voor het maken van herstelresources. Ja
    RemediationIdentityHostRGName Nieuwe resourcegroepnaam voor het maken van herstel. Standaard ingesteld op AzTS-MMARemovalUtility-RG. Nee
    RemediationIdentityName Naam van de beheerde identiteit voor herstel. Ja
    TargetSubscriptionIds Lijst met doelabonnement-id's waarop moet worden uitgevoerd. Nee
    TargetManagementGroupNames Lijst met namen van doelbeheergroepen waarop moet worden uitgevoerd. Nee
    TenantScope Tenantbereik voor het toewijzen van rollen via uw tenant-id. Nee
    SubscriptionId Id van het abonnement waarop de installatie is geïnstalleerd. Ja
    HostRGName Naam van de nieuwe resourcegroep waarin de beheerde identiteit voor herstel wordt gemaakt. De standaardwaarde is AzTS-MMARemovalUtility-Host-RG. Nee
    Location Locatiedomeincontroller waar de installatie wordt gemaakt. De standaardwaarde is EastUS2. Nee
    AzureEnvironmentName Azure-omgeving waarin de oplossing is geïnstalleerd: AzureCloud of AzureGovernmentCloud. De standaardwaarde is AzureCloud. Nee

Het hulpprogramma uitvoeren

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

Het script bevat de volgende parameters:

Parameternaam Beschrijving Vereist
SubscriptionId Id van het abonnement waarop u het hulpprogramma hebt geïnstalleerd. Ja
ResourceGroupName Naam van de resourcegroep waarop u het hulpprogramma hebt geïnstalleerd. Ja
StartScopeResolverAfterMinutes Tijd, in minuten, om te wachten voordat de resolver wordt uitgevoerd. Ja (wederzijds exclusief met -StartScopeResolverImmediately)
StartScopeResolverImmediately Indicator om de resolver onmiddellijk uit te voeren. Ja (wederzijds exclusief met -StartScopeResolverAfterMinutes)
StartExtensionDiscoveryAfterMinutes Tijd, in minuten, om te wachten totdat detectie wordt uitgevoerd (moet zijn nadat de resolver is voltooid). Ja (wederzijds exclusief met -StartExtensionDiscoveryImmediatley)
StartExtensionDiscoveryImmediatley Indicator om extensiedetectie onmiddellijk uit te voeren. Ja (wederzijds exclusief met -StartExtensionDiscoveryAfterMinutes)