Add-IPAllowListProvider

 

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

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

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

语法

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

详细说明

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

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

若要运行 Add-IPAllowListProvider cmdlet,必须为您使用的帐户委派下列角色:

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

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

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

参数

参数 必需 类型 说明

LookupDomain

必需

Microsoft.Exchange.Data.SmtpDomain

这是连接筛选器代理用于查询更新的 IP 允许列表信息的域名。

Name

必需

System.String

IP 允许列表提供程序服务的名称

AnyMatch

可选

System.Boolean

AnyMatch 参数的有效输入是 $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 允许列表提供程序服务。

IPAddressesMatch

可选

Microsoft.Exchange.Data.MultiValuedProperty

如果为 IPAddressMatch 参数配置 IP 地址,则连接筛选器代理只处理与 IP 允许列表提供程序服务所返回的 IP 地址状态代码匹配的邮件。

Priority

可选

System.Int32

通过设置 Priority 参数,可以配置连接筛选器代理在查询您已配置的 IP 允许列表提供程序服务时所使用的查询顺序。默认情况下,每次添加新的 IP 允许列表提供程序服务时,将为该条目分配优先级 N+1,其中,N 是您配置的 IP 允许列表提供程序服务的编号。

如果将 Priority 参数设置为与另一个 IP 允许列表提供程序服务相同的值,则第一个添加的 IP 允许列表提供程序服务的优先级会增加 1。

TemplateInstance

可选

System.Management.Automation.PSObject

将现有对象提供给此参数时,该命令将使用该对象的配置在本地服务器或目标服务器上创建完全重复的对象。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数,您可以查看要发生的更改,而不必应用任何这些更改。您不必使用 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

 

 

示例

下列代码示例显示拥有必需参数的 Add-IPAllowListProvider 命令:LookupDomainName

Add-IPAllowListProvider -Name:Example -LookupDomain:Example.com