Skip to content

Commit 3e85e7c

Browse files
Merge pull request #5 from JeffreyWolford/JeffreyWolford-patch-2
Update azure-monitor-agent-mma-removal-tool.md
2 parents 36e9a6b + fcf5511 commit 3e85e7c

File tree

1 file changed

+8
-7
lines changed

1 file changed

+8
-7
lines changed

articles/azure-monitor/agents/azure-monitor-agent-mma-removal-tool.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,24 +11,24 @@ ms.custom:
1111
---
1212
# MMA/OMS Discovery and Removal Utility
1313

14-
After you migrate your machines to the Azure Monitor Agent (AMA), remove the legacy Log Analytics Agent, MMA or OMS depending on your operating systems, to avoid duplication of logs. The legacy Discovery and Removal Utility can remove the extensions from Azure Virtual Machines (VMs), Azure Virtual Machine Scale Sets, and Azure Arc servers from a single subscription.
14+
After you migrate your machines to the Azure Monitor Agent (AMA), remove the legacy Log Analytics Agent, MMA, or OMS depending on your operating systems, to avoid duplication of logs. The legacy Discovery and Removal Utility can remove the extensions from Azure Virtual Machines (VMs), Azure Virtual Machine Scale Sets (VMSSs), and Azure Arc servers from a single subscription.
1515

1616
The utility works in two steps:
1717

18-
1. *Discovery*: The utility creates an inventory of all machines that have a legacy agent installed in a simple CSV file. We recommend that you don't create any new VMs, virtual machine scale sets, or Azure Arc servers with the legacy agent extension while the utility is running.
18+
1. *Discovery*: The utility creates an inventory of all machines that have a legacy agent installed in a simple CSV file. We recommend that you don't create any new VMs while the utility is running.
1919

2020
2. *Removal*: The utility removes the legacy agent from machines listed in the CSV file. You should edit the list of machine in the CSV file to ensure that only machines you want the agent removed from are present.
2121

2222
## Prerequisites
2323
Do all the setup steps on an Internet connected machine. You need:
2424

2525
- Windows 10 or later, or Windows Server 2019 or later.
26-
- [PowerShell 7.0 or later.](/powershell/scripting/install/installing-powershell?view=powershell-7.4&preserve-view=true) This allows for parallel execution that speeds the process up.
26+
- [PowerShell 7.0 or later.](/powershell/scripting/install/installing-powershell?view=powershell-7.4&preserve-view=true), which enables parallel execution that speeds the process up.
2727
- Azcli must be installed to communicate with the [Azure Graph API.](/cli/azure/install-azure-cli-windows?tabs=azure-cli).
2828
1. Open PowerShell as administrator:
2929
2. Run the command: `Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile AzureCLI.msi`.
3030
3. Run the command: `Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'`.
31-
4. The latest version of Azure CLI will be downloaded and installed.
31+
4. The latest version of Azure CLI will download and install.
3232
- A [user-assigned managed identity](/azure/active-directory/managed-identities-azure-resources/overview) that has**User Access Administrator**, **Reader**, **Virtual Machine Contributor**, and **Azure Arc ScVmm VM Contributor** access on the target scopes.
3333

3434

@@ -44,9 +44,10 @@ Next you must set your subscription.
4444
Az account set --subscription {subscription_id or “subscription_name”}
4545
```
4646
## Step 2 Copy the script
47+
4748
You'll use the following script for agent removal. Open a file in your local directory named MMAUnistallUtilityScript.ps1 and copy the script into the file.
4849
``` PowerShell
49-
# This is per subscription, the customer has to set the az subscription before running this.
50+
# This is per subscription, the customer has to set the az subscription before running this.
5051
# az login
5152
# az account set --subscription <subscription_id/subscription_name>
5253
# This script uses parallel processing, modify the $parallelThrottleLimit parameter to either increase or decrease the number of parallel processes
@@ -234,11 +235,11 @@ switch ($args.Count)
234235
```
235236

236237
## Step 3 Get inventory
237-
You must collect a list of all legacy agents, both MMA and OMS, on all VM, Virtual Machine Scale Sets, and Arc enabled server in the subscription. Run the script you downloaded to your file to product and inventory of legacy agents in your subscription.
238+
You'll collect a list of all legacy agents, both MMA and OMS, on all VM, VMSSs and Arc enabled server in the subscription. You'll run the script you downloaded an inventory of legacy agents in your subscription.
238239
``` PowerShell
239240
.\MMAUnistallUtilityScript.ps1 GetInventory
240241
```
241-
The script will report the total VM, Virtual Machine Scale Sets, or Arc enables servers seen in the subscription. It will take several minutes to run. You'll see a progress bar in the console window. Once complete there will be a CSV file called MMAInventory.csv in the local directory with the following format.
242+
The script reports the total VM, VMSSs, or Arc enables servers seen in the subscription. It takes several minutes to run. You see a progress bar in the console window. Once complete, you are able to see a CSV file called MMAInventory.csv in the local directory with the following format.
242243

243244
|Resource_Group | Resource_Type | Name | Install_Type |Extension_Name |
244245
|---|---|---|---|---|

0 commit comments

Comments
 (0)