POWERSHELL COMMAND
Set-XdrEndpointDeviceCriticalityLevel
Sets the criticality level on endpoint devices in Microsoft Defender XDR.
Updates the criticality level for one or more endpoint devices. Criticality levels help prioritize security operations based on device importance.
Syntax
Set-XdrEndpointDeviceCriticalityLevel [-DeviceId] <string[]> [-CriticalityLevel] <string> [-WhatIf] [-Confirm] [<CommonParameters>]
Parameters
-DeviceId
| Property | Value |
|---|---|
| Type | String[] |
| Required | Yes |
| Position | 1 |
| Pipeline input | true (ByPropertyName) |
| Default | Not documented |
One or more device IDs (SenseMachineIds) identifying the target devices.
-CriticalityLevel
| Property | Value |
|---|---|
| Type | String |
| Required | Yes |
| Position | 2 |
| Pipeline input | No |
| Default | Not documented |
The criticality level to assign. Valid values: VeryHigh, High, Medium, Low, Reset. Reset removes the criticality level from the device.
-WhatIf
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | Not documented |
Shows what would happen if the command runs. The command is not run.
-Confirm
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | Not documented |
Prompts for confirmation before making changes.
Examples
Set-XdrEndpointDeviceCriticalityLevel -DeviceId "abc123" -CriticalityLevel High
Sets the criticality level to High on the specified device.
Set-XdrEndpointDeviceCriticalityLevel -DeviceId "abc123", "def456" -CriticalityLevel Medium
Sets the criticality level to Medium on multiple devices.
Set-XdrEndpointDeviceCriticalityLevel -DeviceId "abc123" -CriticalityLevel Reset
Removes the criticality level from the specified device.
Output
Type: Object
Returns the API response.