Set-IPBlockListProvider

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2007-06-28

使用 Set-IPBlockListProvider cmdlet 可以在安装了边缘传输服务器角色或集线器传输服务器角色的计算机上删除特定 IP 阻止列表提供程序配置的配置信息。

语法

Set-IPBlockListProvider -Identity <IPBlockListProviderIdParameter> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-LookupDomain <SmtpDomain>] [-Name <String>] [-Priority <Int32>] [-RejectionResponse <AsciiString>] [-WhatIf [<SwitchParameter>]]

Set-IPBlockListProvider [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Instance <IPBlockListProvider>] [-IPAddressesMatch <MultiValuedProperty>] [-LookupDomain <SmtpDomain>] [-Name <String>] [-Priority <Int32>] [-RejectionResponse <AsciiString>] [-WhatIf [<SwitchParameter>]]

详细说明

使用 Set-IPBlockListProvider cmdlet 可以修改现有 IP 阻止列表提供程序配置。连接筛选器代理将使用此配置。Identity 参数是必需的。

若要运行 Set-IPBlockListProvider cmdlet，必须为您使用的帐户委派下列角色：

• Exchange Server 管理员角色和目标服务器的本地 Administrators 组

若要在安装了边缘传输服务器角色的计算机上运行 Set-IPBlockListProvider cmdlet，必须使用作为该计算机的本地 Administrators 组成员的帐户登录。

有关管理 Microsoft Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。

参数

参数	必需	类型	说明
Identity	必需	Microsoft.Exchange.Configuration.Tasks.IPBlockListProviderIdParameter	Identity 参数可以接受字符串值（Name 值）或 GUID。
AnyMatch	可选	System.Boolean	Enabled 参数的有效输入是 $true 或 $false。默认设置是 $false。如果将 AnyMatch 参数设置为 $true，则连接筛选器代理会将由 IP 阻止列表提供程序服务所返回的任何 IP 地址状态代码视为匹配项。
BitmaskMatch	可选	System.Net.IPAddress	如果为 BitmaskMatch 参数配置 IP 地址，则连接筛选器代理只处理与 IP 阻止列表提供程序服务所返回的相同 IP 地址状态代码匹配的邮件。
Confirm	可选	System.Management.Automation.SwitchParameter	Confirm 参数将导致命令暂停处理，并且需要您在继续处理之前确认该命令将执行的操作。您不必使用 Confirm 参数指定值。
DomainController	可选	Microsoft.Exchange.Data.Fqdn	若要指定将此配置更改写入 Active Directory 目录服务的域控制器的完全限定的域名，请在命令中包含 DomainController 参数。运行边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色只会写入本地 ADAM 实例。
Enabled	可选	System.Boolean	Enabled 参数的有效输入是 $true 或 $false。默认设置是 $true。如果将 Enabled 参数设置为 $true，则连接筛选器代理将按照为此 IP 阻止列表提供程序配置所设置的优先级来查询 IP 阻止列表提供程序服务。
Instance	可选	Microsoft.Exchange.Data.Directory.SystemConfiguration.IPBlockListProvider	使用 Instance 参数可以将整个对象传递给此命令以进行处理。该参数主要用于必须将整个对象传递给命令的脚本。
IPAddressesMatch	可选	Microsoft.Exchange.Data.MultiValuedProperty	如果为 IPAddressesMatch 参数配置 IP 地址，则连接筛选器代理只处理与 IP 阻止列表提供程序服务所返回的 IP 地址状态代码匹配的邮件。
LookupDomain	可选	Microsoft.Exchange.Data.SmtpDomain	此参数指定连接筛选器代理用于查询更新的 IP 阻止列表数据的域名。
Name	可选	System.String	此参数指定 IP 阻止列表提供程序服务的名称。如果更改此值，则 Identity 参数的字符串值不更改。
Priority	可选	System.Int32	通过设置 Priority 参数，可以配置连接筛选器代理在查询您已配置的 IP 阻止列表提供程序服务时所使用的查询顺序。默认情况下，每次添加新的 IP 阻止列表提供程序时，将为该条目分配优先级 N+1，其中，N 是您已配置的 IP 阻止列表提供程序服务的编号。 如果将 Priority 参数设置为与另一个 IP 阻止列表提供程序相同的值，则其他 IP 阻止列表提供程序将增加 1。
RejectionResponse	可选	Microsoft.Exchange.Data.AsciiString	RejectionResponse 参数接受字符串。当 IP 阻止列表提供程序服务检查到匹配的发件人 IP 地址时，连接筛选器代理将阻止该发件人的邮件。请在这里输入想要在 SMTP 会话中传递给这些被阻止的发件人的邮件正文。建议您在响应中指定 IP 阻止列表提供程序服务，以便合法发件人可以与提供程序服务联系。该参数不能超过 240 个字符。传递参数时，如果短语包含空格，则必须将 RejectionResponse 参数放在双引号内，如下所示： "Originating IP addresses matched to Example.com's IP Block List Provider service".
WhatIf	可选	System.Management.Automation.SwitchParameter	WhatIf 参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。您不必使用 WhatIf 参数指定值。

输入类型

返回类型

错误

错误	说明

示例

以下代码示例显示两个 Set-IPBlockListProvider 命令。

第一个代码示例显示 Set-IPBlockListProvider 命令通过设置连接筛选器，将 IP 阻止列表提供程序服务所引起的任何匹配视为可操作的事件。

第二个代码示例显示 Set-IPBlockListProvider 命令将现有配置的优先级设置为 1。

Set-IPBlockListProvider -Identity Example.com -AnyMatch:$true 
Set-IPBlockListProvider -Identity Example.com -Priority 1