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: defender-endpoint/application-deployment-via-mecm.md
+51-35Lines changed: 51 additions & 35 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,104 +13,120 @@ ms.collection:
13
13
- m365-security
14
14
- tier1
15
15
ms.topic: conceptual
16
-
ms.date: 06/27/2022
16
+
ms.date: 03/14/2025
17
17
---
18
18
19
19
# Migrating servers from Microsoft Monitoring Agent to the unified solution
20
20
21
21
**Applies to:**
22
22
23
-
-Windows Server 2012 R2
24
-
-Windows Server 2016
23
+
-Microsoft Defender for Endpoint for servers
24
+
-Microsoft Defender for Servers Plan 1 or Plan 2
25
25
26
-
This article guides you in migrating down-level servers from Microsoft Monitoring Agent (MMA) to the unified solution.
26
+
This article guides you in migrating servers running Windows Server 2016 or Windows Server 2012 R2 from Microsoft Monitoring Agent (MMA) to the modern, unified solution. In this article, the phrase *down-level servers* refers to older versions of Windows Server, such as Windows Server 2016 and Windows Server 2012 R2.
27
27
28
28
## Prerequisites
29
29
30
-
- Microsoft Endpoint Configuration Manager (MECM) higher than 2207.
30
+
- Microsoft Configuration Manager higher than 2207.
31
31
- Down-level OS devices in your environment onboarded with Microsoft Monitoring Agent. To confirm, verify that `MsSenseS.exe` is running in Task Manager.
32
32
- Presence of the MMA agent. You can verify it by checking if the correct Workspace ID is present in the Control Panel> Microsoft Monitoring Agent.
33
33
- Active Microsoft Defender portal with devices onboarded.
34
-
- A **Device Collection** containing down-level servers such as Windows Server 2012 R2 or Windows Server 2016 using MMA agent is set up in your MECM instance.
34
+
- A **Device Collection** containing down-level servers such as Windows Server 2012 R2 or Windows Server 2016 using MMA agent is set up in your Configuration Manager instance.
35
35
36
-
For more information on installing the listed prerequisites, see [related topics](#related-topics) section.
36
+
For more information on installing the listed prerequisites, see [related articles](#related-articles) section.
37
37
38
38
## Gather required files
39
39
40
-
Copy the unified solution package, onboarding script and migration script to the same content source you deploy other apps with MECM.
40
+
Copy the unified solution package, onboarding script, and migration script to the same content source you deploy other apps with Configuration Manager.
41
+
42
+
1. Download Onboarding Script and the unified solution from [Microsoft Defender portal settings page](https://sip.security.microsoft.com/preferences2/onboarding).
41
43
42
-
1. Download Onboarding Script and the unified solution from [Microsoft Defender XDR settings page](https://sip.security.microsoft.com/preferences2/onboarding).
43
44
:::image type="content" source="media/onboarding-script.png" alt-text="Screenshot of onboarding script and unified solution download" lightbox="media/onboarding-script.png":::
45
+
44
46
> [!Note]
45
47
> You must select the Group Policy from the Deployment method dropdown to obtain the .cmd file.
48
+
46
49
2. Download the migration script from the document: [Server migration scenarios from the previous, MMA-based Microsoft Defender for Endpoint solution](server-migration.md). This script can also be found on GitHub: [GitHub - microsoft/mdefordownlevelserver](https://github.com/microsoft/mdefordownlevelserver).
47
-
3. Save all three files in a shared folder used by MECM as a Software Source.
48
50
49
-
:::image type="content" source="media/ua-migration.png" alt-text="Screenshot of saving the shared folder by MECM.":::
51
+
3. Save all three files in a shared folder used by Configuration Manager as a Software Source.
52
+
53
+
:::image type="content" source="media/ua-migration.png" alt-text="Screenshot of saving the shared folder by Configuration Manager.":::
50
54
51
55
## Create the package as an application
52
56
53
-
1. In the MECM console, follow these steps: **Software Library>Applications>Create Application**.
57
+
1. In the Configuration Manager console, go to **Software Library** > **Applications** > **Create Application**.
58
+
54
59
2. Select **Manually specify the application information**.
55
60
:::image type="content" source="media/manual-application-information.png" alt-text="Screenshot of manually specifying the application information selection." lightbox="media/manual-application-information.png":::
61
+
56
62
3. Select **Next** on the Software Center screen of the wizard.
57
-
4. On the Deployment Types, click **Add**.
63
+
64
+
4. On the Deployment Types, select **Add**.
65
+
58
66
5. Select **Manually to specify the deployment type information** and select **Next**.
67
+
59
68
6. Give a name to your script deployment and select **Next**.
60
69
61
70
:::image type="content" source="media/manual-deployment-information.png" alt-text="Screenshot specifying the script deployment information.":::
62
-
7. On this step, copy the UNC path that your content is located. Example: `\\ServerName\h$\SOFTWARE_SOURCE\path`.
71
+
72
+
7. Copy the UNC path that your content is located. Example: `\\ServerName\h$\SOFTWARE_SOURCE\path`.
63
73
64
74
:::image type="content" source="media/deployment-type-wizard.png" alt-text="Screenshot that shows UNC path copy.":::
65
75
66
-
8.Additionally, set the following as the installation program:
76
+
8.Set the installation program by using the following command:
Check the option: **This registry setting must exit on the target system to indicate presence of this application.**
82
+
Select **Next**, and make sure to add your own Workspace ID in this section.
78
83
79
-
:::image type="content" source="media/detection-wizard.png" alt-text="Screenshot that shows detection type wizard":::
84
+
9. Select **Next**, and then select **add a clause**.
80
85
81
-
> [!TIP]
82
-
> The registry key value was obtained by running the Powershell command shown below on a device that has the unified solution installed. Other creative methods of detection can also be used. The goal is to identify whether the unified solution has already been installed on a specific device. You can leave the Value and Data Type fields as blank.
86
+
10. The detection method is based on this registry key: `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Sense`.
83
87
88
+
Select the option: **This registry setting must exit on the target system to indicate presence of this application.**
89
+
90
+
:::image type="content" source="media/detection-wizard.png" alt-text="Screenshot that shows detection type wizard":::
91
+
92
+
> [!TIP]
93
+
> The registry key value was obtained by running the following PowerShell command on a device that has the unified solution installed. Other creative methods of detection can also be used. The goal is to identify whether the unified solution has already been installed on a specific device. You can leave the Value and Data Type fields as blank.
11. In the **User Experience** section, check the recommended settings shown in the screenshot. You can choose what suits your environment and click **Next**. For **Installation program visibility**, it's advisable to install with **Normal** during phase testing then change it to **Minimized** for general deployment.
99
+
11. In the **User Experience** section, check the recommended settings shown in the screenshot. You can choose what suits your environment, and then select **Next**.
89
100
101
+
For **Installation program visibility**, it's advisable to install with **Normal** during phase testing then change it to **Minimized** for general deployment.
102
+
90
103
> [!TIP]
91
104
> The maximum allowed runtime can be lowered from (default) 120 minutes to 60 minutes.
105
+
106
+
:::image type="content" source="media/user-experience-in-deployment-type-wizard.png" alt-text="Screenshot that shows user experience in deployment-type wizard." lightbox="media/user-experience-in-deployment-type-wizard.png":::
92
107
93
-
:::image type="content" source="media/user-experience-in-deployment-type-wizard.png" alt-text="Screenshot that shows user experience in deployment-type wizard.":::
108
+
12. Add any additional requirements, and then select **Next**.
94
109
95
-
12. Add any additional requirements then select **Next**.
96
110
13. Under the Dependencies section, select **Next**.
97
-
14. Select **Next** until completion screen comes up, then **Close**.
98
-
15. Keep select **Next** until the completion of Application Wizard. Verify all have been green checked.
111
+
112
+
14. Select **Next** until completion screen comes up, and then select **Close**.
113
+
114
+
15. Keep selecting **Next** until the completion of Application Wizard. Verify all have been green checked.
115
+
99
116
16. Close the wizard, right-click on the recently created application and deploy it to your down-level-server collection. Locally, the installation can be confirmed at Software Center. For details, check the CM logs at `C:\Windows\CCM\Logs\AppEnforce.log`.
100
117
101
118
:::image type="content" source="media/deploy-application.png" alt-text="Screenshot that shows deployment of created application." lightbox="media/deploy-application.png":::
102
119
103
-
17. Verify the status of the migration at MECM > Monitoring > Deployments.
120
+
17. Verify the status of the migration in Configuration Manager by going to **Monitoring** > **Deployments**.
104
121
105
-
:::image type="content" source="media/deployment-status.png" alt-text="Screenshot that shows deployment status check." lightbox="media/deployment-status.png":::
122
+
18. Troubleshooting .ETL files are created and automatically saved locally in each server at this location `C:\Windows\ccmcache\#\`. These files can be leveraged by support to troubleshoot onboarding issues.
106
123
107
-
18. Troubleshooting .ETL files will be created and automatically saved locally in each server at this location `C:\Windows\ccmcache\#\`. These files can be leveraged by support to troubleshoot onboarding issues.
- [Microsoft Defender for Endpoint - Configuration Manager](/mem/configmgr/protect/deploy-use/defender-advanced-threat-protection)
114
129
- [Onboard Windows servers to the Microsoft Defender for Endpoint service](configure-server-endpoints.md)
115
130
- [Microsoft Defender for Endpoint: Defending Windows Server 2012 R2 and 2016](https://techcommunity.microsoft.com/t5/microsoft-defender-for-endpoint/defending-windows-server-2012-r2-and-2016/ba-p/2783292)
131
+
116
132
[!INCLUDE [Microsoft Defender for Endpoint Tech Community](../includes/defender-mde-techcommunity.md)]
Copy file name to clipboardExpand all lines: defender-endpoint/comprehensive-guidance-on-linux-deployment.md
+13-8Lines changed: 13 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,6 +19,11 @@ ms.date: 12/10/2024
19
19
20
20
# Advanced deployment guidance for Microsoft Defender for Endpoint on Linux
21
21
22
+
**Applies to:**
23
+
24
+
- Microsoft Defender for Endpoint for servers
25
+
- Microsoft Defender for Servers Plan 1 or Plan 2
26
+
22
27
> [!TIP]
23
28
> We are excited to share that Microsoft Defender for Endpoint on Linux now extends support for ARM64-based Linux servers in preview! For more information, see [Microsoft Defender for Endpoint on Linux for ARM64-based devices (preview)](mde-linux-arm.md).
24
29
@@ -176,7 +181,7 @@ This step of the setup process involves adding Defender for Endpoint to the excl
176
181
177
182
:::image type="content" source="media/mdatp-health-result.png" alt-text="Image of mdatp health result":::
178
183
179
-
Under "conflicting_applications", if you see a result other than "unavailable", uninstall the non-Microsoft antimalware.
184
+
Under "conflicting_applications", if you see a result other than "unavailable," uninstall the non-Microsoft antimalware.
180
185
181
186
- If you don't uninstall the non-Microsoft antimalware product, you might encounter unexpected behaviors such as performance issues, stability issues such as systems hanging, or kernel panics.
182
187
@@ -456,13 +461,13 @@ To verify Microsoft Defender for Endpoint on Linux platform updates, run the fol
456
461
sudo yum update mdatp
457
462
```
458
463
459
-
or
464
+
Or
460
465
461
466
```bash
462
467
apt-get update mdatp
463
468
```
464
469
465
-
depending on your package manager.
470
+
Depending on your package manager.
466
471
467
472
For more information, see [Device health and Microsoft Defender antimalware health report](https://techcommunity.microsoft.com/t5/microsoft-defender-for-endpoint/new-device-health-reporting-for-microsoft-defender-for-endpoint/bc-p/3616205#M1963).
468
473
@@ -483,7 +488,7 @@ Microsoft regularly publishes software updates to improve performance, security,
483
488
With macOS and Linux, you could take a couple of systems and run in the Beta channel.
484
489
485
490
> [!NOTE]
486
-
> Ideally you should include one of each type of Linux system you are running in the Preview channel so that you are able to find compatibility, performance and reliability issues before the build makes it into the Current channel.
491
+
> Ideally you should include one of each type of Linux system you're running in the Preview channel so that you're able to find compatibility, performance, and reliability issues before the build makes it into the Current channel.
487
492
488
493
The choice of the channel determines the type and frequency of updates that are offered to your device. Devices in Beta are the first ones to receive updates and new features, followed later by Preview and lastly by Current.
489
494
@@ -492,7 +497,7 @@ The choice of the channel determines the type and frequency of updates that are
492
497
In order to preview new features and provide early feedback, it's recommended that you configure some devices in your enterprise to use either Beta or Preview.
493
498
494
499
> [!WARNING]
495
-
> Switching the channel after the initial installation requires the product to be reinstalled. To switch the product channel: uninstall the existing package, re-configure your device to use the new channel, and follow the steps in this document to install the package from the new location.
500
+
> Switching the channel after the initial installation requires the product to be reinstalled. To switch the product channel: uninstall the existing package, reconfigure your device to use the new channel, and follow the steps in this document to install the package from the new location.
496
501
497
502
## 18. Verify that you're able to get security intelligence updates (signatures/definition updates)
498
503
@@ -512,15 +517,15 @@ To ensure that the device is correctly onboarded and reported to the service, ru
> If the detections do not show up, it could be that you have set "allowedThreats" to allow in preferences via Ansible or Puppet.
528
+
> If the detections don't show up, it could be that you have set "allowedThreats" to allow in preferences via Ansible or Puppet.
524
529
525
530
- Endpoint detection and response (EDR) detections, see [Experience Microsoft Defender for Endpoint through simulated attacks](attack-simulations.md). If the detection doesn't show up, then it could be that we're missing event or alerts in portal. For more information, see [Troubleshoot missing events or alerts issues for Microsoft Defender for Endpoint on Linux](linux-support-events.md).
526
531
@@ -612,7 +617,7 @@ Then your next step is to uninstall your non-Microsoft antivirus, antimalware, a
612
617
-[Boost protection of Linux estate with behavior monitoring](https://techcommunity.microsoft.com/t5/microsoft-defender-for-endpoint/boost-protection-of-your-linux-estate-with-behavior-monitoring/ba-p/2909320)
613
618
614
619
> [!NOTE]
615
-
> The behavior monitoring functionality complements existing strong content-based capabilities, however you should carefully evaluate this feature in your environment before deploying it broadly since enabling behavioral monitoring consumes more resources and may cause performance issues.
620
+
> The behavior monitoring functionality complements existing strong content-based capabilities. However you should carefully evaluate this feature in your environment before deploying it broadly since enabling behavioral monitoring consumes more resources and may cause performance issues.
616
621
617
622
-[Unified submissions in Microsoft Defender XDR](https://techcommunity.microsoft.com/t5/microsoft-defender-for-endpoint/unified-submissions-in-microsoft-365-defender-now-generally/ba-p/3270770)
0 commit comments