Add-IPBlockListProvider

 

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

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

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

语法

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

详细说明

连接筛选器代理将使用 IP 阻止列表提供程序配置。

Name 参数和 LookupDomain 参数是必需的。如果不传递必需的参数，Exchange 命令行管理程序将提示您输入它们。

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

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

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

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

参数

参数	必需	类型	说明
LookupDomain	必需	Microsoft.Exchange.Data.SmtpDomain	这是连接筛选器代理用于查询更新的 IP 阻止列表数据的域名。
Name	必需	System.String	IP 阻止列表提供程序服务的名称
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 目录服务的域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。已安装边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色只会写入本地 ADAM 实例。
Enabled	可选	System.Boolean	Enabled 参数的有效输入是 $true 或 $false。默认设置是 $true。如果将 Enabled 参数设置为 $true，则连接筛选器代理将按照为此 IP 阻止列表提供程序配置所设置的优先级来查询 IP 阻止列表提供程序服务。
IPAddressesMatch	可选	Microsoft.Exchange.Data.MultiValuedProperty	将 IPAddressesMatch 参数配置为使用 IP 地址时，连接筛选器代理将只处理与 IP 阻止列表提供程序服务所返回的相同 IP 地址状态代码匹配的邮件。
Priority	可选	System.Int32	通过设置 Priority 参数，可以配置连接筛选器代理在查询您已配置的 IP 阻止列表提供程序服务时所使用的查询顺序。默认情况下，每次添加新的 IP 阻止列表提供程序时，将为该条目分配优先级 N+1，其中，N 是您已配置的 IP 阻止列表提供程序服务的编号。 如果将 Priority 参数设置为与另一个 IP 阻止列表提供程序服务相同的值，则第一个添加的 IP 阻止列表提供程序服务的优先级将增加 1。
RejectionResponse	可选	Microsoft.Exchange.Data.AsciiString	RejectionResponse 参数接受字符串。当 IP 阻止列表提供程序服务检查到匹配的发件人 IP 地址时，连接筛选器代理将阻止该发件人的邮件。请在这里输入想要在 SMTP 会话中传递给这些被阻止的发件人的邮件正文。建议您在响应中指定 IP 阻止列表提供程序服务，以便合法的发件人可以与 IP 阻止列表提供程序服务联系。该参数不能超过 240 个字符。传递参数时，如果短语包含空格，则必须将 RejectionResponse 参数放在双引号内，如下所示： "Originating IP addressed matched to Example.com's IP Block List provider service".
TemplateInstance	可选	System.Management.Automation.PSObject	将现有对象提供给此参数时，该命令将使用该对象的配置在本地服务器或目标服务器上创建与对象完全相同的副本。
WhatIf	可选	System.Management.Automation.SwitchParameter	WhatIf 参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。您不必使用 WhatIf 参数指定值。

输入类型

返回类型

错误

错误	说明

示例

第一个代码示例显示有必需参数的 Add-IPBlockListProvider 命令。它还显示如何添加新的 IP 阻止列表提供程序，并设置拒绝响应。

第二个代码示例显示有必需参数的 Add-IPBlockListProvider 命令，并显示如何配置从提供程序返回的位掩码值。

Add-IPBlockListProvider -Name:Example -LookupDomain:Example.com -RejectionResponse "Originating IP addressed matched to Example.com's IP Block List provider service"
Add-IPBlockListProvider -Name:Example -LookupDomain:Example.com -BitmaskMatch 127.1.0.1