Onboard Windows devices to Defender for Endpoint using Intune
Applies to:
- Microsoft Defender for Endpoint Plan 1
- Microsoft Defender for Endpoint Plan 2
- Microsoft Defender XDR
Want to experience Defender for Endpoint? Sign up for a free trial.
You can use mobile device management (MDM) solutions to configure Windows 10 devices. Defender for Endpoint supports MDMs by providing OMA-URIs to create policies to manage devices.
For more information on using Defender for Endpoint CSP, see, WindowsAdvancedThreatProtection CSP and WindowsAdvancedThreatProtection DDF file.
Before you begin
Devices must be enrolled with Intune as your Mobile Device Management (MDM) solution.
For more information on enabling MDM with Microsoft Intune, see Device enrollment (Microsoft Intune).
Onboard devices using Microsoft Intune
Check out Identify Defender for Endpoint architecture and deployment method to see the various paths in deploying Defender for Endpoint.
Follow the instructions from Intune.
For more information on using Defender for Endpoint CSP, see, WindowsAdvancedThreatProtection CSP and WindowsAdvancedThreatProtection DDF file.
Note
- The Health Status for onboarded devices policy uses read-only properties and can't be remediated.
- Configuration of diagnostic data reporting frequency is only available for devices on Windows 10, version 1703.
- Onboarding to Defender for Endpoint will onboard the device to Data Loss Prevention (DLP), which is also a part of Microsoft 365 compliance.
Run a detection test to verify onboarding
After onboarding the device, you can choose to run a detection test to verify that a device is properly onboarded to the service. For more information, see Run a detection test on a newly onboarded Microsoft Defender for Endpoint device.
Offboard devices using Mobile Device Management tools
For security reasons, the package used to Offboard devices expires seven days after the date it was downloaded. Expired offboarding packages sent to a device are rejected. When downloading an offboarding package, you're notified of the package's expiry date, and the date is included in the package name.
Note
To avoid unpredictable policy collisions, onboarding and offboarding policies must not be deployed at the same time on a device.
Get the offboarding package from the Microsoft Defender portal as follows:
In the navigation pane, select Settings > Endpoints > Device management > Offboarding.
Select Windows 10 or Windows 11 as the operating system.
In the Deployment method field, select Mobile Device Management / Microsoft Intune.
Select Download package, and save the .zip file.
Extract the contents of the
.zip
file to a shared, read-only location that can be accessed by the network administrators who'll deploy the package. You should have a file namedWindowsDefenderATP_valid_until_YYYY-MM-DD.offboarding
.In the Microsoft Intune admin center, you can use a custom configuration policy or an EDR policy.
Method Procedure Custom configuration policy 1. In the navigation pane, select Devices > By platform > Windows > Manage Devices > Configuration.
2. Under Policies select Create > New Policy.
3. In the Create a profile slide out, select Windows 10 and later as Platform and Templates as Profile Type.
4. Under Template Name, select the Custom template and select Create.
5. Enter a value for Name and select Next.
6. Under Configuration settings, select Add and use the following OMA-URI settings:
- Name: Provide a name
- OMA-URI:./Device/Vendor/MSFT/WindowsAdvancedThreatProtection/Offboarding
- Date type: String
- Value: Copy and paste the value from the content of theWindowsDefenderATP_valid_until_YYYY-MM-DD
offboarding file.
7. Make the appropriate group assignments, applicability rules, and on the Review + create step, select Create.EDR policy 1. In the navigation pane, select Endpoint security > Manage > Endpoint detection and response.
2. Under Endpoint detection and response (EDR) policies, select Create policy.
3. In the Create a profile slide out, select Windows as Platform and Endpoint detection and response and select Create.
5. Enter a value for Name and select Next.
6. Under Configuration settings, select Offboard for the setting Microsoft Defender for Endpoint client configuration package type.
7. Copy the value from the content of theWindowsDefenderATP_valid_until_YYYY-MM-DD
offboarding file and paste it in the Offboarding (Device) setting. Then select Next.
8. Specify any scope tags if needed, make the appropriate group assignments and on the Review + create step, select Create.For more information on Microsoft Intune policy settings, see Windows 10 policy settings in Microsoft Intune.
Note
The Health Status for offboarded devices policy uses read-only properties and can't be remediated.
Important
Offboarding causes the device to stop sending sensor data to Defender for Endpoint, but data from the device, including references to any alerts it has, is retained for up to 6 months.
Related articles
- Onboard Windows devices using Group Policy
- Onboard Windows devices using Microsoft Endpoint Configuration Manager
- Onboard Windows devices using a local script
- Onboard non-persistent virtual desktop infrastructure (VDI) devices
- Run a detection test on a newly onboarded Microsoft Defender for Endpoint device
- Troubleshoot Microsoft Defender for Endpoint onboarding issues
Tip
Do you want to learn more? Engage with the Microsoft Security community in our Tech Community: Microsoft Defender for Endpoint Tech Community.