You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/azure-monitor/agents/azure-monitor-agent-mma-removal-tool.md
+7-8Lines changed: 7 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ ms.custom:
11
11
---
12
12
# MMA/OMS Discovery and Removal Utility
13
13
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.
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.
15
15
16
16
The utility works in two steps:
17
17
@@ -33,7 +33,7 @@ Do all the setup steps on an Internet connected machine. You need:
33
33
34
34
35
35
## Step 1 Login and set subscription
36
-
The tool works one subscription at a time. You must login and set the subscription to do the removal. Open a PowerShell command prompt as administrator and login.
36
+
The tool works one subscription at a time. You must log in and set the subscription to do the removal. Open a PowerShell command prompt as administrator and login.
37
37
38
38
```PowerShell
39
39
az login
@@ -44,7 +44,7 @@ Next you must set your subscription.
44
44
Az account set --subscription {subscription_id or “subscription_name”}
45
45
```
46
46
## Step 2 Copy the script
47
-
You will use the following script for agent removal. Open a file in your local directory named MMAUnistallUtilityScript.ps1 and copy the script into the file.
47
+
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.
48
48
```PowerShell
49
49
# This is per subscription, the customer has to set the az subscription before running this.
50
50
# az login
@@ -234,22 +234,21 @@ switch ($args.Count)
234
234
```
235
235
236
236
## Step 3 Get inventory
237
-
You must collect a list of all legacy agents, both MMA and OMS, on all VM, VMSS 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.
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
238
```PowerShell
239
239
.\MMAUnistallUtilityScript.ps1 GetInventory
240
240
```
241
-
The script will report the total VM, VMSS, or Arc enables servers seen in the subscription. It will take several minutes to run. You will 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.
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
242
243
243
|Resource_Group | Resource_Type | Name | Install_Type |Extension_Name |
|AMA-ADMIN | VM | test2012-r2-da | Extension | MicrosoftMonitorAgent |
247
247
248
248
## Step 4 Uninstall inventory
249
-
This script iterates through the list of VM, VMSS, and Arc enabled servers and uninstalls the legacy agent. If the VM, VMSS, or Arc enabled server is not running you will not be able to remove the agent.
249
+
This script iterates through the list of VM, Virtual Machine Scale Sets, and Arc enabled servers and uninstalls the legacy agent. If the VM, Virtual Machine Scale Sets, or Arc enabled server is not running you won't be able to remove the agent.
Once the script is complete you will be able to see the removal status for your VM, VMSS and Arc enabled servers in the MMAInventory.csv file.
253
+
Once the script is complete you'll be able to see the removal status for your VM, Virtual Machine Scale Sets, and Arc enabled servers in the MMAInventory.csv file.
0 commit comments