Skip to content

Commit bfb1289

Browse files
chrisdachrisda
committed
Added remaining params
ApplyHtmlDisclaimer, PrependSubject, and [ExceptIf]WithImportance.
1 parent 8122c97 commit bfb1289

File tree

2 files changed

+182
-5
lines changed

2 files changed

+182
-5
lines changed

‎exchange/exchange-ps/exchange/New-DlpComplianceRule.md

Lines changed: 91 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ New-DlpComplianceRule [-Name] <String> -Policy <PolicyIdParameter>
2727
[-AddRecipients <PswsHashtable>]
2828
[-AnyOfRecipientAddressContainsWords <MultiValuedProperty>]
2929
[-AnyOfRecipientAddressMatchesPatterns <MultiValuedProperty>]
30+
[-ApplyHtmlDisclaimer <PswsHashtable>]
3031
[-BlockAccess <Boolean>]
3132
[-BlockAccessScope <BlockAccessScope>]
3233
[-Comment <String>]
@@ -72,6 +73,7 @@ New-DlpComplianceRule [-Name] <String> -Policy <PolicyIdParameter>
7273
[-ExceptIfSubjectMatchesPatterns <MultiValuedProperty>]
7374
[-ExceptIfSubjectOrBodyContainsWords <MultiValuedProperty>]
7475
[-ExceptIfSubjectOrBodyMatchesPatterns <MultiValuedProperty>]
76+
[-ExceptIfWithImportance <WithImportance>]
7577
[-ExpiryDate <DateTime>]
7678
[-From <RecipientIdParameter[]>]
7779
[-FromAddressContainsWords <MultiValuedProperty>]
@@ -92,6 +94,7 @@ New-DlpComplianceRule [-Name] <String> -Policy <PolicyIdParameter>
9294
[-NotifyPolicyTipCustomText <String>]
9395
[-NotifyPolicyTipCustomTextTranslations <MultiValuedProperty>]
9496
[-NotifyUser <MultiValuedProperty>]
97+
[-PrependSubject <String>]
9598
[-Priority <Int32>]
9699
[-ProcessingLimitExceeded <Boolean>]
97100
[-RecipientDomainIs <MultiValuedProperty>]
@@ -110,6 +113,7 @@ New-DlpComplianceRule [-Name] <String> -Policy <PolicyIdParameter>
110113
[-SubjectOrBodyContainsWords <MultiValuedProperty>]
111114
[-SubjectOrBodyMatchesPatterns <MultiValuedProperty>]
112115
[-WhatIf]
116+
[-WithImportance <WithImportance>]
113117
[<CommonParameters>]
114118
```
115119

@@ -267,6 +271,28 @@ Accept pipeline input: False
267271
Accept wildcard characters: False
268272
```
269273

274+
### -ApplyHtmlDisclaimer
275+
The ApplyHtmlDisclaimer parameter specifies an action for the rule that adds disclaimer text to messages.This parameter uses the syntax: `@{Text = "Disclaimer text"; Location = <Append | Prepend>; FallbackAction = <Wrap | Ignore | Reject> }`.
276+
277+
- Text: Specifies the disclaimer text to add. Disclaimer text can include HTML tags and inline cascading style sheet (CSS) tags. You can add images using the IMG tag.
278+
- Location: Specifies where to insert the HTML disclaimer text in the body of messages. Append = Add to the end of the message body. Prepend = Insert at the beginning of the message body.
279+
- FallbackAction: Specifies what to do if the HTML disclaimer can't be added to a message. Wrap = The original message is wrapped in a new message envelope, and the disclaimer is used as the message body for the new message. Ignore = The rule is ignored and the message is delivered without the disclaimer. Reject = The message is rejected.
280+
281+
You can use this condition in DLP policies that are scoped only to Exchange.
282+
283+
```yaml
284+
Type: PswsHashtable
285+
Parameter Sets: (All)
286+
Aliases:
287+
Applicable: Security & Compliance Center
288+
289+
Required: False
290+
Position: Named
291+
Default value: None
292+
Accept pipeline input: False
293+
Accept wildcard characters: False
294+
```
295+
270296
### -BlockAccess
271297
The BlockAccess parameter specifies an action for the DLP rule that blocks access to the source item when the conditions of the rule are met. Valid values are:
272298

@@ -342,9 +368,7 @@ Accept wildcard characters: False
342368
```
343369

344370
### -ContentCharacterSetContainsWords
345-
The ContentCharacterSetContainsWords parameter specifies a condition for the rule that looks for character set names in messages.
346-
347-
To specify multiple words, this parameter uses the syntax: `Word1,word2,...wordN`. Don't use leading or trailing spaces.
371+
The ContentCharacterSetContainsWords parameter specifies a condition for the rule that looks for character set names in messages. You can specify multiple values separated by commas.
348372

349373
Supported character sets are `big5, din_66003, euc-jp, euc-kr, gb18030, gb2312, hz-gb-2312, iso-2022-jp, iso-2022-kr, iso-8859-1, iso-8859-13, iso-8859-15, iso-8859-2, iso-8859-3, iso-8859-4, iso-8859-5, iso-8859-6, iso-8859-7, iso-8859-8, iso-8859-9, koi8-r, koi8-u, ks_c_5601-1987, ns_4551-1, sen_850200_b, shift_jis, utf-7, utf-8, windows-1250, windows-1251, windows-1252, windows-1253, windows-1254, windows-1255, windows-1256, windows-1257, windows-1258, windows-874`.
350374

@@ -1164,6 +1188,28 @@ Accept pipeline input: False
11641188
Accept wildcard characters: False
11651189
```
11661190

1191+
### -ExceptIfWithImportance
1192+
The ExceptIfWithImportance parameter specifies an exception for the rule that looks for messages with the specified importance level. Valid values are:
1193+
1194+
- Low
1195+
- Normal
1196+
- High
1197+
1198+
You can use this exception in DLP policies that are scoped only to Exchange.
1199+
1200+
```yaml
1201+
Type: WithImportance
1202+
Parameter Sets: (All)
1203+
Aliases:
1204+
Applicable: Security & Compliance Center
1205+
1206+
Required: False
1207+
Position: Named
1208+
Default value: None
1209+
Accept pipeline input: False
1210+
Accept wildcard characters: False
1211+
```
1212+
11671213
### -ExpiryDate
11681214
This parameter is reserved for internal Microsoft use.
11691215

@@ -1581,6 +1627,26 @@ Accept pipeline input: False
15811627
Accept wildcard characters: False
15821628
```
15831629

1630+
### -PrependSubject
1631+
The PrependSubject parameter specifies an action for the rule that adds text to add to the beginning of the Subject field of messages. The value for this parameter is the text that you want to add. If the text contains spaces, enclose the value in quotation marks (").
1632+
1633+
Consider ending the value for this parameter with a colon (:) and a space, or at least a space, to separate it from the original subject.
1634+
1635+
You can use this condition in DLP policies that are scoped only to Exchange.
1636+
1637+
```yaml
1638+
Type: String
1639+
Parameter Sets: (All)
1640+
Aliases:
1641+
Applicable: Security & Compliance Center
1642+
1643+
Required: False
1644+
Position: Named
1645+
Default value: None
1646+
Accept pipeline input: False
1647+
Accept wildcard characters: False
1648+
```
1649+
15841650
### -Priority
15851651
The Priority parameter specifies a priority value for the rule that determines the order of rule processing within the policy. A lower integer value indicates a higher priority, the value 0 is the highest priority, and rules can't have the same priority value.
15861652

@@ -1931,6 +1997,28 @@ Accept pipeline input: False
19311997
Accept wildcard characters: False
19321998
```
19331999

2000+
### -WithImportance
2001+
The WithImportance parameter specifies a condition for the rule that looks for messages with the specified importance level. Valid values are:
2002+
2003+
- Low
2004+
- Normal
2005+
- High
2006+
2007+
You can use this condition in DLP policies that are scoped only to Exchange.
2008+
2009+
```yaml
2010+
Type: WithImportance
2011+
Parameter Sets: (All)
2012+
Aliases:
2013+
Applicable: Security & Compliance Center
2014+
2015+
Required: False
2016+
Position: Named
2017+
Default value: None
2018+
Accept pipeline input: False
2019+
Accept wildcard characters: False
2020+
```
2021+
19342022
### CommonParameters
19352023
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/p/?LinkID=113216).
19362024

‎exchange/exchange-ps/exchange/Set-DlpComplianceRule.md

Lines changed: 91 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ Set-DlpComplianceRule [-Identity] <ComplianceRuleIdParameter>
2727
[-AddRecipients <PswsHashtable>]
2828
[-AnyOfRecipientAddressContainsWords <MultiValuedProperty>]
2929
[-AnyOfRecipientAddressMatchesPatterns <MultiValuedProperty>]
30+
[-ApplyHtmlDisclaimer <PswsHashtable>]
3031
[-BlockAccess <Boolean>]
3132
[-BlockAccessScope <BlockAccessScope>]
3233
[-Comment <String>]
@@ -72,6 +73,7 @@ Set-DlpComplianceRule [-Identity] <ComplianceRuleIdParameter>
7273
[-ExceptIfSubjectMatchesPatterns <MultiValuedProperty>]
7374
[-ExceptIfSubjectOrBodyContainsWords <MultiValuedProperty>]
7475
[-ExceptIfSubjectOrBodyMatchesPatterns <MultiValuedProperty>]
76+
[-ExceptIfWithImportance <WithImportance>]
7577
[-ExpiryDate <DateTime>]
7678
[-From <RecipientIdParameter[]>]
7779
[-FromAddressContainsWords <MultiValuedProperty>]
@@ -91,6 +93,7 @@ Set-DlpComplianceRule [-Identity] <ComplianceRuleIdParameter>
9193
[-NotifyPolicyTipCustomText <String>]
9294
[-NotifyPolicyTipCustomTextTranslations <MultiValuedProperty>]
9395
[-NotifyUser <MultiValuedProperty>]
96+
[-PrependSubject <String>]
9497
[-Priority <Int32>]
9598
[-ProcessingLimitExceeded <Boolean>]
9699
[-RecipientDomainIs <MultiValuedProperty>]
@@ -251,6 +254,28 @@ Accept pipeline input: False
251254
Accept wildcard characters: False
252255
```
253256

257+
### -ApplyHtmlDisclaimer
258+
The ApplyHtmlDisclaimer parameter specifies an action for the rule that adds disclaimer text to messages.This parameter uses the syntax: `@{Text = "Disclaimer text"; Location = <Append | Prepend>; FallbackAction = <Wrap | Ignore | Reject> }`.
259+
260+
- Text: Specifies the disclaimer text to add. Disclaimer text can include HTML tags and inline cascading style sheet (CSS) tags. You can add images using the IMG tag.
261+
- Location: Specifies where to insert the HTML disclaimer text in the body of messages. Append = Add to the end of the message body. Prepend = Insert at the beginning of the message body.
262+
- FallbackAction: Specifies what to do if the HTML disclaimer can't be added to a message. Wrap = The original message is wrapped in a new message envelope, and the disclaimer is used as the message body for the new message. Ignore = The rule is ignored and the message is delivered without the disclaimer. Reject = The message is rejected.
263+
264+
You can use this condition in DLP policies that are scoped only to Exchange.
265+
266+
```yaml
267+
Type: PswsHashtable
268+
Parameter Sets: (All)
269+
Aliases:
270+
Applicable: Security & Compliance Center
271+
272+
Required: False
273+
Position: Named
274+
Default value: None
275+
Accept pipeline input: False
276+
Accept wildcard characters: False
277+
```
278+
254279
### -BlockAccess
255280
The BlockAccess parameter specifies an action for the DLP rule that blocks access to the source item when the conditions of the rule are met. Valid values are:
256281

@@ -326,9 +351,9 @@ Accept wildcard characters: False
326351
```
327352

328353
### -ContentCharacterSetContainsWords
329-
The ContentCharacterSetContainsWords parameter specifies a condition for the rule that looks for character set names in messages.
354+
The ContentCharacterSetContainsWords parameter specifies a condition for the rule that looks for character set names in messages. You can specify multiple values separated by commas.
330355

331-
To specify multiple words or phrases, this parameter uses the syntax: `Word1,"Phrase with spaces",word2,...wordN`. Don't use leading or trailing spaces.
356+
Supported character sets are `big5, din_66003, euc-jp, euc-kr, gb18030, gb2312, hz-gb-2312, iso-2022-jp, iso-2022-kr, iso-8859-1, iso-8859-13, iso-8859-15, iso-8859-2, iso-8859-3, iso-8859-4, iso-8859-5, iso-8859-6, iso-8859-7, iso-8859-8, iso-8859-9, koi8-r, koi8-u, ks_c_5601-1987, ns_4551-1, sen_850200_b, shift_jis, utf-7, utf-8, windows-1250, windows-1251, windows-1252, windows-1253, windows-1254, windows-1255, windows-1256, windows-1257, windows-1258, windows-874`.
332357

333358
```yaml
334359
Type: MultiValuedProperty
@@ -1131,6 +1156,28 @@ Accept pipeline input: False
11311156
Accept wildcard characters: False
11321157
```
11331158

1159+
### -ExceptIfWithImportance
1160+
The ExceptIfWithImportance parameter specifies an exception for the rule that looks for messages with the specified importance level. Valid values are:
1161+
1162+
- Low
1163+
- Normal
1164+
- High
1165+
1166+
You can use this exception in DLP policies that are scoped only to Exchange.
1167+
1168+
```yaml
1169+
Type: WithImportance
1170+
Parameter Sets: (All)
1171+
Aliases:
1172+
Applicable: Security & Compliance Center
1173+
1174+
Required: False
1175+
Position: Named
1176+
Default value: None
1177+
Accept pipeline input: False
1178+
Accept wildcard characters: False
1179+
```
1180+
11341181
### -ExpiryDate
11351182
This parameter is reserved for internal Microsoft use.
11361183

@@ -1531,6 +1578,26 @@ Accept pipeline input: False
15311578
Accept wildcard characters: False
15321579
```
15331580

1581+
### -PrependSubject
1582+
The PrependSubject parameter specifies an action for the rule that adds text to add to the beginning of the Subject field of messages. The value for this parameter is the text that you want to add. If the text contains spaces, enclose the value in quotation marks (").
1583+
1584+
Consider ending the value for this parameter with a colon (:) and a space, or at least a space, to separate it from the original subject.
1585+
1586+
You can use this condition in DLP policies that are scoped only to Exchange.
1587+
1588+
```yaml
1589+
Type: String
1590+
Parameter Sets: (All)
1591+
Aliases:
1592+
Applicable: Security & Compliance Center
1593+
1594+
Required: False
1595+
Position: Named
1596+
Default value: None
1597+
Accept pipeline input: False
1598+
Accept wildcard characters: False
1599+
```
1600+
15341601
### -Priority
15351602
The Priority parameter specifies a priority value for the rule that determines the order of rule processing within the policy. A lower integer value indicates a higher priority, the value 0 is the highest priority, and rules can't have the same priority value.
15361603

@@ -1881,6 +1948,28 @@ Accept pipeline input: False
18811948
Accept wildcard characters: False
18821949
```
18831950

1951+
### -WithImportance
1952+
The WithImportance parameter specifies a condition for the rule that looks for messages with the specified importance level. Valid values are:
1953+
1954+
- Low
1955+
- Normal
1956+
- High
1957+
1958+
You can use this condition in DLP policies that are scoped only to Exchange.
1959+
1960+
```yaml
1961+
Type: WithImportance
1962+
Parameter Sets: (All)
1963+
Aliases:
1964+
Applicable: Security & Compliance Center
1965+
1966+
Required: False
1967+
Position: Named
1968+
Default value: None
1969+
Accept pipeline input: False
1970+
Accept wildcard characters: False
1971+
```
1972+
18841973
### CommonParameters
18851974
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/p/?LinkID=113216).
18861975

0 commit comments

Comments
 (0)