Export (0) Print
Expand All
Expand Minimize

Set-HostedContentFilterRule

Exchange 2013
 

Applies to: Exchange Online Protection, Exchange Online

Topic Last Modified: 2013-06-18

This cmdlet is available only in the cloud-based service.

Use the Set-HostedContentFilterRule cmdlet to modify the settings of content filter rules in your cloud-based organization.

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

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

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

Set-HostedContentFilterRule "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-spam" entry in the Feature permissions in Exchange Online topic.

 

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter

The Identity parameter specifies the content filter rule that you want to modify. You can use any value that uniquely identifies the rule. For example, you can specify the name, GUID, or distinguished name (DN) of the content 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

This parameter is reserved for internal Microsoft use.

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.

HostedContentFilterPolicy

Optional

Microsoft.Exchange.Configuration.Tasks.HostedContentFilterPolicyIdParameter

The HostedContentFilterPolicy parameter specifies the content filter policy to apply to messages that match the conditions defined by this content 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 content filter policy. And, you can't specify a content filter policy that's already associated with another content filter rule.

Name

Optional

System.String

The Name parameter specifies a unique name for the content 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.

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.

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft