共用方式為

Test-IPAllowListProvider

  • 發行項

 

適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間： 2007-06-28

使用 Test-IPAllowListProvider 指令程式，可以在已安裝 Hub Transport server role 或 Edge Transport server role 的電腦上測試特定 IP 允許清單提供者組態的組態。此組態是由連線篩選器代理程式使用。

語法

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

詳細描述

此命令會檢查與指定之 IP 允許清單提供者的連線狀態，然後對 IP 允許清單提供者發出查閱要求。測試 IP 允許清單提供者的連線及功能時，必須在 IPAddress 參數中輸入已知的允許 IP 位址。

若要執行 Test-IPAllowListProvider 指令程式，您使用的帳戶必須已委派下列資格：

  • Exchange Server 系統管理員角色和目標伺服器的本機 Administrators 群組

若要在已安裝 Edge Transport server role 的電腦上執行 Test-IPAllowListProvider 指令程式，則必須使用該電腦之本機 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 參數。已安裝 Edge Transport server role 的電腦不支援 DomainController 參數。Edge Transport server role 只會寫入至本機 ADAM 執行個體。

Server

選用

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

若要指定執行 Test-IPAllowListProvider 指令程式的伺服器，請在命令中加入 Server 參數。如果未使用 Server 參數，則會在執行工作的本機伺服器上執行命令。

WhatIf

選用

System.Management.Automation.SwitchParameter

WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數，則不需要套用任何變更，就能檢視變更。您不需要為 WhatIf 參數指定任何值。

輸入類型

傳回類型

輸出 描述

Allow List Provider

Allow List Provider 會傳回儲存在本機 ADAM 目錄或 Active Directory 目錄服務中的 IP 允許清單提供者物件。

Connected

Connected 會傳回下列值：True 或 False。

  • True   連線測試成功。

  • False   連線測試失敗。

Matched

Matched 會傳回下列值︰True 或 False。

  • True   使用 Test-IPAllowListProvider 命令提交的 IPAddress 參數符合 IP 允許清單提供者上的 IP 位址。

  • False   使用 Test-IPAllowListProvider 命令提交的 IPAddress 參數不符合 IP 允許清單提供者上的 IP 位址。

ProviderResult

ProviderResult 會傳回 IP 位址，此 IP 位址代表 Test-IPAllowListProvider 命令中所提交的 IPAddress 參數在 IP 允許清單提供者處的狀態。請連絡 IP 允許清單提供者，以判斷此處所傳回之 IP 位址的意義。

錯誤

錯誤 描述

權限不足

您必須使用已安裝 Edge Transport server role 以執行此命令之本機電腦的本機 Administrators 群組成員的帳戶，進行登入。

無法連接到 ADAM

如果您是從已安裝 Edge Transport server role 的電腦上執行此工作，請確認本機電腦上已執行 ADAM 服務 (MsExchangeAdam)。如果您是在已安裝 Hub Transport server role 的電腦上執行此工作，請確認該部電腦可連接到 Active Directory。

無法連接至 IP 允許清單提供者

請連絡 IP 允許清單提供者。

範例

下列程式碼範例顯示含有必要參數的 Test-IPAllowListProvider 命令。此命令會測試虛構 IP 允許清單提供者 (ExampleProviderName) 的連線狀態，然後對該提供者發出查閱要求。

Test-IPAllowListProvider -IPAddress 192.168.0.1 -Provider ExampleProviderName