Set-IPAllowListProvider (RTM)

 

適用版本： Exchange Server 2007

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

使用 Set-IPAllowListProvider 指令程式，可以修改已安裝 Edge Transport server role 或 Hub Transport server role 之電腦上的特定 IP 允許清單提供者組態的組態資訊。

語法

Set-IPAllowListProvider -Identity <IPAllowListProviderIdParameter> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-LookupDomain <SmtpDomain>] [-Name <String>] [-Priority <Int32>]

Set-IPAllowListProvider [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Instance <IPAllowListProvider>] [-IPAddressesMatch <MultiValuedProperty>] [-LookupDomain <SmtpDomain>] [-Name <String>] [-Priority <Int32>]

詳細描述

使用 Set-IPAllowListProvider 指令程式，可以修改現有的 IP 允許清單提供者組態。此組態是由連線篩選器代理程式使用。必須有 Identity 參數。

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

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

若要在已安裝 Edge Transport server role 的電腦上執行 Set-IPAllowListProvider 指令程式，則必須使用該電腦之本機 Administrators 群組成員的帳戶進行登入。

如需管理 Exchange Server 2007 所需之權限、委派角色及權利的相關資訊，請參閱權限考量。

參數

參數	必要	類型	描述
Identity	必要	Microsoft.Exchange.Configuration.Tasks.IPAllowListProviderIdParameter	Identity 參數可以是字串值，也就是 Name 值或 GUID。
AnyMatch	選用	System.Boolean	AnyMatch 參數的有效輸入是 $true 或 $false。預設值是 $false。當 AnyMatch 參數設定為 $true 時，連線篩選器代理程式就會將由 IP 允許清單提供者服務傳回的任何 IP 位址狀態碼視為相符。
BitmaskMatch	選用	System.Net.IPAddress	當您設定 BitmaskMatch 參數的 IP 位址時，連線篩選器代理程式只會對符合 IP 允許清單提供者服務傳回之 IP 位址狀態碼的郵件採取動作。
DomainController	選用	Microsoft.Exchange.Data.Fqdn	若要指定要將此連線篩選組態資料的組態變更寫入 Active Directory 目錄服務的網域控制站，請在命令中加入 DomainController 參數。如果您是在已安裝 Edge Transport server role 的電腦上執行此命令，則不支援 DomainController 參數。Edge Transport Server 只會寫入至本機 ADAM 執行個體。
Enabled	選用	System.Boolean	Enabled 參數的有效輸入是 $true 或 $false。預設值是 $true。當 Enabled 參數設定為 $true 時，連線篩選器代理程式就會依據此 IP 允許清單提供者組態所設定的優先順序，查詢 IP 允許清單提供者服務。
Instance	選用	Microsoft.Exchange.Data.Directory.SystemConfiguration.IPAllowListProvider	Instance 參數可讓您將整個物件傳遞至要處理的命令。它主要是用於必須將整個物件傳遞至該命令的指令碼。
IPAddressesMatch	選用	Microsoft.Exchange.Data.MultiValuedProperty	當您設定 IPAddressesMatch 參數的 IP 位址時，連線篩選器代理程式只會對符合 IP 允許清單提供者服務傳回之 IP 位址狀態碼的郵件採取動作。
LookupDomain	選用	Microsoft.Exchange.Data.SmtpDomain	連線篩選器代理程式查詢更新 IP 允許清單資料的網域名稱。
Name	選用	System.String	IP 允許清單提供者服務的名稱。如果您變更此值，Identity 參數的字串值仍然不會變。
Priority	選用	System.Int32	設定 Priority 參數，以設定連線篩選器代理程式查詢您已設定之 IP 允許清單提供者服務的順序。依預設，每次新增 IP 允許清單提供者服務時，會將 N+1 的順序指派給項目，其中 N 是您已設定之 IP 允許清單提供者服務的號碼。 如果您將 Priority 參數的值設定為與另一個 IP 允許清單提供者服務相同，則最先新增的 IP 允許清單提供者的優先順序會從 1 開始遞增。

輸入類型

傳回類型

錯誤

錯誤	描述

範例

第一個程式碼範例顯示 Set-IPAllowListProvider 命令，用來設定連線篩選器將所有與 IP 允許清單提供者服務相符者視為可執行的事件。

第二個程式碼範例顯示 Set-IPAllowListProvider 命令，會將現有組態的優先順序設為 1。

Set-IPAllowListProvider -Identity Example.com -AnyMatch:$true 
Set-IPAllowListProvider -Identity Example.com -Priority 1

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