Add-IPAllowListProvider

模块:: ExchangePowerShell

适用于:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

此 cmdlet 仅在本地 Exchange 中的边缘传输服务器上可用或有效。

使用 Add-IPAllowListProvider cmdlet 可创建边缘传输服务器上连接筛选代理使用的 IP 允许列表提供程序。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Add-IPAllowListProvider
   [-Name] <String>
   -LookupDomain <SmtpDomain>
   [-AnyMatch <Boolean>]
   [-BitmaskMatch <IPAddress>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-IPAddressesMatch <MultiValuedProperty>]
   [-Priority <Int32>]
   [-WhatIf]
   [<CommonParameters>]

说明

在边缘传输服务器上，需要是本地管理员组的成员才能运行此 cmdlet。

示例

示例 1

Add-IPAllowListProvider -Name "Contoso.com Allow List" -LookupDomain allowlist.contoso.com -AnyMatch $true

本示例将添加新的 IP 允许列表提供程序并配置连接筛选，以将由 IP 允许列表提供程序返回的任何 IP 地址状态代码视为匹配项并允许连接。您可以从允许列表提供程序获取 LookupDomain 参数的值。

示例 2

Add-IPAllowListProvider -Name "Fabrikam.com Allow List" -LookupDomain allowlist.fabrikam.com -BitmaskMatch 127.1.0.1

本示例将添加 IP 允许列表提供程序，并配置从提供程序返回的位掩码值。您可以从允许列表提供程序获取 LookupDomain 和 BitmaskMatch 参数的值。

参数

-AnyMatch

AnyMatch 参数指定是否将允许列表提供程序的任何响应视为匹配项。此参数的有效输入为 $true 或 $false。默认值为 $false。当此参数设置为 $true 且连接筛选将连接的 SMTP 服务器的 IP 地址发送给允许列表提供程序时，允许列表提供程序返回的任何响应代码都会导致连接筛选允许来自该源的邮件。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-BitmaskMatch

BitmaskMatch 参数指定允许列表提供程序返回的位掩码状态代码。如果允许列表提供程序返回位掩码响应，则使用此参数。此参数的有效输入为 127.0.0.1 格式的单个 IP 地址。

类型:	IPAddress
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

Confirm 开关指定是否显示确认提示。此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DomainController

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。可以使用完全限定的域名 (FQDN) 来标识域控制器。例如，dc01.contoso.com。

边缘传输服务器上不支持 DomainController 参数。边缘传输服务器使用活动目录轻型目录服务 (AD LDS) 的本地实例来读取和写入数据。

类型:	Fqdn
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Enabled

Enabled 参数指定连接筛选是否使用此 IP 允许列表提供程序。此参数的有效输入为 $true 或 $false。默认值为 $true。默认情况下，连接筛选使用您创建的新 IP 允许列表提供程序。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IPAddressesMatch

IPAddressesMatch 参数指定允许列表提供程序返回的 IP 地址状态代码。如果允许列表提供程序返回 IP 地址或 A 记录响应，则使用此参数。此参数的有效输入为 127.0.0.1 格式的一个或多个 IP 地址。可以输入多个 IP 地址，中间用逗号分隔。

类型:	MultiValuedProperty
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LookupDomain

LookupDomain 参数指定使用允许列表提供程序所需的主机名。连接筛选将连接 SMTP 服务器的 IP 地址发送到您指定的主机名值。示例值为 allowlist.spamservice.com。允许列表提供程序提供了您需要使用的实际值。

类型:	SmtpDomain
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Name

Name 参数指定 IP 允许列表提供程序的描述性名称。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Priority

Priority 参数指定连接筛选代理在查询已配置的 IP 允许列表提供程序时所依据的查询顺序。较低的优先级整数值表示较高的优先级。默认情况下，每次添加新的 IP 允许列表提供程序时，都将为该条目分配优先级 N+1，其中 N 是已配置的 IP 允许列表提供程序数。

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

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

WhatIf 开关模拟命令操作。可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。不必为此开关指定值。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。