en-US

Action

Parameter of SafeAttachmentPolicy

Applies to : Exchange Online

Description

The Action parameter specifies the action for the safe attachment policy. Valid values are:

  • Allow: Deliver the message if malware is detected in the attachment and track scanning results. This value corresponds to Monitor for the Safe Attachments unknown malware response property of the policy in the Microsoft Defender portal.
  • Block: Block the email message that contains the malware attachment. This value is the default.
  • 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.

The value of this parameter is meaningful only when the value of the Enable parameter is $true (the default value is $false).

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 Defender portal), use the value $false for the Enable parameter.

The results of all actions are available in message trace.

Microsoft Learn documentation

Characteristics

Type
SafeAttachmentAction
Parameter sets
(All)

Apply

This value type (SafeAttachmentAction) must be built by hand: see the examples on the policy page and the Microsoft documentation.