Test-IPAllowListProvider (RTM)

適用版本： Exchange Server 2007

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

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

語法

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

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

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

若要在已安裝 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 允許清單提供者。
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 參數，則會在執行工作的本機伺服器上執行命令。

輸出	描述
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

若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.