Share via

Set-IPAllowListProvider

  • 项目

 

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

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

使用 Set-IPAllowListProvider cmdlet 可以在安装了边缘传输服务器角色或集线器传输服务器角色的计算机上，修改特定 IP 允许列表提供程序配置的配置信息。

语法

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

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

详细说明

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

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

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

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

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

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.IPAllowListProviderIdParameter

Identity 参数可以接受字符串值（Name 值）或 GUID。

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 允许列表提供程序服务。

Instance

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.IPAllowListProvider

使用　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。

WhatIf

可选

System.Management.Automation.SwitchParameter

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

输入类型

返回类型

错误

错误 说明

 

示例

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

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

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