Study guide

14.1 Onboarding Devices to Defender for Endpoint

Microsoft 365 Administrator Expert MS-102

Track your progress as you read

Finished sections get a check mark.

1 Introduction & Exam Overview

1.1 MS-102 Exam Facts & Blueprint 1.2 Registration, Retake & Renewal 1.3 Study Strategy & Using This Guide

2 Tenant Setup, Domains & Org Settings

2.1 Creating a Microsoft 365 Tenant 2.2 Implementing and Managing Domains 2.3 Configuring Org Settings: Security, Privacy & Profile

3 Service Health, Network & Software Updates

3.1 Monitoring Service Health & Notifications 3.2 Network Connectivity Insights 3.3 Configuring & Monitoring Software Updates

4 Adoption, Usage & Microsoft 365 Backup

4.1 Monitoring Adoption & Usage 4.2 Configuring & Managing Microsoft 365 Backup

5 Users, Contacts, Groups & Shared Mailboxes

5.1 Creating & Managing Users Including External Users 5.2 Creating & Managing Contacts 5.3 Managing Microsoft 365 Groups & Shared Mailboxes

6 Licensing & Bulk User Management

6.1 Managing & Monitoring Microsoft 365 Licenses 6.2 Bulk User Management with Graph & Entra PowerShell

7 Roles, Admin Units & Privileged Identity Management

7.1 Implementing & Managing Roles in M365 & Entra ID 7.2 Managing Permissions for Defender XDR, Purview & Workloads 7.3 Managing Delegation with Administrative Units 7.4 Managing Entra ID Roles in PIM

8 Identity Synchronization with Entra Connect

8.1 Preparing for Identity Synchronization & IdFix 8.2 Directory Sync with Entra Connect Sync & Cloud Sync 8.3 Monitoring Sync with Entra Connect Health 8.4 Troubleshooting Synchronization

9 Authentication, SSPR & Password Protection

9.1 Implementing & Managing Authentication Methods 9.2 Self-Service Password Reset (SSPR) 9.3 Microsoft Entra Password Protection 9.4 Investigating & Resolving Authentication Issues

10 Identity Protection, Conditional Access & MFA

10.1 Planning for Identity Protection 10.2 Implementing Entra Identity Protection 10.3 Planning & Implementing Conditional Access Policies 10.4 Managing MFA with Conditional Access

11 Defender XDR Posture, Incidents & Threat Intelligence

11.1 Security Exposure Management & Secure Score 11.2 Incidents, Alerts & Advanced Hunting 11.3 Reviewing Defender XDR Reports 11.4 Defender Threat Intelligence

12 Defender for Office 365: Policies, Alerts & Investigation

12.1 Threat Policies & Rules in Defender for Office 365 12.2 Configuring Alert Policies 12.3 Investigating & Responding to Email Threats

13 Attack Simulation & Restricted Entities

13.1 Managing Attack Simulations & Training 13.2 Managing Restricted Entities & Blocked Users

14 Defender for Endpoint

14.1 Onboarding Devices to Defender for Endpoint 14.2 Configuring Endpoint Settings 14.3 Defender Vulnerability Management Dashboard

15 Defender for Cloud Apps

15.1 Configuring the App Connector for Microsoft 365 15.2 Defender for Cloud Apps Policies & Alerts 15.3 Interpreting the Activity Log 15.4 Cloud App Discovery

16 Purview Information Protection & Data Lifecycle

16.1 Sensitive Information Types 16.2 Retention Labels & Policies 16.3 Sensitivity Labels & Policies 16.4 Monitoring Label Usage: Content & Activity Explorer

17 Purview Data Loss Prevention

17.1 DLP Policies for Microsoft 365 Workloads 17.2 Configuring Endpoint DLP 17.3 Reviewing & Responding to DLP Alerts, Events & Reports

18 Final Review & Exam Strategy

18.1 Exam-Day Strategy & Question Handling 18.2 Final Review Checklist & Next Steps

14.1 Onboarding Devices to Defender for Endpoint

Key Takeaways Explain This Topic AI

Defender for Endpoint Plan 1 is prevention only (next-gen antivirus, ASR, device control, web and network protection); Plan 2 adds EDR, automated investigation and remediation, vulnerability management, device discovery, advanced hunting, and Defender Experts

Onboarding connects a device to the tenant via a configuration package or script downloaded from the Microsoft Defender portal onboarding page

Intune device configuration profiles are the recommended onboarding path for Microsoft-managed endpoints across Windows, iOS, Android, and macOS

VDI onboarding uses a PowerShell script on the golden image plus a GPO or Intune policy to complete onboarding for each non-persistent session at startup

Device discovery uses onboarded endpoints as network sensors to find unmanaged devices on the corporate network without requiring agents on every asset

Last updated: August 2026

Onboarding Devices to Microsoft Defender for Endpoint

Quick Answer: Onboarding is the act of connecting a device to your Defender for Endpoint tenant so it starts reporting sensors, detections, and inventory data. You download an onboarding package (a script or configuration blob) from the Microsoft Defender portal and deploy it through Intune, Group Policy, Configuration Manager with tenant attach, a local script, or a VDI golden-image procedure.

Plan 1 vs Plan 2

Microsoft Defender for Endpoint ships in two tiers. Knowing which features come from which plan matters because licensing drives what you can configure.

  • Capability Plan 1 Plan 2
  • Next-generation antivirus (NGAV) ✅ ✅
  • Attack surface reduction (ASR) rules ✅ ✅
  • Device control, endpoint firewall, network and web protection ✅ ✅
  • Manual response actions and centralized management ✅ ✅
  • Endpoint detection and response (EDR) ❌ ✅
  • Automated investigation and remediation (self-healing) ❌ ✅
  • Core Defender Vulnerability Management ❌ ✅
  • Device discovery and device inventory ❌ ✅
  • Threat analytics ❌ ✅
  • Advanced hunting (30-day raw event query) ❌ ✅
  • Microsoft Defender Experts (managed hunting) ❌ ✅
  • Six months of raw data retention ❌ ✅

The headline distinction to memorise: Plan 1 is prevention, Plan 2 adds detection and response. EDR, automated investigation and remediation, vulnerability management, device discovery, and advanced hunting are all Plan 2 — a scenario that needs any of them rules Plan 1 out.

Plan 2 is what most MS-102 candidates deploy. It is included with Microsoft 365 E5 and Microsoft 365 E5 Security , or with Microsoft 365 E3 plus the Defender for Endpoint Plan 2 add-on . Plan 1 is included with Microsoft 365 E3/A3 and is also sold standalone. Note the small-business trap: Microsoft 365 Business Premium includes Microsoft Defender for Business, not Defender for Endpoint Plan 1 or Plan 2 — Defender for Business is a separate SKU with its own feature set, and a tenant cannot mix it with Defender for Endpoint licensing.

Prerequisites Before You Onboard

Before any device can report in, three things must be true:

The workspace is provisioned. Sign in to the Microsoft Defender portal ( security.microsoft.com ) and complete the initial setup wizard. The portal becomes the single pane of glass for incidents, alerts, vulnerability management, and onboarding.

Licensing is assigned. Each onboarded device needs a license that includes MDE P2 (or P1 for the reduced feature set). Plan 2 comes from Microsoft 365 E5, Microsoft 365 E5 Security, Microsoft 365 E3 plus the MDE Plan 2 add-on, or a standalone MDE Plan 2 SKU; Plan 1 is included in Microsoft 365 E3. Microsoft 365 Business Premium licenses Defender for Business , which is a different product from Defender for Endpoint.

Network connectivity is in place. Endpoints must reach the Defender for Endpoint service URLs over HTTPS (for example *.endpoint.security.microsoft.com and the telemetry endpoints documented in Microsoft Learn). If you route through a proxy, allow these domains and disable SSL inspection for them.

Onboarding Methods

Microsoft supports six onboarding paths. The right choice depends on your management plane and operating system.

Method Best For OS Coverage

Intune (MDM) Cloud-managed or co-managed devices; recommended for new deployments Windows 10/11, iOS, Android, macOS, Linux

Group Policy (GPO) On-prem AD-joined devices with no MDM Windows 10/11, Windows Server 2016+

Configuration Manager (MECM) with tenant attach Existing MECM environments that want Defender portal visibility Windows, plus macOS/Linux with the MECM client

  • Local script Pilots, small labs, isolated laptops Windows, macOS, Linux
  • VDI / non-persistent Virtual desktops (AVD single/multi-session, Citrix, VMware) Windows
  • Microsoft Defender for Cloud Azure-native VMs and servers Windows Server, Linux Server
  • Intune (recommended)

For Microsoft-managed endpoints the recommended path is an Intune device configuration profile . You create a profile under Devices → Configuration profiles → Create profile , pick Defender for Endpoint as the template on Windows, or use the Microsoft Defender for Endpoint mobile threat defense connector for iOS and Android. The profile pushes the onboarding blob silently; no user interaction is required. macOS onboarding uses the same Intune profile plus the standalone MDE installer package (.pkg) distributed through Intune required apps.

Group Policy

In a classic on-prem AD environment you download a Group Policy Object (GPO) -formatted onboarding package (a ZIP containing an Onboarding.xml script and a WindowsDefenderATPOnboardingScript.cmd ) and import it into a GPO linked to an OU containing the target machines. Group Policy writes the onboarding blob into HKLM\SOFTWARE\Policies\Microsoft\Windows Advanced Threat Protection\Onboarding . On next GP refresh the sensor starts and reports within minutes.

Configuration Manager with tenant attach

If you already manage devices with Microsoft Endpoint Configuration Manager (MECM) , tenant attach syncs your MECM devices into the Defender portal without requiring Intune enrollment. You enable tenant attach in the MECM console, then deploy the MDE client as an application. Collections become device groups in the portal.

Local script

For a pilot or a single laptop with no management system, download the local script (a 10 KB PowerShell or bash file) from the onboarding page and run it elevated. It writes the onboarding blob to the same registry key (Windows) or /etc/opt/microsoft/mdatp (Linux/macOS). This is fine for tens of devices; it does not scale.

VDI onboarding

Non-persistent virtual desktops need a different procedure because each session starts from a clean image. The Microsoft-published approach is:

Optimize the golden image — run the VDI optimization script (or the WindowsDefenderATPOnboardingScript with the -vdi flag) on the master image to set the OnboardingInfo registry key and the SenseId placeholder.

Set up the onboarding completion method — use a GPO or Intune policy that runs a small script at logon to generate a unique sensor identity for each session. Microsoft supports both single-session (one user per VM, persistent identity) and multi-session (AVD, Citrix MCS/PVS) scenarios.

Offboard at logoff (optional) — for strict non-persistence, run the offboarding script at logoff so each session's machine object cleans up in the portal.

Onboarding Linux and macOS servers

Linux servers use the mdatp package deployed through yum, apt, or zypper, with the onboarding blob pushed via Puppet, Ansible, Chef, or Intune. macOS servers use the .pkg installer plus the onboarding blob via Intune, Jamf, or Microsoft's own script.

The Onboarding Package

Regardless of method, every onboarding relies on the onboarding package downloaded from Settings → Endpoints → Onboarding in the Defender portal. The package contains:

  • A workspace ID / onboarding blob that identifies your tenant
  • The script or MSI that writes the blob to the device and starts the sensor
  • The service URLs the sensor uses for telemetry and portal communication

The blob is tenant-specific. Never copy a blob from one tenant into another — devices will report to the wrong workspace and you will not be able to offboard them cleanly.

Device Discovery

Once you have a few onboarded devices, Device Discovery turns them into network sensors. Each onboarded Windows or macOS endpoint scans the local subnet (and any configured scan ranges) for other devices: servers, printers, IoT, and unmanaged laptops. Discovered devices appear in the Device inventory tagged Discovered rather than Onboarded . You can then prioritize onboarding the high-value discovered assets.

Device discovery is a Plan 2 capability. Within it, Standard discovery (the default) actively probes unmanaged devices using techniques the Microsoft Learn documentation describes as "non-intrusive," while Basic discovery is passive — it only listens to the traffic onboarded devices already see. Configure the mode under Settings → Endpoints → Advanced features → Device discovery .

Verifying Onboarding

After deployment, verify onboarding in three places:

On the device : run Get-MpComputerStatus (Windows) or mdatp health (Linux/macOS) and confirm AMServiceEnabled / OnboardingState shows the device is managed and reporting.

In the Defender portal : open Assets → Devices and confirm the device appears with a green check under Onboarding status .

In the Sensor health report : under Reports → General → Sensor health , look for No sensor data or Impaired communication and remediate any devices that are not checking in.