Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

Set-MalwareFilterRule

Exchange 2013
 

Applies to: Exchange Server 2013, Exchange Online Protection, Exchange Online

Topic Last Modified: 2013-06-18

Use the Set-MalwareFilterRule cmdlet to modify malware filter rules in your organization.

For information about the parameter sets in the Syntax section below, see Syntax.

Set-MalwareFilterRule -Identity <RuleIdParameter> [-Comments <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptIfRecipientDomainIs <Word[]>] [-ExceptIfSentTo <RecipientIdParameter[]>] [-ExceptIfSentToMemberOf <RecipientIdParameter[]>] [-MalwareFilterPolicy <MalwareFilterPolicyIdParameter>] [-Name <String>] [-Priority <Int32>] [-RecipientDomainIs <Word[]>] [-SentTo <RecipientIdParameter[]>] [-SentToMemberOf <RecipientIdParameter[]>] [-WhatIf [<SwitchParameter>]]

This example adds an exception to the malware filter rule named Contoso Recipients for members of the distribution group named Contoso Human Resources.

Set-MalwareFilterRule "Contoso Recipients" -ExceptIfSentToMemberOf "Contoso Human Resources"

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Anti-malware" entry in the Anti-Spam and Anti-Malware Permissions topic.

 

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter

The Identity parameter specifies the malware filter rule that you want to view. You can use any value that uniquely identifies the rule. For example, you can use the name, GUID, or distinguished name (DN) of the malware filter rule.

Comments

Optional

System.String

The Comments parameter specifies informative comments for the rule, such as what the rule is used for or how it has changed over time. The length of the comment can't exceed 1024 characters.

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory.

ExceptIfRecipientDomainIs

Optional

Microsoft.Exchange.Data.Word[]

The ExceptIfRecipientDomainIs parameter specifies the recipient's domain. The rule isn't applied to messages sent to recipients whose email addresses are in the specified domain.

ExceptIfSentTo

Optional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

The ExceptIfSentTo parameter specifies a recipient. The rule isn't applied to messages sent to the specified recipient.

ExceptIfSentToMemberOf

Optional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

The ExceptIfSentToMemberOf parameter specifies a distribution group. The rule isn't applied to messages where any recipient is a member of the specified group.

NoteNote:
If the distribution group is removed after creation of the rule, no exception is made.

MalwareFilterPolicy

Optional

Microsoft.Exchange.Configuration.Tasks.MalwareFilterPolicyIdParameter

The MalwareFilterPolicy parameter specifies the malware filter policy to apply to messages that match the conditions defined by this malware filter rule.

You can use any value that uniquely identifies the policy. For example, you can specify the name, GUID, or distinguished name (DN) of the content filter policy.

NoteNote:
You can't specify the default malware filter policy. And, you can't specify a malware filter policy that's already associated with another malware filter rule.

Name

Optional

System.String

The Name parameter specifies a unique name for the malware filter rule.

Priority

Optional

System.Int32

The Priority parameter specifies the priority for this rule. Rules with a lower priority value are processed first. If you modify the priority of the rule, the position of the rule in the rule list changes to match the priority that you specified.

The value of this parameter must be greater than or equal to 0, and must be one less than the total number of rules in your organization. For example, if you configured 8 rules, you can set this parameter to any value from 0 through 7.

RecipientDomainIs

Optional

Microsoft.Exchange.Data.Word[]

The RecipientDomainIs parameter specifies the recipient's domain. The rule is applied to messages sent to recipients whose email addresses are in the specified domain.

This parameter is used to define a rule condition.

SentTo

Optional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

The SentTo parameter specifies a recipient. The rule is applied to messages sent to the specified recipient.

This parameter is used to define a rule condition.

SentToMemberOf

Optional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

The SentToMemberOf parameter specifies a distribution group. The rule is applied to messages where any recipient is a member of the specified group.

NoteNote:
If the distribution group is removed after creation of the rule, no action is taken.
This parameter is used to define a rule condition.

This parameter is used to define a rule condition.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch.

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.

 
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.