Skip to content

[AutoPublish] main to live - 05/19 15:33 PDT | 05/20 04:03 IST #12758

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
May 19, 2025
17 changes: 17 additions & 0 deletions exchange/exchange-ps/exchange/New-DlpCompliancePolicy.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ New-DlpCompliancePolicy [-Name] <String>
[-EndpointDlpExtendedLocations <String>]
[-EndpointDlpLocation <MultiValuedProperty>]
[-EndpointDlpLocationException <MultiValuedProperty>]
[-EnforcementPlanes <MultiValuedProperty>]
[-ExceptIfOneDriveSharedBy <RecipientIdParameter[]>]
[-ExceptIfOneDriveSharedByMemberOf <RecipientIdParameter[]>]
[-ExchangeAdaptiveScopes <MultiValuedProperty>]
Expand Down Expand Up @@ -294,6 +295,22 @@ Accept pipeline input: False
Accept wildcard characters: False
```

### -EnforcementPlanes
{{ Fill EnforcementPlanes Description }}

```yaml
Type: MultiValuedProperty
Parameter Sets: (All)
Aliases:
Applicable: Security & Compliance

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ExceptIfOneDriveSharedBy
The ExceptIfOneDriveSharedBy parameter specifies the users to exclude from the DLP policy (the sites of the OneDrive for Business user accounts are included in the policy). You identify the users by UPN (laura@contoso.onmicrosoft.com).

Expand Down
24 changes: 20 additions & 4 deletions exchange/exchange-ps/exchange/New-DlpComplianceRule.md
Original file line number Diff line number Diff line change
Expand Up @@ -305,6 +305,22 @@ New-DLPComplianceRule -Name "Contoso Rule 1" -Policy "Contoso Policy 1" -Advance

This example uses the AdvancedRule parameter to read the following complex condition from a file: "Content contains sensitive information: "Credit card number OR Highly confidential" AND (NOT (Sender is a member of "Jane's Team" OR Recipient is "adele@contoso.com")).

### Example 4
```powershell

$myEntraAppId = ""

$myEntraAppName = ""

$locations = "[{`"Workload`":`"Applications`",`"Location`":`"$myEntraAppId`",`"LocationDisplayName`":`"$myEntraAppName`",`"LocationSource`":`"Entra`",`"LocationType`":`"Individual`",`"Inclusions`":[{`"Type`":`"Tenant`",`"Identity`":`"All`"}]}]"

New-DlpCompliancePolicy -Name "Test Entra DLP" -Mode Enable -Locations $locations -EnforcementPlanes @("Entra")

New-DlpComplianceRule -Name "Test Entra Rule" -Policy "Test Entra DLP" -ContentContainsSensitiveInformation @{Name = "credit card number"} -GenerateAlert $true -GenerateIncidentReport @("siteadmin") -NotifyUser @("admin@contonso.onmicrosoft.com") -RestrictAccess @(@{setting="UploadText";value="Block"})
```

This is an example of applying a CCSI-based DLP rule that should be handled by an entra-registered enterprise application in the organization.

## PARAMETERS

### -Name
Expand Down Expand Up @@ -3344,11 +3360,11 @@ Accept wildcard characters: False
```

### -SharedByIRMUserRisk
The SharedByIRMUserRisk paramter specifies the risk category of the user performing the violating action. Valid values are:
The SharedByIRMUserRisk parameter specifies the risk category of the user performing the violating action. Valid values are:

- Elevated Risk Level
- Moderate Risk Level
- Minor Risk Level
- FCB9FA93-6269-4ACF-A756-832E79B36A2A (Elevated Risk Level)
- 797C4446-5C73-484F-8E58-0CCA08D6DF6C (Moderate Risk Level)
- 75A4318B-94A2-4323-BA42-2CA6DB29AAFE (Minor Risk Level)

You can specify multiple values separated by commas.

Expand Down
17 changes: 17 additions & 0 deletions exchange/exchange-ps/exchange/Set-DlpCompliancePolicy.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,7 @@ Set-DlpCompliancePolicy [-Identity] <PolicyIdParameter>
[-EndpointDlpAdaptiveScopes <MultiValuedProperty>]
[-EndpointDlpAdaptiveScopesException <MultiValuedProperty>]
[-EndpointDlpExtendedLocations <String>]
[-EnforcementPlanes <MultiValuedProperty>]
[-ExceptIfOneDriveSharedBy <RecipientIdParameter[]>]
[-ExceptIfOneDriveSharedByMemberOf <RecipientIdParameter[]>]
[-ExchangeAdaptiveScopes <MultiValuedProperty>]
Expand Down Expand Up @@ -570,6 +571,22 @@ Accept pipeline input: False
Accept wildcard characters: False
```

### -EnforcementPlanes
{{ Fill EnforcementPlanes Description }}

```yaml
Type: MultiValuedProperty
Parameter Sets: (All)
Aliases:
Applicable: Security & Compliance

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ExceptIfOneDriveSharedBy
The ExceptIfOneDriveSharedBy parameter specifies the users to exclude from the DLP policy (the sites of the OneDrive for Business user accounts are included in the policy). You identify the users by UPN (laura@contoso.onmicrosoft.com).

Expand Down
10 changes: 8 additions & 2 deletions exchange/exchange-ps/exchange/Set-DlpComplianceRule.md
Original file line number Diff line number Diff line change
Expand Up @@ -187,7 +187,7 @@ This example modifies the access scope and blocking behavior of a DLP compliance

### Example 2
```powershell
Contents of the file named C:\Data\Sensitive Type.txt:
# Contents of the file named C:\Data\Sensitive Type.txt:

{
"Version": "1.0",
Expand Down Expand Up @@ -3237,7 +3237,13 @@ Accept wildcard characters: False
```

### -SharedByIRMUserRisk
{{ Fill SharedByIRMUserRisk Description }}
The SharedByIRMUserRisk parameter specifies the risk category of the user performing the violating action. Valid values are:

- FCB9FA93-6269-4ACF-A756-832E79B36A2A (Elevated Risk Level)
- 797C4446-5C73-484F-8E58-0CCA08D6DF6C (Moderate Risk Level)
- 75A4318B-94A2-4323-BA42-2CA6DB29AAFE (Minor Risk Level)

You can specify multiple values separated by commas.

```yaml
Type: MultiValuedProperty
Expand Down