Export (0) Print
Expand All
Expand Minimize

Set-SenderReputationConfig

 

Applies to: Exchange Server 2013

Topic Last Modified: 2014-04-11

This cmdlet is available only in on-premises Exchange Server 2013.

Use the Set-SenderReputationConfig cmdlet to modify the sender reputation configuration on a Mailbox server or an Edge Transport server.

Set-SenderReputationConfig [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-InternalMailEnabled <$true | $false>] [-OpenProxyDetectionEnabled <$true | $false>] [-ProxyServerName <String>] [-ProxyServerPort <Int32>] [-ProxyServerType <None | Socks4 | Socks5 | HttpConnect | HttpPost | Telnet | Cisco | Wingate>] [-SenderBlockingEnabled <$true | $false>] [-SenderBlockingPeriod <Int32>] [-SrlBlockThreshold <Int32>] [-WhatIf [<SwitchParameter>]]

This example makes the following modifications to the sender reputation configuration:

  • It sets the sender reputation action to block all senders whose sender reputation level (SRL) rating exceeds the SRL threshold.

  • It sets the SRL blocking threshold to 6.

  • It sets the number of hours that senders are put on the blocked senders list to 36 hours.

Set-SenderReputationConfig -SenderBlockingEnabled $true -SrlBlockThreshold 6 -SenderBlockingPeriod 36

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 features" entry in the Anti-spam and anti-malware permissions topic.

 

Parameter Required Type Description

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.

The DomainController parameter isn't supported on Edge Transport servers. An Edge Transport server uses the local instance of Active Directory Lightweight Directory Services (AD LDS) to read and write data.

Enabled

Optional

System.Boolean

The Enabled parameter enables or disables sender reputation on your Exchange server. Valid input for this parameter is $true or $false. The default value is $true.

ExternalMailEnabled

Optional

System.Boolean

The ExternalMailEnabled parameter allows or prevents sender reputation from processing all messages from unauthenticated connections that are external to your Exchange organization. Valid input for this parameter is $true or $false. The default value is $true.

InternalMailEnabled

Optional

System.Boolean

The InternalMailEnabled parameter allows or prevents sender reputation from processing all messages from authenticated sender domains that are authoritative domains in your Exchange organization. Valid input for this parameter is $true or $false. The default value is $false.

OpenProxyDetectionEnabled

Optional

System.Boolean

The OpenProxyDetectionEnabled parameter allows or prevents sender reputation from connecting to the source IP address to determine if the sender is an open proxy. Valid input for this parameter is $true or $false. The default value is $true.

The values of the OpenProxyDetectionEnabled and SenderBlockingEnabled parameters can both be set to $true, but they both can't be set to $false. If one value is $true and the other is $false, and you change the $true value to $false, the parameter that was previously $false will automatically change to $true.

ProxyServerName

Optional

System.String

The ProxyServerName parameter specifies the name of your organization's proxy server. Sender reputation uses this parameter to connect to the Internet.

ProxyServerPort

Optional

System.Int32

The ProxyServerPort parameter specifies the port number that's used by your organization's proxy server. Sender reputation uses this parameter to connect to the Internet.

ProxyServerType

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ProxyType

The ProxyServerType parameter classifies your organization's proxy server. Sender reputation uses this parameter to connect to the Internet.

Valid input for this parameter is None, Socks4, Socks5, HttpConnect, HttpPost, Telnet, Cisco, or Wingate. The default value is None.

SenderBlockingEnabled

Optional

System.Boolean

The SenderBlockingEnabled parameter allows or prevents sender reputation from blocking senders when the source server fails an open proxy test. Valid input for this parameter is $true or $false. The default value is $true.

You can temporarily block senders for up to 48 hours when you use the SenderBlockingPeriod parameter.

The values of the OpenProxyDetectionEnabled and SenderBlockingEnabled parameters can both be set to $true, but they both can't be set to $false. If one value is $true and the other is $false, and you change the $true value to $false, the parameter that was previously $false will automatically change to $true.

SenderBlockingPeriod

Optional

System.Int32

The SenderBlockingPeriod parameter specifies the number of hours that a sender remains on the blocked senders list when their source IP address fails the open proxy test. Valid input for this parameter is an integer from 0 through 48. The default value is 24.

SrlBlockThreshold

Optional

System.Int32

The SrlBlockThreshold specifies the sender reputation level (SRL) rating that must be exceeded for sender reputation to block a sender. Valid input for this parameter is an integer value from 0 through 9. The default value is 7.

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