You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: defender-endpoint/device-control-policies.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -383,22 +383,22 @@ Groups are used two ways: to select devices for inclusion/exclusion in rules, a
383
383
| File | Filter file properties | Windows || X |
384
384
| Print Job | Filter properties of the file being printed | Windows || X |
385
385
386
-
The devices that are in scope for the policy determined by a list of included groups and a list of excluded groups. A rule applies if the device is in all of the included groups and none of the excluded groups. Groups can be composed from the properties of devices. The following properties can be used:
386
+
The devices that are in scope for the policy determined by a list of included groups and a list of excluded groups. A rule applies if the device is in all of the included groups and none of the excluded groups. Groups can be composed from the properties of devices. The following properties can be used:
387
387
388
388
| Property | Description | Windows devices | Mac devices | Printers |
389
389
|---|---|---|---|---|
390
390
|`FriendlyNameId`| The friendly name in Windows Device Manager | Y | N | Y |
391
391
|`PrimaryId`| The type of the device | Y | Y | Y |
392
392
|`VID_PID`| Vendor ID is the four-digit vendor code that the USB committee assigns to the vendor. Product ID is the four-digit product code that the vendor assigns to the device. Wildcards are supported. For example, `0751_55E0`| Y | N | Y |
393
-
|`PrinterConnectionId`| The type of printer connection: <br/>- `USB`: A printer connected through USB port of a computer. <br/>- `Network`: A network printer is a printer that is accessible by network connection, making it usable by other computers connected to the network.<br/>- `Corporate`: A corporate printer is a print queue shared through on-premises Windows Print Server.<br/>- `Universal`: Universal Print is a modern print solution that organizations can use to manage their print infrastructure through cloud services from Microsoft. [What is Universal Print? - Universal Print \| Microsoft Docs](/universal-print/discover-universal-print) <br/>- `File`: 'Microsoft Print to PDF' and 'Microsoft XPS Document Writer' or other printers using a FILE: or PORTPROMPT: port<br/>- `Custom`: printer that isn't connecting through Microsoft print port<br/>- `Local`: printer not any of previously mentioned types. For example print through RDP or redirect printers | N | N | Y |
393
+
|`PrinterConnectionId`| The type of printer connection: <br/>- `USB`: A printer connected through USB port of a computer. <br/>- `Network`: A network printer is a printer that is accessible by network connection, making it usable by other computers connected to the network.<br/>- `Corporate`: A corporate printer is a print queue shared through on-premises Windows Print Server.<br/>- `Universal`: Universal Print is a modern print solution that organizations can use to manage their print infrastructure through cloud services from Microsoft. [What is Universal Print? - Universal Print \| Microsoft Docs](/universal-print/discover-universal-print) <br/>- `File`: 'Microsoft Print to PDF' and 'Microsoft XPS Document Writer' or other printers using a FILE: or PORTPROMPT: port<br/>- `Custom`: printer that isn't connecting through Microsoft print port<br/>- `Local`: printer not any of previously mentioned types. For example, print through RDP or redirect printers | N | N | Y |
394
394
|`BusId`| Information about the device (for more information, see the sections that follow this table) | Y | N | N |
395
395
|`DeviceId`| Information about the device (for more information, see the sections that follow this table) | Y | N | N |
396
396
|`HardwareId`| Information about the device (for more information, see the sections that follow this table) | Y | N | N |
397
397
|`InstancePathId`| Information about the device (for more information, see the sections that follow this table) | Y | N | N |
398
398
|`SerialNumberId`| Information about the device (for more information, see the sections that follow this table) | Y | Y | N |
399
399
|`PID`| Product ID is the four-digit product code that the vendor assigns to the device | Y | Y | N |
400
400
|`VID`| Vendor ID is the four-digit vendor code that the USB committee assigns to the vendor. | Y | Y | N |
401
-
|`DeviceEncryptionStateId`|(Preview) The BitLocker encryption state of a device. Valid values are `BitlockerEncrypted` or `Plain`|Y|N|N|
401
+
|`DeviceEncryptionStateId`|(Preview) The BitLocker encryption state of a device. Valid values are `BitlockerEncrypted` or `Plain`|Y|N|N|
402
402
|`APFS Encrypted`| If the device is APFS encrypted | N | Y | N |
403
403
404
404
### Using Windows Device Manager to determine device properties
@@ -425,7 +425,7 @@ For Windows devices, you can use Device Manager to understand the properties of
425
425
426
426
### Using reports and advanced hunting to determine properties of devices
427
427
428
-
Device properties have slightly different labels in advanced hunting. The table below maps the labels in the portal to the `propertyId` in a device control policy.
428
+
Device properties have slightly different labels in advanced hunting. The following table maps the labels in the portal to the `propertyId` in a device control policy.
429
429
430
430
| Microsoft Defender Portal property | Device control property Id |
431
431
|---|---|
@@ -442,7 +442,7 @@ Device properties have slightly different labels in advanced hunting. The table
442
442
You can configure groups in Intune, by using an XML file for Windows, or by using a JSON file on Mac. Select each tab for more details.
443
443
444
444
> [!NOTE]
445
-
> The `Group Id` in XML and `id` in JSON is used to identify the group within device control. Its not a reference to any other such as a [user group](#users) in Entra Id.
445
+
> The `Group Id` in XML and `id` in JSON is used to identify the group within device control. It's not a reference to any other such as a [user group](#users) in Microsoft Entra ID.
446
446
447
447
### [**Intune**](#tab/Removable)
448
448
@@ -540,7 +540,7 @@ The following values are supported as clauses:
540
540
|`productId`| four-digit hexadecimal string | Matches a device's product ID |
541
541
|`serialNumber`| string | Matches a device's serial number. Doesn't match if the device doesn't have a serial number. |
542
542
|`encryption`| apfs | Match if a device is apfs-encrypted. |
543
-
|`groupId`| UUID string | Match if a device is a member of another group. The value represents the UUID of the group to match against. The group must be defined within the policy prior to the clause. |
543
+
|`groupId`| UUID string | Match if a device is a member of another group. The value represents the UUID of the group to match against. The group must be defined within the policy before the clause. |
544
544
545
545
Here's an example query:
546
546
@@ -582,7 +582,7 @@ This query matches all devices that don't have the specified serial number.
582
582
583
583
## Advanced conditions
584
584
585
-
Entries can be further restricted based on parameters. Parameters apply advanced conditions that go beyond the device. Advanced conditions allow for fine-grained control based on Network, VPN Connection, File or Print Job being evaluated.
585
+
Entries can be further restricted based on parameters. Parameters apply advanced conditions that go beyond the device. Advanced conditions allow for fine-grained control based on Network, VPN Connection, File, or Print Job being evaluated.
586
586
587
587
> [!NOTE]
588
588
> Advanced conditions are only supported in the XML format.
@@ -636,7 +636,7 @@ The following table describes VPN connection conditions:
636
636
|`VPNServerAddressId`| The string value of `VPNServerAddress`. Wildcards are supported. |
637
637
|`VPNDnsSuffixId`| The string value of `VPNDnsSuffix`. Wildcards are supported. |
638
638
639
-
These properties are added to the DescriptorIdList of a group of type VPNConnection, as shown in the following snippet:
639
+
These properties are added to the `DescriptorIdList` of a group of type `VPNConnection`, as shown in the following snippet:
0 commit comments