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
- Follow the guidance on the selected tab.
- Proceed to your next steps.
Windows 10 or 11
Windows 10 or 11
- Go to the
Microsoft Defender portal (Microsoft Defender portal)and sign in. - In the navigation pane, choose Settings, and then choose Endpoints.
- Under Device management, choose Offboarding.
- 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
- Go to the
Microsoft Defender portal (Microsoft Defender portal)and sign in. - In the navigation pane, choose Settings, and then choose Endpoints.
- Under Device management, choose Offboarding.
- In the Select operating system to start the offboarding process list, select macOS.
Windows Server
- Go to the
Microsoft Defender portal (Microsoft Defender portal),and sign in. - In the navigation pane, choose Settings > Endpoints, and then under Device management, choose Offboarding.
- Select an operating system, such as Windows Server 1803, 2019, and 2022, and then in the Deployment method section, choose Local script.
- 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, whereYYYY-MM-DDis the expiry date of thepackage).package. - On your Windows Server device, extract the contents of the zipped folder to a location such as the Desktop folder.
- Open a
command promptCommand Prompt window as an administrator. - Type the location of the script file. For example, if you copied the file to the Desktop folder,
you wouldtype%userprofile%\Desktop\WindowsDefenderATPOffboardingScript_valid_until_2022-11-11.cmd(where, whereYYYY-MM-DDis the expiry date of thepackage), and thenpackage. Then press Enter(oror select OK).
Linux Server
- Go to the
Microsoft Defender portal (Microsoft Defender portal),and sign in. - In the navigation pane, choose Settings > Endpoints, and then under Device management, choose Offboarding.
- Select Linux Server for the operating system, and then in the Deployment method section, choose Local script.
- 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, whereYYYY-MM-DDis the expiry date of thepackage).package. - On your Linux Server device, extract the contents of the zipped folder to a location such as the Desktop folder.
- Open a terminal, and navigate to the directory where the
MicrosoftDefenderATPOffboardingLinuxServer_valid_until_YYYY-MM-DDfile (wherefile, whereYYYY-MM-DDis the expiry date of thefile)file, is located. - Type
python MicrosoftDefenderATPOffboardingLinuxServer_valid_until_YYYY-MM-DD.pyin 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
@@ -1,6 +1,6 @@ --- layout: Conceptual-title: Offboard a device from Microsoft Defender for Business - Microsoft Defender for Business | Microsoft Learn+title: Offboard a Device from Microsoft Defender for Business - Microsoft Defender for Business | Microsoft Learn canonicalUrl: https://learn.microsoft.com/en-us/defender-business/mdb-offboard-devices breadcrumb_path: /defender-business/breadcrumb/toc.json feedback_system: Standard@@ -8,7 +8,7 @@ permissioned-type: public feedback_product_url: https://techcommunity.microsoft.com/t5/security-compliance-and-identity/ct-p/MicrosoftSecurityandCompliance uhfHeaderId: MSDocsHeader-MicrosoftDefender manager: bagol-description: Learn about how to remove or offboard a device from Microsoft Defender for Business.+description: Learn about how to remove or offboard devices from Microsoft Defender for Business, as devices are replace or your business needs change. author: chrisda ms.author: chrisda ms.topic: overview@@ -47,13 +47,13 @@ spProducts: platformId: e4057644-0565-0a31-a935-ff4df0839bf0 --- -# Offboard a device from Microsoft Defender for Business - Microsoft Defender for Business | Microsoft Learn+# Offboard a Device from Microsoft Defender for Business - Microsoft Defender for Business | Microsoft Learn -As devices are replaced or retired, or your business needs change, you can offboard devices from Defender for Business. Offboarding a device causes the device to stop sending data to Defender for Business, and its status changes to `Inactive` within seven days. You don't have to offboard devices that are already listed as `Inactive`.
+As you replace or retire devices, or as your business needs change, you can offboard devices from Defender for Business. When you offboard a device, it stops sending data to Defender for Business. Its status changes to `Inactive` within seven days. You don't need 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](/en-us/defender-endpoint/data-storage-privacy#how-long-will-microsoft-store-my-data-what-is-microsofts-data-retention-policy) expires (usually 180 days).
+Data from a device, such as alerts, vulnerabilities, and detected threats, remains visible in the Microsoft Defender portal until the [configured retention period](/en-us/defender-endpoint/data-storage-privacy#how-long-will-microsoft-store-my-data-what-is-microsofts-data-retention-policy) expires, usually 180 days.
-Devices that weren't active within the last 30 days aren't factored into your organization's [exposure score](mdb-view-tvm-dashboard).
+Devices that weren't active within the last 30 days don't affect your organization's [exposure score](mdb-view-tvm-dashboard).
Important
@@ -65,15 +65,15 @@ The procedures in this article describe how to remove a device from monitoring b
- **Windows 10 or 11**
- **Mac**
- - **Servers** (Windows Server or Linux Server)
- - **Mobile** (for iOS/iPadOS or Android devices)
+ - **Servers**: Windows Server or Linux Server
+ - **Mobile**: for iOS/iPadOS or Android devices
2. Follow the guidance on the selected tab.
3. Proceed to your next steps.
# [Windows 10 or 11](#tab/Windows1011)
## Windows 10 or 11
-1. Go to the Microsoft Defender portal (https://security.microsoft.com) and sign in.
+1. Go to the [Microsoft Defender portal](https://security.microsoft.com) 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**.
@@ -84,7 +84,7 @@ The procedures in this article describe how to remove a device from monitoring b # [Mac](#tab/mac)
## Mac
-1. Go to the Microsoft Defender portal (https://security.microsoft.com) and sign in.
+1. Go to the [Microsoft Defender portal](https://security.microsoft.com) 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**.
@@ -102,27 +102,27 @@ Choose the operating system for your server:
### Windows Server
-1. Go to the Microsoft Defender portal (https://security.microsoft.com), and sign in.
+1. Go to the [Microsoft Defender portal](https://security.microsoft.com) 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 `YYYY-MM-DD` is the expiry date of the package).
+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 `YYYY-MM-DD` is the expiry date of the 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 prompt 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 `YYYY-MM-DD` is the expiry date of the package), and then press Enter (or select **OK**).
+6. Open a Command Prompt window as an administrator.
+7. Type the location of the script file. For example, if you copied the file to the Desktop folder, type `%userprofile%\Desktop\WindowsDefenderATPOffboardingScript_valid_until_2022-11-11.cmd`, where `YYYY-MM-DD` is the expiry date of the package. Then press **Enter** or select **OK**.
### Linux Server
-1. Go to the Microsoft Defender portal (https://security.microsoft.com), and sign in.
+1. Go to the [Microsoft Defender portal](https://security.microsoft.com) 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 `YYYY-MM-DD` is the expiry date of the package).
+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 `YYYY-MM-DD` is the expiry date of the 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 (where `YYYY-MM-DD` is the expiry date of the file) is located.
+6. Open a terminal, and navigate to the directory where the `MicrosoftDefenderATPOffboardingLinuxServer_valid_until_YYYY-MM-DD` file, where `YYYY-MM-DD` is the expiry date of the 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, it 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](/en-us/defender-endpoint/linux-off-board-endpoints).
+This procedure offboards the server, meaning that the server stops sending security data to Defender for Business. It 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](/en-us/defender-endpoint/linux-off-board-endpoints).
# [Mobile devices](#tab/mobiles)
## Mobile devices
