Install the sensor v2.x | Microsoft Defender for Identity
In brief
The installation page now clarifies sensor package download steps, formats endpoint lists, and adds tables and examples for silent and proxy installations. It also updates the post-installation next steps.
What Defender admins need to know
Administrators can more easily find silent-installation parameters and proxy options when deploying sensors.
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.
Download and install a Microsoft Defender for Identity sensor v2.x
Download and install the Defender for Identity sensor v2.x on domain controllers, or on AD FS, AD CS, and Microsoft Entra Connect servers that aren't domain controllers. Standalone sensor installation is also covered in Install the v2.x sensor in the Defender portal. Before you begin, review the sensor installation prerequisites, including .NET Framework, server specifications, and certificate requirements.
Download the sensor package
Perform the following steps to download the sensor installation package from the Microsoft Defender portal.
In Microsoft Defender XDR, go to System > Settings > Identities.
Select the Sensors tab, which displays all of your Defender for Identity sensors. For example:
Install the v2.x sensor in the Defender portal
Commands for running a silent installation
Use the following commands to perform a fully silent installation of the Defender for Identity sensor, by using the access key that you copied when you downloaded the sensor package.
cmd.exe syntax
PowerShell syntax
UseIf you're launching the installer from PowerShell, use the following PowerShell syntax for athe same silent installation:installation command:
.\"Azure ATP sensor Setup.exe" /quiet NetFrameworkCommandLineArguments="/q" AccessKey="<Access Key>"
#### Installation options
The following table lists the available installation options for a silent installation.
|Name|Syntax|Mandatory for silent installation?|Description|
|-------------|----------|---------|---------|
|`Quiet`|`/quiet`|Yes|Runs the installer without displaying UI or prompts.|
#### Installation parameters
The following table describes the available installation parameters for a silent installation.
|Name|Syntax|Mandatory for silent installation?|Description|
|-------------|----------|---------|---------|
|`InstallationPath`|`InstallationPath=""`|No|Sets the path for the installation of Defender for Identity sensor binaries. Default path: `%programfiles%\Azure Advanced Threat Protection Sensor`. |
#### Examples
The following examples show common silent installation commands.
Use the following command to silently install the Defender for Identity sensor with the access key passed directly on the command line:
```cmd
### Command for running a silent installation with a proxy configuration
UseThe following syntax shows the following command to configure youroptional proxy together withparameters you can include when running a silent installation:installation. Values in brackets are optional:
```cmd
"Azure ATP sensor Setup.exe" [/quiet] [/Help] [ProxyUrl="http://proxy.internal.com"] [ProxyUserName="domain\proxyuser"] [ProxyUserPassword="ProxyPassword"]`
InstallationProxy installation parameters
The following table lists the proxy-related installation parameters.
| Name | Syntax | Mandatory for silent installation? | Description |
|---|
- Configure port mirroring
- Configure Windows event forwarding to your Defender for Identity standalone sensor
Next stepsteps
After installing the sensor, continue to configure your sensor settings.
[!div class="step-by-step"] Configure Microsoft Defender for Identity sensor settings
@@ -1,16 +1,16 @@ --- title: Install the sensor v2.x | Microsoft Defender for Identity description: Learn how to download and install the Microsoft Defender for Identity sensor v2.x on domain controllers, AD FS servers, AD CS servers, or Microsoft Entra Connect servers.-ms.date: 06/15/2026+ms.date: 07/02/2026 ms.topic: how-to ms.reviewer: rlitinsky ai-usage: ai-assisted-ms.custom: sfi-ropc-nochange, msecd-doc-authoring-1014+ms.custom: sfi-ropc-nochange, msecd-doc-authoring-1016 --- # Download and install a Microsoft Defender for Identity sensor v2.x -Download and install the Defender for Identity sensor v2.x on domain controllers, or on AD FS, AD CS, and Microsoft Entra Connect servers that aren't domain controllers. Standalone sensor installation is also covered in [Install the v2.x sensor in the Defender portal](#install-the-v2x-sensor-in-the-defender-portal). Before you begin, review the [prerequisites](#prerequisites), including .NET Framework, server specifications, and certificate requirements.+Download and install the Defender for Identity sensor v2.x on domain controllers, or on AD FS, AD CS, and Microsoft Entra Connect servers that aren't domain controllers. Standalone sensor installation is also covered in [Install the v2.x sensor in the Defender portal](#install-the-v2x-sensor-in-the-defender-portal). Before you begin, review the [sensor installation prerequisites](#prerequisites), including .NET Framework, server specifications, and certificate requirements. > [!TIP] > For domain controllers running Windows Server 2019 or later, deploy the [Defender for Identity sensor v3.x](deploy-sensor-v3.md) instead. The v3.x sensor is activated from the Defender portal and doesn't require a downloaded installation package.@@ -38,6 +38,8 @@ Before you start, make sure that you have: ## Download the sensor package +Perform the following steps to download the sensor installation package from the Microsoft Defender portal.+ 1. In [Microsoft Defender XDR](https://security.microsoft.com), go to **System > Settings** > **Identities**. 1. Select the **Sensors** tab, which displays all of your Defender for Identity sensors. For example:@@ -64,9 +66,9 @@ Before you start, make sure that you have: > [!Note] > To download the installation package behind a firewall or proxy server, make sure you allow network traffic to the following FQDNs through TCP/443. > - > sensorpackage-prd.mdi.securitycenter.microsoft.com- > sensorpackage-fm.mdi.securitycenter.microsoft.us- > sensorpackage-ff.mdi.securitycenter.microsoft.us+ > - sensorpackage-prd.mdi.securitycenter.microsoft.com+ > - sensorpackage-fm.mdi.securitycenter.microsoft.us+ > - sensorpackage-ff.mdi.securitycenter.microsoft.us ## Install the v2.x sensor in the Defender portal @@ -142,7 +144,7 @@ Make the Defender for Identity sensor package dependent on the deployment of the ### Commands for running a silent installation -Use the following commands to perform a fully silent installation of the Defender for Identity sensor, by using the access key you copied in [Download the sensor package](#download-the-sensor-package).+Use the following commands to perform a fully silent installation of the Defender for Identity sensor, by using the access key that you copied when you [downloaded the sensor package](#download-the-sensor-package). #### cmd.exe syntax @@ -154,7 +156,7 @@ Use the following cmd.exe syntax for a silent installation: #### PowerShell syntax -Use the following PowerShell syntax for a silent installation:+If you're launching the installer from PowerShell, use the following syntax for the same silent installation command: ```powershell .\"Azure ATP sensor Setup.exe" /quiet NetFrameworkCommandLineArguments="/q" AccessKey="<Access Key>"@@ -165,6 +167,8 @@ Use the following PowerShell syntax for a silent installation: #### Installation options +The following table lists the available installation options for a silent installation.+ |Name|Syntax|Mandatory for silent installation?|Description| |-------------|----------|---------|---------| |`Quiet`|`/quiet`|Yes|Runs the installer without displaying UI or prompts.|@@ -173,6 +177,8 @@ Use the following PowerShell syntax for a silent installation: #### Installation parameters +The following table describes the available installation parameters for a silent installation.+ |Name|Syntax|Mandatory for silent installation?|Description| |-------------|----------|---------|---------| |`InstallationPath`|`InstallationPath=""`|No|Sets the path for the installation of Defender for Identity sensor binaries. Default path: `%programfiles%\Azure Advanced Threat Protection Sensor`. |@@ -183,6 +189,8 @@ Use the following PowerShell syntax for a silent installation: #### Examples +The following examples show common silent installation commands.+ Use the following command to silently install the Defender for Identity sensor with the access key passed directly on the command line: ```cmd@@ -197,7 +205,7 @@ Alternatively, use the following command to read the access key from a text file ### Command for running a silent installation with a proxy configuration -Use the following command to configure your proxy together with a silent installation:+The following syntax shows the optional proxy parameters you can include when running a silent installation. Values in brackets are optional: ```cmd "Azure ATP sensor Setup.exe" [/quiet] [/Help] [ProxyUrl="http://proxy.internal.com"] [ProxyUserName="domain\proxyuser"] [ProxyUserPassword="ProxyPassword"]`@@ -206,7 +214,10 @@ Use the following command to configure your proxy together with a silent install > [!NOTE] > If you previously configured your proxy by using legacy options, including WinINet or a registry key update, you need to make any changes with the same method that you used originally. For more information, see [Change proxy configuration using legacy methods](configure-proxy.md#change-proxy-configuration-using-legacy-methods). -#### Installation parameters+<a name="installation-parameters-1"></a>+#### Proxy installation parameters++The following table lists the proxy-related installation parameters. |Name|Syntax|Mandatory for silent installation?|Description| |-------------|----------|---------|---------|@@ -228,7 +239,10 @@ After you install a sensor, you can follow extra steps: - [Configure port mirroring](configure-port-mirroring.md) - [Configure Windows event forwarding to your Defender for Identity standalone sensor](configure-event-forwarding.md) -## Next step+<a name="next-step"></a>+## Next steps++After installing the sensor, continue to configure your sensor settings. > [!div class="step-by-step"] > [Configure Microsoft Defender for Identity sensor settings](configure-sensor-settings.md) 