Microsoft Defender for Business
Endpoint protection

Offboard a Device from Microsoft Defender for Business - Microsoft Defender for Business | Microsoft Learn

In brief

The article now uses clearer wording for device replacement and retirement, inactive-device status, data retention, and exposure-score treatment. It also standardizes platform labels, portal links, and package and script instructions.

What Defender admins need to know

Administrators have clearer instructions and links for offboarding Windows, Linux, server, and mobile devices. No action is required.

Summaries are generated from the documentation change itself.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

Offboard a deviceDevice from Microsoft Defender for Business - Microsoft Defender for Business | Microsoft Learn

As devices are replacedyou replace or retired,retire devices, or as your business needs change, you can offboard devices from Defender for Business. OffboardingWhen you offboard a device causes the device to stopdevice, it stops sending data to Defender for Business, and itsBusiness. Its status changes to Inactive within seven days. You don't haveneed to offboard devices that are already listed as Inactive.

Data from a device, such as alerts, vulnerabilities, and detected threats, remains visible in the Microsoft Defender portal until the configured retention period expires (usuallyexpires, usually 180 days).days.

Devices that weren't active within the last 30 days arendon't factored intoaffect your organization's exposure score.

Important

- **Windows 10 or 11**
- **Mac**
- **Servers** (Windows: Windows Server or Linux Server)Server
- **Mobile** (for: for iOS/iPadOS or Android devices)devices
  1. Follow the guidance on the selected tab.
  2. Proceed to your next steps.

Windows 10 or 11

Windows 10 or 11

  1. Go to the Microsoft Defender portal (Microsoft Defender portal) and sign in.
  2. In the navigation pane, choose Settings, and then choose Endpoints.
  3. Under Device management, choose Offboarding.
  4. Select an operating system, such as Windows 10 and 11, and then, under Offboard a device, in the Deployment method section, choose Local script.

Mac

Mac

  1. Go to the Microsoft Defender portal (Microsoft Defender portal) and sign in.
  2. In the navigation pane, choose Settings, and then choose Endpoints.
  3. Under Device management, choose Offboarding.
  4. In the Select operating system to start the offboarding process list, select macOS.

Windows Server

  1. Go to the Microsoft Defender portal (Microsoft Defender portal), and sign in.
  2. In the navigation pane, choose Settings > Endpoints, and then under Device management, choose Offboarding.
  3. Select an operating system, such as Windows Server 1803, 2019, and 2022, and then in the Deployment method section, choose Local script.
  4. Select Download package. We recommend that you save the offboarding package to a removable drive. The zipped folder is named WindowsDefenderATPOffboardingPackage_valid_until_YYYY-MM-DD.zip (where, where YYYY-MM-DD is the expiry date of the package).package.
  5. On your Windows Server device, extract the contents of the zipped folder to a location such as the Desktop folder.
  6. Open a command promptCommand Prompt window as an administrator.
  7. Type the location of the script file. For example, if you copied the file to the Desktop folder, you would type %userprofile%\Desktop\WindowsDefenderATPOffboardingScript_valid_until_2022-11-11.cmd (where, where YYYY-MM-DD is the expiry date of the package), and thenpackage. Then press Enter (or or select OK).

Linux Server

  1. Go to the Microsoft Defender portal (Microsoft Defender portal), and sign in.
  2. In the navigation pane, choose Settings > Endpoints, and then under Device management, choose Offboarding.
  3. Select Linux Server for the operating system, and then in the Deployment method section, choose Local script.
  4. Select Download package. We recommend that you save the offboarding package to a removable drive. The zipped folder is named WindowsDefenderATPOffboardingPackage_valid_until_YYYY-MM-DD.zip (where, where YYYY-MM-DD is the expiry date of the package).package.
  5. On your Linux Server device, extract the contents of the zipped folder to a location such as the Desktop folder.
  6. Open a terminal, and navigate to the directory where the MicrosoftDefenderATPOffboardingLinuxServer_valid_until_YYYY-MM-DD file (wherefile, where YYYY-MM-DD is the expiry date of the file)file, is located.
  7. Type python MicrosoftDefenderATPOffboardingLinuxServer_valid_until_YYYY-MM-DD.py in the terminal.

Note

This procedure offboards the server, meaning that the server stops sending security data to Defender for Business. However, itIt doesn't remove the Defender for Business software from the device. For information about how to completely remove the software from the device, see Offboard or uninstall Microsoft Defender for Endpoint on Linux.

Mobile devices

Mobile devices