Skip to content

Commit 2a9d5c8

Browse files
committed
Merge branch 'main' into chrisda
2 parents ae288b5 + 1e3ab09 commit 2a9d5c8

File tree

2 files changed

+18
-20
lines changed

2 files changed

+18
-20
lines changed

exchange/exchange-ps/exchange/New-SafeAttachmentPolicy.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -84,9 +84,9 @@ The Action parameter specifies the action for the safe attachment policy. Valid
8484
- Block: Block the email message that contains the malware attachment. This is the default value.
8585
- DynamicDelivery: Deliver the email message with a placeholder for each email attachment. The placeholder remains until a copy of the attachment is scanned and determined to be safe. For more information, see [Dynamic Delivery in Safe Attachments policies](https://learn.microsoft.com/microsoft-365/security/office-365-security/safe-attachments-about#dynamic-delivery-in-safe-attachments-policies).
8686
87-
The value of this parameter is meaningful only if the value of the Enable parameter is also $true (the default value is $false).
87+
The value of this parameter is meaningful only when the value of the Enable parameter is $true (the default value is $false).
8888
89-
To specify no action for the safe attachment policy (corresponds to **Off** for the **Safe Attachments unknown malware response** property of the policy in the admin center), don't use the Enable parameter (the default value is $false).
89+
To specify no action for the safe attachment policy (corresponds to the value **Off** for the **Safe Attachments unknown malware response** policy setting in the admin center), use the value $false for the Enable parameter.
9090
9191
The results of all actions are available in message trace.
9292
@@ -104,10 +104,7 @@ Accept wildcard characters: False
104104
```
105105
106106
### -ActionOnError
107-
The ActionOnError parameter specifies the error handling option for Safe Attachments scanning (what to do if attachment scanning times out or an error occurs). Valid values are:
108-
109-
- $true: This is the default value. The action specified by the Action parameter is applied to messages even when the attachments aren't successfully scanned. This value is required when the Redirect parameter value is $true. Otherwise, messages might be lost.
110-
- $false: The action specified by the Action parameter isn't applied to messages when the attachments aren't successfully scanned.
107+
This parameter has been deprecated and is no longer used.
111108
112109
```yaml
113110
Type: Boolean
@@ -237,9 +234,9 @@ Accept wildcard characters: False
237234
```
238235

239236
### -Redirect
240-
The Redirect parameter specifies whether to deliver messages that were identified by Safe Attachments as containing malware attachments to another email address. Valid values are:
237+
The Redirect parameter specifies whether to deliver messages to an alternate email address if malware is detected in an attachment. Valid values are:
241238

242-
- $true: Messages that contain malware attachments are delivered to the email address specified by the RedirectAddress parameter. This value is required when the ActionOnError parameter value is $true. Otherwise, messages might be lost.
239+
- $true: Messages that contain malware attachments are delivered to the email address specified by the RedirectAddress parameter.
243240
- $false: Messages that contain malware attachments aren't delivered to another email address. This is the default value.
244241

245242
**Note**: Redirection will soon be available only for the Allow action. For more information, see [MC424899](https://admin.microsoft.com/AdminPortal/Home?#/MessageCenter/:/messages/MC424899).
@@ -258,7 +255,9 @@ Accept wildcard characters: False
258255
```
259256

260257
### -RedirectAddress
261-
The RedirectAddress parameter specifies the email address to deliver messages that were identified by Safe Attachments as containing malware attachments when the Redirect parameter is set to the value $true.
258+
The RedirectAddress parameter specifies the destination email address to deliver messages if malware is detected in an attachment.
259+
260+
The value of this parameter is meaningful only when when value of the Redirect parameter is $true and the value of the Action parameter is Allow.
262261

263262
**Note**: Redirection will soon be available only for the Allow action. For more information, see [MC424899](https://admin.microsoft.com/AdminPortal/Home?#/MessageCenter/:/messages/MC424899).
264263

exchange/exchange-ps/exchange/Set-SafeAttachmentPolicy.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -45,10 +45,10 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
4545

4646
### Example 1
4747
```powershell
48-
Set-SafeAttachmentsPolicy -Identity "Engineering Block Attachments" -Redirect $true -RedirectAddress [email protected]
48+
Set-SafeAttachmentsPolicy -Identity "Engineering Block Attachments" -QuarantineTag ContosoLimitedAccess
4949
```
5050

51-
This example modifies the existing safe attachment policy named Engineering Block Attachments to redirect detected malware attachments to [email protected].
51+
This example modifies the existing safe attachment policy named Engineering Block Attachments to set the quarantine policy to ContosoLimitedAccess.
5252

5353
## PARAMETERS
5454

@@ -81,9 +81,9 @@ The Action parameter specifies the action for the safe attachment policy. Valid
8181
- Block: Block the email message that contains the malware attachment. This is the default value.
8282
- DynamicDelivery: Deliver the email message with a placeholder for each email attachment. The placeholder remains until a copy of the attachment is scanned and determined to be safe. For more information, see [Dynamic Delivery in Safe Attachments policies](https://learn.microsoft.com/microsoft-365/security/office-365-security/safe-attachments-about#dynamic-delivery-in-safe-attachments-policies).
8383
84-
The value of this parameter is meaningful only if the value of the Enable parameter is also $true (the default value is $false).
84+
The value of this parameter is meaningful only when the value of the Enable parameter is $true (the default value is $false).
8585
86-
To specify no action for the safe attachment policy (corresponds to **Off** for the **Safe Attachments unknown malware response** property of the policy in admin center), use the Enable parameter with the value $false.
86+
To specify no action for the safe attachment policy (corresponds to the value **Off** for the **Safe Attachments unknown malware response** policy setting in the admin center), use the value $false for the Enable parameter.
8787
8888
The results of all actions are available in message trace.
8989
@@ -101,10 +101,7 @@ Accept wildcard characters: False
101101
```
102102
103103
### -ActionOnError
104-
The ActionOnError parameter specifies the error handling option for Safe Attachments scanning (what to do if attachment scanning times out or an error occurs). Valid values are:
105-
106-
- $true: This is the default value. The action specified by the Action parameter is applied to messages even when the attachments aren't successfully scanned. This value is required when the Redirect parameter value is $true. Otherwise, messages might be lost.
107-
- $false: The action specified by the Action parameter isn't applied to messages when the attachments aren't successfully scanned.
104+
This parameter has been deprecated and is no longer used.
108105
109106
```yaml
110107
Type: Boolean
@@ -202,9 +199,9 @@ Accept wildcard characters: False
202199
```
203200

204201
### -Redirect
205-
The Redirect parameter specifies whether to deliver messages that were identified by Safe Attachments as containing malware attachments to another email address. Valid values are:
202+
The Redirect parameter specifies whether to deliver messages to an alternate email address if malware is detected in an attachment. Valid values are:
206203

207-
- $true: Messages that contain malware attachments are delivered to the email address specified by the RedirectAddress parameter. This value is required when the ActionOnError parameter value is $true. Otherwise, messages might be lost.
204+
- $true: Messages that contain malware attachments are delivered to the email address specified by the RedirectAddress parameter.
208205
- $false: Messages that contain malware attachments aren't delivered to another email address. This is the default value.
209206

210207
**Note**: Redirection will soon be available only for the Allow action. For more information, see [MC424899](https://admin.microsoft.com/AdminPortal/Home?#/MessageCenter/:/messages/MC424899).
@@ -223,7 +220,9 @@ Accept wildcard characters: False
223220
```
224221

225222
### -RedirectAddress
226-
The RedirectAddress parameter specifies the email address to deliver messages that were identified by Safe Attachments as containing malware attachments when the Redirect parameter is set to the value $true.
223+
The RedirectAddress parameter specifies the destination email address to deliver messages if malware is detected in an attachment.
224+
225+
The value of this parameter is meaningful only when when value of the Redirect parameter is $true and the value of the Action parameter is Allow.
227226

228227
**Note**: Redirection will soon be available only for the Allow action. For more information, see [MC424899](https://admin.microsoft.com/AdminPortal/Home?#/MessageCenter/:/messages/MC424899).
229228

0 commit comments

Comments
 (0)