Add-IPBlockListProvider

 

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

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

使用 Add-IPBlockListProvider 指令程式，可以在已安裝 Edge Transport server role 或 Hub Transport server role 的電腦上建立新的 IP 封鎖清單提供者組態。

語法

Add-IPBlockListProvider -Name <String> -LookupDomain <SmtpDomain> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-Priority <Int32>] [-RejectionResponse <AsciiString>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

詳細描述

IP 封鎖清單提供者組態是由連線篩選器代理程式使用。

必須有 Name 參數及 LookupDomain 參數。如果您沒有傳遞必要的參數，Exchange 管理命令介面就會提示您提供。

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

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

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

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

參數

參數	必要	類型	描述
LookupDomain	必要	Microsoft.Exchange.Data.SmtpDomain	連線篩選器代理程式查詢更新 IP 封鎖清單資料的網域名稱
Name	必要	System.String	IP 封鎖清單提供者服務的名稱
AnyMatch	選用	System.Boolean	Enabled 參數的有效輸入是 $true 或 $false。預設值是 $false。當 AnyMatch 參數設定為 $true 時，連線篩選器代理程式就會將由 IP 封鎖清單提供者服務傳回的任何 IP 位址狀態碼視為相符。
BitmaskMatch	選用	System.Net.IPAddress	當您設定 BitmaskMatch 參數使用 IP 位址時，連線篩選器代理程式只會對符合 IP 封鎖清單提供者服務傳回之 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 執行個體。
Enabled	選用	System.Boolean	Enabled 參數的有效輸入是 $true 或 $false。預設值是 $true。當 Enabled 參數設定為 $true 時，連線篩選器代理程式就會依據此 IP 封鎖清單提供者組態所設定的優先順序，查詢 IP 封鎖清單提供者服務。
IPAddressesMatch	選用	Microsoft.Exchange.Data.MultiValuedProperty	當 IPAddressesMatch 參數已設定為使用 IP 位址時，連線篩選器代理程式只會對符合 IP 封鎖清單提供者服務傳回之相同 IP 位址狀態碼的郵件採取動作。
Priority	選用	System.Int32	設定 Priority 參數，以設定連線篩選器代理程式查詢您已設定之 IP 封鎖清單提供者服務的順序。依預設，每次新增 IP 封鎖清單提供者時，會將 N+1 的順序指派給項目，其中 N 是您已設定之 IP 封鎖清單提供者服務的號碼。 如果您將 Priority 參數的值設定為與另一個 IP 封鎖清單提供者服務相同，則最先新增的 IP 封鎖清單提供者的優先順序會從 1 開始遞增。
RejectionResponse	選用	Microsoft.Exchange.Data.AsciiString	RejectionResponse 參數需要一個字串。輸入您想要在 SMTP 工作階段中傳遞給寄件者的郵件內文，在 IP 封鎖清單提供者服務發現相符的寄件者 IP 位址時，連線篩選器代理程式就會封鎖該寄件者的郵件並寄出這段文字。建議您在回應中指定 IP 封鎖清提供者服務，如此合法的寄件者才能連絡 IP 封鎖清單提供者服務。引數不可以超過 240 個字元。傳遞引數時，如果字詞如下所示含有空格，則必須用雙引號括住 RejectionResponse 參數，例如： "Originating IP addressed matched to Example.com's IP Block List provider service".
TemplateInstance	選用	System.Management.Automation.PSObject	將現有物件提供給此參數時，命令會使用該物件的組態在本機或目標伺服器上建立該物件的相同複本。
WhatIf	選用	System.Management.Automation.SwitchParameter	WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數，則不需要套用任何變更，就能檢視變更。您不需要為 WhatIf 參數指定任何值。

輸入類型

傳回類型

錯誤

錯誤	描述

範例

第一個程式碼範例顯示具有必要參數的 Add-IPBlockListProvider 命令。這個程式碼也會顯示如何新增 IP 封鎖清單提供者並設定拒絕回應。

第二個程式碼範例顯示具有必要參數的 Add-IPBlockListProvider 命令，並顯示如何設定來自提供者的位元遮罩傳回值。

Add-IPBlockListProvider -Name:Example -LookupDomain:Example.com -RejectionResponse "Originating IP addressed matched to Example.com's IP Block List provider service"
Add-IPBlockListProvider -Name:Example -LookupDomain:Example.com -BitmaskMatch 127.1.0.1