Commands › Exchange Online

Set-HostedOutboundSpamFilterPolicy

Exchange Online ExchangeOnlineManagement Set-*

Modify outbound spam filter policies in your cloud-based organization.

Quick start script

# Set-HostedOutboundSpamFilterPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-HostedOutboundSpamFilterPolicy
$before | Format-List

# 3. Make the change (dry run first)
Set-HostedOutboundSpamFilterPolicy -Identity <HostedOutboundSpamFilterPolicyIdParameter> -WhatIf
Set-HostedOutboundSpamFilterPolicy -Identity <HostedOutboundSpamFilterPolicyIdParameter>

# 4. Verify and diff
$after = Get-HostedOutboundSpamFilterPolicy
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

Set-HostedOutboundSpamFilterPolicy [-Identity] <HostedOutboundSpamFilterPolicyIdParameter>
 [-ActionWhenThresholdReached <OutboundRecipientLimitsExceededAction>]
 [-AdminDisplayName <String>]
 [-AutoForwardingMode <AutoForwardingMode>]
 [-BccSuspiciousOutboundAdditionalRecipients <MultiValuedProperty>]
 [-BccSuspiciousOutboundMail <Boolean>]
 [-Confirm]
 [-NotifyOutboundSpam <Boolean>]
 [-NotifyOutboundSpamRecipients <MultiValuedProperty>]
 [-RecipientLimitExternalPerHour <UInt32>]
 [-RecipientLimitInternalPerHour <UInt32>]
 [-RecipientLimitPerDay <UInt32>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (13)

Parameter	Type	Required	What it controls
-Identity	HostedOutboundSpamFilterPolicyIdParameter	yes	The Identity parameter specifies the outbound spam filter policy you want to modify. You can use any value that uniquely identifies the policy. For example:
-ActionWhenThresholdReached	OutboundRecipientLimitsExceededAction		The ActionWhenThresholdReach parameter specifies the action to take when any of the limits specified in the policy are reached. Valid values are:
-AdminDisplayName	String		The AdminDisplayName parameter specifies a description for the policy. If the value contains spaces, enclose the value in quotation marks (").
-AutoForwardingMode	AutoForwardingMode		The AutoForwardingMode specifies how the policy controls automatic email forwarding to external recipients. Valid values are:
-BccSuspiciousOutboundAdditionalRecipients	MultiValuedProperty		The BccSuspiciousOutboundAdditionalRecipients parameter specifies an email address to add to the Bcc field of outgoing spam messages. You can specify multiple email addresses separated by commas.
-BccSuspiciousOutboundMail	Boolean		The BccSuspiciousOutboundMail parameter specifies whether to add recipients to the Bcc field of outgoing spam messages. Valid values are:
-Confirm	SwitchParameter		The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding.
-NotifyOutboundSpam	Boolean		Note: This setting is replaced by the default alert policy named User restricted from sending email, which sends notification messages to admins. We recommend that you use the alert policy rather than this...
-NotifyOutboundSpamRecipients	MultiValuedProperty		Note: This setting is replaced by the default alert policy named User restricted from sending email, which sends notification messages to admins. We recommend that you use the alert policy rather than this...
-RecipientLimitExternalPerHour	UInt32		The RecipientLimitExternalPerHour parameter specifies the maximum number of external recipients that a user can send to within an hour. A valid value is 0 to 10000. The default value is 0, which means the service...
-RecipientLimitInternalPerHour	UInt32		The RecipientLimitInternalPerHour parameter specifies the maximum number of internal recipients that a user can send to within an hour. A valid value is 0 to 10000. The default value is 0, which means the service...
-RecipientLimitPerDay	UInt32		The RecipientLimitPerDay parameter specifies the maximum number of recipients that a user can send to within a day. A valid value is 0 to 10000. The default value is 0, which means the service defaults are used. For...
-WhatIf	SwitchParameter		The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.