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:
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.
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:
Ga naar de GitHub-opslagplaats azTS-docs. Download het implementatiepakketbestand, AzTSMMARemovalUtilityDeploymentFiles.zip, naar uw lokale computer.
Pak het .zip-bestand uit naar de locatie van de lokale map.
De blokkering van de bestanden opheffen met behulp van dit script:
Get-ChildItem -Path "<Extracted folder path>" -Recurse | Unblock-File
Het hulpprogramma instellen
Ga naar de implementatiemap en laad het geconsolideerde installatiescript. U moet eigenaarstoegang hebben voor het abonnement.
CD "<LocalExtractedFolderPath>\AzTSMMARemovalUtilityDeploymentFiles" . ".\MMARemovalUtilityConsolidatedSetup.ps1"
Meld u aan bij het Azure-account met behulp van de volgende PowerShell-opdracht:
$TenantId = "<TenantId>" Connect-AzAccount -Tenant $TenantId
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
ofAzureGovernmentCloud
. De standaardwaarde isAzureCloud
.Nee
Het hulpprogramma uitvoeren
- Discovery (Detectie)
- Verwijdering
- Cleanup
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 ) |