Test-IPAllowListProvider
适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上一次修改主题： 2007-06-28
使用 Test-IPAllowListProvider cmdlet 可以在安装了集线器传输服务器角色或边缘传输服务器角色的计算机上测试特定 IP 允许列表提供程序配置的配置。连接筛选器代理将使用此配置。
语法
Test-IPAllowListProvider -Identity <IPAllowListProviderIdParameter> -IPAddress <IPAddress> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
此命令检查与指定 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 允许列表提供程序。 |
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
Confirm 参数将导致命令暂停处理，并且需要您在继续处理之前确认该命令将执行的操作。您不必使用 Confirm 参数指定值。 |
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
若要指定用于将此配置更改写入 Active Directory 目录服务的域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。已安装边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色只会写入本地 ADAM 实例。 |
Server |
可选 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
若要指定运行 Test-IPAllowListProvider cmdlet 的服务器，请在命令中包含 Server 参数。如果不使用 Server 参数，则命令将在执行任务的本地服务器上运行。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
WhatIf 参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。您不必使用 WhatIf 参数指定值。 |
输入类型
返回类型
| 输出 | 说明 |
|---|---|
Allow List Provider |
Allow List Provider 返回本地 ADAM 目录或 Active Directory 目录服务中存储的 IP 允许列表提供程序对象。 |
Connected |
Connected 返回下列值：True 或 False。
|
Matched |
Matched 返回下列值：True 或 False。
|
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