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: exchange/exchange-ps/exchange/New-SafeAttachmentPolicy.md
+8-9Lines changed: 8 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -84,9 +84,9 @@ The Action parameter specifies the action for the safe attachment policy. Valid
84
84
- Block: Block the email message that contains the malware attachment. This is the default value.
85
85
- 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).
86
86
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).
88
88
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.
90
90
91
91
The results of all actions are available in message trace.
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.
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:
241
238
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.
243
240
- $false: Messages that contain malware attachments aren't delivered to another email address. This is the default value.
244
241
245
242
**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).
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.
262
261
263
262
**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).
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.
52
52
53
53
## PARAMETERS
54
54
@@ -81,9 +81,9 @@ The Action parameter specifies the action for the safe attachment policy. Valid
81
81
- Block: Block the email message that contains the malware attachment. This is the default value.
82
82
- 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).
83
83
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).
85
85
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.
87
87
88
88
The results of all actions are available in message trace.
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.
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:
206
203
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.
208
205
- $false: Messages that contain malware attachments aren't delivered to another email address. This is the default value.
209
206
210
207
**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).
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.
227
226
228
227
**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).
0 commit comments