en-US

Locations

Parameter of DlpCompliancePolicy

Applies to : Security & Compliance

Description

The Locations parameter specifies to whom, what, and where the DLP policy applies. This parameter uses the following properties:

  • Workload: What the DLP policy applies to. Use the value Applications.
  • Location: Where the DLP policy applies. For Microsoft 365 Copilot, (Preview), use the value 470f2276-e011-4e9d-a6ec-20768be3a4b0.
  • AddInclusions or RemoveInclusions: Add or remove security groups, distribution groups, or users to or from the scope of this DLP policy. For users, use the email address in this syntax: {Type:IndividualResource,Identity:<EmailAddress>}. For security groups or distribution groups, use the ObjectId value of the group from the Microsoft Entra portal in this syntax: {Type:Group,Identity:<ObjectId>}.
  • AddExclusions or RemoveExclusions: Add or remove security groups, distribution groups, or users to or from exclusions to the scope of this DLP policy. For users, use the email address in this syntax: {Type:IndividualResource,Identity:<EmailAddress>}. For security groups or distribution groups, use the ObjectId value of the group from the Microsoft Entra portal in this syntax: {Type:Group,Identity:<ObjectId>}.

You create and store the properties in a variable as shown in the following examples:

DLP policy scoped to all users in the tenant:

$loc = "[{"Workload":"Applications","Location":"470f2276-e011-4e9d-a6ec-20768be3a4b0","AddInclusions":[{Type:"Tenant",Identity:"All"}]}]"

DLP policy scoped to the specified user and groups:

$loc = "[{"Workload":"Applications","Location":"470f2276-e011-4e9d-a6ec-20768be3a4b0","AddInclusions":[{"Type":"Group","Identity":"fef0dead-5668-4bfb-9fc2-9879a47f9bdb"},{"Type":"Group","Identity":"b4dc1e1d-8193-4525-b59c-6d6e0f1718d2"},{"Type":"IndividualResource","Identity":"[email protected]"}]}]"

DLP policy scoped to all users in the tenant except for members of the specified group:

$loc = "[{"Workload":"Applications","Location":"470f2276-e011-4e9d-a6ec-20768be3a4b0","AddInclusions":[{Type:"Tenant",Identity:"All"}],"AddExclusions": [{"Type":"Group","Identity":"fef0dead-5668-4bfb-9fc2-9879a47f9bdb"},{"Type":"Group","Identity":"b4dc1e1d-8193-4525-b59c-6d6e0f1718d2"}]}]

After you create the $loc variable as shown in the previous examples, use the value $loc for this parameter.

Microsoft Learn documentation

Characteristics

Type
String
Parameter sets
Identity

Apply

Enter the name of the policy to change.