Test-IPAllowListProvider (RTM)

 

适用于: Exchange Server 2007

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

使用 Test-IPAllowListProvider cmdlet 可以在安装了集线器传输服务器角色或边缘传输服务器角色的计算机上测试特定 IP 允许列表提供程序配置的配置。连接筛选器代理将使用此配置。

语法

Test-IPAllowListProvider -Identity <IPAllowListProviderIdParameter> -IPAddress <IPAddress> [-DomainController <Fqdn>] [-Server <ServerIdParameter>]

详细说明

此命令检查与指定 IP 允许列表提供程序的连接,然后对 IP 允许列表提供程序发出查找请求。在测试 IP 允许列表提供程序的连接和功能时,必须在 IPAddress 参数中输入已知允许的 IP 地址。

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

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

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

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

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.IPAllowListProviderIdParameter

在此参数中输入 IP 允许列表提供程序的名称。Identity 参数必须与要测试的 IP 允许列表提供程序的 Name 参数或 Identity (GUID) 参数匹配。

IPAddress

必需

System.Net.IPAddress

使用 IPAddress 参数验证和测试已配置的 IP 允许列表提供程序。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定用于将此配置更改写入 Active Directory 目录服务域控制器的完全限定的域名 (FQDN),请在命令中包含 DomainController 参数。已安装边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色只会写入本地 ADAM 实例。

Server

可选

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

若要指定运行 Test-IPAllowListProvider cmdlet 的服务器,请在命令中包含 Server 参数。如果不使用 Server 参数,则命令将在执行任务的本地服务器上运行。

输入类型

返回类型

输出 说明

Allow List Provider

Allow List Provider 返回本地 ADAM 目录或 Active Directory 目录服务中存储的 IP 允许列表提供程序对象。

Connected

Connected 返回下列值:TrueFalse

  • True   通过连接测试。

  • False   连接测试失败。

Matched

Matched 返回下列值:TrueFalse

  • True   与 Test-IPAllowListProvider 命令一起提交的 IPAddress 参数与 IP 允许列表提供程序的 IP 地址匹配。

  • False   与 Test-IPAllowListProvider 命令一起提交的 IPAddress 参数与 IP 允许列表提供程序的 IP 地址不匹配。

ProviderResult

ProviderResult 返回一个 IP 地址,代表在 Test-IPAllowListProvider 命令中提交的 IPAddress 参数的状态(根据 IP 允许列表提供程序)。与 IP 允许列表提供程序联系,确定此处返回的 IP 地址的含义。

错误

错误 说明

权限不足

必须使用在安装了边缘传输服务器角色的本地计算机上成为本地 Administrators 组成员的帐户进行登录,才能运行此命令。

无法连接到 ADAM

如果从安装了边缘传输服务器角色的计算机运行此任务,请验证该本地计算机是否正在运行 ADAM 服务 (MsExchangeAdam)。如果从安装了集线器传输服务器角色的计算机运行此任务,请验证该计算机是否可以连接到 Active Directory。

无法连接到 IP 允许列表提供程序

与 IP 允许列表提供程序联系。

示例

以下代码示例显示包含所需参数的 Test-IPAllowListProvider 命令。该命令测试与称为 ExampleProviderName 的虚拟 IP 允许列表提供程序的连接,然后对该提供程序发出查找请求。

Test-IPAllowListProvider -IPAddress 192.168.0.1 -Provider ExampleProviderName